Importar dados de um banco de dados usando a consulta de banco de dados nativa

O Power Query oferece a flexibilidade de importar dados de uma ampla variedade de bancos de dados compatíveis. Ele pode executar consultas de banco de dados nativas, o que pode economizar o tempo necessário para criar consultas usando a interface do Power Query. Esse recurso é especialmente útil para usar consultas complexas que já existem e que talvez você não queira nem saiba como recriar usando a interface do Power Query.

Observação

Uma das intenções das consultas de banco de dados nativas é ser livre de efeitos colaterais. No entanto, o Power Query não garante que a consulta não afetará o banco de dados. Se você executar uma consulta de banco de dados nativa escrita por outro usuário, será indagado se está ciente das consultas que serão avaliadas com suas credenciais. Para obter mais informações, confira Segurança de consulta de banco de dados nativa.

O Power Query permite especificar sua consulta de banco de dados nativo em uma caixa de texto em Opções avançadas ao se conectar a um banco de dados. No exemplo abaixo, você importará dados de um banco de dados do SQL Server usando uma consulta de banco de dados nativa inserida na caixa de texto Instrução SQL. O procedimento é semelhante em todos os outros bancos de dados com consulta de banco de dados nativa às quais o Power Query dá suporte.

1. Conecte-se a um banco de dados do SQL Server usando o Power Query. Selecione a opção Banco de dados do SQL Server na seleção de conector.

2. Na janela pop-up do banco de dados do SQL Server:

   1. Especifique o Servidor e o Banco de Dados do qual você deseja importar dados usando a consulta de banco de dados nativa.

   2. Em Opções avançadas, selecione o campo Instrução SQL e cole ou insira sua consulta de banco de dados nativa e selecione OK.

      

3. Se essa for a primeira vez que você estiver se conectando a esse servidor, verá um prompt para selecionar o modo de autenticação para se conectar ao banco de dados. Selecione um modo de autenticação apropriado e continue.

   Observação

   Se você não tiver acesso à fonte de dados (Servidor e Banco de dados), verá um prompt para solicitar acesso ao servidor e ao banco de dados (se as informações de solicitação de acesso à fonte de dados forem especificadas no Power BI).

4. Se a conexão for estabelecida, os dados resultantes serão retornados no Editor do Power Query.

   Modele os dados conforme preferir e selecione Aplicar e Fechar para salvar as alterações e importar os dados.

Conectores que dão suporte a consultas de banco de dados nativas

Os conectores do Power Query a seguir dão suporte a consultas de banco de dados nativas.

Conector	Tipo de consulta de banco de dados nativa
Amazon Redshift	SQL statement
Banco de Dados do Azure Analysis Services	Consulta MDX ou DAX
Banco de Dados do Azure para PostgreSQL	SQL statement
Azure Cosmos DB	SQL statement
Azure Synapse Analytics	SQL statement
Banco de dados SQL do Azure	SQL statement
DataWorld.Dataset	dwSQL
Dataverse	SQL statement
Essbase	Instrução MDX
FHIR	Pesquisa de FHIR
BigQuery do Google	SQL statement
Banco de dados IBM Db2	SQL statement
Banco de dados IBM Informix (Beta)	SQL statement
Banco de dados MySQL	SQL statement
ODBC	SQL statement
OLE DB	SQL statement
Oracle database	SQL statement
PostgreSQL	SQL statement
Banco de dados do SAP HANA	SQL statement
Snowflake	SQL statement
Banco de dados do SQL Server Analysis Services	Consulta MDX ou DAX
Banco de dados SQL Server	SQL statement
Virtualização de dados TIBCO(R) (Beta)	SQL statement
Vena (Beta)	Consulta de Modelo (MQL)

Limitações e problemas

Antes de usar a consulta de banco de dados nativa, você deve estar ciente das limitações e problemas que poderão ocorrer.

Dobragem de consultas

A dobra de consultas ao usar uma consulta de banco de dados nativa é limitada a apenas um determinado número de conectores do Power Query. Para obter mais informações, vá para Dobramento de consultas em consultas nativas.

Segurança da consulta de banco de dados nativa

Às vezes, quando você tenta usar uma consulta criada por outro usuário ou por meio do Editor Avançado ou da barra de fórmulas (essencialmente qualquer outro caminho fora das caixas de diálogo de conector em que a caixa de entrada da consulta nativa é mostrada) você poderá receber uma mensagem com o seguinte:

Se você vir essa mensagem, selecione Editar Permissão. Essa seleção abrirá a caixa de diálogo Consulta de Banco de Dados Nativa. Você terá a oportunidade de executar a consulta de banco de dados nativa ou cancelar a consulta.

Por padrão, se você executar uma consulta de banco de dados nativa fora das caixas de diálogo de conector, será solicitado sempre que executar um texto de consulta diferente para garantir que a consulta que será executada seja aprovada por você.

Observação

Consultas de banco de dados nativas que você insere em sua operação para obter dados não perguntarão se você deseja executar a consulta ou não. Elas vão simplesmente ser executadas.

Você pode desativar as mensagens de segurança de consultas de banco de dados nativas se a consulta for executada no Power BI Desktop ou no Excel. Para desativar as mensagens de segurança:

1. Se você estiver usando Power BI Desktop, na guia Arquivo, selecione Opções e configurações > Opções.

   Se você estiver usando o Excel, na guia Dados, selecione Obter Dados > Opções de Consulta.

2. Em configurações Globais, selecione Segurança.

3. Desmarque Exigir aprovação do usuário para novas consultas do banco de dados nativas.

4. Selecione OK.

Você também pode revogar a aprovação de todas as consultas de banco de dados nativas aprovadas anteriormente para uma determinada fonte de dados no Power BI Desktop ou no Excel. Para revogar a aprovação:

1. Se você estiver usando o Power BI Desktop, na guia Arquivo, selecione Opções e configurações > Configurações da fonte de dados.

   Se você estiver usando o Excel, na guia Dados, selecione Obter Dados > Configurações da Fonte de Dados.

2. Na caixa de diálogo Configurações da Fonte de Dados, selecione Permissões globais. Em seguida, selecione a fonte de dados que contém as consultas de banco de dados nativas cujas aprovações você deseja revogar.

3. Selecione Editar permissões.

4. Na caixa de diálogo Editar permissões, em Consultas de Banco de Dados Nativas, selecione Revogar Aprovações.