通过

连接到 Fabric 数据仓库

适用于：✅SQL Analytics 终结点和 Microsoft Fabric 中的仓库

本教程介绍如何将工具和应用程序连接到 SQL 分析终结点或仓库，或连接到仓库的快照。

若要开始，需要访问具有参与者或更高权限的工作区中的 SQL 分析终结点或仓库。

查找数据仓库的连接字符串

若要查找仓库项的服务器名称，请执行以下作：

  1. 打开仓库或 SQL 分析终结点 的设置 。

  2. 在 “设置” 窗口中，选择 “SQL 终结点 ”页。

  3. 复制 SQL connection string并将其用于通过外部连接从 Power BI 桌面、应用程序或客户端工具连接到项。 这是仓库的服务器名称。

  4. 连接时，始终提供仓库项名称作为 初始目录 或 数据库名称 。

    Fabric 门户中“设置”窗口的“SQL 终结点”页的屏幕截图。

使用 SQL Server Management Studio 进行连接 （SSMS）

以下步骤详细介绍了如何从Microsoft Fabric工作区开始，并将仓库连接到 SQL Server Management Studio （SSMS）。

  1. 打开 SSMS 时，将显示 “连接到服务器 ”窗口。 如果已打开，可以通过选择 Object Explorer>Connect>Database Engine 手动连接。

    截图显示在“连接”菜单上选择数据库引擎的位置。

  2. 打开 Connect to Server 窗口后，将本文上一部分复制的connection string粘贴到 Server name 框中。 服务器名称如下所示 <unique identifier>.datawarehouse.fabric.microsoft.com。 选择“连接”，然后继续使用适当的凭据进行身份验证。

    显示“连接到服务器”窗口的屏幕截图。

  3. 提供要连接到的仓库名称。 有效的仓库名称不包括<unique identifier>.datawarehouse.fabric.microsoft.com服务器名称所需的内容。 如果仓库名称为 NYC Taxi， 则初始目录 为 NYC Taxi。

  4. 建立连接后，Object Explorer将在工作区中显示已连接的仓库及其各自的表和视图，所有这些均已可以查询。

    屏幕截图显示连接的服务器名称在对象资源管理器窗格中的位置。

通过 SSMS（或 ADS）进行连接时，会看到 SQL 分析终结点和数据仓库都被列为数据仓库。 采用命名约定，可在Microsoft Fabric门户体验之外的工具中轻松区分这两种项类型。 仅支持 SSMS 19 或更高版本。

使用 Power BI 进行连接

仓库或 Lakehouse SQL 分析终结点是 Power BI 中完全受支持的原生数据源，无需使用 SQL 连接字符串。 “数据”窗格公开你有权直接访问的所有仓库。 这样，你可以轻松地按工作区查找仓库，并：

  1. 选择仓库。
  2. 选择实体。
  3. 加载数据 - 选择数据连接模式： 导入或 DirectQuery。

有关详细信息，请参阅 在 Microsoft Fabric。

使用 OLE DB 进行连接

我们支持使用 OLE DB 连接到仓库或 SQL 分析终结点。 请确保运行最新的 Microsoft OLE DB Driver for SQL Server。

使用 ODBC 进行连接

Microsoft Fabric支持使用 ODBC 连接到仓库或 SQL 分析终结点。 请确保您使用最新的 SQL Server ODBC 驱动程序。 使用Microsoft Entra ID身份验证。 仅支持 ODBC 18 或更高版本。

使用 Fabric Python Notebook 进行连接

Fabric Python Notebooks（预览版）提供使用 T-SQL 魔法命令运行 T-SQL 代码的能力。 在以下步骤中，使用 %%tsql magic 命令连接到 Fabric 中的仓库项：

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

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

    在以下示例中，将 <warehouse> 替换为您仓库项的名称。 参数 -type 应为 Warehouse.

    %%tsql -artifact <warehouse> -type Warehouse

    接着加入您的 T-SQL 命令。 例如，若要从名为 Contoso： 的仓库运行查询，

    %%tsql -artifact Contoso -type Warehouse
SELECT * FROM wh.DimDate;

  3. 还可以使用 -bind 参数将结果绑定到数据帧：

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

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

使用 JDBC 进行连接

Microsoft Fabric还支持使用Java数据库连接（JDBC）驱动程序连接到仓库或 SQL 分析终结点。

通过 JDBC 建立连接时，请检查以下依赖项：

  1. 添加项目。 选择 “添加项目 ”并添加以下四个依赖项，然后选择“ 下载/更新 ”以加载所有依赖项。 例如：

    显示“下载/更新”位置的屏幕截图。

  2. 选择 “测试连接”和 “完成”。

    “依赖项声明”选项卡的屏幕截图。 

    <dependency>
   <groupId>com.microsoft.azure</groupId>
   <artifactId>msal4j</artifactId>
   <version>1.13.3</version>
</dependency>

<dependency>
   <groupId>com.microsoft.sqlserver</groupId>
   <artifactId>mssql-jdbc_auth</artifactId>
   <version>11.2.1.x86</version>
</dependency>

 <dependency>
   <groupId>com.microsoft.sqlserver</groupId>
   <artifactId>mssql-jdbc</artifactId>
   <version>12.1.0.jre11-preview</version>
</dependency>

 <dependency>
   <groupId>com.microsoft.aad</groupId>
   <artifactId>adal</artifactId>
   <version>4.2.2</version>
</dependency>

使用 dbt 进行连接

适配器 dbt 是一个数据转换框架，它使用软件工程最佳做法（如测试和版本控制）来减少代码、自动执行依赖项管理，以及交付更可靠的数据（全部使用 SQL）。

用于特定数据平台的适配器插件允许用户连接到所选择的数据存储。 若要从 dbt中连接到仓库，请使用 dbt-fabric 适配器。 同样，Azure Synapse Analytics专用 SQL 池数据源有自己的适配器，dbt-synapse。

这两个适配器都支持Microsoft Entra ID身份验证，并允许开发人员使用 az cli authentication。 但是，dbt-fabric 不支持 SQL 身份验证。

dbt Fabric DW 适配器使用pyodbc库与仓库建立连接。 pyodbc 库是Python语言的 ODBC 实现，它使用 Python 数据库 API 规范 v2.0。  pyodbc 库通过 msodbc 连接结构中的 SQLDriverConnect，将连接字符串直接传递给数据库驱动程序，使用 TDS（表格数据流式处理）代理服务来连接 Microsoft Fabric。

有关详细信息，请参阅以下资源：

通过其他方式建立连接

任何非 Microsoft 工具还可以通过 ODBC 或 OLE DB 驱动程序使用 SQL 连接字符串，并通过 Microsoft Entra ID 身份验证连接到 Microsoft Fabric 仓库或 SQL 分析终结点。 有关详细信息和示例连接字符串，请参阅 Microsoft Entra 身份验证作为 SQL 身份验证的替代方法。

自定义应用程序

在 Microsoft Fabric 中，Warehouse 和 Lakehouse SQL 分析终结点分别提供 SQL 连接字符串。 数据可从庞大的 SQL 工具生态系统访问，前提是它们可以使用Microsoft Entra ID进行身份验证。 有关详细信息，请参阅 Microsoft SQL 数据库的连接库。 有关详细信息和示例连接字符串，请参阅 Microsoft Entra 身份验证作为 SQL 身份验证的替代方法。

相关内容

  • Last updated on