Partilhar via

Ligue-se à sua base de dados SQL no Microsoft Fabric

Aplica-se a:✅base de dados SQL em Microsoft Fabric

Pode ligar-se e consultar a sua base de dados SQL em Fabric da mesma forma que Azure SQL Database.

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.

Encontrar cadeia de conexão SQL

No Microsoft Fabric, o endpoint de análise SQL e a base de dados SQL são acessíveis através de um Tabular Data Stream, ou endpoint TDS, familiar a todas as aplicações web modernas que interagem com um endpoint TDS do SQL Server. Isto é referido como a cadeia de conexão SQL na interface do utilizador do Microsoft Fabric.

  • O nome do servidor da base de dados SQL é semelhante ao nome do servidor Azure SQL Database, <server-unique-identifier>.database.windows.net.
  • O nome do servidor endpoint de SQL Analytics é semelhante ao nome do servidor de um armazém, <server-unique-identifier>.<tenant>.fabric.microsoft.com.

Para encontrar o nome do servidor para a sua base de dados SQL em Fabric:

  • 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 ligação completas para fornecedores 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 encontrar o nome do servidor do endpoint de análise SQL da sua base de dados SQL:

  • Vá para as configurações do item do banco de dados SQL e selecione Cadeias de conexão.
  • Ou, selecione o menu ..., depois selecione SQL endpoint, e depois copie a string de conexão SQL. Este é o nome do servidor.

Botão para abrir e conectar

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 para Visual Studio Code.

Captura de ecrã do editor de consultas do portal Fabric a mostrar o botão Abrir para ligações fáceis com SSMS ou a extensão MSSQL no VS Code.

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

Em 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 pela cadeia de ligação da sua base 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 Autenticação tipo: 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. Iniciar sessão usando Microsoft Entra ID - Universal com suporte a MFA.

Ligue-se manualmente à extensão MSSQL para Visual Studio Code

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 usando o sqlcmd

Podes ligar-te à tua base de dados SQL no Fabric com sqlcmd, tal como qualquer outro produto Database Engine SQL. Use autenticação Microsoft Entra ID com a opção G. A autenticação Microsoft Entra (-G) requer pelo menos a versão 13.1.

No exemplo a seguir, substitua <server name> pela longa cadeia de texto exclusiva de caracteres que representa o seu banco de dados SQL no Fabric.

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

Conecte-se com o utilitário bcp

Podes ligar-te à tua base de dados SQL no Fabric com a utilidade bcp, tal como qualquer outro produto SQL Database Engine. Use a autenticação Microsoft Entra ID com a opção -G.

No exemplo a seguir, substitua <server name> pela longa cadeia de texto único que representa o seu banco de dados SQL no Fabric.

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

Ligue-se ao Python Notebook

Fabric Python Notebooks (pré-visualização) oferecem a capacidade de executar código T-SQL com o comando mágico T-SQL.

Sugestão

Também pode ligar as suas aplicações a uma base de dados SQL no Fabric com o Microsoft Python Driver.

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

  1. Cria um caderno no teu espaço de trabalho com a linguagem definida para 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 mais possibilidades de consultar os seus dados com T-SQL dentro do Python Notebooks, veja Run T-SQL code in Fabric Python notebooks. 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.

Conteúdo relacionado

  • Last updated on