PostgreSQL

Resumo

Item	Descrição
Estado da liberação	Disponibilidade geral
Produtos	Excel Power BI (Modelos semânticos) Power BI (Fluxos de dados) Malha (fluxo de dados Gen2) Power Apps (Fluxos de dados) Dynamics 365 Customer Insights Analysis Services
Tipos de autenticação compatíveis	Banco de dados (nome de usuário/senha)
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 cronogramas de implantação e funcionalidades específicas do host.

Pré-requisitos

A partir da versão de dezembro de 2019, o NpgSQL 4.0.10 é enviado com o Power BI Desktop e nenhuma instalação adicional é necessária. A Instalação do GAC substitui a versão fornecida com o Power BI Desktop, que será o padrão. A atualização tem suporte tanto por meio da nuvem no serviço do Power BI quanto no local por meio do gateway de dados local. Para atualizar dados do serviço do Power BI sem um gateway de dados local, o PostgreSQL deve ser hospedado de uma maneira que permita a conexão direta dos serviços do Power BI no Azure. Isso tem suporte nativo para PostgreSQL hospedado no Microsoft Azure. Para outros ambientes de hospedagem, consulte seu provedor de hospedagem sobre como configurar seu PostgreSQL para acesso direto da Internet. Se o PostgreSQL estiver configurado para que ele não possa ser acessado diretamente da Internet (recomendado para segurança), você precisará usar um gateway de dados local para atualizações. No serviço do Power BI, o NpgSQL 4.0.10 será usado, enquanto a atualização local usará a instalação local do NpgSQL, se disponível, e, caso contrário, usará o NpgSQL 4.0.10.

Para versões do Power BI Desktop lançadas antes de dezembro de 2019, você deve instalar o provedor NpgSQL em seu computador local. Para instalar o provedor NpgSQL, acesse a página de versões, procure v4.0.10 e 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, verifique se você selecionou a Instalação do GAC do NpgSQL para garantir que o próprio NpgSQL seja adicionado ao computador.

Recomendamos o NpgSQL 4.0.10. O NpgSQL 4.1 e versões superiores não funcionarão devido a incompatibilidades de versão do .NET.

Para Power Apps, você deve instalar o provedor NpgSQL em seu computador local. Para instalar o provedor NpgSQL, acesse a página de versões e baixe a versão relevante. Baixe e execute o arquivo do instalador (o NpgSQL-[número da versão].msi). Selecione a Instalação do NpgSQL GAC e, quando terminar, reinicie o computador para que essa instalação entre em vigor.

Funcionalidades com suporte

• Importação
• DirectQuery (Modelos semânticos do Power BI)
• Opções avançadas
  • Tempo limite do comando em minutos
  • Instrução de SQL nativa
  • Colunas do relacionamento
  • Navegar usando 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 banco de dados PostgreSQL na seleção do conector.

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

   

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

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

   

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

   Observação

   Se a conexão não estiver criptografada, você receberá 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.

5. No Navegador, selecione as informações de banco de dados e selecione Carregar para carregar os dados ou Transformar Dados para continuar transformando os dados em Editor do 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 banco de dados PostgreSQL na seleção do conector.

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

   

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 do PostgreSQL nas caixas Nome de usuário e Senha.

5. Se sua conexão não estiver criptografada, desmarque Usar Conexão Criptografada.

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

7. No Navegador, selecione os dados necessários e selecione Transformar dados para transformar os dados em Editor do Power Query.

Conectar usando opções avançadas

O 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.

Opção avançada	Descrição
Tempo limite do comando em minutos	Se a sua conexão durar mais de 10 minutos (o tempo limite padrão), você poderá inserir outro valor em minutos para manter a conexão aberta por mais tempo. Esta opção está disponível somente no Power Query Desktop.
Instrução SQL	Para obter mais informações, acesse Importar dados de um banco de dados usando a consulta natuva de banco de dados.
Adicionar colunas de relação	Se marcada, inclui colunas que podem ter relações com outras tabelas. Se essa caixa estiver desmarcada, você não verá essas colunas.
Navegar usando hierarquia completa	Se marcada, o navegador exibirá a hierarquia completa de tabelas no banco de dados ao qual você está se conectando. Se desmarcada, 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 banco de dados PostgreSQL.

Dobragem de consultas nativa

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

No caso raro de a dobra não funcionar com a dobragem de consultas nativa habilitada, você pode desabilitá-la. Para desabilitar a dobragem de consultas nativa, 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 disparo de problemas é verificar se a consulta em Value.NativeQuery() gera o mesmo erro com uma cláusula limit 1 em torno dela:

select * from (query) _ limit 1