SQL Server

Resumo

Item	Description
Estado de Lançamento	Disponibilidade Geral
Produtos	Excel Power BI (modelos semânticos) Power BI (Fluxos de Dados) Malha (Dataflow Gen2) Power Apps (Fluxos de Dados) Dynamics 365 Customer Insights Analysis Services
Tipos de autenticação suportados	Base de Dados (Nome de Utilizador/Palavra-passe) Windows Conta organizacional (se o servidor especificado oferecer suporte a ela)
Referência da função M	Sql.Database Sql.Databases

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.

Capacidades suportadas

• Importar
• 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 utilizando hierarquia completa
  • Suporte a failover do SQL Server

Ligar à base de dados do SQL Server a partir do Power Query Desktop

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

1. Selecione a opção de banco de dados do SQL Server na seleção do conector.

2. Na caixa de diálogo do banco de dados do SQL Server exibida, forneça o nome do servidor e do banco de dados (opcional).

   

3. Selecione o modo de conectividade de dados Importar ou DirectQuery (somente Power BI Desktop).

4. Selecione OK.

5. Se você estiver se conectando a esse banco de dados pela primeira vez, selecione o tipo de autenticação, insira suas credenciais e selecione o nível ao qual aplicar as configurações de autenticação. Em seguida, selecione Conectar.

   

   Nota

   Se a ligação não estiver encriptada, ser-lhe-á apresentada a seguinte caixa de diálogo.

   

   Selecione OK para se conectar ao banco de dados usando uma conexão não criptografada ou siga estas instruções para configurar conexões criptografadas com o SQL Server. Além disso, quando a criptografia estiver habilitada para servidores SQL usando certificados autoassinados, revise esta seção para adicionar os servidores SQL à lista de confiança do cliente Power Query Desktop.

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 Power Query Editor.

   

Ligar à base de dados do SQL Server a partir do Power Query Online

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

1. Selecione a opção de banco de dados do SQL Server na seleção do conector.

2. Na caixa de diálogo do banco de dados do SQL Server exibida, forneça o nome do servidor e do banco de dados (opcional).

   

3. Se o servidor SQL não estiver online, selecione um gateway de dados local. Além disso, se estiver usando a porta com servername, use o valor servername* como o nome do servidor nas configurações de conexão.

4. Se você estiver se conectando a esse banco de dados pela primeira vez, selecione o tipo de autenticação e insira suas credenciais.

5. Se a conexão não estiver criptografada e a caixa de diálogo de conexão contiver uma caixa de seleção Usar Conexão Criptografada , desmarque a caixa de seleção.

6. Selecione Seguinte para continuar.

7. No Navegador, selecione os dados necessários e, em seguida, selecione Transformar dados.

   

Conecte-se usando opções avançadas

Tanto o Power Query Desktop como o Power Query Online fornecem 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 e no Power Query Online.

Opção avançada	Description
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.
SQL statement	Para obter informações, vá para Importar dados de um banco de dados usando consulta de banco de dados nativa.
Incluir colunas de relação	Se estiver marcada, inclui colunas que podem ter relações com outras tabelas. Se essa caixa estiver desmarcada, você não poderá ver essas colunas.
Navegar utilizando 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 Navigator apresenta apenas as tabelas cujas colunas e linhas contêm dados.
Ativar o suporte de Ativação Pós-falha do SQL Server	Se estiver marcada, quando um nó no grupo de failover do SQL Server não estiver disponível, o Power Query será movido desse nó para outro quando ocorrer failover. Se estiver limpo, não ocorrerá failover.

Depois de selecionar as opções avançadas necessárias, selecione OK no Power Query Desktop ou Avançar no Power Query Online para se conectar ao banco de dados do SQL Server.

Limitações

O certificado do SQL Server não é confiável no cliente (Power BI Desktop ou gateway de dados local)

Ao estabelecer uma conexão com um SQL Server local usando o gateway de dados local ou o Power BI Desktop e o SQL Server utiliza um certificado autoassinado, é possível que a operação de atualização para um modelo semântico de malha ou fluxo de dados possa falhar com a seguinte mensagem de erro:

Microsoft SQL: A connection was successfully established with the server, but then an error occurred during the login process. (provider: SSL Provider, error: 0 - The certificate chain was issued by an authority that is not trusted.)

Para solucionar esse erro ao usar o gateway de dados local, altere as configurações do gateway para atualizar a configuração usando as SqlTrustedServers seguintes etapas:

1. Na máquina local onde o gateway de dados local está instalado, navegue até C:\Arquivos de Programas\Gateway de dados local.

2. Faça um backup do arquivo de configuração chamado Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.

3. Abra o arquivo de configuração Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config original e localize a SqlTrustedServers entrada.

4. Atualize o SqlTrustedServers valor com os nomes dos servidores SQL nos quais confiar e se conectar.

   O valor contém uma lista delimitada por vírgulas de nomes de servidor e suporta * como um curinga. Assim, por exemplo, no seguinte exemplo:

   <setting name="SqlTrustedServers" serializeAs="String"> <value>contososql*,mysvr</value> </setting>

   o valor contososql*,mysvr corresponde a contososql6, contososqlazuree , mas mysvrnão corresponde a mysvr.microsoft.com.

Para solucionar esse erro ao usar o Power BI Desktop, modifique o valor da variável PBI_SQL_TRUSTED_SERVERS de ambiente para incluir os SQL Servers. Os valores suportados são os mesmos descritos para a configuração do gateway (conforme descrito na etapa 4 acima).

Para conexões com o SQL Server a partir do Power BI Desktop e versões de gateway de dados local a partir de fevereiro de 2024 ou posterior, siga uma destas opções:

• Siga a solução mencionada anteriormente para adicionar a variável PBI_SQL_TRUSTED_SERVERSde ambiente.
• Peça aos administradores SQL para adquirir um certificado de uma autoridade de certificação conhecida.
• Altere a configuração SqlTrustedServers no arquivo de configuração do gateway.

Colunas sempre encriptadas

O Power Query não suporta colunas 'Sempre encriptadas'.

Autenticação do Microsoft Entra ID

A autenticação do Microsoft Entra ID (conta organizacional) só é suportada no conector do SQL Server se o servidor especificado também oferecer suporte à autenticação do Microsoft Entra ID. Caso contrário, você pode encontrar um erro "O método de autenticação OAuth não é suportado nesta fonte de dados".

Observe que, no serviço Power BI, o método de autenticação do Microsoft Entra ID aparece como "OAuth2".

Próximos passos

Otimizar o Power Query ao expandir colunas de tabela