Analisar dados de emissões
Importante
Algumas ou todas estas funcionalidades estão disponíveis como parte de uma versão de pré-visualização. O conteúdo e a funcionalidade estão sujeitos a alterações.
Você pode usar dois métodos para acessar dados de emissões com o recurso Azure insights de emissões em soluções de dados de sustentabilidade em Microsoft Fabric:
Aceda aos dados de emissões através do SQL
Você pode acessar os dados agregados no ComputedESGMetrics lakehouse por meio do SQL ponto final disponível no AnalyzeAzureEmissionsDataset com estas etapas:
Na página inicial do recurso Azure emissions insights , selecione o modelo semântico AnalyzeAzureEmissionsDataset .
Navegue até o ponto final ComputedESGMetrics SQL.
Você pode usar a cadeia de conexão Copiar SQL para usar o conjunto de dados externamente com ferramentas de cliente SQL compatíveis, como Azure Data Studio e SQL Server Management Studio (SSMS).
Aceda a dados de emissões através de APIs
Crie uma identidade de aplicativo em seu Microsoft Entra locatário de ID e crie um novo segredo de cliente para a identidade do aplicativo.
Para este caso de uso, registre o aplicativo com um tipo de conta de Contas somente neste diretório organizacional. Ignore o URI de redirecionamento, porque ele não é necessário neste caso. Você também pode ignorar as etapas Configurar configurações da plataforma, pois elas não são necessárias para esse cenário.
Defina as configurações de locatário no nível de administrador. Certifique-se de ter uma das funções de administrador, conforme definido em Compreender Microsoft Fabric funções de administrador na Microsoft Fabric documentação. Consulte o Microsoft Fabric administrador do locatário para concluir estas etapas, se necessário:
Abra o espaço de trabalho no Fabric onde você implantou soluções de dados de sustentabilidade.
Selecione o ícone Configurações no canto superior direito para abrir o painel lateral de configurações e, em seguida, selecione Portal de administração.
Na secção Configurações do locatário, vá para Configurações do desenvolvedor e habilite a permissão As entidades de serviço podem usar APIs de malha para toda a organização ou para um grupo de segurança específico.
Verifique se a identidade do aplicativo que você criou anteriormente é membro do grupo de segurança.
Atribua permissões à identidade do aplicativo:
Navegue até a exibição do espaço de trabalho e selecione a opção Gerenciar acesso para gerenciar funções no nível do espaço de trabalho.
Selecione o botão Adicionar pessoas ou grupos para adicionar a identidade do aplicativo com uma das seguintes funções: Membro, contribuinte ou Administrador. Esse passo é necessário, porque os dados acessados são um atalho interno do OneLake.
Chame as APIs REST:
Nota
Você pode integrar essas chamadas API REST em qualquer aplicativo cliente HTTP.
Buscar o token de acesso para a identidade do aplicativo configurado. Consulte Adquirir tokens para chamar uma API da Web usando um aplicativo daemon na documentação de Microsoft Entra ID para buscar o token para a identidade do aplicativo usando o fluxo de trabalho de credenciais OAuth de cliente 2.0. O parâmetro de âmbito deve ser "https://storage.azure.com/.default" na solicitação de token.
Liste os arquivos de partição de dados presentes no IngestedRawData lakehouse usando a seguinte chamada de API.
workspaceId: O identificador exclusivo do Microsoft Fabric espaço de trabalho. Por exemplo, é o primeiro GUID na URL quando o IngestedRawData lakehouse é aberto no Microsoft Fabric.
lakehouseId: O identificador exclusivo do lakehouse com os dados de emissões Azure importados. Aqui, os dados brutos ingeridos lakehouse ID. Por exemplo, é o segundo GUID na URL quando o IngestedRawData lakehouse é aberto no Microsoft Fabric.
enrollmentNumber: ID de inscrição de faturamento cujos dados precisam ser lidos. O ID de inscrição de cobrança que está a ser passado aqui é o mesmo que um dos nomes de pasta disponíveis no caminho de "Files/AzureEmissions" no IngestedRawData lakehouse.
Pedido:
HTTP GET https://onelake.dfs.fabric.microsoft.com/<workspaceId>?recursive=false&resource=filesystem&directory=<lakehouseId>%2FFiles%2FAzureEmissions%2F<enrollmentNumber>Resposta:
Retorna uma lista de propriedades de arquivo. Estes são os arquivos de partição de dados que armazenam os dados de emissões para o número de inscrição especificado.
Buscar o conteúdo do arquivo de partição de dados específico.
workspaceId: O identificador exclusivo do Microsoft Fabric espaço de trabalho.
emissionsPartitionFilePath: Caminho relativo de um dos arquivos de partição obtidos da chamada de API anterior. Por exemplo, isso pode ser visualizado da seguinte forma:
<lakehouseId>/Files/AzureEmissions/<enrollmentNumber>/<emissionsPartitionFileName>.parquet
Pedido:
HTTP GET https://onelake.dfs.fabric.microsoft.com/<workspaceId>/<emissionsPartitionFilePath>Resposta:
O conteúdo do arquivo de partição de dados de emissões. Aqui, como a API está a ler o arquivo Parquet, o corpo resposta deve ser analisado através de uma biblioteca ou ferramenta Parquet apropriada. Por exemplo, se você estiver a usar um aplicativo .NET para ler os dados de emissões usando APIs, poderá usar uma das bibliotecas do C# Parquet para decodificar o conteúdo do Parquet e armazená-lo na extremidade do aplicativo.
