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

  • Artigo

Se o seu ambiente de trabalho requerer 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 de elementos de proxy nos arquivos de configuração .NET, acesse Elemento defaultProxy (configurações de rede).

    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 ou na porta 8888:

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

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

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

  4. Localize o elemento defaultProxy e o substitua por sua configuração de proxy criada na etapa 1 acima. A seguir, salve as alterações do arquivo.

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

  6. Para o terceiro arquivo de configuração sendo usado para o gateway se conectar às fontes de dados — de modo geral 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 nesse arquivo.

    Se o arquivo estiver no estado padrão, você precisará adicionar a tag system.net juntamente com a 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 do Serviço e selecione Reiniciar agora para reiniciar o serviço de Gateway e aplicar as novas configurações de proxy.

Verificar se há uma 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. Após o teste de portas de rede ter sido concluído, selecione Abrir os resultados do último teste concluído.

  6. Se sua configuração de proxy for consistente nos três arquivos de configuração obrigatórios, uma mensagem Proxy configuration : Proxy settings match for all Gateway process configurations. 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.

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

%LocalAppData%\Microsoft\On-premises data gateway (personal mode)\PersonalGatewayConfigurator.exe.config %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\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 for inconsistente, você poderá experimentar comportamentos diferentes com seu gateway de dados local. Estes são alguns exemplos:

  • Um modelo semântico ou falha na atualização do fluxo de dados, exemplo de mensagem de erro: Error: Unable to connect to the remote server.
  • Ao iniciar o 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 ao se conectar aos servidores.

Próximas etapas