Partilhar via


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

Se o seu ambiente de trabalho exigir que um gateway de dados local da Microsoft passe por um servidor proxy para se conectar ao serviço, use as etapas a seguir 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 defaultProxy elemento e substitua-o pela configuração de proxy criada na etapa 1 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 system.net tag , 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 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.
    

Quando você executa a verificação de consistência da configuração de proxy de um gateway de dados local (modo pessoal), os seguintes arquivos de configuração sã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 inconsistente, você poderá experimentar comportamentos diferentes com seu gateway de dados local. Alguns exemplos são:

  • 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 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 de conexão com os servidores.