适用于:✅Microsoft Fabric中的SQL分析端点和仓库
在 Microsoft Fabric 中,用户通过表格数据流(TDS)终结点访问 SQL 分析终结点或仓库。 现代 Web 应用程序与 SQL Server TDS 端点交互。 在 Microsoft Fabric 设置中,此终结点标记为 SQL 连接字符串。
小窍门
有关使用常用工具进行连接的教程,请参阅 “连接到 Fabric 数据仓库”。
向 Fabric 中的仓库进行身份验证
在 Microsoft Fabric 中,SQL 连接字符串支持两种类型的经过身份验证的用户:
- Microsoft Entra ID 用户主体或用户标识
- Microsoft Entra ID 服务主体
有关详细信息,请参阅 Microsoft Entra 身份验证作为 Microsoft Fabric 中 SQL 身份验证的替代方法。
SQL 连接字符串要求打开 TCP 端口 1433。 TCP 1433 是标准的 SQL Server 端口号。 Warehouse 使用 Microsoft SQL Server 表格数据流(TDS)协议,通过 TCP 端口 1433。 在使用协议响应防火墙或应用层检测的环境中,将SQL流量配置并检测为Microsoft SQL Server(MSSQL/TDS)流量,而非HTTPS流量。
一些防火墙区分TCP端口访问和应用协议检查。 在这些环境中,如果防火墙被配置为将该端口上的流量视为 HTTPS 流量,那么仅允许 TCP 1433 端口可能还不够。
SQL 连接字符串还遵循用于数据访问的仓库或 Lakehouse SQL 分析终结点安全模型。 用户可以访问他们有权访问的所有对象的数据。
有关 SQL 分析终结点中安全性的详细信息,请参阅 适用于 SQL 分析终结点的 OneLake 安全性。
最佳做法
向应用程序和 ETL 作业添加重试,使其更具弹性。 有关详细信息,请参阅以下文档:
- 重试模式 - Azure 架构中心
- 处理临时错误 - Azure SQL 数据库
- 步骤 4:使用 ADO.NET 实现弹性连接 SQL - SQL Server 的 ADO.NET 提供程序
- 步骤 4:使用 PHP 可靠地连接到 SQL - 适用于 SQL Server 的 PHP 驱动程序
- 使用服务标记进行防火墙清理,如以下部分所述。
- 连接时,应提供仓库项名称作为 初始目录 或 数据库名称 。 如果未提供
InitialCatalog连接字符串 属性,则初始连接上下文将为master仓库。
允许通过防火墙使用 Azure 服务标记
若要通过防火墙启用连接,需要允许 Power BI 服务标记和 SQL 服务标记。 有关详细信息,请参阅 Power BI 服务标记和服务标记。
不能单独使用 TDS 终结点的完全限定域名(FQDN)。
重要
如果您的组织使用 Azure 防火墙 应用规则或类似的协议响应型防火墙,将仓库流量配置为 MSSQL/TDS 流量。 在端口1433上将SQL流量配置为HTTPS流量,即使允许网络访问该端口,也可能阻碍成功连接。
防火墙与应用层检查的考虑
一些企业防火墙解决方案除了传统的IP和端口过滤外,还执行应用层检测。
配置仓库防火墙策略时:
- 允许端口1433进行TCP外站连接。
- 确保SQL流量被视为Microsoft SQL Server(MSSQL/TDS)流量。
- 不要把连接到仓库的SQL连接配置为1433端口的HTTPS流量。
- 在防火墙策略更改部署后验证连接性。
注意
使用 Azure 防火墙应用程序规则的客户应为 SQL 流量配置 SQL 感知筛选。 Azure 防火墙 支持 MSSQL 协议处理和 SQL FQDN 过滤以处理 SQL 工作负载。
基于FQDN的防火墙过滤
限制使用完全限定域名(FQDN)的出站访问的组织可以使用防火墙规则,只允许经过批准的SQL目的地。
对于使用 Azure 防火墙 的环境:
- 支持通过 MSSQL 应用程序规则实现 SQL 感知的 FQDN 过滤。
- FQDN 过滤可配合端口 1433 限制使用,以限制出站 SQL 连接。
- 确保本文中记录的所有 Warehouse 端点都已添加到防火墙允许列表中。
实现细节请参见“用SQL FQDNS配置Azure 防火墙应用规则。
连接空闲
客户端与仓库之间的连接在打开时处于 空闲 状态,没有请求在运行或返回结果,且客户端没有提交新请求。 空闲连接并不代表断线或不健康。 它只是敞开着,没有被使用。
仓库和 SQL 分析端点会自动关闭那些空闲 15 分钟的连接。 空闲定时器在 warehouse 向客户端发送完响应后开始。 每当客户端提交新的请求(例如查询批处理、远程过程调用(RPC)、事务请求或批量加载时,它都会暂停。
例如,以下时间轴显示了与 15 分钟空闲超时的连接:
- 上午10:00: 一个客户端连接到数据仓库。
- 上午 10:05: 客户端运行查询,查询成功完成。
- 上午 10:05 至 10:20: 连接保持开放,但客户端不会提交任何其他查询或请求。 这段时间是非活动期。
- 上午10:20: 连接已空闲15分钟,因此数据仓库将其关闭。
- 上午 10:25: 客户端尝试运行另一个查询。 客户端必须先建立一个新的连接。
空闲超时、连接超时和查询超时
空闲连接超时与您在客户端或连接字符串中可能配置的其他超时不同:
| Timeout | 它限制的内容 | 控制它的人员 |
|---|---|---|
| 空闲连接超时 | 连接能保持多长时间无活动。 | 由 Warehouse 固定为15分钟。 |
| 连接超时 | 客户在建立连接期间等待多长时间。 | 客户端,例如Connect Timeout连接字符串属性。 |
| 查询超时 | 单个查询可运行多长时间。 | 客户端,例如 ADO.NET 中的 CommandTimeout 属性。 |
连接闲置对您的应用意味着什么
- 长期运行的查询不受影响。 空闲计时器会在请求执行期间暂停,因此运行超过 15 分钟的查询不会因空闲超时而被关闭。 只有在请求之间闲置的连接才会被关闭。
- 连接弹性依然有效。 空闲超时不会改变连接的弹性或您用于恢复连接的其他选项。 驱动程序功能(如空闲连接复原能力,例如 Microsoft.Data.SqlClient 中的
ConnectRetryCount和ConnectRetryInterval连接字符串 属性)、连接池和应用重试逻辑仍与以往一样工作。 有关详细信息,请参阅最佳做法。 - 为已关闭的连接做好规划。 如果您的应用程序保持连接开启并在长时间中断后重复使用,下一个请求可能会失败,因为连接已被关闭。 需要连接时打开连接,完成后关闭连接,或者使用重试逻辑让应用自动重新连接。
- 请及时提交事务。 如果连接中事务处于空闲状态 15 分钟,仓库会关闭该连接,并回滚未提交的交易。 不要在应用程序等待用户输入或其他工作时让事务保持开放状态。
- 管理并发会话。 仓库和 SQL 分析端点每个工作区的用户会话数量限制为 2048 个。 关闭空闲连接可以减少未使用的会话,但并不能阻止达到这一上限。 空闲会话仍然计入,直到关闭为止,且使用频率超过每15分钟的连接不会被空闲超时关闭。 连接的突发也可能在空闲连接超时前达到上限。管理连接寿命和并发会话,而不是依赖空闲清理。 当达到限制时,新的连接尝试会因会话限制错误而失败。 更多信息,请参见会话。
注意事项和限制
- 不支持 SQL 身份验证。
- Microsoft Fabric Warehouse 不支持多重活动结果集(MARS)。 MARS 默认处于禁用状态。 如果
MultipleActiveResultSets包含在连接字符串中,请将其删除或设置为 false。 - 如果收到错误代码 24804,并显示消息“由于系统更新而无法完成操作。 关闭此连接,再次登录,然后重试该操作,或出现错误代码 6005,并显示消息“正在关闭”。 在 SQL Server 上执行失败。 如果需要进一步支持,请联系 SQL Server 团队。”,这是由于临时连接丢失,可能是由于系统部署或重新配置。 若要解决此问题,请重新登录,然后重试。 若要了解如何在应用程序中构建复原能力和重试,请参阅最佳做法。
- 如果收到错误代码 6008,并显示消息“工作区暂时不可用。 这可能是由于系统维护或内部操作造成的。 请重新建立连接。“此错误表示临时连接中断。 若要解决此问题,请重新建立连接,再次登录,然后重试该操作。 此条件是暂时性的,并不指示查询或应用程序中的故障。
- 不支持来自 SQL Server 的链接服务器连接。
InitialCatalog 的连接行为
2026 年 5 月,Microsoft 更新了 Fabric Data Warehouse 和 SQL 分析终结点的连接行为,使 InitialCatalog连接字符串属性成为可选项。 目前,如果未提供 master 属性,用户将连接到 InitialCatalog 系统数据库。 在Fabric Data Warehouse中,只能连接到 master 数据库,不能修改 master 数据库,也不能在 master 数据库中创建、更改或删除用户对象。
可以使用 USE Transact-SQL 语法在连接到 master 后更改连接仓库上下文,使用 DB_NAME() 函数来确定当前仓库。 例如:
SELECT DB_NAME(); --returns name of current warehouse context
GO
USE [ContosoWarehouse];
GO
SELECT DB_NAME(); --returns name of current warehouse context
GO
下表概述了在连接字符串中指定或省略 InitialCatalog 属性时Fabric Data Warehouse和 SQL 分析终结点的更新连接行为。
| 输入场景 | 2026 年 5 月之前 | 当前行为 |
|---|---|---|
| 提供的现有仓库名称 | 连接到指定的仓库 | 无变化 - 连接到指定的仓库 |
| 提供的现有仓库 ID | 连接到指定的仓库 | 无变化 - 连接到指定的仓库 |
InitialCatalog 未提供属性 |
连接到工作区中的非确定性仓库 | 连接至 master |
InitialCatalog = master |
连接到工作区中的非确定性仓库 | 连接至 master |
InitialCatalog 属性中的仓库不存在 |
连接到工作区中的非确定性仓库 | 引发一个错误,指示不存在仓库 |
错误处理
如果工作区中不存在任何仓库,并且在未指定有效仓库的情况下尝试连接,用户将看到以下错误:“用户“<令牌标识的主体>”登录失败”。 原因:身份验证成功,但找不到数据库,或者你没有足够的权限连接到它。
以下屏幕截图显示了在将无效仓库名称提供为 InitialCatalog 时,SSMS 中出现的错误: