PostgreSQL

Resumo

Iteme	Descrição
Estado do Lançamento	Disponibilidade Geral
Produtos	Excel Power BI (modelos semânticos) Power BI (Fluxos de Dados) Infraestrutura (Dataflow Gen2) Power Apps (Fluxos de Dados) Dynamics 365 Customer Insights Serviços de análise
Tipos de autenticação suportados	Base de Dados (Nome de Utilizador/Palavra-passe)
Documentação de referência da função	PostgreSQL.Database

Observação

Alguns recursos podem estar presentes em um produto, mas não em outros devido a agendas de implantação e recursos específicos do host.

Pré-requisitos

O Power BI Desktop inclui o provedor Npgsql para conector PostgreSQL desde dezembro de 2019, eliminando a necessidade de instalação adicional. A partir da versão de outubro de 2024, incorpora a versão 4.0.17 do Npgsql. A instalação separada do Npgsql GAC substituirá essa versão padrão.

O conector PostgreSQL é suportado para conexão à nuvem e através do gateway de dados VNet ou do gateway de dados no 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 separada do Npgsql GAC substituirá essa versão padrão.

Para versões do Power BI Desktop lançadas antes de dezembro de 2019 e gateway de dados local lançado antes de junho de 2025, você deve instalar o provedor Npgsql em sua máquina local para usar o conector PostgreSQL. Para instalar o provedor Npgsql, vá para 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 onde você pretende usar o conector. Ao instalar, certifique-se de selecionar Npgsql GAC Installation para garantir que o próprio Npgsql seja adicionado à sua máquina. Npgsql 4.1 e superior não são suportados devido a incompatibilidades de versão do .NET.

Capacidades suportadas

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

Ligar a uma base de dados PostgreSQL a partir do Power Query Desktop

Depois que o provedor Npgsql correspondente estiver instalado, você poderá se conectar a um banco de dados PostgreSQL. Para estabelecer a ligação, siga os seguintes passos:

1. Selecione a opção de banco de dados PostgreSQL na seleção do conector. Para obter mais informações, vá para 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 Import ou DirectQuery .

4. Se você estiver se conectando a esse banco de dados pela primeira vez, insira suas credenciais PostgreSQL nas caixas Nome de usuário e Senha do tipo de autenticação Banco de dados . Selecione o nível ao qual aplicar as configurações de autenticação. Em seguida, selecione Conectar.

   

   Para obter mais informações sobre como usar métodos de autenticação, vá para Autenticação com uma fonte de dados.

5. Se a ligação não estiver encriptada, ser-lhe-á apresentada a seguinte mensagem.

   

   Selecione OK para se conectar ao banco de dados usando uma conexão não criptografada ou siga as instruções em Habilitar conexões criptografadas com o Mecanismo de Banco de Dados para configurar conexões criptografadas com o banco de dados PostgreSQL.

6. No Navegador, selecione as informações da base de dados que pretende e, em seguida, selecione Carregar para carregar os dados ou Transformar Dados para continuar a transformar os dados no editor do Power Query.

   

Ligar a uma base de dados PostgreSQL a partir do Power Query Online

Para estabelecer a ligação, siga os seguintes passos:

1. Selecione a opção de banco de dados PostgreSQL na seleção do conector. Para obter mais informações, vá para 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ásica e insira suas credenciais PostgreSQL nas caixas Nome de usuário e Senha .

5. Se a sua ligação não estiver encriptada, desmarque Utilizar Ligação Encriptada.

6. Selecione Avançar para conectar-se ao banco de dados.

7. No Navegador, selecione os dados de que necessita e, em seguida, selecione Transformar dados para transformar os dados no editor do Power Query.

Conecte-se usando opções avançadas

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

A tabela seguinte lista todas as opções avançadas que pode definir no Power Query Desktop.

Opção avançada	Descrição
Tempo limite do comando em minutos	Se a sua ligação durar mais de 10 minutos (o tempo limite predefinido), pode introduzir outro valor em minutos para manter a ligação aberta por mais tempo. Esta opção só está disponível no Power Query Desktop.
instrução SQL	Para obter informações, vá para Importar dados de um banco de dados usando consulta de banco de dados nativa.
Incluir colunas de relacionamento	Se estiver marcada, inclui colunas que podem ter relações com outras tabelas. Se essa caixa estiver desmarcada, essas colunas não serão exibidas.
Navegar usando hierarquia completa	Se estiver marcada, o navegador exibirá a hierarquia completa de tabelas no banco de dados ao qual você está se conectando. Se estiver desmarcado, o navegador exibe apenas as tabelas cujas colunas e linhas contêm dados.

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

Dobragem de consulta nativa

Por predefinição, o dobramento de consultas nativas está ativado. As operações que podem ser agrupadas são aplicadas sobre a sua consulta nativa segundo a lógica normal de Importação ou Consulta Direta. O dobramento de consulta nativo não é aplicável com parâmetros opcionais presentes em Value.NativeQuery.

No caso raro em que a dobragem não funciona com a dobragem de consulta nativa ativada, você pode desativá-la. Para desativar a pregagem de consulta nativa, atribua ao EnableFolding sinalizador o valor 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 gera o mesmo erro com uma limit 1 cláusula ao redor:

select * from (query) _ limit 1