Solucionar problemas de gateways de dados locais

Este artigo discute problemas comuns que podem ocorrer quando você usa o gateway de dados local com o serviço do Power BI. Se você encontrar um problema que não esteja listado aqui, visite a Comunidade do Power BI ou crie um tíquete de suporte.

Configuração

Erro: o serviço do Power BI relatou o gateway local como inacessível

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 dinâmico. Reiniciar o serviço Windows pode permitir que a comunicação seja bem-sucedida. Para obter mais informações, você pode coletar e examinar os logs, conforme descrito em Coletar logs do aplicativo de gateway de dados local.

Traga sua própria Retransmissão do Azure

Se você habilitou o Bring Your Own (BYO) Azure Relay e tiver problemas de conectividade, verifique se o Link Privado não está habilitado nesse namespace de retransmissão—essa configuração não é atualmente suportada com o recurso de Relay BYO do gateway. Se você não precisar de controles de Retransmissão personalizados, reverta para a Retransmissão gerenciada padrão desabilitando a Retransmissão BYO.

Fontes de dados

Erro: Não é possível estabelecer conexão. 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 essa:

Login failed for user 'username'.

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

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

Você conseguiu conectar ao servidor, mas não ao banco de dados fornecido. Verifique o nome do banco de dados e se o nome de usuário e a senha possuem 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ê verá algo como a seguinte mensagem:

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

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

Esse erro pode ocorrer por diferentes motivos. Não se esqueça de validar que você pode se conectar à fonte de dados do computador que hospeda o gateway. Essa situação pode ocorrer devido ao fato de o servidor não estar acessível.

Em Mostrar detalhes, é possível ver um código de erro DM_GWPipeline_UnknownError.

Você também pode examinar os Logs de Eventos>Logs de Aplicativos e Serviços>Serviço do gateway de dados local para obter mais detalhes. Veja Registros de eventos para obter uma descrição detalhada.

Erro: foi encontrado um erro ao tentar conexão com o <servidor>. Detalhes: "Acessamos o gateway de dados, mas o gateway não pode acessar a fonte de dados local."

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

Em Mostrar detalhes, é possível ver um código de erro de DM_GWPipeline_Gateway_DataSourceAccessError.

Se a mensagem de erro subjacente for semelhante à seguinte, 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, confira Conceder direitos de administrador de servidor a uma instância de 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 habilitado. A maioria dos domínios recém-criados não habilita esse atributo por padrão. Para obter mais informações, confira Alguns aplicativos e APIs exigem acesso às informações de autorização em objetos da conta.

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

1. Conecte-se ao computador do Analysis Services no SQL Server Management Studio. Nas propriedades de conexão Avançada, 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 do Active Directory para validar se o atributo está listado. Essa é uma ferramenta encontrada em um controlador de domínio. É necessário saber o que é o nome de domínio diferenciado para a conta e passá-lo para a ferramenta.

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

   Você deseja ver algo semelhante à seguinte saída nos resultados:

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

Para corrigir esse problema, é necessário 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 poderá ser causado se o servidor do Analysis Services estiver em um domínio diferente dos usuários e não houver uma relação de confiança bidirecional estabelecida.

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

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

Confira se sua conta está listada na guia Usuários da fonte de dados na configuração do gateway. Se não tiver acesso ao gateway, verifique com o administrador do gateway e solicite a verificação. Somente as contas na lista Usuários podem ver a fonte de dados relacionada na lista do Analysis Services.

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

Verifique se você adicionou uma ou mais fontes de dados para o gateway, conforme está descrito em Adicionar uma fonte de dados. Se o gateway não aparecer no portal de administração em Gerenciar conexões e gateways, limpe o cache do navegador ou saia do serviço e faça login novamente. Nas configurações de modelo semântico, a seção do gateway lista apenas os gateways que têm definições de fonte de dados correspondentes para cada fonte local usada.

Erro: sua fonte de dados não pode ser atualizada porque as credenciais são inválidas

Você conseguiu se conectar e atualizar o modelo semântico 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 conhecidas, 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. Quando o gateway executa um teste de conexão, ele atualmente omite parâmetros opcionais (por exemplo, snowflake warehouse, função ou outras configurações avançadas) e alguns conectores exigem esses valores.

Se a atualização for concluída corretamente e você não tiver erros de runtime, 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

Esse erro ocorrerá se uma única linha importada exceder aproximadamente 4 MB (limite do mecanismo de armazenamento compactado). Identifique a linha ofensiva na origem e filtre ou divida colunas (por exemplo, reduza grandes campos de texto/blob) antes da importação.

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

Esse erro pode ocorrer quando o nome comum do certificado é para o FQDN (nome de domínio totalmente qualificado) do servidor, mas você somente forneceu o nome NetBIOS do servidor. Essa situação causa uma incompatibilidade para o certificado. Para resolver esse problema, crie o nome do servidor na fonte de dados do gateway e no arquivo PBIX para usar o FQDN do servidor.

Erro: você não vê o gateway de dados local presente ao configurar 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 corresponde ao que foi inserido no Power BI Desktop e a fonte de dados configurada para o gateway. Esses nomes devem ser iguais (sem distinção entre maiúsculas e 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 por um administrador de gateway.
• Seu arquivo do Power BI Desktop tem várias fontes de dados e nem todas essas fontes de dados são definidas no gateway. Todas as fontes locais devem ter uma entrada correspondente na fonte de dados do gateway.

Erro: os dados não compactados recebidos no cliente do gateway excederam o limite

A limitação é de 10 GB de dados não compactados por segmento de tabela durante a atualização. Para otimizar:

• Substitua cadeias de caracteres longas repetidas por chaves substitutas.
• Remova colunas de texto não utilizadas de alta cardinalidade.
• Divida tabelas muito largas ou filtre partições históricas.
• Considere DirectQuery para tabelas de fatos extremamente grandes.

Erro: DM_GWPipeline_Gateway_SpooledOperationMissing

Alguns cenários diferentes podem causar esse erro:

• O serviço windows do gateway foi reiniciado enquanto a atualização ou consulta do modelo semântico estava em andamento (por exemplo, aplicação de patch do sistema operacional ou falha de serviço).
• Uma imagem de máquina virtual foi clonada após a instalação do gateway, resultando em duplicação do estado temporário.

Evite clonar computadores após a instalação– execute uma nova instalação de gateway em novos hosts. Revise os logs de serviço do gateway ao redor do carimbo de data/hora de erro para eventos de reinicialização.

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

Esse erro geralmente é causado por um dos motivos a seguir:

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

Erro: erro de acesso à fonte de dados (contate o administrador do gateway)

Se este relatório usar uma conexão dinâmica do Analysis Services, você poderá encontrar um problema em que o valor passado para EffectiveUserName não seja válido ou não tenha permissões no servidor do Analysis Services. Normalmente, um problema de autenticação ocorre porque o valor EffectiveUserName não corresponde a um UPN (nome de entidade de 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 obter o valor que está sendo passado, valide se ele está correto. Se ele for seu usuário, será possível usar o comando a seguir em um prompt de comando para ver o UPN. O UPN tem a aparência de um endereço de email.

   whoami /upn
   

Se preferir, é possível ver o que o Power BI obtém do Microsoft Entra ID.

1. Navegue até o Explorador do Graph.
2. Selecione Entrar no canto superior direito.
3. Execute a seguinte consulta do Microsoft Graph (o Azure AD Graph foi desativado):

https://graph.microsoft.com/v1.0/me

1. Procure a propriedade userPrincipalName na resposta JSON.

Se o UPN do Microsoft Entra não corresponder ao UPN local do Active Directory, você poderá usar o recurso Mapear nomes de usuário para substituí-lo por um valor válido. Como alternativa, trabalhe com o administrador do Power BI ou o administrador local do Active Directory para alinhar os UPNs.

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 registro adicional no gateway. Em seguida, investigue com base nos erros ou rastreamentos nos arquivos de log do gateway como um ponto de partida para a solução de problemas. Para coletar os logs de gateway para exibição, confira Coletar logs do aplicativo de gateway de dados local.

ImpersonationLevel

O ImpersonationLevel está relacionado à configuração do SPN (nome principal do servidor) ou à configuração de política local.

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

Solução (nível de representação)

Execute estas etapas para resolver o problema.

1. Configure um SPN para o gateway local.
2. Configure a delegação restrita em seu Active Directory.

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

O FailedToImpersonateUserException ocorre quando o gateway não pode representar em nome de outro usuário. Esse erro também pode ocorrer se a conta que está sendo impersonada residir em um domínio diferente sem a configuração necessária de confiança.

Solução (Exceção FailedToImpersonateUserException)

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

Erro geral: erro 1033 ao analisar o protocolo

Você receberá o erro 1033 quando sua ID externa configurada no SAP HANA não corresponder à credencial se o usuário for representado usando o UPN (alias@___domain.com). Você verá “PN original “alias@___domain.com” substituído por um novo UPN “alias@___domain.com”” na parte superior dos logs de erros, conforme visto aqui:

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

Solução (erro 1033)

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

  

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

  

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

Falha no link de comunicação do SAP HANA: falha na conexão -10709 (credenciais Kerberos indisponíveis)

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

Solução (SAP HANA Kerberos -10709)

• Certifique-se de ter o servidor SAP HANA na guia Delegação no Active Directory para a conta de serviço de gateway.

  

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 um proprietário de modelo semântico, primeiro verifique o nome do cluster de gateway associado ao modelo semântico. Na imagem a seguir, IgniteGateway será o cluster de gateway.

   

2. Verifique as propriedades de gateway.

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

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

3. Recuperar e exportar logs de gateway.

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

   1. Entre no computador do gateway e inicie o aplicativo do gateway de dados local para entrar no gateway.
   2. Habilite um registro em log adicional.
   3. (Opcional) Habilite os recursos de monitoramento de desempenho e inclua logs de desempenho.
   4. Execute o cenário para o qual você está tentando capturar logs de gateway.
   5. Exporte os logs de gateway.

Histórico de atualização

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

Na página de detalhes do modelo semântico, selecione Atualizar na faixa de opções e selecione Atualizar histórico.

Você também pode acessar o Histórico de atualizações nas configurações do modelo semântico. Selecione Arquivo na faixa de opções e selecione Configurações.

Para obter mais informações sobre solucionar problemas de cenários de atualização, confira Solucionar problemas de cenários de atualização. Se a atualização agendada parar de ser executada inesperadamente, examine o comportamento de inatividade descrito em Configurar atualização agendada.

Conteúdo relacionado

• Solucionar problemas do gateway de dados local
• Definir as configurações de proxy do gateway de dados local
• Gerenciar fontes de dados do SQL Server Analysis Services
• Gerenciar sua fonte de dados – SAP HANA
• Gerenciar uma fonte de dados do SQL Server
• Gerencie sua fonte de dados – importação e atualização agendada

Mais perguntas? Experimente a Comunidade do Power BI.