Fabric HorizonDB 对 PostgreSQL 连接使用 Microsoft Entra 身份验证。 调用主体确定实际生效的 PostgreSQL 身份。
Important
Fabric HorizonDB 处于公开预览阶段。 只有创建数据库的 Microsoft Entra 身份才能连接。 其他用户和主体无法连接,即使他们能打开 Fabric 项。 使用您自己的数据库中的连接详细信息。 有关详细信息,请参阅 Microsoft Fabric 预览功能。
认证和授权是不同的
身份验证用于验证身份。 授权决定身份可以执行什么操作。
成功登录本身并不会授予以下权限:
- 访问 Fabric 工作区或项目。
- PostgreSQL
CONNECT权限。 - Schema
USAGE。 - 表、序列、函数或 DDL 权限。
- 访问联合源、复制作业源或 SQL 分析端点。
有关授权,请参见授权。
支持的身份模式
以数据库创建者身份登录到 Fabric SQL 编辑器、Visual Studio Code、应用程序练习和复制作业目标连接。 在当前预览版中,Microsoft Entra 组、服务主体、托管身份以及其他 Microsoft Entra 用户不支持 PostgreSQL 连接。
交互式客户端
对于 Fabric SQL 编辑器,服务使用您登录到的 Fabric 上下文。 调用主体确定有效的 PostgreSQL 身份。
针对 Visual Studio Code:
安装 Microsoft PostgreSQL 扩展。
在 Fabric HorizonDB 工具栏中选择 Visual Studio Code,然后在连接窗格中选择在 VS Code 中打开。
选择 Entra Auth。
以数据库创建者身份登录正确的租户。
验证主机、数据库、用户格式和 TLS 配置。
运行:
SELECT current_database(), current_user, clock_timestamp();
应用程序身份验证
应用程序应当:
- 从配置中加载非敏感连接信息。
- 在预览演练中使用数据库创建者的 Microsoft Entra 身份。
- 使用为预览连接指定的受众或范围请求令牌。
- 打开一个受 TLS 保护的 PostgreSQL 连接,并将令牌作为密码等效凭据提供。
- 设置有限连接超时和非敏感应用程序名称。
- 不再需要时丢弃令牌。
不要用服务主体或托管身份替代创建者。 对于本地 Python 练习,请使用 Psycopg 3 和显式交互式凭据。 参见“使用 Python 进行连接”。
令牌和池生命周期
当建立物理连接时,令牌验证会发生。 现有会话不会在每次语句前自动重新认证。
- 每新增一个物理连接或刷新池,获取一个新的令牌。
- 在令牌到期前替换池连接。
- 在暂停、扩缩容或维护后验证借用连接。
- 限制重试次数,且永不无限期重试无效或过期凭据。
更改 Fabric 项目权限不会在当前预览版中启用额外的 PostgreSQL 身份。
验证已认证的身份
运行:
SELECT
current_database() AS database_name,
current_user AS current_role,
session_user AS session_role,
pg_backend_pid() AS session_id,
clock_timestamp() AS checked_at;
确认返回的身份是否代表数据库创建者或其映射的数据库身份。 不要创建 PostgreSQL 登录角色来绕过预览限制。
排查身份验证问题
| 问题 | 检查 |
|---|---|
| 令牌获取失败 | 凭据配置、租户选择、条件访问以及本地登录状态。 |
| PostgreSQL 拒绝该凭据 | 令牌范围或受众、过期时间、租户、用户格式、服务器时钟和端点。 |
| 门户功能正常但应用程序失败 | 比较身份、数据库、用户格式、令牌流、TLS 模式以及有效的数据库访问。 |
| 其他用户无法连接 | 当前预览中预期如此。 以数据库创建者身份重新连接;共享该项目不会启用另一个 PostgreSQL 身份。 |
| 身份验证有效,但查询被拒绝 | 验证当前数据库、对象所有权以及操作是否受支持。 |
| 数据库已暂停 | 在授权连接开始恢复时使用有界连接重试。 |
捕获已净化的错误类别、UTC 时间戳、客户端和驱动程序版本以及关联 ID。 永远不要发送令牌或完整的 连接字符串。
Limitations
- 密码认证并未作为公开预览身份模型被记录在文档中。
- 客户超级用户和主机身份验证配置不可用。
- 只有数据库创建者可以连接;不支持其他用户和应用程序主体。
- 分享并不是解决仅限创作者限制的办法。
- 不要假设 SQL 角色管理或细粒度多用户访问都可用。
- TLS 和端点值不能用于其他服务。