Guia passo a passo sobre como definir suas configurações de proxy

  • Artigo

Se o seu ambiente de trabalho exigir que o gateway de dados local da Microsoft passe por um servidor proxy para se conectar ao serviço, siga as etapas abaixo para definir as configurações de proxy.

Definir configurações de proxy

  1. Crie seu elemento de definição de proxy. Para saber mais sobre a configuração dos elementos proxy para arquivos de configuração .NET, vá para defaultProxy Element (Network settings).

    O exemplo a seguir roteia todas as solicitações por meio de um proxy específico com o endereço IP 192.168.0.1 na porta 8888:

    <defaultProxy useDefaultCredentials="true">
    <proxy  
        autoDetect="false"  
        proxyaddress="http://192.168.0.1:8888"
        bypassonlocal="false"
        usesystemdefault="false"
    />
</defaultProxy>

  2. Procure na pasta de instalação o gateway de dados local, por exemplo, *C:\Arquivos de Programas\Gateway de dados local*.

  3. Abra o primeiro arquivo usado para as telas de configuração que configuram o gateway, ou seja, EnterpriseGatewayConfigurator.exe.config.

  4. Localize o elemento e substitua-o defaultProxy pela configuração de proxy criada na etapa 1 acima e salve as alterações no arquivo.

  5. Abra o segundo arquivo usado para o serviço real do Windows que interage com o serviço de nuvem usando o gateway e lida com as solicitações, ou seja, Microsoft.PowerBI.EnterpriseGateway.exe.config e repita a etapa 4.

  6. Para o terceiro arquivo de configuração usado para o gateway se conectar às fontes de dados — normalmente fontes de dados na nuvem — abra a subpasta m na pasta de instalação e, em seguida, o arquivo Microsoft.Mashup.Container.NetFX45.exe.config. Repita a etapa 4 para inserir a configuração de proxy neste arquivo.

    Se o arquivo estiver no estado padrão, você precisará adicionar a tag , juntamente com a system.net definição de proxy, como no exemplo a seguir:

    <system.net>
    <defaultProxy useDefaultCredentials="true">
        <proxy  
            autoDetect="false"  
            proxyaddress="http://192.168.0.1:8888"
            bypassonlocal="false"
            usesystemdefault="false"
        />
    </defaultProxy>
</system.net>

  7. Abra o aplicativo de gateway de dados local, navegue até a guia Configurações de Serviço e selecione Reiniciar agora para reiniciar o serviço de Gateway e aplicar as novas configurações de proxy.

Verificar a configuração de proxy consistente

  1. Verifique se você está executando a versão de setembro de 2022 ou superior.

  2. Abra o aplicativo de gateway de dados local.

  3. Navegue até a guia Diagnóstico .

  4. Em Teste de portas de rede, selecione Iniciar novo teste.

  5. Quando o teste de portas de rede estiver concluído, selecione Abrir os últimos resultados do teste concluído.

  6. Se a configuração de proxy for consistente entre os três arquivos de configuração necessários, uma Proxy configuration : Proxy settings match for all Gateway process configurations. mensagem será exibida.

  7. Caso contrário, se a configuração de proxy não for consistente, as seguintes informações serão exibidas:

    Proxy configuration : Proxy settings are not consistent. Please ensure that the proxy configuration matches across the files listed below:
C:\Program Files\On-premises data gateway\EnterpriseGatewayConfigurator.exe.config
C:\Program Files\On-premises data gateway\Microsoft.PowerBI.EnterpriseGateway.exe.config
C:\Program Files\On-premises data gateway\m\Microsoft.Mashup.Container.NetFX45.exe.config
Review <https://docs.microsoft.com/data-integration/gateway/service-gateway-proxy>  for additional information about configuring proxies for the Gateway.

Ao executar a verificação de consistência da configuração de proxy a partir de um gateway de dados local (modo pessoal), os seguintes arquivos de configuração serão verificados:

%LocalAppData%\Microsoft\Gateway de dados local (modo pessoal)\PersonalGatewayConfigurator.exe.config %LocalAppData%\Microsoft\Gateway de dados local (modo pessoal)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config %LocalAppData%\Microsoft\Gateway de dados local (modo pessoal)\m\Microsoft.Mashup.Container.NetFX45.exe.config

Comportamentos de configuração de proxy inconsistentes ou ausentes

Se a definição de proxy estiver ausente ou inconsistente, você poderá experimentar comportamentos diferentes com seu gateway de dados local. Eis alguns exemplos:

  • Um modelo semântico ou falha de atualização de fluxo de dados, exemplo de mensagem de erro: Error: Unable to connect to the remote server.
  • Ao iniciar no gateway de dados local, você não consegue entrar, o prompt de entrada aparece, mas seu conteúdo não pode ser exibido ou uma página de mensagem de erro é exibida.
  • Os resultados do teste da Porta de Rede relatam falhas de conexão com os servidores.

Próximos passos