PostgreSQL
Resumo
| Item | Descrição |
|---|---|
| Estado da versão | Disponibilidade geral |
| Produtos | Excel Power BI (modelos semânticos) Power BI (fluxos de dados) Fabric (Dataflow Gen2) Power Apps (fluxos de dados) Dynamics 365 Customer Insights Analysis Services (Serviços de Análise) |
| Tipos de autenticação com suporte | Banco de dados (nome de usuário/senha) |
| Documentação de referência de função | PostgreSQL.Database |
Nota
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
Desde dezembro de 2019, o Power BI Desktop é fornecido com o NpgSQL e nenhuma instalação adicional é necessária. A partir da versão de outubro de 2024, o NpgSQL 4.0.17 é a versão incluída. A Instalação GAC substitui a versão fornecida com o Power BI Desktop, que é 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 o PostgreSQL para acesso direto da Internet. Se o PostgreSQL estiver configurado para que ele não possa ser acessado diretamente pela 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.17 é usado, enquanto a atualização local usa a instalação local do NpgSQL, se disponível, e, caso contrário, usa o NpgSQL 4.0.17.
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 , pesquise a versão v4.0.x mais recente 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, selecione a Instalação do NpgSQL GAC para garantir que o NpgSQL em si seja adicionado ao seu computador.
Recomendamos o NpgSQL 4.0.17. O NpgSQL 4.1 ou posterior não funcionará devido a incompatibilidades de versão do .NET.
Para o 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. Baixar e executar o instalador (o arquivo NpgSQL-[número de versão].msi). Verifique se você selecionou a Instalação do GAC do NpgSQL e, ao concluir, reinicie seu computador para que essa instalação entre em vigor.
Capacidades Suportadas
- Importação
- DirectQuery (modelos semânticos do 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:
Selecione a opção de banco de dados PostgreSQL na seleção do conector.
Na caixa de diálogo Banco de dados PostgreSQL exibida, forneça o nome do servidor e do banco de dados.
Selecione o modo de conectividade de dados Importar ou DirectQuery.
Se esta for a primeira vez que você estiver se conectando a esse banco de dados, insira suas credenciais do PostgreSQL nas caixas de nome de usuário
e senha do tipo de autenticação do 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, acesse Autenticação com uma fonte de dados.
Nota
Se a conexão não estiver criptografada, você será solicitado com a mensagem a seguir.
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 para o mecanismo de banco de dados para configurar conexões criptografadas com o banco de dados PostgreSQL.
No Navigator, selecione as informações de banco de dados desejadas e selecione Carregar para carregar os dados ou Transformar Dados para continuar transformando os dados no 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:
Selecione a opção de banco de dados PostgreSQL na seleção do conector.
Na caixa de diálogo Banco de dados PostgreSQL exibida, forneça o nome do servidor e do banco de dados.
Selecione o nome do gateway de dados local que você deseja usar.
Selecione o tipo de autenticação Básico e insira suas credenciais do PostgreSQL nas caixas de Nome de Usuário e Senha.
Se a conexão não estiver criptografada, desmarque Use Conexão Criptografada.
Selecione Próximo para se conectar ao banco de dados.
No Navegador, selecione os dados necessários e selecione Transformar dados para transformar os dados no Editor do Power Query.
Conectar-se 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 de comando em minutos | Se a 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. Essa opção só está disponível no Power Query Desktop. |
| Instrução SQL | Para obter informações, acesse Importar dados de um banco de dados usando consulta de banco de dados nativa. |
| Incluir colunas de relação | Caso esteja marcada, inclui colunas que podem ter relações com outras tabelas. Se essa caixa estiver desmarcada, você não verá essas colunas. |
| Navegar usando a hierarquia completa | Se marcada, o navegador exibirá a hierarquia completa de tabelas no banco de dados ao qual você está se conectando. Se estiver limpo, o navegador mostra 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 os 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 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 resolução de problemas é verificar se a consulta em Value.NativeQuery() lança o mesmo erro com uma cláusula limit 1 ao redor.
select * from (query) _ limit 1