Analysera utsläppsdata
Viktigt
Några eller alla dessa funktioner ingår som en del av en förhandsversion. Innehållet och funktionerna kan komma att ändras.
Du kan använda två metoder för att komma åt utsläppsdata med funktionen Azure utsläppsinsikter i lösningar för hållbarhetsdata i Microsoft Fabric:
Få tillgång till utsläppsdata via SQL
Du kan komma åt aggregerade data i ComputedESGMetrics sjöhus via de SQL slutpunkt som är tillgängliga i AnalyzeAzureEmissionsDataset med följande steg:
På startsidan för Azure emissions insights-funktionen Välj den semantiska modellen AnalyzeAzureEmissionsDataset .
Navigera till slutpunkten för ComputedESGMetrics SQL.
Du kan använda συμβολοσειρά SQLσύνδεσης för att använda datauppsättning externt med kompatibla SQL klientverktyg, till exempel Azure Data Studio och SQL Server Management Studio (SSMS).
Få tillgång till utsläppsdata via API:er
Skapa en appidentitet i din Microsoft Entra ID-klientorganisation och skapa en ny klienthemlighet för appidentiteten.
I det här användningsfallet registrerar du programmet med kontotypen Konton endast i den här organisationskatalogen. Hoppa över omdirigerings-URI:n eftersom det inte krävs i det här fallet. Du kan också hoppa över stegen Konfigurera plattformsinställningar , eftersom de inte krävs för det här scenariot.
Konfigurera klientinställningar på administratörsnivå. Kontrollera att du har någon av administratörsrollerna enligt definitionen i Förstå administratörsroller Microsoft Fabric i dokumentationen Microsoft Fabric . Kontakta klientadministratören Microsoft Fabric för att slutföra de här stegen om det behövs:
Öppna arbetsytan i infrastrukturen där du distribuerade lösningar för hållbarhetsdata.
Välj den Inställningar i det övre högra hörnet för att öppna sidopanelen för inställningar och sedan välj Admin-portalen.
I avsnittet Klientinställningar går du till Utvecklarinställningar och aktiverar Tjänstens huvudnamn kan använda behörigheten Fabric-API:er för hela organisationen eller för en specifik säkerhetsgrupp.
Kontrollera att appidentiteten som du skapade tidigare är medlem i säkerhetsgruppen.
Tilldela behörigheter till appidentiteten:
Gå till arbetsytevyn och välj alternativet Hantera åtkomst för att hantera roller på arbetsytenivå.
Välj den Lägg till personer eller grupper för att lägga till appidentiteten med någon av följande roller: Medlem, deltagare eller Administratör. Det här steget krävs eftersom de data som används är en intern genväg från OneLake.
Anropa REST-API:erna:
Obs
Du kan integrera dessa REST-API-anrop i alla HTTP-klientprogram.
Hämta åtkomsttoken för den konfigurerade appidentiteten. Se Hämta token för att anropa ett webb-API med hjälp av ett daemonprogram i ID-dokumentationen för att hämta token för appidentiteten med hjälp av Microsoft Entra arbetsflödet för klientautentiseringsuppgifter OAuth 2.0. Parametern scope ska vara "https://storage.azure.com/.default" i tokenbegäran.
Visa en lista över de datapartitionsfiler som finns i IngestedRawData sjöhus med hjälp av följande API-anrop.
workspaceId: Den unika identifieraren för Microsoft Fabric arbetsytan. Det är till exempel det första GUID:en i URL:en när IngestedRawData sjöhus öppnas i Microsoft Fabric.
lakehouseId: Den unika identifieraren för sjöhus som har importerade Azure utsläppsdata. Hit det inmatade rådata-ID:t sjöhus. Det är till exempel det andra GUID:en i URL:en när IngestedRawData sjöhus öppnas i Microsoft Fabric.
enrollmentNumber: Registrerings-ID för fakturering vars data måste läsas. Det faktureringsregistrerings-ID som skickas Hit är samma som ett av mappnamnen som är tillgängliga under sökvägen "Files/AzureEmissions" i IngestedRawData sjöhus.
Begäran:
HTTP GET https://onelake.dfs.fabric.microsoft.com/<workspaceId>?recursive=false&resource=filesystem&directory=<lakehouseId>%2FFiles%2FAzureEmissions%2F<enrollmentNumber>
Svar:
Returnerar en lista med filegenskaper. Det här är datapartitionsfilerna som lagrar utsläppsdata för det angivna registreringsnumret.
Hämta innehållet i den specifika datapartitionsfilen.
workspaceId: Den unika identifieraren för Microsoft Fabric arbetsytan.
emissionsPartitionFilePath: Relativ sökväg till en av partitionsfilerna som hämtades från tidigare API-anrop. Detta kan till exempel visualiseras på följande sätt:
<lakehouseId>/Files/AzureEmissions/<enrollmentNumber>/<emissionsPartitionFileName>.parquet
Begäran:
HTTP GET https://onelake.dfs.fabric.microsoft.com/<workspaceId>/<emissionsPartitionFilePath>
Svar:
Innehållet i partitionsfilen för utsläppsdata. Hit, när API:et läser Parquet-filen, måste svaret parsas via ett lämpligt Parquet-bibliotek eller verktyg. Om du till exempel använder ett . NET-program för att läsa utsläppsdata med hjälp av API:er kan du använda ett av C# Parquet-biblioteken för att avkoda Parquet-innehållet och lagra det i programslutet.