PostgreSQL

Resumo

Pré-requisitos

O Power BI Desktop inclui o fornecedor Npgsql para o conector PostgreSQL desde dezembro de 2019, eliminando a necessidade de mais instalações. A partir da versão de outubro de 2024, incorpora a versão 4.0.17 do Npgsql. Uma instalação separada de Npgsql GAC sobrepõe-se a esta versão predefinida.

O conector PostgreSQL é suportado para ligação à cloud, seja através de um gateway de dados de rede virtual ou um gateway de dados em locais. Desde a versão de junho de 2025, o gateway de dados local inclui o provedor Npgsql, portanto, nenhuma instalação extra é necessária. Uma instalação separada de Npgsql GAC sobrepõe-se a esta versão predefinida.

Para as versões do Power BI Desktop lançadas antes de dezembro de 2019 e para o data gateway local lançado antes de junho de 2025, deve instalar o fornecedor Npgsql na sua máquina local para usar o conector PostgreSQL. Para instalar o fornecedor Npgsql, vá à página de lançamentos da versão 4.0.17, descarregue e execute o ficheiro .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. O Npgsql 4.1 e versões posteriores não são suportados devido a incompatibilidades com a 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

Ligue-se 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, selecione o tipo de autenticação que deseja usar e insira suas credenciais. Os tipos de autenticação disponíveis são:

   • Base de dados (Nome de utilizador e palavra-passe)
   • Conta Microsoft (Microsoft Entra ID)

   Para obter mais informações sobre 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. Se uma conexão criptografada for desejada, o servidor PostgreSQL deve ser configurado para acomodar conexões SSL (vá para a documentação do PostgreSQL para obter orientação). Uma vez concluída, sua máquina pode ser obrigada a instalar o certificado SSL do servidor PostgreSQL em suas Autoridades de Certificação Raiz Confiáveis.

6. Em Navigator, selecione a informação da base de dados que pretende e depois selecione Load para carregar os dados ou Transform Data para continuar a transformar os dados no Power Query editor.

   

Ligue-se 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. Em Navigator, selecione os dados que necessita e depois selecione Transform data para transformar os dados no Power Query editor.

Conecte-se usando opções avançadas

O Power Query Desktop oferece 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.

Depois de selecionares as opções avançadas de que precisas, seleciona OK no Power Query Ambiente de Trabalho para te ligares à tua base 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