Solução de problemas do gateway de dados localTroubleshooting the On-premises data gateway

Esta página é útil?

Este artigo aborda alguns problemas comuns ao usar o Gateway de dados local.This article discusses some common issues when using the On-premises data gateway.

Observação

Se você encontrar um problema que não esteja listado abaixo, peça assistência adicional nos locais a seguir.If you encounter an issue that is not listed below, you can ask for further assistance in the following locations.

Atualize para a versão mais recenteUpdate to the latest version

Muitos problemas podem surgir quando a versão de gateway estiver desatualizada.A lot of issues can surface when the gateway version is out of date. É uma boa prática geral ter certeza que você está na última versão.It is a good general practice to make sure you are on the latest version. Se não tiver atualizado o gateway por um mês ou mais, considere a possibilidade de instalar a última versão do gateway e tentar reproduzir o problema.If you haven't updated the gateway for a month, or longer, you may want to consider installing the latest version of the gateway and see if you can reproduce the issue.

Problemas comunsCommon issues

Aqui estão algumas resoluções e problemas comuns que ajudaram um número de clientes em ambientes com acesso restrito à Internet.Here are a few common issues and resolutions that have helped a number of customers in environments that restrict internet access.

Autenticação com o servidor proxyAuthentication to proxy server

Seu proxy pode exigir autenticação de uma conta de usuário do domínio.Your proxy may require authentication from a domain user account. Por padrão, o gateway usa um SID de Serviço para o log de serviço Windows no usuário.By default, the gateway uses a Service SID for the windows service log on user. Alterar o usuário de logon para um usuário de domínio pode ajudar com isso.Changing the log on user to a domain user can help with this. Para obter mais informações, veja Alterando a conta de serviço do gateway para um usuário de domínio.For more information, see Changing the gateway service account to a domain user.

Seu proxy permite apenas tráfego pelas portas 80 e 443Your proxy only allows ports 80 and 443 traffic

Alguns proxies restringem o tráfego exclusivamente para as portas 80 e 443.Some proxies restrict traffic to only ports 80 and 443. Por padrão, a comunicação com o Barramento de Serviço do Azure ocorrerá em outras portas que não a 443.By default, communication to Azure Service Bus will occur on ports other than 443.

Você pode forçar o gateway para se comunicar com o Barramento de Serviço do Azure usando HTTPS em vez de TCP direto.You can force the gateway to communicate with Azure Service Bus using HTTPS instead of direct TCP. Você precisará modificar o arquivo Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.You will need to modify the Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config file. Altere o valor de AutoDetect para Https.Change the value from AutoDetect to Https. Este arquivo está localizado, por padrão, em C:\Arquivos de Programas\Gateway de dados local.This file is located, by default, at C:\Program Files\On-premises data gateway.

<setting name="ServiceBusSystemConnectivityModeString" serializeAs="String">
    <value>Https</value>
</setting>

InstalaçãoInstallation

Erro: falha ao adicionar usuário ao grupo.Error: Failed to add user to group. (-2147463168 PBIEgwService Usuários de Log de Desempenho)(-2147463168 PBIEgwService Performance Log Users )

Você poderá receber esse erro se estiver tentando instalar o gateway em um controlador de domínio.You may receive this error if you are trying to install the gateway on a domain controller. Não há suporte para a implantação em um controlador de domínio.Deploying on a domain controller is not supported. Você precisará implantar o gateway em um computador que não seja um controlador de domínio.You will need to deploy the gateway on a machine that is not a domain controller.

Falha na instalaçãoInstallation fails

Você poderá encontrar falhas na instalação se o software antivírus do computador de instalação estiver desatualizado.You may encounter installation failures if the anti-virus software on the installation machine is out of date. Você pode atualizar a instalação do antivírus ou desabilitá-lo apenas até a instalação do gateway ser concluída e habilitá-lo novamente.You can either update the anti-virus installation, or disable anti-virus only for the duration of the gateway installation to complete, then re-enable anti-virus.

ConfiguraçãoConfiguration

Como reiniciar o gatewayHow to restart the gateway

O gateway é executado como um serviço Windows para você poder iniciá-lo e pará-lo de várias maneiras.The gateway runs as a Windows service, so you can start and stop it in a few ways. Por exemplo, você pode abrir um prompt de comando com permissões elevadas no computador em que o gateway está em execução e, em seguida, executar um destes comandos:For example, you can open a command prompt with elevated permissions on the machine where the gateway is running and then run either of these commands:

  • Para interromper o serviço, execute este comando:To stop the service, run this command:

    net stop PBIEgwService
    
  • Para iniciar o serviço, execute este comando:To start the service, run this command:

    net start PBIEgwService
    

Configuração do arquivo de logLog file configuration

Os logs de serviço de gateway são categorizados em três buckets: informações, erro e rede.The gateway service logs are categorized into three buckets: information, error, and network. Essa classificação proporciona uma experiência melhor de solução de problemas que permite que você se concentre em uma área específica, dependendo do problema ou do erro.This categorization provides a better troubleshooting experience that allows you to focus on a specific area, depending on the error or issue. Você pode ver as três categorias no seguinte snippet do arquivo de configuração de gateway: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log.You can see the three categories in the following snippet from the gateway configuration file: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log.

  <system.diagnostics>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <remove name="Default" />
        <add name="ApplicationFileTraceListener"
             type="Microsoft.PowerBI.DataMovement.Pipeline.Common.Diagnostics.RotatableFilesManagerTraceListener, Microsoft.PowerBI.DataMovement.Pipeline.Common"
             initializeData="%LOCALAPPDATA%\Microsoft\On-premises data gateway\,GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50" />
      </listeners>
    </trace>
  </system.diagnostics>

Esse arquivo está localizado por padrão em: \Arquivos de Programas\On-premises data gateway\Microsoft.PowerBI.EnterpriseGateway.exe.config. Para configurar o número de arquivos de log a serem retidos, altere o primeiro número (20 neste exemplo): GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50.This file is located by default at: \Program Files\On-premises data gateway\Microsoft.PowerBI.EnterpriseGateway.exe.config. To configure the number of log files to retain, change the first number (20 in this example): GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50.

Erro: Falha ao criar um gateway.Error: Failed to create a gateway. Tentar novamenteTry again

Todos os detalhes estão disponíveis, mas a chamada para o serviço do Power BI retornou um erro.All of the details are available, but the call to the Power BI service returned an error. São exibidos o erro e uma ID de atividade.The error and an activity id are displayed. Isso pode acontecer por diferentes motivos.This could happen for different reasons. Você pode coletar e examinar os logs da maneira descrita abaixo para obter mais detalhes.You can collect, and review, the logs, as mentioned below, to get more details.

Isso também pode ser devido a problemas de configuração de proxy.This could also be due to proxy configuration issues. A interface do usuário agora permite a configuração de proxy.The user interface does now allow for proxy configuration. Saiba mais sobre como fazer alterações da configuração de proxyYou can learn more about making proxy configuration changes

Erro: Falha ao atualizar detalhes do gateway.Error: Failed to update gateway details. Tente novamentePlease try again

As informações foram recebidas do serviço do Power BI para o gateway.Information was received from the Power BI service to the gateway. As informações foram transmitidas para o serviço do Windows local, mas houve uma falha ao retornar.The information was passed onto the local windows service, but it failed to return. Ou então houve uma falha de geração de chave simétrica.Alternatively, a symmetric key generation failed. A exceção interna é exibida em Mostrar detalhes.The inner exception is displayed under Show details. Para obter mais detalhes, colete e analise os logs mencionados abaixo.To get more details, you can collect and review the logs mentioned below.

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 novamenteRestart 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 does not report the gateway as live. Reiniciar o serviço do Windows pode permitir que a comunicação seja bem-sucedida.Restarting the windows service may allow the communication to be successful. Você pode coletar e examinar os logs da maneira descrita abaixo para obter mais detalhes.You can collect, and review, the logs, as mentioned below, to get more details.

Erro de script durante a conexão no Power BIScript error during sign into Power BI

Você pode receber um erro de script ao entrar no Power BI como parte da configuração de gateway de dados local.You may receive a script error when signing into Power BI as part of the On-premises data gateway configuration. A instalação da seguinte atualização de segurança resolve o problema.Installing the following security update resolves the issue. Isso pode ser instalado por meio do Windows Update.This can be installed via Windows Update.

MS16-051: Atualização de segurança do Internet Explorer: 10 de maio de 2016 (KB 3154070)MS16-051: Security update for Internet Explorer: May 10, 2016 (KB 3154070)

Falha de configuração do gateway com uma exceção de referência nulaGateway configuration failed with a null reference exception

Você pode receber um erro semelhante a este:You may encounter an error similar to the following.

    Failed to update gateway details.  Please try again.
    Error updating gateway configuration.

Isso inclui um rastreamento de pilha e ele pode incluir a seguinte mensagem.This includes a stack trace, and that stack trace may include the following message.

    Microsoft.PowerBI.DataMovement.Pipeline.Diagnostics.CouldNotUpdateGatewayConfigurationException: Error updating gateway configuration. ----> System.ArgumentNullException: Value cannot be null.
    Parameter name: serviceSection

Se você estiver atualizando um gateway mais antigo, o arquivo de configuração será preservado.If you are upgrading from an older gateway, we preserve the config file. Pode haver uma seção ausente.There may be a section that is missing. Quando o gateway tentar ler isso, obteremos a exceção de referência nula acima.When the gateway tries to read it, we can get the above null reference exception.

Para corrigir isso, siga estas etapas.To correct this, do the following steps.

  1. Desinstale o gateway.Uninstall the gateway.

  2. Exclua a seguinte pasta:Delete the following folder.

     c:\Program Files\On-premises data gateway
    
  3. Reinstale o gateway.Reinstall the gateway.

  4. Se preferir, aplique a chave de recuperação para restaurar um gateway existente.Optionally apply the recovery key to restore an existing gateway.

Suporte para TLS 1.2Support for TLS 1.2

Por padrão, o gateway de dados local usa o protocolo TLS 1.2 para se comunicar com o serviço do Power BI.By default, the On-premises data gateway uses Transport Layer Security (TLS) 1.2 to communicate with the Power BI service. Para garantir que todo o tráfego de gateway use o TLS 1.2, pode ser preciso adicionar ou modificar as seguintes chaves do Registro no computador que esteja executando o serviço de gateway:To ensure all gateway traffic uses TLS 1.2, you might have to add or modify the following registry keys on the machine running the gateway service:

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319]"SchUseStrongCrypto"=dword:00000001
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\v4.0.30319]"SchUseStrongCrypto"=dword:00000001

Observação

A adição ou modificação dessas chaves do Registro aplica a alteração a todos os aplicativos .NET.Adding or modifying these registry keys applies the change to all .NET applications. Para obter informações sobre as alterações no registro que afetam o TLS em outros aplicativos, consulte Transport Layer Security (TLS) registry settings (Configurações de registro do protocolo TLS).For information about registry changes that affect TLS for other applications, see Transport Layer Security (TLS) registry settings.

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, it displays the error message received from the data source. 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 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"

Conseguimos nos conectar ao servidor, mas não ao banco de dados fornecido.We were able to connect to the server, but not to the database 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 as the proper permission to access that database.

Em Mostrar detalhes, a mensagem de erro recebida da fonte de dados é exibida.Within Show details, it displays the error message received from the data source. 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 could 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 hosting the gateway. Isso pode ocorrer devido ao fato de o servidor não estar acessível.This 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 the Event Logs > Applications and Services Logs > On-premises data gateway Service for more details.

Erro: Encontramos um erro ao tentar conectar ao .Error: We encountered an error while trying to connect to . 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."

Não é possível se conectar à fonte de dados especificada.We 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 are using for the data source is not a server admin for that Analysis Services instance. Saiba maisLearn more

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 may 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. No entanto, os domínios criados mais recentemente não habilitam esse atributo por padrão.However, most newly created domains do not enable this attribute by default. Leia mais sobre isso aqui.You can read more about this here.

Confirme isso fazendo o seguinte:You can confirm this by doing the following.

  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 isso reproduz o erro.Within the Advanced connection properties, include EffectiveUserName for the user in question and see if this 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 is a tool 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 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 need to enable TGGAU on the account used for the Analysis Services windows service.

Outra possibilidade de nome de usuário ou senha incorretosAnother possibility for username or password 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 is not a two-way trust established.

É necessário trabalhar com seus administradores de domínio para verificar a relação de confiança entre os domínios.You need to 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 dadosError: 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 have 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, tente limpar o cache do navegador ou sair do serviço e entrar novamente.If the gateway doesn't appear in the admin portal under Manage gateways, try clearing your browser cache or signing out of the service then signing back in.

Conjuntos de dadosDatasets

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

Isso ocorrerá se você tiver uma única linha com um tamanho maior que 4 MB.This occurs if you have a single row greater than 4 MB in size. É necessário determinar qual linha é proveniente da fonte de dados e tentar filtrá-la ou reduzir seu tamanho.You need to 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 ServerError: The server name provided doesn't match the server name on the SQL Server SSL Certificate

Isso pode ocorrer quando o certificado CN é para o FQDN (nome de domínio totalmente qualificado) do servidor, mas você somente forneceu o nome NetBIOS do servidor.This can occur when the certificate CN is for the servers fully qualified domain name (FQDN), but you only supplied the NetBIOS name for the server. Isso causa uma incompatibilidade para o certificado.This causes a mismatch for the certificate. Para resolver esse problema, é necessário criar o nome do servidor na fonte de dados do gateway e no arquivo PBIX para usar o FQDN do servidor.To resolve this issue, you need to make the server name within the gateway data source, and the PBIX file, to use the FQDN of the server.

Não consigo ver o gateway de dados local presente ao configurar a atualização agendadaI don't see the On-premises data gateway present when configuring scheduled refresh

Isso pode ser devido a alguns cenários diferentes.This could be because of a few different scenarios.

  1. O nome do servidor e do banco de dados não corresponde entre o que foi inserido no Power BI Desktop e a fonte de dados configurada para o gateway.The server and database name don't match between what was entered in Power BI Desktop and the data source configured for the gateway. Eles precisam ter os mesmos valores.These need to be the same values. Eles não diferenciam maiúsculas de minúsculas.They are not case-sensitive.
  2. Sua conta não está listada na guia Usuários da fonte de dados na configuração do gateway.Your account is not listed in the Users tab of the data source within the gateway configuration. É necessário solicitar ao administrador do gateway para ser adicionado à lista.You need to get with the administrator of the gateway to be added to that list.
  3. 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 limiteError: 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 are hitting this issue, there are good options to optimize and avoid the issue. Especificamente, será útil reduzir o uso de valores de cadeias de caracteres longas e altamente repetitivas e, em vez disso, usar uma chave normalizada ou remover a coluna (se ela não estiver em uso).In particular, reducing the use of highly constant, long string values and instead using a normalized key or removing the column (if not in use) helps.

RelatóriosReports

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 localReport could not access the data source because you do not have access to our data source via an On-premises data gateway

Isso geralmente é causado por um dos motivos a seguir.This is usually caused by one of the following.

  1. As informações da fonte de dados não correspondem as que estão no conjunto de dados subjacente.The data source information does not match what is 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.
  2. Não há uma fonte de dados disponível em nenhum gateway de sua organização.There is not a 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. Contate o administrador do gatewayPlease contact the gateway administrator

Se este relatório estiver usando 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 is making use of a live Analysis Services connection, you could be encountering an issue with a value being passed to EffectiveUserName that is either not 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 isso, faça o seguinte:To confirm this, you can do the following.

  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.Once you have the value being passed, validate that it is 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 is 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.

  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, será possível 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 usernames 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.

Firewall ou proxyFirewall or Proxy

Para obter informações sobre como fornecer informações de proxy para o gateway, veja Definindo as configurações de proxy dos gateways do Power BI.For information on providing proxy information for your gateway, see Configuring proxy settings for the Power BI gateways.

É possível testar para ver se seu firewall, ou proxy, pode estar bloqueando as conexões executando Test-NetConnection em um prompt do PowerShell.You can test to see if your firewall, or proxy, may be blocking connections by running Test-NetConnection from a PowerShell prompt. Isso testará a conectividade com o Barramento de Serviço do Azure.This will test connectivity to the Azure Service Bus. Isso apenas testa a conectividade de rede e não tem nenhuma relação com o serviço do servidor de nuvem nem com o gateway.This only tests network connectivity and doesn't have anything to do with the cloud server service or the gateway. Isso ajuda a determinar se seu computador pode realmente acessar a Internet.It helps to determine if your machine can actually get out to the internet.

Test-NetConnection -ComputerName watchdog.servicebus.windows.net -Port 9350

Observação

Test-NetConnection só está disponível no Windows Server 2012 R2 e versões posteriores.Test-NetConnection is only available on Windows Server 2012 R2 and later. Também está disponível no Windows 8.1 e versões posteriores.It is also available on Windows 8.1 and later. Em versões anteriores do sistema operacional, é possível usar o Telnet para testar a conectividade da porta.On earlier OS versions, you can use Telnet to test port connectivity.

Os resultados devem ser parecidos ao mostrado a seguir.The results should look similar to the following. A diferença será em TcpTestSucceeded.The difference will be with TcpTestSucceeded. Se TcpTestSucceeded não for true, isso indica que você poderá estar sendo bloqueado por um firewall.If TcpTestSucceeded is not true, then you may be blocked by a firewall.

ComputerName           : watchdog.servicebus.windows.net
RemoteAddress          : 70.37.104.240
RemotePort             : 5672
InterfaceAlias         : vEthernet (Broadcom NetXtreme Gigabit Ethernet - Virtual Switch)
SourceAddress          : 10.120.60.105
PingSucceeded          : False
PingReplyDetails (RTT) : 0 ms
TcpTestSucceeded       : True

Se você quiser fazer uma verificação completa, substitua os valores de ComputerName e Port por aqueles listados para portasIf you want to be exhaustive, substitute the ComputerName and Port values with those listed for ports

O firewall também pode estar bloqueando as conexões que o Barramento de Serviço do Azure estabelece com os datacenters do Azure.The firewall may also be blocking the connections that the Azure Service Bus makes to the Azure data centers. Se este for o caso, será recomendável adicionar à lista branca (desbloquear) todos os endereços IP da sua região para os data centers.If that is the case, you will want to whitelist (unblock) the IP addresses for your region for those data centers. Você pode obter uma lista de endereços IP do Azure aqui.You can get a list of Azure IP addresses here.

É possível encontrar a região do datacenter em que você está fazendo o seguinte:You can find the data center region you are in by doing the following:

  1. Selecione ?Select the ? na parte superior direita do serviço do Power BI.in the upper right of the Power BI service.

  2. Selecione Sobre o Power BI.Select About Power BI.

  3. Sua região de dados é listada em Seus dados estão armazenados em.Your data region is listed in Your data is stored in.

    Região de dados

Se você ainda não conseguiu descobri-la, tente obter um rastreamento de rede usando uma ferramenta como fiddler ou netsh, embora esses sejam métodos de coleta avançados e você possa precisar de assistência para analisar os dados coletados.If you are still not getting anywhere, you could try getting a network trace using a tool like fiddler or netsh, although these are advanced collection methods and you may need assistance in analyzing the collected data. Entre em contato com o suporte para obter assistência.You can contact support for assistance.

DesempenhoPerformance

Contadores de desempenhoPerformance Counters

Existem inúmeros contadores de desempenho que podem ser usados para medir as atividades do gateway.There are a number of performance counters that can be used to gauge the activities for the gateway. Eles podem ser úteis para entender quando há uma grande carga de atividade e talvez seja necessário criar um novo gateway.These can be helpful to understand if we have a large load of activity and may need to make a new gateway. Esses contadores não refletem a duração de algo.These counters do not reflect how long something takes.

Eles podem ser acessados por meio da ferramenta Monitor de desempenho do Windows.These counters can be accessed through the Windows Performance Monitor tool.

Há agrupamentos gerais desses contadores.There are general groupings of these counters.

Tipo de contadorCounter Type DescriçãoDescription
ADO.NETADO.NET É usado para qualquer conexão de DirectQuery.This is used for any DirectQuery connection.
ADOMDADOMD É usado para o Analysis Services 2014 e anterior.This is used for Analysis Services 2014 and earlier.
OLEDBOLEDB Determinadas fontes de dados usam isso.Certain data sources use this. Inclui o SAP HANA e o Analysis Service 2016 ou posterior.This includes SAP HANA and Analysis Service 2016 or later.
MashupMashup Inclui qualquer fonte de dados importados.This includes any imported data source. Se estiver agendando uma atualização ou fazendo uma atualização sob demanda, esse processo passará pelo mecanismo de mashup.If you are scheduling refresh or doing an on-demand refresh, it goes through the mashup engine.

Aqui está uma lista de contadores de desempenho disponíveis.Here is a listing of the available performance counters.

ContadorCounter DescriçãoDescription
Número de conexões abertas do ADO.NET executadas por segundo# of ADO.NET open connection executed / sec Número de ações de conexões abertas do ADO.NET executadas por segundo (com êxito ou falha).Number of ADO.NET open connection actions executed per second (succeeded or failed).
Número de conexões abertas do ADO.NET com falha por segundo# of ADO.NET open connection failed / sec Número de ações de conexões abertas do ADO.NET com falha por segundo.Number of ADO.NET open connections actions failed per second.
Número de consultas do ADO.NET executadas por segundo# of ADO.NET queries executed / sec Número de consultas do ADO.NET executadas por segundo (com êxito ou falha).Number of ADO.NET queries executed per second (succeeded or failed).
Número de consultas do ADO.NET com falha por segundo# of ADO.NET queries failed / sec Número de consultas do ADO.NET com falha executadas por segundo.Number of ADO.NET failed queries executed per second.
Número de conexões abertas do ADOMD executadas por segundo# of ADOMD open connection executed / sec Número de ações de conexões abertas do ADOMD executadas por segundo (com êxito ou falha).Number of ADOMD open connection actions executed per second (succeeded or failed).
Número de conexões abertas do ADOMD com falha por segundo# of ADOMD open connection failed / sec Número de ações de conexões abertas do ADOMD com falha por segundo.Number of ADOMD open connection actions failed per second.
Número de consultas do ADOMD executadas por segundo# of ADOMD queries executed / sec Número de consultas do ADOMD executadas por segundo (com êxito ou falha).Number of ADOMD queries executed per second (succeeded or failed).
Número de consultas do ADOMD com falha por segundo# of ADOMD queries failed / sec Número de consultas do ADOMD com falha executadas por segundo.Number of ADOMD failed queries executed per second.
Número de todas as conexões abertas executadas por segundo# of all open connection executed / sec Número de ações de conexões abertas executadas por segundo (com êxito ou falha).Number of open connection actions executed per second (succeeded or failed).
Número de todas as conexões abertas com falha por segundo# of all open connection failed / sec Número de ações de conexões abertas com falha executadas por segundo.Number of failed open connection actions executed per second.
Número de todas as consultas executadas por segundo# of all queries executed / sec Número de consultas executadas por segundo (com êxito ou falha).Number of queries executed per second (succeeded or failed).
Número de itens no pool de conexões do ADO.NET# of items in the ADO.NET connection pool Número de itens no pool de conexões do ADO.NET.Number of items in the ADO.NET connection pool.
Número de itens no pool de conexões do OLEDB# of items in the OLEDB connection pool Número de itens no pool de conexões do OLEDB.Number of items in the OLEDB connection pool.
Número de itens no pool de Barramentos de Serviço# of items in the Service Bus pool Número de itens no pool de Barramentos de Serviço.Number of items in the Service Bus pool.
Número de conexões abertas do Mashup executadas por segundo# of Mashup open connection executed / sec Número de ações de conexões abertas do Mashup executadas por segundo (com êxito ou falha).Number of Mashup open connection actions executed per second (succeeded or failed).
Número de conexões abertas do Mashup com falha por segundo# of Mashup open connection failed / sec Número de ações de conexões abertas do Mashup com falha por segundo.Number of Mashup open connection actions failed per second.
Número de consultas do Mashup executadas por segundo# of Mashup queries executed / sec Número de consultas do Mashup executadas por segundo (com êxito ou falha).Number of Mashup queries executed per second (succeeded or failed).
Número de consultas do Mashup com falha por segundo# of Mashup queries failed / sec Número de consultas do Mashup com falha executadas por segundoNumber of Mashup failed queries executed per second
Número de consultas de conjunto de resultados múltiplos do OLEDB com falha/segundo# of OLEDB multiple result set queries failed / sec Número de conjuntos de resultados múltiplos de consultas do OLEDB com falha executados por segundo.Number of multiple result sets of OLEDB failed queries executed per second.
Número de conjuntos de resultados múltiplos de consultas do OLEDB executados/segundo# of OLEDB multiple result sets of queries executed / sec Número de conjunto de resultados múltiplos de consultas do OLEDB executados por segundo (com êxito ou falha).Number of OLEDB multiple result sets of queries executed per second (succeeded or failed).
Número de conexões abertas OLEDB executadas por segundo# of OLEDB open connection executed / sec Número de ações de conexões abertas do OLEDB executadas por segundo (com êxito ou falha).Number of OLEDB open connection actions executed per second (succeeded or failed).
Número de conexões abertas do OLEDB com falha por segundo# of OLEDB open connection failed / sec Número de ações de conexões abertas do OLEDB com falha por segundo.Number of OLEDB open connection actions failed per second.
Número de consultas do OLEDB executadas por segundo# of OLEDB queries executed / sec Número de conjunto de resultados múltiplos de consultas do OLEDB executados por segundo (com êxito ou falha).Number of OLEDB multiple result sets of queries executed per second (succeeded or failed).
Número de consultas do OLEDB com falha por segundo# of OLEDB queries failed / sec Número de conjuntos de resultados múltiplos de consultas com falha do OLEDB executados por segundo.Number of OLEDB multiple result sets of failed queries executed per second.
Número de consultas de conjunto de resultados únicos do OLEDB executadas/segundo# of OLEDB single result set queries executed / sec Número de consultas de conjunto de resultados únicos do OLEDB executadas por segundo (com êxito ou falha).Number of OLEDB single result set queries executed per second (succeeded or failed).
Número de consultas com falha por segundo# of queries failed / sec Número de consultas com falha executadas por segundo.Number of failed queries executed per second.
Número de consultas do OLEDB de conjunto de resultados único com falha por segundo# of single result set OLEDB queries failed / sec Número de consultas com falha do OLEDB de conjunto de resultados únicos executadas por segundo.Number of single result set OLEDB failed queries executed per second.

Examinando consultas com desempenho lentoReviewing slow performing queries

Você pode achar que a resposta pelo gateway está lenta.You may find that response through the gateway is slow. Isso pode ser em consultas DirectQuery ou ao atualizar o conjunto de dados importado.This could be for DirectQuery queries or when refreshing your imported dataset. Você pode habilitar um registro em log adicional para emitir as consultas e seus tempos para ajudar a entender o que está com desempenho lento.You can enable additional logging to output queries and their timings to help understand what is performing slow. Ao encontrar alguma consulta de execução longa, poderá ser necessário fazer modificações adicionais na fonte de dados para ajustar o desempenho da consulta.When you find a long-running query, it may require additional modification on your data source to tune query performance. Por exemplo, ajustando os índices para uma consulta do SQL Server.For example, adjusting indexes for a SQL Server query.

É necessário modificar dois arquivos de configuração para determinar a duração de uma consulta.You need to modify two configuration files to determine the duration of a query.

Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.configMicrosoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config

No arquivo Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config, altere o valor de EmitQueryTraces de False para True.Within the Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config file, change the EmitQueryTraces value from False to True. Este arquivo está localizado, por padrão, em C:\Arquivos de Programas\Gateway de dados local.This file is located, by default, at C:\Program Files\On-premises data gateway. Ao habilitar EmitQueryTraces, começarão a ser registradas em log as consultas enviadas do gateway para uma fonte de dados.Enabling EmitQueryTraces begins to log queries that are sent from the gateway to a data source.

Importante

Habilitar EmitQueryTraces pode aumentar o tamanho do log significativamente, dependendo do uso de gateway.Enabling EmitQueryTraces could increase the log size significantly depending on gateway usage. Depois de terminar de examinar os logs, defina EmitQueryTraces como False.Once you are done reviewing the logs, you can need to set EmitQueryTraces to False. Não é recomendado deixar essa configuração habilitada a longo prazo.It is not recommended to leave this setting enabled long term.

<setting name="EmitQueryTraces" serializeAs="String">
    <value>True</value>
</setting>

Exemplo de entrada de consultaExample query entry

DM.EnterpriseGateway Information: 0 : 2016-09-15T16:09:27.2664967Z DM.EnterpriseGateway    4af2c279-1f91-4c33-ae5e-b3c863946c41    d1c77e9e-3858-4b21-3e62-1b6eaf28b176    MGEQ    c32f15e3-699c-4360-9e61-2cc03e8c8f4c    FF59BC20 [DM.GatewayCore] Executing query (timeout=224) "<pi>
SELECT
TOP (1000001) [t0].[ProductCategoryName],[t0].[FiscalYear],SUM([t0].[Amount])
 AS [a0]
FROM
(
(select [$Table].[ProductCategoryName] as [ProductCategoryName],
    [$Table].[ProductSubcategory] as [ProductSubcategory],
    [$Table].[Product] as [Product],
    [$Table].[CustomerKey] as [CustomerKey],
    [$Table].[Region] as [Region],
    [$Table].[Age] as [Age],
    [$Table].[IncomeGroup] as [IncomeGroup],
    [$Table].[CalendarYear] as [CalendarYear],
    [$Table].[FiscalYear] as [FiscalYear],
    [$Table].[Month] as [Month],
    [$Table].[OrderNumber] as [OrderNumber],
    [$Table].[LineNumber] as [LineNumber],
    [$Table].[Quantity] as [Quantity],
    [$Table].[Amount] as [Amount]
from [dbo].[V_CustomerOrders] as [$Table])
)
 AS [t0]
GROUP BY [t0].[ProductCategoryName],[t0].[FiscalYear] </pi>"

Microsoft.PowerBI.DataMovement.Pipeline.Diagnostics.dll.configMicrosoft.PowerBI.DataMovement.Pipeline.Diagnostics.dll.config

No arquivo Microsoft.PowerBI.DataMovement.Pipeline.Diagnostics.dll.config, altere o valor de TracingVerbosity de 4 para 5.Within the Microsoft.PowerBI.DataMovement.Pipeline.Diagnostics.dll.config file, change the TracingVerbosity value from 4 to 5. Este arquivo está localizado, por padrão, em C:\Arquivos de Programas\Gateway de dados local.This file is located, by default, at C:\Program Files\On-premises data gateway. Alterar essa configuração começa a registrar entradas detalhadas no log de gateway.Changing this setting begins to log verbose entries to the gateway log. Isso inclui entradas que mostram a duração.This includes entries that show duration. Também é possível habilitar entradas detalhadas habilitando o botão "Registro de Log Adicional" no aplicativo Gateway local.You can also enable verbose entries by enabling the "Additional Logging" button in the On-Premises Gateway application.

log adicional

Importante

Habilitar o TracingVerbosity para 5 pode aumentar o tamanho do log significativamente, dependendo do uso do gateway.Enabling TracingVerbosity to 5 could increase the log size significantly depending on gateway usage. Depois de terminar de examinar os logs, defina TraceVerbosity como 4.Once you are done reviewing the logs, you need to set TraceVerbosity to 4. Não é recomendado deixar essa configuração habilitada a longo prazo.It is not recommended to leave this setting enabled long term.

<setting name="TracingVerbosity" serializeAs="String">
    <value>5</value>
</setting>

Tipos de atividadeActivity Types

Tipo de atividadeActivity Type DescriçãoDescription
MGEQMGEQ Consultas executadas no ADO.NET.Queries executed over ADO.NET. Estão inclusas outras fontes de dados do DirectQuery.This includes DirectQuery data sources.
MGEOMGEO Consultas executadas no OLEDB.Queries executed over OLEDB. Inclui o SAP HANA e o Analysis Services 2016.This includes SAP HANA and Analysis Services 2016.
MGEMMGEM Consultas executadas do mecanismo de Mashup.Queries executed from the Mashup engine. Usadas com conjuntos de dados importados que usam a atualização agendada ou a atualização sob demanda.This is used with imported datasets that use scheduled refresh or refresh on-demand.

Determinar a duração de uma consultaDetermine the duration of a query

Para determinar o tempo necessário para consultar a fonte de dados, você pode fazer o seguinte.To determine the time it took to query the data source, you can do the following.

  1. Abra o log de gateway.Open the gateway log.

  2. Pesquise um Tipo de Atividade para localizar a consulta.Search for an Activity Type to find the query. Um exemplo seria MGEQ.An example of this would be MGEQ.

  3. Anote o segundo GUID, que é a ID de solicitação.Make a note of the second GUID as this is the request id.

  4. Continue a pesquisar o MGEQ até encontrar a entrada FireActivityCompletedSuccessfullyEvent com a duração.Continue to search for MGEQ until you find the FireActivityCompletedSuccessfullyEvent entry with the duration. Você pode verificar se a entrada tem a mesma ID de solicitação. A duração é em milissegundos.You can verify the entry has the same request id. Duration is in milliseconds.

     DM.EnterpriseGateway Verbose: 0 : 2016-09-26T23:08:56.7940067Z DM.EnterpriseGateway    baf40f21-2eb4-4af1-9c59-0950ef11ec4a    5f99f566-106d-c8ac-c864-c0808c41a606    MGEQ    21f96cc4-7496-bfdd-748c-b4915cb4b70c    B8DFCF12 [DM.Pipeline.Common.TracingTelemetryService] Event: FireActivityCompletedSuccessfullyEvent (duration=5004)
    

    Observação

    FireActivityCompletedSuccessfullyEvent é uma entrada detalhada.FireActivityCompletedSuccessfullyEvent is a verbose entry. Essa entrada não será registrada, exceto se TraceVerbosity estiver no nível 5.This entry is not logged unless TraceVerbosity is at level 5.

Firewall ou proxyFirewall or Proxy

Para obter informações sobre como fornecer informações de proxy para o gateway, veja Definindo as configurações de proxy dos gateways do Power BI.For information on providing proxy information for your gateway, see Configuring proxy settings for the Power BI gateways.

É possível testar para ver se seu firewall, ou proxy, pode estar bloqueando as conexões executando Test-NetConnection em um prompt do PowerShell.You can test to see if your firewall, or proxy, may be blocking connections by running Test-NetConnection from a PowerShell prompt. Isso testa a conectividade com o Barramento de Serviço do Azure.This tests connectivity to the Azure Service Bus. Isso testa apenas a conectividade de rede e não tem nenhuma relação com o serviço do servidor de nuvem nem com o gateway.This only tests network connectivity and don't have anything to do with the cloud server service or the gateway. Isso ajuda a determinar se seu computador pode realmente acessar a Internet.It helps to determine if your machine can actually get out to the internet.

Test-NetConnection -ComputerName watchdog.servicebus.windows.net -Port 9350

Observação

Test-NetConnection só está disponível no Windows Server 2012 R2 e versões posteriores.Test-NetConnection is only available on Windows Server 2012 R2 and later. Também está disponível no Windows 8.1 e versões posteriores.It is also available on Windows 8.1 and later. Em versões anteriores do sistema operacional, é possível usar o Telnet para testar a conectividade da porta.On earlier OS versions, you can use Telnet to test port connectivity.

Os resultados são parecidos com o seguinte.The results look similar to the following. A diferença é com TcpTestSucceeded.The difference is with TcpTestSucceeded. Se TcpTestSucceeded não for true, isso indica que você poderá estar sendo bloqueado por um firewall.If TcpTestSucceeded is not true, then you may be blocked by a firewall.

ComputerName           : watchdog.servicebus.windows.net
RemoteAddress          : 70.37.104.240
RemotePort             : 5672
InterfaceAlias         : vEthernet (Broadcom NetXtreme Gigabit Ethernet - Virtual Switch)
SourceAddress          : 10.120.60.105
PingSucceeded          : False
PingReplyDetails (RTT) : 0 ms
TcpTestSucceeded       : True

Se você quiser fazer uma verificação completa, substitua os valores de ComputerName e Port por aqueles listados para portasIf you want to be exhaustive, substitute the ComputerName and Port values with those listed for ports

O firewall também pode estar bloqueando as conexões que o Barramento de Serviço do Azure estabelece com os datacenters do Azure.The firewall may also be blocking the connections that the Azure Service Bus makes to the Azure data centers. Se este for o caso, será recomendável adicionar à lista de permissões (desbloquear) os endereços IP da sua região para esses data centers.If that is the case, you want to whitelist (unblock) the IP addresses for your region for those data centers. Você pode obter uma lista de endereços IP do Azure aqui.You can get a list of Azure IP addresses here.

Teste de portas de redeNetwork Ports Test

O teste de portas de rede é uma ferramenta para verificar se o gateway pode acessar as portas corretas para todos os servidores remotos exigidos pelo seu gateway para a transferência de dados.The network ports test is a tool to check if your gateway can access the correct ports for all remote servers that are required by your gateway for transferring data. Se o teste de portas de rede não conseguir se conectar a nenhuma porta, seu gateway poderá enfrentar problemas de rede.If the network ports test fails to connect to any of the ports, your gateway may experience network issues. Se, no momento, você estiver enfrentando problemas de rede com seu gateway, execute um teste de portas de rede para garantir que você tem o ambiente de rede ideal.If you are currently experiencing network issues with your gateway, run a network ports test to ensure that you have the optimal network environment.

Iniciar um novo testeStart a new test

Para executar um novo teste de portas de rede na interface do usuário do gateway de dados local.To run a new network ports test, in the On-premises data gateway user interface.

Iniciar teste de portas

Ao executar o teste de portas de rede, seu gateway recupera uma lista de portas e servidores do Barramento de Serviço do Azure e, em seguida, ele tenta se conectar com todos os servidores e portas.When executing the network ports test, your gateway retrieves a list of ports and servers from Azure Service Bus and then it attempts to connect to all the servers and ports. Quando o link Iniciar novo teste for exibido novamente, o teste de portas de rede terá terminado a execução.When the Start new test link reappears, the network ports test has finished executing.

Resultados de testeTest results

Um resumo do teste pode ser visto embaixo do link Iniciar novo teste como Resultado do teste recentes.A summary of the test can be seen below the Start new test link as Recent test results. Os dois resultados são Concluído (Com êxito) e Concluído (Com falha, consulte os últimos resultados de teste).The two results are Completed (Succeeded) and Completed (Failed, see last test results). Se o teste foi bem-sucedido, então seu gateway se conectou com êxito a todas as portas necessárias.If the test succeeded, then your gateway successfully connected to all the required ports. Se o teste falhou, então seu ambiente de rede talvez esteja bloqueando essas portas e servidores necessários.If the test failed, then your network environment may be blocking these required ports and servers.

Resultados de teste de porta

Para exibir os resultados do último teste concluído, selecione o link Abrir os últimos resultados de teste concluídos, conforme mostrado abaixo.To view the results of the last completed test, select the Open last completed test results link, as seen below. Os resultado do teste são abertos no editor de texto padrão do Windows.The test results open in Windows’ default text editor.

Os resultados de teste listam todos os servidores, portas e endereços IP exigidos pelo seu gateway.The test results list all the servers, ports, and IP addresses that are required by your gateway. Se os resultados de teste exibirem Fechado para quaisquer portas conforme mostrado abaixo, certifique-se de que seu ambiente de rede não está bloqueando a conexão.If the test results display Closed for any ports as shown below, ensure that your network environment is not blocking the connection. Talvez seja necessário contatar seu administrador de rede para abrir as portas necessárias.You may need to contact your network administrator to open the required ports.

Arquivo de resultado do teste de porta

KerberosKerberos

Se o servidor de banco de dados subjacente e o gateway de dados local não estiverem devidamente configurados para Delegação Restrita de Kerberos, habilite o log detalhado no gateway e investigue com base nos erros/rastreamentos em arquivos de log do gateway como um ponto de partida para solução de problemas.If the underlying database server and On-premises data gateway are not appropriately configured for Kerberos Constrained Delegation, enable verbose logging on the gateway, and investigate based on the errors/traces in the gateway’s log files as a starting point for troubleshooting.

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. Configurar um SPN para o gateway localSetup an SPN for the On-Premises Gateway
  2. Configurar a delegação restrita em seu Active Directory (AD)Setup constrained delegation in your Active Directory (AD)

FailedToImpersonateUserException: falha ao criar a identidade do Windows para a ID do 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 are not able to impersonate on behalf of another user. Isso também pode 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á (isso é uma limitação).This could also happen if the account you are trying to impersonate is from another domain than the one the gateway service domain is on (this is a limitation).

SoluçãoSolution

  • Verifique se a configuração está correta de acordo com as etapas na seção ImpersonationLevel acimaVerify that the configuration is correct as per the steps in the ImpersonationLevel section above
  • Verifique se a userid que ele está tentando representar é de uma conta válida do ADEnsure that the userid it's trying to impersonate is a valid AD Account

Erro geral; erro 1033 ao analisar o protocoloGeneral error; 1033 error while parsing the protocol

Você receberá o erro 1033 quando sua ID externa configurada no SAP HANA não estiver correspondendo ao logon se o usuário for representado usando o UPN (alias@domain.com).You get the 1033 error when your external ID that is configured in SAP HANA is not matching the login if the user is impersonated 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 abaixo".In the logs you see the “Original UPN 'alias@domain.com' replaced with a new UPN 'alias@domain.com' at the top of the error logs as seen below.”

[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 AD (alias do usuário).SAP HANA requires the impersonated user to use the sAMAccountName attribute in AD (user alias). Se não estiver correto, você verá o erro 1033.If this is not 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 AD.You get the -10709 Connection failed error message if your delegation is not configured correctly in AD.

SoluçãoSolution

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

    guia Delegação

Ferramentas para solução de problemasTools for troubleshooting

Coletando logs do configurador do gatewayCollecting logs from the gateway configurator

Existem vários logs que você pode coletar para o gateway e você sempre deve começar com os logs.There are several logs you can collect for the gateway, and you should always start with the logs. A maneira mais simples de coletar logs depois de instalar o gateway é por meio da interface do usuário.The simplest way to collect logs after installing the gateway is through the user interface. Na interface do usuário Gateway de dados local, selecione Diagnóstico e, em seguida, selecione o link Exportar logs próximo à parte inferior da página, conforme mostrado na imagem a seguir.In the On-premises data gateway user interface, select Diagnostics and then select the Export logs link near the bottom of the page, as shown in the following image.

On-prem-data-gateway-UI-logs

Logs do instaladorInstaller logs

%localappdata%\Temp\On-premises_data_gateway_*.log

Logs de configuraçãoConfiguration logs

%localappdata%\Microsoft\On-premises Data Gateway\GatewayConfigurator*.log

Logs de serviço do gateway de dados localOn-premises data gateway service logs

C:\Users\PBIEgwService\AppData\Local\Microsoft\On-premises Data Gateway\Gateway*.log

Logs de eventosEvent Logs

Os logs de eventos do serviço do gateway de dados local estão presentes nos Logs de Aplicativos e Serviços.The On-premises data gateway service event logs are present under Application and Services Logs.

On-prem-data-gateway-event-logs

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. Isso pode mostrar erros e outras informações relacionadas.This may show errors and other related information.

Histórico de atualizaçãoRefresh History

Ao usar o gateway para uma atualização agendada, o Histórico de Atualizações pode ajudá-lo a ver quais erros ocorreram, além de fornecer dados úteis caso precise criar uma solicitação de suporte.When using the gateway for a scheduled refresh, Refresh History can help you see what errors have occurred, as well as provide useful data if you need to create a support request. É possível exibir atualizações agendadas e sob demanda.You can view both scheduled, as well as on-demand, refreshes. Aqui está como você pode acessar o Histórico de atualização.Here is 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 > Abrir Menu > Agendar Atualização.In the Power BI navigation pane, in Datasets, select a dataset > Open Menu > Schedule Refresh.

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

Para obter informações adicionais sobre como solucionar problemas de cenários de atualização, examine o artigo Solução de problemas de cenários de atualização.For additional information about troubleshooting refresh scenarios, take a look at the Troubleshooting Refresh Scenarios article.

Próximas etapasNext steps

Definindo as configurações de proxy dos gateways do Power BIConfiguring proxy settings for the Power BI gateways
Gateway de dados localOn-premises data gateway
Detalhes sobre o gateway de dados localOn-premises data gateway - in-depth
Gerenciar sua fonte de dados – Analysis ServicesManage your data source - Analysis Services
Gerenciar sua fonte de dados – SAP HANAManage your data source - SAP HANA
Gerenciar sua fonte de dados – SQL ServerManage your data source - SQL Server
Gerenciar sua fonte de dados – Importar/Atualização agendadaManage your data source - Import/Scheduled refresh
Mais perguntas?More questions? Experimente a Comunidade do Power BITry the Power BI Community