Solucionar problemas de gateways - Power BI

Nota

Dividimos os documentos do gateway de dados local em conteúdo específico do Power BI e conteúdo geral que se aplica a todos os serviços suportados pelo gateway. Você está atualmente no conteúdo do Power BI. Para fornecer comentários sobre este artigo ou sobre a experiência geral de documentos do gateway, role até a parte inferior do artigo.

Este artigo discute alguns problemas comuns quando você usa o gateway de dados local com o Power BI. Se encontrar um problema que não esteja listado aqui, pode utilizar o site da Comunidade do Power BI. Ou, você pode criar um tíquete de suporte.

Configuração

Erro: O serviço do Power BI relatou o gateway local como inacessível. Reinicie o gateway e tente novamente.

No final da configuração, o serviço do Power BI é chamado novamente para validar o gateway. O serviço do Power BI não relata o gateway como ativo. Reiniciar o serviço do Windows pode permitir que a comunicação seja bem-sucedida. Para obter mais informações, você pode coletar e revisar os logs conforme descrito em Coletar logs do aplicativo de gateway de dados local.

Origens de dados

Nota

Nem todas as fontes de dados têm artigos dedicados detalhando suas configurações ou configurações de conexão. Para muitas fontes de dados e conectores que não sejam da Microsoft, as opções de conexão podem variar entre o Power BI Desktop e Gerenciar gateways Configurações de configurações de > fonte de dados no serviço do Power BI. Nesses casos, as configurações padrão fornecidas são os cenários atualmente suportados para o Power BI.

Erro: Não é possível conectar. Detalhes: "Credenciais de conexão inválidas"

Em Mostrar detalhes, a mensagem de erro recebida da fonte de dados é exibida. Para o SQL Server, você verá uma mensagem como a seguinte:

Login failed for user 'username'.

Verifique se você tem o nome de usuário e a senha corretos. Além disso, verifique se essas credenciais podem se conectar com êxito à fonte de dados. Verifique se a conta que está sendo usada corresponde ao método de autenticação.

Erro: Não é possível conectar. Detalhes: "Não é possível conectar-se ao banco de dados"

Você conseguiu se conectar ao servidor, mas não ao banco de dados fornecido. Verifique o nome do banco de dados e se a credencial do usuário tem a permissão adequada para acessar esse banco de dados.

Em Mostrar detalhes, a mensagem de erro recebida da fonte de dados é exibida. Para o SQL Server, você vê algo como o seguinte:

Cannot open database "AdventureWorks" requested by the login. The login failed. Login failed for user 'username'.

Erro: Não é possível conectar. Detalhes: "Erro desconhecido no gateway de dados"

Este erro pode ocorrer por diferentes motivos. Certifique-se de validar que você pode se conectar à fonte de dados da máquina que hospeda o gateway. Esta situação pode ser o resultado do servidor não estar acessível.

Em Mostrar detalhes, você pode ver um código de erro de DM_GWPipeline_UnknownError.

Você também pode procurar em Logs de Eventos, Logs de Aplicativos>e Serviços, Serviço de>gateway de dados local para obter mais informações.

Erro: Encontramos um erro ao tentar se conectar ao <servidor>. Detalhes: "Chegamos ao gateway de dados, mas o gateway não pode acessar a fonte de dados local."

Você não pôde se conectar à fonte de dados especificada. Certifique-se de validar as informações fornecidas para essa fonte de dados.

Em Mostrar detalhes, você pode ver um código de erro de DM_GWPipeline_Gateway_DataSourceAccessError.

Se a mensagem de erro subjacente for semelhante à seguinte, isso significa que a conta que você está usando para a fonte de dados não é um administrador de servidor para essa instância do Analysis Services. Para obter mais informações, consulte Conceder direitos de administrador do servidor a uma instância do Analysis Services.

The 'CONTOSO\account' value of the 'EffectiveUserName' XML for Analysis property is not valid.

Se a mensagem de erro subjacente for semelhante à seguinte, isso pode significar que a conta de serviço do Analysis Services pode estar faltando o atributo de diretório token-groups-global-and-universal (TGGAU).

The username or password is incorrect.

Os domínios com acesso de compatibilidade anterior ao Windows 2000 têm o atributo TGGAU ativado. A maioria dos domínios recém-criados não habilita esse atributo por padrão. Para obter mais informações, consulte Alguns aplicativos e APIs exigem acesso a informações de autorização em objetos de conta.

Para confirmar se o atributo está habilitado, siga estas etapas.

  1. Conecte-se à máquina do Analysis Services no SQL Server Management Studio. Nas propriedades de conexão avançadas, inclua EffectiveUserName para o usuário em questão e veja se essa adição reproduz o erro.

  2. Você pode usar a ferramenta dsacls Ative Directory para validar se o atributo está listado. Esta ferramenta é encontrada em um controlador de domínio. Você precisa saber qual é o nome de domínio distinto para a conta e passar esse nome para a ferramenta.

    dsacls "CN=John Doe,CN=UserAccounts,DC=contoso,DC=com"
    

    Você quer ver algo semelhante ao seguinte nos resultados:

    Allow BUILTIN\Windows Authorization Access Group
                                    SPECIAL ACCESS for tokenGroupsGlobalAndUniversal
                                    READ PROPERTY
    

Para corrigir esse problema, você deve habilitar o TGGAU na conta usada para o serviço Windows do Analysis Services.

Outra possibilidade para "O nome de usuário ou senha está incorreto."

Esse erro também pode ser causado se o servidor do Analysis Services estiver em um domínio diferente dos usuários e não houver uma confiança bidirecional estabelecida.

Trabalhe com os administradores de domínio para verificar a relação de confiança entre domínios.

Não é possível ver as fontes de dados do gateway de dados na experiência Obter Dados para Analysis Services a partir do serviço Power BI

Verifique se sua conta está listada na guia Usuários da fonte de dados dentro da configuração do gateway. Se você não tiver acesso ao gateway, verifique com o administrador do gateway e peça-lhe para verificar. Somente as contas na lista Usuários podem ver a fonte de dados listada na lista Analysis Services.

Erro: Você não tem nenhum gateway instalado ou configurado para as fontes de dados neste conjunto de dados.

Certifique-se de ter adicionado uma ou mais fontes de dados ao gateway, conforme descrito em Adicionar uma fonte de dados. Se o gateway não aparecer no portal de administração em Gerenciar gateways, limpe o cache do navegador ou saia do serviço e entre novamente.

Erro: Sua fonte de dados não pode ser atualizada porque as credenciais são inválidas. Atualize as credenciais e tente novamente.

Você conseguiu conectar e atualizar o conjunto de dados, sem erros de tempo de execução para a conexão, mas no serviço do Power BI essa barra de erro aparece. Quando o usuário tenta atualizar as credenciais com credenciais em boas condições, aparece um erro informando que as credenciais fornecidas eram inválidas.

Esse erro pode ocorrer quando o gateway tenta uma conexão de teste, mesmo se as credenciais fornecidas forem aceitáveis e a operação de atualização for bem-sucedida. Isso ocorre porque quando o gateway executa um teste de conexão, ele não inclui nenhum parâmetro opcional durante a tentativa de conexão, e alguns conectores de dados (como Snowflake, por exemplo) exigem parâmetros de conexão opcionais para se conectar.

Quando a atualização estiver sendo concluída corretamente e você não tiver erros de tempo de execução, poderá ignorar esses erros de conexão de teste para fontes de dados que exigem parâmetros opcionais.

Modelos semânticos

Erro: Não há espaço suficiente para esta linha.

Este erro ocorre se tiver uma única linha com mais de 4 MB de tamanho. Determine qual é a linha da sua fonte de dados e tente filtrá-la ou reduzir o tamanho dessa linha.

Erro: O nome do servidor fornecido não corresponde ao nome do servidor no certificado SSL do SQL Server.

Este erro pode ocorrer quando o nome comum do certificado é para o nome de domínio totalmente qualificado (FQDN) do servidor, mas você forneceu apenas o nome NetBIOS para o servidor. Essa situação causa uma incompatibilidade para o certificado. Para resolver esse problema, faça com que o nome do servidor dentro da fonte de dados do gateway e o arquivo PBIX use o FQDN do servidor.

Erro: Você não vê o gateway de dados local presente quando configura a atualização agendada.

Alguns cenários diferentes podem ser responsáveis por esse erro:

  • O nome do servidor e do banco de dados não correspondem ao que foi inserido no Power BI Desktop e à fonte de dados configurada para o gateway. Estes nomes devem ser os mesmos. Eles não diferenciam maiúsculas de minúsculas.
  • Sua conta não está listada na guia Usuários da fonte de dados na configuração do gateway. Você precisa ser adicionado a essa lista pelo administrador do gateway.
  • Seu arquivo do Power BI Desktop tem várias fontes de dados dentro dele, e nem todas essas fontes de dados são configuradas com o gateway. Você precisa ter cada fonte de dados definida com o gateway para que o gateway apareça na atualização agendada.

Erro: Os dados não compactados recebidos no cliente de gateway excederam o limite.

A limitação exata é de 10 GB de dados não compactados por tabela. Se você está enfrentando esse problema, há boas opções para otimizá-lo e evitá-lo. Em particular, reduza o uso de valores de cadeia de caracteres longos e altamente constantes e, em vez disso, use uma chave normalizada. Ou remover a coluna se ela não estiver em uso ajuda.

Erro: DM_GWPipeline_Gateway_SpooledOperationMissing

Alguns cenários diferentes podem ser responsáveis por este erro

  • O processo de gateway pode ter sido reiniciado quando a atualização do conjunto de dados estava em andamento.
  • A máquina de gateway é clonada onde o gateway está sendo executado. Não devemos clonar a máquina de gateway.

Relatórios

Erro: O relatório não pôde acessar a fonte de dados porque você não tem acesso à nossa fonte de dados por meio de um gateway de dados local.

Este erro é geralmente causado por um dos seguintes:

  • As informações da fonte de dados não correspondem ao que está no conjunto de dados subjacente. O nome do servidor e do banco de dados precisa corresponder entre a fonte de dados definida para o gateway de dados local e o que você fornece no Power BI Desktop. Se você usar um endereço IP no Power BI Desktop, a fonte de dados para o gateway de dados local também precisará usar um endereço IP.
  • Não há nenhuma fonte de dados disponível em nenhum gateway dentro da sua organização. Você pode configurar a fonte de dados em um gateway de dados local novo ou existente.

Erro: Erro de acesso à fonte de dados. Entre em contato com o administrador do gateway.

Se esse relatório fizer uso de uma conexão ativa do Analysis Services, você poderá encontrar um problema com um valor sendo passado para EffectiveUserName que não é válido ou não tem permissões na máquina do Analysis Services. Normalmente, um problema de autenticação é devido ao fato de que o valor que está sendo passado para EffectiveUserName não corresponde a um UPN (nome principal do usuário) local.

Para confirmar o nome de usuário efetivo, siga estas etapas.

  1. Encontre o nome de usuário efetivo nos logs do gateway.

  2. Depois de ter o valor sendo passado, valide se ele está correto. Se for seu usuário, você pode usar o seguinte comando em um prompt de comando para ver o UPN. O UPN parece um endereço de e-mail.

    whoami /upn
    

Opcionalmente, você pode ver o que o Power BI obtém da ID do Microsoft Entra.

  1. Navegue para https://developer.microsoft.com/graph/graph-explorer.

  2. Selecione Entrar no canto superior direito.

  3. Execute a seguinte consulta. Você vê uma resposta JSON bastante grande.

    https://graph.windows.net/me?api-version=1.5
    
  4. Procure userPrincipalName.

Se o UPN do Microsoft Entra não corresponder ao UPN local do Ative Directory, você poderá usar o recurso Mapear nomes de usuário para substituí-lo por um valor válido. Em alternativa, pode trabalhar com o administrador do Power BI ou com o administrador local do Ative Directory para alterar o UPN.

Kerberos

Se o servidor de banco de dados subjacente e o gateway de dados local não estiverem configurados adequadamente para delegação restrita de Kerberos, habilite o log detalhado no gateway. Em seguida, investigue com base nos erros ou rastreamentos nos arquivos de log do gateway como ponto de partida para a solução de problemas. Para coletar os logs do gateway para exibição, consulte Coletar logs do aplicativo de gateway de dados local.

ImpersonationLevel

O ImpersonationLevel está relacionado à configuração do SPN ou à configuração de política local.

[DataMovement.PipeLine.GatewayDataAccess] About to impersonate user DOMAIN\User (IsAuthenticated: True, ImpersonationLevel: Identification)

Solução

Siga estas etapas para resolver o problema.

  1. Configure um SPN para o gateway local.
  2. Configure a delegação restrita no Ative Directory.

FailedToImpersonateUserException: Falha ao criar identidade do Windows para userid de usuário

O FailedToImpersonateUserException acontece se você não conseguir representar em nome de outro usuário. Esse erro também pode acontecer se a conta que você está tentando representar for de outro domínio que não aquele em que o domínio do serviço de gateway está. Esta é uma limitação.

Solução

  • Verifique se a configuração está correta de acordo com as etapas na seção "ImpersonationLevel" anterior.
  • Verifique se o ID de usuário que está tentando representar é uma conta válida do Ative Directory.

Erro geral: erro 1033 ao analisar o protocolo

Você recebe o erro 1033 quando sua ID externa configurada no SAP HANA não corresponde ao login se o usuário for representado usando o UPN (alias@domain.com). Nos logs, você verá "UPN original '' substituído por um novo UPN ''alias@domain.comalias@domain.com" na parte superior dos logs de erro, como visto aqui:

[DM.GatewayCore] SingleSignOn Required. Original UPN 'alias@domain.com' replaced with new UPN 'alias@domain.com.'

Solução

  • O SAP HANA requer que o usuário representado use o atributo sAMAccountName no Ative Directory (alias de usuário). Se esse atributo não estiver correto, você verá o erro 1033.

    Attribute editor

  • Nos logs, você vê o sAMAccountName (alias) e não o UPN, que é o alias seguido pelo domínio (alias@doimain.com).

    Account info in logs

      <setting name="ADUserNameReplacementProperty" serializeAs="String">
        <value>sAMAccount</value>
      </setting>
      <setting name="ADServerPath" serializeAs="String">
        <value />
      </setting>
      <setting name="CustomASDataSource" serializeAs="String">
        <value />
      </setting>
      <setting name="ADUserNameLookupProperty" serializeAs="String">
        <value>AADEmail</value>

Você receberá a mensagem de erro "-10709 Falha na conexão" se sua delegação não estiver configurada corretamente no Ative Directory.

Solução

  • Verifique se você tem o servidor SAP Hana na guia delegação no Ative Directory para a conta de serviço de gateway.

    Delegation tab

Exportar logs para um tíquete de suporte

Os logs de gateway são necessários para solucionar problemas e criar um tíquete de suporte. Use as etapas a seguir para extrair esses logs.

  1. Identifique o cluster de gateway.

    Se você for proprietário de um conjunto de dados, primeiro verifique o nome do cluster de gateway associado ao seu conjunto de dados. Na imagem a seguir, IgniteGateway é o cluster de gateway.

    Gateway cluster

  2. Verifique as propriedades do gateway.

    O administrador do gateway deve verificar o número de membros do gateway no cluster e se o balanceamento de carga está habilitado.

    Se o balanceamento de carga estiver habilitado, a etapa 3 deverá ser repetida para todos os membros do gateway. Se não estiver habilitado, a exportação de logs no gateway primário será suficiente.

  3. Recupere e exporte os logs do gateway.

    Em seguida, o administrador do gateway, que também é o administrador do sistema de gateway, deve executar as seguintes etapas:

    a. Entre na máquina do gateway e inicie o aplicativo de gateway de dados local para entrar no gateway.

    b. Habilite o registro em log adicional.

    c. Opcionalmente, você pode habilitar os recursos de monitoramento de desempenho e incluir logs de desempenho para fornecer detalhes adicionais para a solução de problemas.

    d. Execute o cenário para o qual você está tentando capturar logs de gateway.

    e. Exporte os logs do gateway.

Histórico de atualizações

Quando você usa o gateway para uma atualização agendada, o histórico de atualizações pode ajudá-lo a ver quais erros ocorreram. Ele também pode fornecer dados úteis se você precisar criar uma solicitação de suporte. Você pode visualizar atualizações agendadas e sob demanda. As etapas a seguir mostram como você pode acessar o histórico de atualizações.

  1. No painel de navegação do Power BI, em Modelos semânticos, selecione um conjunto de dados. Abra o menu e selecione Agendar atualização.

    How to select schedule refresh

  2. Em Configurações para..., selecione Atualizar histórico.

    Select refresh history

    Refresh history display

Para obter mais informações sobre como solucionar problemas de cenários de atualização, consulte Solucionar problemas de cenários de atualização.

Tem dúvidas? Experimente a Comunidade do Power BI.