Delen via


Uitstootgegevens analyseren

Belangrijk

Een gedeelte van of alle functionaliteit is beschikbaar als onderdeel van een preview-release. De inhoud en functionaliteit zijn aan verandering onderhevig.

U kunt twee methoden gebruiken om toegang te krijgen tot emissiegegevens met de emissie-inzichtenfunctie Azure in Duurzaamheidsdataoplossingen in Microsoft Fabric:

Krijg toegang tot emissiegegevens via SQL

U kunt de geaggregeerde gegevens in de ComputedESGMetrics lakehouse openen via de SQL eindpunt die beschikbaar is in de AnalyzeAzureEmissionsDataset met de volgende stappen:

  1. Selecteer op de startpagina van de mogelijkheden van Azure emissions insights het semantische model AnalyzeAzureEmissionsDataset .

  2. Navigeer naar ComputedESGMetrics SQL en aanwijzen.

    Schermafbeelding van ComputedESGMetrics SQL en aanwijzen.

  3. U kunt de verbindingsreeks SQL kopiëren gebruiken om gegevensset extern te gebruiken met compatibele SQL-clienthulpprogramma's, zoals Azure Data Studio en SQL Server Management Studio (SSMS).

    Schermafbeelding van de verbindingsreeks SQL.

Toegang tot emissiegegevens via API's

  1. Maak een app-identiteit in uw Microsoft Entra ID-tenant en maak een nieuw clientgeheim voor de app-identiteit.

    Voor dit gebruiksscenario registreert u de toepassing met het accounttype Alleen accounts in deze organisatiedirectory. Sla de omleidings-URI over, omdat deze in dit geval niet nodig is. U kunt ook de stappen Configureer platforminstellingen overslaan, omdat deze niet vereist zijn voor dit scenario.

  2. Configureer tenantinstellingen op beheerdersniveau. Zorg ervoor dat u een van de beheerdersrollen hebt zoals gedefinieerd in Begrijp Microsoft Fabric beheerdersrollen in de Microsoft Fabric documentatie. Neem contact op met uw tenantbeheerder om deze stappen te voltooien als dat nodig is: Microsoft Fabric

    1. Open de werkruimte in Fabric waar u Sustainability-dataoplossingen hebt geïmplementeerd.

    2. Selecteer het pictogram instellingen in de rechterbovenhoek om het instellingenpaneel te openen en selecteer vervolgens Beheerportaal.

    3. Ga in het gedeelte Tenantinstellingen naar Ontwikkelaarsinstellingen en schakel de machtiging Serviceprincipals kunnen Fabric API's gebruiken in voor de hele organisatie of voor een specifieke beveiligingsgroep.

    4. Controleer of de app-identiteit die u eerder hebt gemaakt, lid is van de beveiligingsgroep.

      Schermafbeelding van beveiligingsgroep.

  3. Wijs machtigingen toe aan de app-identiteit:

    1. Navigeer naar de werkruimteweergave en selecteer de optie toegang beheren om rollen op werkruimteniveau te beheren.

    2. Selecteer de knop Personen of groepen toevoegen om de app-identiteit toe te voegen met een van de volgende rollen: Lid, inzender of Beheerder. Deze stap is vereist, omdat de benaderde gegevens een interne snelkoppeling van OneLake zijn.

    Schermafbeelding van het scherm 'Personen toevoegen'.

  4. Roep de REST API's aan:

    Notitie

    U kunt deze REST API-aanroepen integreren in elke HTTP-clienttoepassing.

    1. Haal de toegangstoken op voor de geconfigureerde app-identiteit. Raadpleeg Tokens verkrijgen om een web-API aan te roepen met behulp van een daemon-applicatie in de Microsoft Entra ID-documentatie om het token voor de app-identiteit op te halen met behulp van clientreferenties OAuth 2.0-workflow. De scopeparameter moet "https://storage.azure.com/.default" zijn in de tokenaanvraag.

    2. Geef de gegevenspartitiebestanden weer die aanwezig zijn in de IngestedRawData lakehouse met behulp van de volgende API-aanroep.

      • workspaceId: De unieke identificatie van de Microsoft Fabric werkruimte. Het is bijvoorbeeld de eerste GUID in de URL wanneer IngestedRawData lakehouse wordt geopend in Microsoft Fabric.

      • lakehouseId: De unieke identificatie van de lakehouse met de geïmporteerde Azure emissiegegevens. Hier de opgenomen ruwe data lakehouse ID. Het is bijvoorbeeld de tweede GUID in de URL wanneer IngestedRawData lakehouse wordt geopend in de Microsoft Fabric.

      • enrollmentNumber: Factureringsinschrijvings-ID waarvan de gegevens moeten worden gelezen. De factureringsinschrijvings-ID die hier wordt doorgegeven, is hetzelfde als een van de mapnamen die beschikbaar zijn onder het pad 'Files/AzureEmissions' in IngestedRawData lakehouse.

      Verzoek:

      HTTP GET https://onelake.dfs.fabric.microsoft.com/<workspaceId>?recursive=false&resource=filesystem&directory=<lakehouseId>%2FFiles%2FAzureEmissions%2F<enrollmentNumber> 
      

      Respons:

      Retourneert een lijst met bestandseigenschappen. Dit zijn de gegevenspartitiebestanden waarin de emissiegegevens voor het opgegeven inschrijvingsnummer zijn opgeslagen.

    3. Haal de inhoud van het specifieke gegevenspartitiebestand op.

      • workspaceId: De unieke identificatie van de Microsoft Fabric werkruimte.

      • emissionsPartitionFilePath: Relatief pad van een van de partitiebestanden opgehaald uit de vorige API-aanroep. Dit kan bijvoorbeeld als volgt worden gevisualiseerd:

        <lakehouseId>/Files/AzureEmissions/<enrollmentNumber>/<emissionsPartitionFileName>.parquet 
        

      Verzoek:

      HTTP GET https://onelake.dfs.fabric.microsoft.com/<workspaceId>/<emissionsPartitionFilePath> 
      

      Respons:

      De inhoud van het emissiegegevenspartitiebestand. Omdat de API het Parquet-bestand leest, moet de body respons worden geparseerd via een geschikte Parquet-bibliotheek of -tool. Als u bijvoorbeeld een .NET-toepassing gebruikt om emissiegegevens te lezen met behulp van API's, kunt u een van de C# Parquet-bibliotheken gebruiken om de Parquet-inhoud te decoderen en op te slaan aan de toepassingszijde.

Volgende stap