Use identidade gerida para autenticar o seu trabalho Azure Stream Analytics no Power BI

Autenticação de identidade gerida para exportação para o Power BI permite que as tarefas de Stream Analytics acedam diretamente a um espaço de trabalho na sua conta de Power BI. Esta funcionalidade permite que as implementações de trabalhos de Stream Analytics sejam totalmente automatizadas, uma vez que o utilizador já não precisa de iniciar sessão interativamente no Power BI através do portal Azure. Além disso, trabalhos de longa duração que escrevem para Power BI são agora melhor suportados, pois não é necessário reautorizar o trabalho periodicamente.

Este artigo mostra-lhe como ativar a identidade gerida para as saídas do Power BI de um trabalho de Stream Analytics através do portal Azure e através de uma implementação no Azure Resource Manager.

Importante

O streaming em tempo real no Power BI está a ser retirado. A partir de 31 de outubro de 2027, os utilizadores não poderão criar jobs do Azure Stream Analytics que utilizem o conector de saída do Power BI, e os jobs existentes que utilizam este conector deixam de funcionar. Microsoft recomenda explorar Inteligência em Tempo Real no Microsoft Fabric para cenários em tempo real. Para orientações sobre migração, consulte o artigo power-bi-output.md.

Note

Apenas as identidades geridas atribuídas pelo sistema são suportadas com a saída do Power BI. Atualmente, o uso de identidades geridas atribuídas pelo utilizador com a saída do Power BI não é suportado.

Prerequisites

Para usar esta funcionalidade, são necessários os seguintes pré-requisitos:

  • Uma conta Power BI com uma licença Pro.
  • Um espaço de trabalho melhorado dentro da sua conta Power BI. Para mais informações, consulte o anúncio de Power BI.

Crie um trabalho de Análise de Fluxos usando o portal Azure

  1. Crie um novo emprego de Stream Analytics ou abra um emprego existente no portal do Azure.

  2. Na barra de menu do lado esquerdo do ecrã, selecione Identidade Gerida em Definições.

    Captura de ecrã a mostrar a página de Identidade Gerida com o botão Select Identity selecionado.

  3. Ao selecionar identidade, selecione Identidade atribuída ao sistema. Em seguida, selecione Salvar.

    Captura de ecrã que mostra a página de Selecionar identidade com a identidade atribuída ao Sistema selecionada.

  4. Na Managed identity, confirme que vê o ID Principal e nome Principal atribuídos ao seu trabalho de Stream Analytics. O nome principal deve ser o mesmo que o nome do seu emprego em Análise de Fluxos.

  5. Antes de configurar a saída, dê ao trabalho de Stream Analytics acesso ao seu espaço de trabalho de Power BI seguindo as instruções na secção Dê ao trabalho de Stream Analytics acesso ao seu Power BI espaço de trabalho deste artigo.

  6. Vai à secção Outputs do teu trabalho de Análise de Fluxos, seleciona + Adicionar e depois escolhe Power BI. Depois, selecione o botão Autorizar e inicie sessão com a sua conta Power BI.

    Autorizar com conta Power BI

  7. Depois de autorizado(a), uma lista suspensa é preenchida com todos os espaços de trabalho a que tem acesso. Selecione o espaço de trabalho que autorizou na etapa anterior. Depois, selecione Identidade Gerida como modo de Autenticação. Por fim, selecione o botão Guardar .

    Captura de ecrã mostrando a configuração de saída Power BI com o modo de autenticação de identidade gerida selecionado.

Implementação do Gestor de Recursos do Azure

O Azure Resource Manager permite-lhe automatizar totalmente a implementação do seu trabalho de Stream Analytics. Pode implementar modelos Resource Manager usando Azure PowerShell ou o CLI do Azure. Os exemplos seguintes utilizam a CLI do Azure.

  1. Cria um Microsoft. StreamAnalytics/streamingjobs recurso com identidade gerida ao incluir a seguinte propriedade na secção de recursos do seu modelo de Resource Manager:

    "identity": {
    "type": "SystemAssigned",
}

    Esta propriedade indica ao Azure Resource Manager para criar e gerir a identidade para o seu trabalho de Stream Analytics. O exemplo seguinte mostra um modelo de Resource Manager que implementa um trabalho de Stream Analytics com identidade gerida ativada e um dissipador de saída Power BI que utiliza identidade gerida:

    {
    "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "apiVersion": "2017-04-01-preview",
            "name": "pbi_managed_id",
            "location": "[resourceGroup().location]",
            "type": "Microsoft.StreamAnalytics/StreamingJobs",
            "identity": {
                "type": "systemAssigned"
            },
            "properties": {
                "sku": {
                    "name": "standard"
                },
                "outputs":[
                    {
                        "name":"output",
                        "properties":{
                            "datasource":{
                                "type":"PowerBI",
                                "properties":{
                                    "dataset": "dataset_name",
                                    "table": "table_name",
                                    "groupId": "01234567-89ab-cdef-0123-456789abcdef",
                                    "authenticationMode": "Msi"
                                }
                            }
                        }
                    }
                ]
            }
        }
    ]
}

    Implemente o trabalho anterior para o grupo de recursos ExampleGroup usando o seguinte comando CLI do Azure:

    az deployment group create --resource-group ExampleGroup -template-file StreamingJob.json

  2. Depois de criar o trabalho, use o Azure Resource Manager para obter a definição completa do trabalho.

    az resource show --ids /subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.StreamAnalytics/StreamingJobs/<resource-name>

    O comando anterior devolve uma resposta semelhante à seguinte:

    {
    "id": "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.StreamAnalytics/streamingjobs/<resource-name>",
    "identity": {
        "principalId": "<principal-id>",
        "tenantId": "<tenant-id>",
        "type": "SystemAssigned",
        "userAssignedIdentities": null
    },
    "kind": null,
    "location": "West US",
    "managedBy": null,
    "name": "<resource-name>",
    "plan": null,
    "properties": {
        "compatibilityLevel": "1.0",
        "createdDate": "2019-07-12T03:11:30.39Z",
        "dataLocale": "en-US",
        "eventsLateArrivalMaxDelayInSeconds": 5,
        "jobId": "<job-id>",
        "jobState": "Created",
        "jobStorageAccount": null,
        "jobType": "Cloud",
        "outputErrorPolicy": "Stop",
        "package": null,
        "provisioningState": "Succeeded",
        "sku": {
            "name": "Standard"
        }
    },
    "resourceGroup": "<resource-group>",
    "sku": null,
    "tags": null,
    "type": "Microsoft.StreamAnalytics/streamingjobs"
}

    Se planeia usar a API REST do Power BI para adicionar o trabalho de Stream Analytics ao seu espaço de trabalho Power BI, note o principalId devolvido.

  3. Dado que o trabalho foi criado, avance para a secção Conceder acesso ao trabalho de Stream Analytics ao seu espaço de trabalho Power BI deste artigo.

Dê ao trabalho de Stream Analytics acesso ao seu espaço de trabalho no Power BI

Depois de criar o trabalho de Stream Analytics, dê-lhe acesso a um espaço de trabalho do Power BI. Depois de conceder acesso ao trabalho, aguarde alguns minutos para que a identidade se propague.

Usar a interface do Power BI

Note

Para adicionar o trabalho de Stream Analytics ao seu espaço de trabalho do Power BI usando a interface, também precisa de ativar o acesso do principal do serviço nas Definições de Desenvolvedor no portal de administração do Power BI. Para mais informações, consulte Começar com um princípio de serviço.

  1. Vai às definições de acesso do workspace. Para mais informações, consulte Dar acesso ao seu espaço de trabalho.

  2. Introduza o nome do seu trabalho de Stream Analytics na caixa de texto e selecione Contribuidor como nível de acesso.

  3. Selecione Adicionar e feche o painel.

    Adicionar trabalho de Stream Analytics ao Power BI espaço de trabalho

Use os comandos do PowerShell do Power BI

  1. Instala os comandos Power BI MicrosoftPowerBIMgmt PowerShell.

    Importante

    Certifica-te de que estás a usar a versão 1.0.821 ou posterior dos cmdlets.

    Install-Module -Name MicrosoftPowerBIMgmt

  2. Iniciar sessão no Power BI.

    Login-PowerBI

  3. Adiciona o teu trabalho de Stream Analytics como Contribuidor ao espaço de trabalho.

    Add-PowerBIWorkspaceUser -WorkspaceId <group-id> -PrincipalId <principal-id> -PrincipalType App -AccessRight Contributor

Usar a API REST do Power BI

Pode adicionar o trabalho de Stream Analytics como Contribuidor ao espaço de trabalho usando diretamente a API REST "Adicionar Utilizador de Grupo". Para documentação completa, consulte Grupos - Adicionar Utilizador de Grupo.

Pedido de amostra

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users

Órgão do Pedido

{
    "groupUserAccessRight": "Contributor",
    "identifier": "<principal-id>",
    "principalType": "App"
}

Utilize um principal de serviço para conceder permissão à identidade gerida de um trabalho da ASA

Para implementações automatizadas, não é possível usar uma sessão de login interativa para dar a um trabalho do ASA acesso a um espaço de trabalho do Power BI. Pode usar um principal de serviço para conceder permissão para a identidade gerida de um trabalho ASA. Pode usar o PowerShell para esta abordagem:

Connect-PowerBIServiceAccount -ServicePrincipal -TenantId "<tenant-id>" -CertificateThumbprint "<thumbprint>" -ApplicationId "<app-id>"
Add-PowerBIWorkspaceUser -WorkspaceId <group-id> -PrincipalId <principal-id> -PrincipalType App -AccessRight Contributor

Remover identidade gerenciada

A identidade gerida que é criada para um trabalho de Stream Analytics só é eliminada quando elimina o trabalho. Não há forma de apagar a identidade gerida sem eliminar o trabalho. Se já não quiser usar a identidade gerida, pode alterar o método de autenticação para a saída. A identidade gerida continua a existir até apagares o trabalho. Se decidir usar novamente a autenticação por identidade gerida, a identidade gerida voltará a ser usada.

Limitations

Este recurso tem as seguintes limitações:

  • Os espaços de trabalho clássicos do Power BI não são suportados.

  • Contas Azure sem Microsoft Entra ID não são suportadas.

  • O acesso multitenant não é suportado. O "service principal" que criar para um determinado trabalho do Stream Analytics deve residir no mesmo tenant do Microsoft Entra no qual criou o trabalho. Não podes usá-lo com um recurso que reside noutro tenant do Microsoft Entra.

  • A identidade atribuída pelo utilizador não é suportada. Não podes inserir o teu próprio principal de serviço para ser usado pelo teu trabalho de Stream Analytics. O Azure Stream Analytics deve gerar o principal do serviço.

Passos seguintes

  • Last updated on