连接到 Microsoft Fabric SQL 数据库

适用于:✅Microsoft Fabric 中的 SQL 数据库

可以通过与 Azure SQL 数据库相同的方式在 Fabric 中连接到 SQL 数据库并查询 SQL 数据库。

Prerequisites

Fabric 门户中的查询编辑器

可以在 Fabric 门户中使用基于 Web 的编辑器连接到 SQL 数据库。

Fabric SQL 数据库的基于 Web 的编辑器提供了基础对象资源管理器和查询执行界面。 集成的“资源管理器”菜单列出了所有数据库对象

Fabric 中的新 SQL 数据库会自动打开到 Web 编辑器中,现有数据库可以通过在 Fabric 中选择它来在 Web 编辑器中打开。

查找 SQL 连接字符串

在 Microsoft Fabric 中,SQL 分析终结点和 SQL 数据库可以通过表格数据流(TDS)终结点进行访问,该终结点是所有与 SQL Server TDS 终结点交互的新式 Web 应用程序所熟悉的。 这在 Microsoft Fabric 用户界面中被称为 SQL 连接字符串。

SQL 数据库的连接字符串类似于 Azure SQL 数据库的 <server-unique-identifer>.database.windows.net连接字符串。 SQL 分析终结点连接字符串如下所示 <server-unique-identifier>.<tenant>.fabric.microsoft.com

查找 Fabric SQL 数据库的 SQL 连接字符串

  • 转到 SQL 数据库项的设置。
  • 或者,在项列表中,选择 ... 菜单。 选择 “设置” ,然后选择 “连接字符串”。 Fabric 为 ADO.NET、JDBC、ODBC、PHP 和 Go 等提供程序提供完整的连接字符串。
  • 或者,选择“ 打开” 按钮,然后选择 SQL Server Management StudioVisual Studio Code。 将显示服务器名称和数据库名称。

查找 Fabric SQL 数据库 SQL 分析终结点的 SQL 连接字符串

  • 转到 SQL 数据库项的设置,然后选择 “连接字符串”。
  • 或者,选择 ... 菜单,然后选择 SQL 终结点,然后复制 SQL 连接字符串

通过“打开方式”按钮进行连接

可以使用 Fabric 门户查询编辑器中的“打开”按钮轻松连接到 SQL 数据库。 选择 SQL Server Management StudioVisual Studio Code 的 mssql 扩展

Fabric 门户查询编辑器的屏幕截图,其中显示了“打开”按钮,方便与 SSMS 或 VS Code 中的 mssql 扩展建立连接。

通过 SQL Server Management Studio 手动连接

如果 SSMS 版本早于 21,单击“ 打开” 后,仍不支持自动填充连接详细信息,只需提供服务器、数据库和身份验证信息即可手动连接。

SSMS 设置的屏幕截图。

在“SQL Server Management Studio (SSMS)”中

  1. 在 Fabric“数据库”工作负载的工作区中,选择 SQL 数据库旁边的 ...
  2. 选择“设置”。
  3. 选择“连接字符串”。 查找 SQL 数据库的连接字符串,包括 Data Source=。 例如,tcp:<servername>.database.fabric.microsoft.com,1433Initial Catalog= 是数据库名称。
  4. 在 SSMS 中,打开“新建连接”
  5. 在“构造”对话框中,复制 Server Name 的值并将其粘贴到“服务器名称”中。
  6. 选择“身份验证”类型:“Microsoft Entra ID - 支持 MFA 的通用方法”
  7. 选择 选项<<
  8. Database Name 中的值复制粘贴到“连接到数据库”文本框中
  9. 选择 连接
  10. 使用“Microsoft Entra ID - 支持 MFA 的通用方法”登录

在 Visual Studio Code 中手动连接 MSSQL 扩展

还可以在 适用于 VS Code 的 MSSQL 扩展中使用 Fabric 浏览体验。 此功能允许开发人员在 Fabric 或 SQL 分析终结点中无缝连接到其 SQL 数据库,而无需从 Fabric 门户手动复制连接字符串,也不依赖于 “打开” 按钮直接连接到 VS Code 中的数据库。

VS Code 连接设置的屏幕截图。

使用 sqlcmd 进行连接

可以使用 sqlcmd 连接到 Fabric 中的 SQL 数据库,就像任何其他 SQL 数据库引擎产品一样。 通过 选项G。 Microsoft Entra 身份验证(-G)要求至少版本 13.1。

在下面的示例中,将 <server name> 替换为代表 Fabric SQL 数据库的唯一文本长字符串。

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

通过 bcp 实用程序连接

可以使用 bcp 实用工具连接到 Fabric 中的 SQL 数据库,就像任何其他 SQL 数据库引擎产品一样。 通过 -G 选项使用 Microsoft Entra ID 身份验证。

在下面的示例中,将 <server name> 替换为代表 Fabric SQL 数据库的唯一文本长字符串。

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

使用 Python 笔记本进行连接

Fabric Python Notebook( 预览版)提供 使用 T-SQL magic 命令运行 T-SQL 代码的功能

在以下步骤中,使用 %%tsql magic 命令连接到 Fabric 中的 SQL 数据库:

  1. 在工作区中创建笔记本,语言设置为 Python。

  2. 在单元格中使用 %%tsql magic命令。 单元格类型会自动更改为 T-SQL

    在以下示例中,将 <databasename> 替换为 Fabric 中的 SQL 数据库名称。 参数 -type 应为 SQLDatabase.

    %%tsql -artifact <databasename> -type SQLDatabase
    

    然后包含你的 T-SQL 命令。 例如,若要从名为 Contoso: 的数据库运行查询:

    %%tsql -artifact Contoso -type SQLDatabase
    SELECT * FROM SalesLT.Customer;
    
  3. 还可以使用 -bind 参数将结果绑定到数据帧:

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

有关在 Python 笔记本中使用 T-SQL 查询数据的可能性更多,请参阅 在 Fabric Python 笔记本中运行 T-SQL 代码。 若要查看完整的语法,请使用 %tsql? 命令。 此命令显示 T-SQL magic 命令的帮助信息,包括可用参数及其说明。