Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Azure DevOps Services | Servidor Azure DevOps | Azure DevOps Server 2022
Ao se conectar ao Analytics do Power BI ou do Excel, você deve autenticar-se no Azure DevOps. Este artigo explica como inserir credenciais, escolher um método de autenticação e atualizar as credenciais armazenadas quando elas expirarem ou precisarem ser alteradas.
Importante
Considere usar os tokens do Microsoft Entra mais seguros em vez dos tokens de acesso pessoal de maior risco. Para obter mais informações, consulte Reduzir o uso do PAT. Examine as diretrizes de autenticação para escolher o mecanismo de autenticação correto para suas necessidades.
Pré-requisitos
| Categoria | Requisitos |
|---|---|
| Níveis de Acesso |
-
Membro do projeto. – Pelo menos acesso básico . |
| Permissões | Por padrão, os membros do projeto têm permissão para consultar o Analytics e criar visualizações. Para obter mais informações sobre outros pré-requisitos sobre a habilitação de serviços e recursos e atividades gerais de acompanhamento de dados, consulte Permissões e pré-requisitos para acessar o Analytics. |
| Ferramentas | Power BI Desktop |
Nota
O serviço de Análise é habilitado automaticamente e tem suporte na produção de todos os serviços no Azure DevOps Services. A integração do Power BI e o acesso ao feed OData do serviço de Análise estão disponíveis em geral. Você é incentivado a usar o feed OData do Analytics e fornecer comentários.
Os dados disponíveis dependem da versão. A versão mais recente com suporte da API OData é v2.0e a versão de versão prévia mais recente é v4.0-preview. Para obter mais informações, confira Sobre o controle de versão da API OData.
Nota
O serviço de Analytics é automaticamente instalado e suportado em produção para todas as novas coleções de projetos no Azure DevOps Server 2020 e versões posteriores. A integração do Power BI e o acesso ao feed OData do serviço de Análise estão disponíveis em geral. Você é incentivado a usar o feed OData do Analytics e fornecer comentários. Se você atualizar do Azure DevOps Server 2019, poderá instalar o serviço de Análise durante a atualização.
Os dados disponíveis dependem da versão. A versão mais recente com suporte da API OData é v2.0e a versão de versão prévia mais recente é v4.0-preview. Para obter mais informações, confira Sobre o controle de versão da API OData.
Microsoft Entra ID
A ID do Microsoft Entra também é conhecida como "Credencial Organizacional" no Power BI Desktop. Você pode usá-lo no Power BI selecionando OAuth ao configurar a atualização de dados.
Ao se conectar ao Power BI Desktop, você será solicitado a inserir suas credenciais para a fonte de dados. Selecione a conta organizacional , conforme mostrado aqui:
Escolha Entrar e digite suas credenciais do Microsoft Entra. Depois disso, você terminou.
Para alterar uma URL existente para usar o Microsoft Entra ID em vez de um PAT, consulte Alterar credenciais de autenticação posteriormente neste artigo.
autenticação do Windows
Você pode usar a autenticação do Windows no do Power BI por meio da seleção de OAuth ao configurar a atualização de dados.
Ao se conectar ao Power BI Desktop, você será solicitado a inserir suas credenciais para a fonte de dados. Selecione o Windows , conforme mostrado aqui:
Insira suas credenciais do Windows e escolha Conectar.
Para alterar uma URL existente para utilizar o Windows em vez de um PAT, veja a seção Alterar credenciais de autenticação mais adiante neste artigo.
Inserir credenciais em um cliente
O Power BI e o Excel usam o Power Query ao acessar o OData. O mecanismo de autenticação, incluindo as várias telas de autenticação, é idêntico. Este passo a passo usa o Power BI Desktop, mas também se aplica ao Excel.
Abra o Power BI Desktop.
Escolha Obter Dados.
Selecione Feed OData (ou Mais > Outro > Feed OData).
Insira a URL do ponto de extremidade de OData e escolha OK.
- Na caixa de diálogo de autenticação, escolha a conta organizacional e, em seguida, selecione Entrar e insira suas credenciais do Microsoft Entra.
- Na caixa de diálogo de autenticação, escolha o Windows e insira suas credenciais do Windows.
- Escolha Conectar.
Tip
Se você se conectou anteriormente a um PAT (autenticação básica), atualize suas credenciais armazenadas para usar a ID do Microsoft Entra ou a autenticação do Windows. Para obter etapas, consulte Alterar credenciais de autenticação.
Em vez disso, use um PAT (não recomendado)
Se você não puder usar a ID do Microsoft Entra ou a autenticação do Windows, você poderá autenticar com um PAT:
-
Criar um PAT com o escopo Analytics (leitura) (
vso.analytics). - Copie a o token. Se você for para uma página diferente, não poderá recuperá-la mais tarde.
- Na caixa de diálogo de autenticação, escolha Básico e insira o PAT como a senha.
Aviso
Os PATs são menos seguros do que a ID do Microsoft Entra ou a autenticação do Windows e exigem rotação manual. Use PATs somente quando outros métodos de autenticação não estiverem disponíveis para seu cenário.
Alterar credenciais de autenticação
Se você receber uma mensagem de acesso negado, talvez seja necessário alterar suas credenciais de autenticação. O Power Query armazena em cache suas informações de credencial para que você só precise inseri-la uma vez. No entanto, os tokens de acesso pessoal expiram e talvez seja necessário atualizar ou alterar suas informações de autenticação.
Atualizar credenciais no Power BI Desktop
Abra o Power BI Desktop.
Selecione Arquivo>Opções e Configurações>Configurações de fonte de dados. Selecione a URL correta no Feed OData e selecione Editar.
Na próxima caixa de diálogo Configurações da Fonte de Dados , selecione o botão Editar na configuração Credenciais .
Edite as credenciais conforme descrito anteriormente, selecione Salvar e, em seguida, Concluído e Feche.
Atualizar credenciais no Excel
Abra o Excel e selecione Obter>.
Selecione a URL correta no feed OData e selecione Editar.
Na próxima caixa de diálogo Configurações da Fonte de Dados , selecione o botão Editar na configuração Credenciais .
Edite as credenciais conforme descrito anteriormente e salve sua atualização.
Publicar no Power BI
Depois de criar um modelo e carregá-lo com dados, você pode publicá-lo no Power BI. Ao usar a ID do Microsoft Entra ou o Windows, selecione a opção oAuth2 .