Partilhar via


Conectar-se ao seu banco de dados SQL no Microsoft Fabric

Aplica-se a:Base de dados SQL no Microsoft Fabric

Você pode se conectar e consultar seu banco de dados SQL no Fabric das mesmas maneiras que o Banco de Dados SQL do Azure.

Prerequisites

Editor de consultas no portal do Fabric

Você pode se conectar ao banco de dados SQL usando o editor baseado na Web no portal Fabric.

O editor baseado na Web para banco de dados SQL no Fabric fornece um explorador de objetos fundamental e uma interface de execução de consulta. O menu Explorer integrado lista todos os objetos de banco de dados.

Um novo banco de dados SQL no Fabric abre automaticamente no editor da Web e um banco de dados existente pode ser aberto no editor da Web selecionando-o no Fabric.

Localizar cadeia de conexão SQL

No Microsoft Fabric, o endereço TDS para análise SQL e a base de dados SQL são acessíveis por meio de um fluxo de dados tabular, familiar a todas as aplicações Web modernas que interagem com um endereço TDS do SQL Server. Isso é conhecido como a cadeia de conexão SQL na interface do usuário do Microsoft Fabric.

A cadeia de conexão do banco de dados SQL é semelhante à cadeia de conexão do Banco de Dados SQL do Azure, <server-unique-identifer>.database.windows.net. A cadeia de conexão do ponto de extremidade da análise SQL se parece com <server-unique-identifier>.<tenant>.fabric.microsoft.com.

Para localizar a cadeia de conexão SQL para o seu Fabric SQL database:

  • Vá para as configurações do item do banco de dados SQL.
  • Ou, na lista de itens, selecione o ... menu. Selecione Configurações e, em seguida, Cadeias de conexão. O Fabric fornece cadeias de conexão completas para provedores, incluindo ADO.NET, JDBC, ODBC, PHP e Go.
  • Ou selecione o botão Abrir em e selecione SQL Server Management Studio ou Visual Studio Code. O nome do servidor e o nome do banco de dados são exibidos.

Para localizar a string de conexão SQL para o ponto de extremidade de análise SQL do seu banco de dados Fabric SQL:

  • Vá para as configurações do item do banco de dados SQL e selecione Cadeias de conexão.
  • Ou, selecione o ... menu e, em seguida, selecione Ponto de extremidade SQL e, em seguida, copie a cadeia de conexão SQL.

Botão Abrir para ligar

Você pode se conectar facilmente ao seu banco de dados SQL com o botão Abrir em no editor de consultas do portal Fabric. Escolha SQL Server Management Studio ou a extensão mssql com Visual Studio Code.

Captura de tela do editor de consultas do portal Fabric mostrando o botão Abrir em para conexões fáceis com o SSMS ou a extensão mssql no VS Code.

Conectar-se manualmente ao SQL Server Management Studio

Se a sua versão do SSMS for anterior a 21, o preenchimento automático de detalhes da conexão não é suportado após clicar em Abrir em. Ainda pode conectar-se manualmente fornecendo o seu servidor, base de dados e informações de autenticação.

Captura de ecrã das definições do SSMS.

No SQL Server Management Studio (SSMS):

  1. Na área do espaço de trabalho na carga de trabalho de Banco de Dados do Fabric, selecione a ... ao lado do banco de dados SQL.
  2. Selecione Configurações.
  3. Selecione Cadeias de conexão. Procure a cadeia de conexão com o seu banco de dados SQL, incluindo o Data Source=. Por exemplo, tcp:<servername>.database.fabric.microsoft.com,1433. O Initial Catalog= é o nome do banco de dados.
  4. No SSMS, abra uma nova conexão.
  5. Na caixa de diálogo Malha, copie o valor de Server Name e cole-o no nome do servidor.
  6. Escolha Tipo de autenticação : Microsoft Entra ID - Universal com suporte a MFA.
  7. Selecione Opções<<.
  8. Copie e cole o valor de Database Name na caixa de texto Conectar ao banco de dados.
  9. Selecione Conectar.
  10. Entre usando o Microsoft Entra ID - Universal com suporte a MFA.

Conecte-se com a extensão MSSQL para Visual Studio Code manualmente

Você também pode usar a experiência de navegação do Fabric na extensão MSSQL para VS Code. Esse recurso permite que os desenvolvedores se conectem perfeitamente ao banco de dados SQL no Fabric ou aos endpoints de análise SQL — sem copiar manualmente as cadeias de conexão do portal do Fabric ou confiar no botão Open in para se conectar diretamente ao banco de dados dentro do VS Code.

Captura de ecrã das definições de ligação do VS Code.

Conecte-se com o sqlcmd

Você pode se conectar ao seu banco de dados SQL no Fabric com sqlcmd, assim como qualquer outro produto do Mecanismo de Banco de Dados SQL. Use a autenticação do Microsoft Entra ID com a G opção. A autenticação do Microsoft Entra (-G) requer pelo menos a versão 13.1.

No exemplo a seguir, substitua <server name> pela longa cadeia de caracteres de texto exclusivo que representa seu banco de dados SQL na malha.

sqlcmd -S <your_server>.database.fabric.microsoft.com;1433 -G -d <your_database> -i ./script.sql

Conecte-se com o utilitário bcp

Você pode conectar-se ao seu banco de dados SQL no Fabric com o utilitário bcp, da mesma forma que com qualquer outro produto do Motor de Base de Dados SQL. Use a autenticação do Microsoft Entra ID com a -G opção.

No exemplo a seguir, substitua <server name> pela longa cadeia de caracteres de texto exclusivo que representa seu banco de dados SQL na malha.

bcp bcptest in "c:\temp\sample.dat" -S <your_server>.database.fabric.microsoft.com;1433 -d testdb -G -c

Conecte-se com o Python Notebook

Os Fabric Python Notebooks (visualização) oferecem a capacidade de executar código T-SQL com o comando T-SQL magic.

Nas etapas a seguir, conecte-se a um banco de dados SQL no Fabric usando o %%tsql comando magic:

  1. Crie um bloco de anotações em seu espaço de trabalho com a linguagem definida como Python.

  2. Em uma célula, use o comando %%tsql magic. O tipo de célula muda automaticamente para T-SQL.

    No exemplo a seguir, substitua <databasename> pelo nome do seu banco de dados SQL no Fabric. O -type parâmetro deve ser SQLDatabase.

    %%tsql -artifact <databasename> -type SQLDatabase
    

    Em seguida, inclua o comando T-SQL. Por exemplo, para executar uma consulta a partir de um banco de dados chamado Contoso:

    %%tsql -artifact Contoso -type SQLDatabase
    SELECT * FROM SalesLT.Customer;
    
  3. Você também pode vincular os resultados a um dataframe com o -bind argumento:

    %%tsql -artifact Contoso -type SQLDatabase -bind df2
    

Para obter mais possibilidades de consultar os seus dados com T-SQL dentro de notebooks Python, consulte Executar código T-SQL em notebooks Python do Fabric. Para ver a sintaxe completa, use o %tsql? comando. Este comando exibe as informações de ajuda para o comando mágico T-SQL, incluindo os parâmetros disponíveis e suas descrições.