PostgreSQL

Resumo

Pré-requisitos

Power BI Desktop inclui o provedor Npgsql para o conector do PostgreSQL desde dezembro de 2019, eliminando a necessidade de mais instalações. A partir da versão de outubro de 2024, ela incorpora o Npgsql versão 4.0.17. A instalação do Npgsql GAC separada substitui essa versão padrão.

O conector PostgreSQL é compatível para conexão em nuvem e por meio de um gateway de dados de rede virtual ou de um gateway de dados local. Desde a versão de junho de 2025, o gateway de dados local inclui o provedor Npgsql, portanto, nenhuma instalação extra é necessária. A instalação do Npgsql GAC separada substitui essa versão padrão.

Para versões do Power BI Desktop lançadas antes de dezembro de 2019 e do gateway de dados local lançado antes de junho de 2025, você deve instalar o provedor Npgsql em seu computador local para usar o conector PostgreSQL. Para instalar o provedor Npgsql, acesse a página de versões da versão 4.0.17, baixe e execute o arquivo .msi. A arquitetura do provedor (32 bits ou 64 bits) precisa corresponder à arquitetura do produto em que você pretende usar o conector. Ao instalar, selecione a Instalação do Npgsql GAC para garantir que o Npgsql em si seja adicionado ao computador. Não há suporte para npgsql 4.1 ou posterior devido a incompatibilidades de versão .NET.

Capacidades Suportadas

• Importação
• DirectQuery (modelos semânticos Power BI)
• Opções avançadas
  • Tempo limite de comando em minutos
  • Instrução SQL nativa
  • Colunas de relação
  • Navegar usando a hierarquia completa

Conectar-se a um banco de dados PostgreSQL do Power Query Desktop

Depois que o provedor Npgsql correspondente for instalado, você poderá se conectar a um banco de dados PostgreSQL. Para fazer a conexão, execute as seguintes etapas:

1. Selecione a opção de banco de dados PostgreSQL na seleção do conector. Para obter mais informações, acesse Onde obter dados.

2. Na caixa de diálogo Banco de dados PostgreSQL exibida, forneça o nome do servidor e do banco de dados.

   

3. Selecione o modo de conectividade de dados Importar ou DirectQuery.

4. Se você estiver se conectando a esse banco de dados pela primeira vez, selecione o tipo de autenticação que deseja usar e insira suas credenciais. Os tipos de autenticação disponíveis são:

   • Banco de dados (nome de usuário e senha)
   • Conta da Microsoft (Microsoft Entra ID)

   Para ter mais informações sobre a autenticação, acesse Autenticação com uma fonte de dados.

   

5. Se a conexão não estiver criptografada, você será solicitado a receber a mensagem a seguir.

   

   Selecione OK para se conectar ao banco de dados usando uma conexão não criptografada. Se uma conexão criptografada for desejada, o servidor PostgreSQL deverá ser configurado para acomodar conexões SSL (acesse a documentação do PostgreSQL para obter diretrizes). Depois de concluído, talvez seja necessário que você instale o certificado SSL do servidor PostgreSQL nas suas Autoridades de Certificação Raiz Confiáveis.

6. Em Navigator, selecione as informações de banco de dados desejadas e selecione Load para carregar os dados ou Transform Data para continuar transformando os dados no editor de Power Query.

   

Conectar-se a um banco de dados PostgreSQL do Power Query Online

Para fazer a conexão, execute as seguintes etapas:

1. Selecione a opção de banco de dados PostgreSQL na seleção do conector. Para obter mais informações, acesse Onde obter dados.

2. Na caixa de diálogo Banco de dados PostgreSQL exibida, forneça o nome do servidor e do banco de dados.

   

3. Selecione o nome do gateway de dados local que você deseja usar.

4. Selecione o tipo de autenticação Básico e insira suas credenciais do PostgreSQL nas caixas de Nome de Usuário e Senha.

5. Se a conexão não estiver criptografada, desmarque Use Conexão Criptografada.

6. Selecione Próximo para se conectar ao banco de dados.

7. Em Navigator, selecione os dados necessários e selecione Transform data para transformar os dados no editor de Power Query.

Conectar-se usando opções avançadas

Power Query Desktop fornece um conjunto de opções avançadas que você pode adicionar à consulta, se necessário.

A tabela a seguir lista todas as opções avançadas que você pode definir no Power Query Desktop.

Depois de selecionar as opções avançadas necessárias, selecione OK no Power Query Desktop para se conectar ao banco de dados PostgreSQL.

Dobragem de consultas nativa

Por padrão, a dobragem de consultas nativa está habilitada. As operações com capacidade de dobragem são aplicadas acima da consulta nativa de acordo com a lógica de Importação ou Consulta Direta normal. A dobragem de consulta nativa não é aplicável com parâmetros opcionais presentes em Value.NativeQuery.

No raro caso em que o processo de agregação não funcione com a agregação de consultas nativas habilitada, você pode desativá-la. Para desabilitar a dobragem de consultas nativas, defina o sinalizador EnableFolding como false para Value.NativeQuery() no editor avançado.

Exemplo: Value.NativeQuery(target as any, query, null, [EnableFolding=false])

Solução de problemas

Sua consulta nativa pode gerar o seguinte erro:

We cannot fold on top of this native query. Please modify the native query or remove the 'EnableFolding' option.

Uma etapa básica de solução de problemas é verificar se a consulta em Value.NativeQuery lança o mesmo erro com uma limit 1 cláusula em torno dela:

select * from (query) _ limit 1