Solucionar problemas de gateways – Power BITroubleshoot gateways - Power BI

Observação

Recentemente, revisamos os documentos do gateway de dados local. Nós os dividimos em conteúdo específico para Power BI e conteúdo geral que se aplica a todos os serviços compatíveis com o gateway.We recently revised the on-premises data gateway docs. We split them into content that's specific to Power BI and general content that applies to all services that the gateway supports. No momento, você está no conteúdo do Power BI.You're currently in the Power BI content. Para fornecer comentários sobre este artigo ou sobre a experiência geral de documentos do gateway, role até a parte inferior do artigo.To provide feedback on this article, or the overall gateway docs experience, scroll to the bottom of the article.

Este artigo aborda alguns problemas comuns ao usar o gateway de dados local com o Power BI.This article discusses some common issues when you use the on-premises data gateway with Power BI. Se você encontrar um problema que não está listado aqui, poderá usar o site da Comunidade do Power BI.If you encounter an issue that isn't listed here, you can use the Power BI Community site. Ou crie um tíquete de suporte.Or, you can create a support ticket.

ConfiguraçãoConfiguration

Erro: O serviço do Power BI relatou o gateway local como inacessível.Error: Power BI service reported local gateway as unreachable. Reinicie o gateway e tente novamente.Restart the gateway and try again.

No final da configuração, o serviço do Power BI é chamado novamente para validar o gateway.At the end of configuration, the Power BI service is called again to validate the gateway. O serviço do Power BI não relata o gateway como dinâmico.The Power BI service doesn't report the gateway as live. Reiniciar o serviço Windows pode permitir que a comunicação seja bem-sucedida.Restarting the Windows service might allow the communication to be successful. Para obter mais informações, você pode coletar e examinar os logs, conforme descrito em Coletar logs do aplicativo de gateway de dados local.To get more information, you can collect and review the logs as described in Collect logs from the on-premises data gateway app.

Fontes de dadosData sources

Erro: Não é possível estabelecer conexão.Error: Unable to Connect. Detalhes: "Credenciais de conexão inválidas"Details: "Invalid connection credentials"

Em Mostrar detalhes, a mensagem de erro recebida da fonte de dados é exibida.Within Show details, the error message that was received from the data source is displayed. Para o SQL Server, você verá algo semelhante ao seguinte:For SQL Server, you see something like the following:

Login failed for user 'username'.

Verifique se você tem o nome de usuário correto e a senha.Verify that you have the correct username and password. Além disso, verifique se essas credenciais podem se conectar à fonte de dados com êxito.Also, verify that those credentials can successfully connect to the data source. Verifique se a conta que está sendo usada corresponde ao método de autenticação.Make sure the account that's being used matches the authentication method.

Erro: Não é possível estabelecer conexão.Error: Unable to Connect. Detalhes: "Não é possível se conectar ao banco de dados"Details: "Cannot connect to the database"

Você conseguiu conectar ao servidor, mas não ao banco de dados fornecido.You were able to connect to the server but not to the database that was supplied. Verifique o nome do banco de dados e se as credenciais do usuário têm a permissão apropriada para acessar esse banco de dados.Verify the name of the database and that the user credential has the proper permission to access that database.

Em Mostrar detalhes, a mensagem de erro recebida da fonte de dados é exibida.Within Show details, the error message that was received from the data source is displayed. Para o SQL Server, você verá algo semelhante ao seguinte:For SQL Server, you see something like the following:

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

Erro: Não é possível estabelecer conexão.Error: Unable to Connect. Detalhes: "Erro desconhecido no gateway de dados"Details: "Unknown error in data gateway"

Esse erro pode ocorrer por diferentes motivos.This error might occur for different reasons. Não se esqueça de validar que você pode se conectar à fonte de dados do computador que hospeda o gateway.Be sure to validate that you can connect to the data source from the machine that hosts the gateway. Essa situação pode ocorrer devido ao fato de o servidor não estar acessível.This situation could be the result of the server not being accessible.

Em Mostrar detalhes, é possível ver um código de erro DM_GWPipeline_UnknownError.Within Show details, you can see an error code of 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.You can also look in Event Logs > Applications and Services Logs > On-premises data gateway Service for more information.

Erro: Erro: encontramos um erro ao tentar conectar-se com o <servidor>.Error: We encountered an error while trying to connect to <server>. Detalhes: "Acessamos o gateway de dados, mas o gateway não pode acessar a fonte de dados local."Details: "We reached the data gateway, but the gateway can't access the on-premises data source."

Você não conseguiu se conectar à fonte de dados especificada.You were unable to connect to the specified data source. Certifique-se de validar as informações fornecidas para essa fonte de dados.Be sure to validate the information provided for that data source.

Em Mostrar detalhes, é possível ver um código de erro de DM_GWPipeline_Gateway_DataSourceAccessError.Within Show details, you can see an error code of 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 do servidor para essa instância do Analysis Services.If the underlying error message is similar to the following, this means that the account you're using for the data source isn't a server admin for that Analysis Services instance. Para obter mais informações, confira Conceder direitos de administrador de servidor a uma instância de Analysis Services.For more information, see Grant server admin rights to an Analysis Services instance.

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

Caso a mensagem de erro subjacente seja semelhante à seguinte, isso pode indicar que a conta de serviço do Analysis Services pode não ter o atributo de diretório TGGAU (token-groups-global-and-universal).If the underlying error message is similar to the following, it could mean that the service account for Analysis Services might be missing the token-groups-global-and-universal (TGGAU) directory attribute.

The username or password is incorrect.

Os domínios com acesso de compatibilidade anterior ao Windows 2000 têm o atributo TGGAU habilitado.Domains with pre-Windows 2000 compatibility access have the TGGAU attribute enabled. A maioria dos domínios recém-criados não habilita esse atributo por padrão.Most newly created domains don't enable this attribute by default. Para obter mais informações, confira Alguns aplicativos e APIs exigem acesso às informações de autorização em objetos da conta.For more information, see Some applications and APIs require access to authorization information on account objects.

Para confirmar se o atributo está habilitado, siga estas etapas.To confirm whether the attribute is enabled, follow these steps.

  1. Conecte-se ao computador do Analysis Services no SQL Server Management Studio.Connect to the Analysis Services machine within 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.Within the Advanced connection properties, include EffectiveUserName for the user in question and see if this addition reproduces the error.

  2. Você pode usar a ferramenta dsacls do Active Directory para validar se o atributo está listado.You can use the dsacls Active Directory tool to validate whether the attribute is listed. Essa é uma ferramenta encontrada em um controlador de domínio.This tool is found on a domain controller. É necessário saber o que é o nome de domínio diferenciado para a conta e passá-lo para a ferramenta.You need to know what the distinguished domain name is for the account and pass that name to the tool.

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

    Você deseja ver algo semelhante ao mostrado a seguir nos resultados:You want to see something similar to the following in the results:

         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.To correct this issue, you must enable TGGAU on the account used for the Analysis Services Windows service.

Outra possibilidade para “O nome de usuário ou senha está incorreto”.Another possibility for "The username or password is incorrect."

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.This error could also be caused if the Analysis Services server is in a different domain than the users and there isn't a two-way trust established.

Trabalhe com seus administradores de domínio para verificar a relação de confiança entre os domínios.Work with your domain administrators to verify the trust relationship between domains.

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 BIUnable to see the data gateway data sources in the Get Data experience for Analysis Services from the Power BI service

Confira se sua conta está listada na guia Usuários da fonte de dados na configuração do gateway.Make sure that your account is listed in the Users tab of the data source within the gateway configuration. Se não tiver acesso ao gateway, verifique com o administrador do gateway e solicite a verificação.If you don't have access to the gateway, check with the administrator of the gateway and ask them to verify. Somente as contas na lista Usuários podem ver a fonte de dados relacionada na lista do Analysis Services.Only accounts in the Users list can see the data source listed in the Analysis Services list.

Erro: Você não tem nenhum gateway instalado ou configurado para as fontes de dados neste conjunto de dados.Error: You don't have any gateway installed or configured for the data sources in this dataset.

Verifique se você adicionou uma ou mais fontes de dados para o gateway, conforme está descrito em Adicionar uma fonte de dados.Ensure that you've added one or more data sources to the gateway, as described in Add a data source. 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.If the gateway doesn't appear in the admin portal under Manage gateways, clear your browser cache or sign out of the service and then sign back in.

Conjuntos de dadosDatasets

Erro: Não há espaço suficiente para esta linha.Error: There is not enough space for this row.

Esse erro ocorrerá se você tiver uma única linha com um tamanho maior que 4 MB.This error occurs if you have a single row greater than 4 MB in size. Determine qual linha é proveniente da fonte de dados e tente filtrá-la ou reduza seu tamanho.Determine what the row is from your data source, and attempt to filter it out or reduce the size for that row.

Erro: O nome do servidor fornecido não corresponde ao nome do servidor no certificado SSL do SQL Server.Error: The server name provided doesn't match the server name on the SQL Server SSL certificate.

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.This error can occur when the certificate common name is for the server's fully qualified domain name (FQDN), but you supplied only the NetBIOS name for the server. Essa situação causa uma incompatibilidade para o certificado.This situation causes a mismatch for the certificate. 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.To resolve this issue, make the server name within the gateway data source and the PBIX file use the FQDN of the server.

Erro: Você não vê o gateway de dados local presente ao configurar a atualização agendada.Error: You don't see the on-premises data gateway present when you configure scheduled refresh.

Alguns cenários diferentes podem ser responsáveis por esse erro:A few different scenarios could be responsible for this error:

  • 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.The server and database name don't match what was entered in Power BI Desktop and the data source configured for the gateway. Esses nomes devem ser iguais.These names must be the same. Eles não diferenciam maiúsculas de minúsculas.They aren't case sensitive.
  • Sua conta não está listada na guia Usuários da fonte de dados na configuração do gateway.Your account isn't listed in the Users tab of the data source within the gateway configuration. Você precisa ser adicionado a essa lista pelo administrador do gateway.You need to be added to that list by the administrator of the gateway.
  • O arquivo do Power BI Desktop contém dados de várias fontes e nem todas as fontes de dados estão configuradas com o gateway.Your Power BI Desktop file has multiple data sources within it, and not all of those data sources are configured with the gateway. É necessário ter cada fonte de dados definida com o gateway para que ele seja exibido na atualização agendada.You need to have each data source defined with the gateway for the gateway to show up within scheduled refresh.

Erro: Os dados descompactados recebidos no cliente de gateway excederam o limite.Error: The received uncompressed data on the gateway client has exceeded the limit.

A limitação exata é de 10 GB de dados descompactados por tabela.The exact limitation is 10 GB of uncompressed data per table. Se você estiver tendo esse problema, há boas opções para otimizá-lo e evitá-lo.If you're hitting this issue, there are good options to optimize and avoid it. Em especial, reduza o uso de valores de cadeia de caracteres muito constantes e longos e, em vez disso, use uma chave normalizada.In particular, reduce the use of highly constant, long string values and instead use a normalized key. Ou remover a coluna, se ela não estiver em uso, ajuda.Or, removing the column if it's not in use helps.

RelatóriosReports

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.Error: Report could not access the data source because you do not have access to our data source via an on-premises data gateway.

Esse erro geralmente é causado por um dos motivos a seguir:This error is usually caused by one of the following:

  • As informações da fonte de dados não correspondem às que estão no conjunto de dados subjacente.The data source information doesn't match what's in the underlying dataset. 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.The server and database name need to match between the data source defined for the on-premises data gateway and what you supply within 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.If you use an IP address in Power BI Desktop, the data source for the on-premises data gateway needs to use an IP address as well.
  • Não há nenhuma fonte de dados disponível em nenhum gateway de sua organização.There's no data source available on any gateway within your organization. É possível configurar a fonte de dados em um gateway de dados local novo ou existente.You can configure the data source on a new or existing on-premises data gateway.

Erro: Erro de acesso à fonte de dados.Error: Data source access error. Entre em contato com o administrador do gateway.Please contact the gateway administrator.

Se este relatório usar uma conexão dinâmica do Analysis Services, talvez você tenha problemas ao passar um valor para EffectiveUserName que não seja válido ou que não tenha permissões no computador do Analysis Services.If this report makes use of a live Analysis Services connection, you could encounter an issue with a value being passed to EffectiveUserName that either isn't valid or doesn't have permissions on the Analysis Services machine. Normalmente, um problema de autenticação ocorre devido ao fato de que o valor passado para EffectiveUserName não corresponde a um nome UPN local.Typically, an authentication issue is due to the fact that the value being passed for EffectiveUserName doesn't match a local user principal name (UPN).

Para confirmar o nome de usuário efetivo, siga estas etapas.To confirm the effective username, follow these steps.

  1. Encontre o nome de usuário efetivo nos logs do gateway.Find the effective username within the gateway logs.

  2. Depois de obter o valor que está sendo passado, valide se ele está correto.After you have the value being passed, validate that it's correct. Se ele for seu usuário, será possível usar o comando a seguir em um prompt de comando para ver o UPN.If it's your user, you can use the following command from a command prompt to see the UPN. O UPN tem a aparência de um endereço de email.The UPN looks like an email address.

     whoami /upn
    

Se preferir, é possível ver o que o Power BI obtém do Azure Active Directory.Optionally, you can see what Power BI gets from Azure Active Directory.

  1. Navegue até https://developer.microsoft.com/graph/graph-explorer.Browse to https://developer.microsoft.com/graph/graph-explorer.

  2. Selecione Entrar no canto superior direito.Select Sign in in the upper-right corner.

  3. Execute a consulta a seguir.Run the following query. Você verá uma resposta JSON bem grande.You see a rather large JSON response.

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

Se o UPN do Azure Active Directory 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.If your Azure Active Directory UPN doesn't match your local Active Directory UPN, you can use the Map user names feature to replace it with a valid value. Ou será possível trabalhar com seu administrador de locatários ou com o administrador local do Active Directory para alterar o UPN.Or, you can work with either your tenant admin or local Active Directory admin to get your UPN changed.

KerberosKerberos

Se o servidor de banco de dados subjacente e o gateway de dados local não estiverem configurados adequadamente para a delegação restrita de Kerberos, habilite o log detalhado no gateway.If the underlying database server and on-premises data gateway aren't appropriately configured for Kerberos constrained delegation, enable verbose logging on the 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.Then, investigate based on the errors or traces in the gateway’s log files as a starting point for troubleshooting. Para coletar os logs de gateway para exibição, confira Coletar logs do aplicativo de gateway de dados local.To collect the gateway logs for viewing, see Collect logs from the on-premises data gateway app.

ImpersonationLevelImpersonationLevel

O ImpersonationLevel está relacionado à configuração de SPN ou à configuração de política local.The ImpersonationLevel is related to the SPN setup or the local policy setting.

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

SoluçãoSolution

Execute estas etapas para resolver o problema.Follow these steps to solve the issue.

  1. Configure um SPN para o gateway local.Set up an SPN for the on-premises gateway.
  2. Configure a delegação restrita em seu Active Directory.Set up constrained delegation in your Active Directory.

FailedToImpersonateUserException: Falha ao criar a identidade do Windows para a ID de usuárioFailedToImpersonateUserException: Failed to create Windows identity for user userid

O FailedToImpersonateUserException ocorrerá se você não puder representar em nome de outro usuário.The FailedToImpersonateUserException happens if you're unable to impersonate on behalf of another user. Esse erro também poderá ocorrer se a conta que você está tentando representar for de um domínio diferente do domínio no qual o domínio do serviço de gateway está.This error could also happen if the account you're trying to impersonate is from another domain than the one the gateway service domain is on. Essa é uma limitação.This is a limitation.

SoluçãoSolution

  • Verifique se a configuração está correta de acordo com as etapas na seção “ImpersonationLevel” anterior.Verify that the configuration is correct as per the steps in the previous "ImpersonationLevel" section.
  • Verifique se a ID de usuário que ele está tentando representar é de uma conta válida do Active Directory.Ensure that the user ID it's trying to impersonate is a valid Active Directory account.

Erro geral: erro 1033 ao analisar o protocoloGeneral error: 1033 error while you parse the protocol

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).You get the 1033 error when your external ID that's configured in SAP HANA doesn't match the sign-in if the user is impersonated by using the UPN (alias@domain.com). Nos logs, você vê o “UPN Original 'alias@domain.com' substituído por um novo UPN 'alias@domain.com'” na parte superior dos logs de erro, conforme mostrado aqui:In the logs, you see "Original UPN 'alias@domain.com' replaced with a new UPN 'alias@domain.com'" at the top of the error logs, as seen here:

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

SoluçãoSolution

  • O SAP HANA exige que o usuário representado use o atributo sAMAccountName no Active Directory (alias do usuário).SAP HANA requires the impersonated user to use the sAMAccountName attribute in Active Directory (user alias). Se este atributo não estiver correto, você verá o erro 1033.If this attribute isn't correct, you see the 1033 error.

    sAMAccount

  • Nos logs, você vê sAMAccountName (alias) e não o UPN, que é o alias seguido pelo domínio (alias@doimain.com).In the logs, you see the sAMAccountName (alias) and not the UPN, which is the alias followed by the domain (alias@doimain.com).

    sAMAccount

      <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 Active Directory.You get the "-10709 Connection failed" error message if your delegation isn't configured correctly in Active Directory.

SoluçãoSolution

  • Certifique-se de que você tenha o servidor SAP Hana na guia Delegação no Active Directory para a conta de serviço do gateway.Make sure that you have the SAP Hana server on the delegation tab in Active Directory for the gateway service account.

    Guia Delegação

Histórico de atualizaçãoRefresh history

Quando você usa o gateway para uma atualização agendada, Histórico de atualização pode ajudá-lo a ver quais erros ocorreram.When you use the gateway for a scheduled refresh, Refresh history can help you see what errors occurred. Ele também poderá fornecer dados úteis se você precisar criar uma solicitação de suporte.It can also provide useful data if you need to create a support request. É possível exibir atualizações agendadas e sob demanda.You can view scheduled and on-demand refreshes. As etapas a seguir mostram como você pode acessar o histórico de atualização.The following steps show how you can get to the refresh history.

  1. No painel de navegação do Power BI, em Conjuntos de Dados, selecione um conjunto de dados.In the Power BI navigation pane, in Datasets, select a dataset. Abra o menu e selecione Agendar atualização.Open the menu, and select Schedule refresh.

    Como selecionar a atualização agendada

  2. Em Configurações de... > Agendar atualização, selecione Histórico de atualização.In Settings for... > Schedule refresh, select Refresh history.

    Selecionar histórico de atualização

    Exibição do histórico de atualização

Para obter mais informações sobre solucionar problemas de cenários de atualização, confira Solucionar problemas de cenários de atualização.For more information about troubleshooting refresh scenarios, see Troubleshoot refresh scenarios.

Rastreamento do FiddlerFiddler trace

Fiddler é uma ferramenta gratuita da Telerik que monitora o tráfego HTTP.Fiddler is a free tool from Telerik that monitors HTTP traffic. Você pode ver a parte de trás e frente com o serviço do Power BI do computador cliente.You can see the back and forth with the Power BI service from the client machine. Essa lista de tráfego pode mostrar erros e outras informações relacionadas.This traffic list might show errors and other related information.

Usando o rastreamento Fiddler

Próximas etapasNext steps

Mais perguntas?More questions? Experimente a Comunidade do Power BI.Try the Power BI Community.