在门户中创建 HorizonDB 数据库

在本快速入门中,你将在 Microsoft Fabric HorizonDB 中创建一个 HorizonDB 数据库,并通过 PostgreSQL 查询进行验证。

Important

Fabric HorizonDB 处于公开预览阶段。 功能、限制和行为可能会在正式发布前发生变化。 有关详细信息,请参阅 Microsoft Fabric 预览功能。

Prerequisites

  • 一个 Fabric 租户和一个被分配给活动 Fabric 容量的合格工作区。
  • 贡献者或管理员对工作区的访问权限以及创建 PostgreSQL 数据库项的权限。
  • 工作区区域中的 Fabric HorizonDB 可用性。
  • 为预览启用的 Microsoft Entra 身份。

使用专用的开发或测试工作区以及合成的、非敏感数据。 与管理员或预览联系人确认租户、工作区、容量和区域启用情况。

创建数据库

  1. 登录到 Fabric 门户。

  2. 打开目标工作区。

  3. 选择 + 新建项目。

  4. 搜索 HorizonDB 数据库。

  5. 选择 HorizonDB 数据库(预览)。

    新建项目对话框中 HorizonDB 数据库(预览)项的截图。

  6. 输入唯一的项名称,例如 contoso-horizondb。

    新 HorizonDB 数据库对话框中名称字段为空的截图。

  7. 选择“创建”,然后等待该项状态显示为在线或就绪。

创建是异步的。 如果操作仍在进行中,请不要创建重复项目。 打开项详细信息,并在预配报告失败时记录其操作或关联 ID。

只有在项目报告就绪状态且其 PostgreSQL 端点接受授权查询后,数据库才可用。 Fabric 集成可以独立继续初始化。

验证数据库

  1. 打开数据库项。

  2. 选择 “新建查询”。

  3. 粘贴以下 PostgreSQL 查询,选择完整语句,然后选择 “运行”:

    SELECT
        current_database() AS database_name,
        current_user AS signed_in_user,
        current_setting('server_version') AS server_version,
        current_setting('server_version_num') AS server_version_number,
        pg_backend_pid() AS session_id,
        clock_timestamp() AS validated_at;
    
  4. 确认:

    • database_name 与项目连接详细信息中的 PostgreSQL 数据库名称匹配。 在当前预览中,这是 postgres,而不是 Fabric 项目的显示名称。
    • signed_in_user表示您预期的 Microsoft Entra 主体。
    • server_version 报告您的预览数据库所使用的引擎版本。
    • 查询返回一个会话 ID 和一个时间戳。

在当前预览版中,只有创建数据库的 Microsoft Entra 身份才能连接。 共享该项目不会使其他用户或主体能够连接。 参见 “验证 PostgreSQL 访问”。

查看连接信息

在数据库工具栏中选择 Visual Studio Code 以打开连接窗格。 记录您的客户所需的非敏感值:

  • PostgreSQL 主机。
  • 港口。
  • 数据库名称。
  • Microsoft Entra 用户格式。
  • 发布了TLS模式和证书指导。

不要将令牌复制到文档、笔记本输出、shell 历史记录或源文件中。 不要将 SQL 分析端点用于业务操作的 PostgreSQL 连接。

理解初始计算状态

该平台管理计算资源。 仅使用数据库项中显示的控件。 在启用“缩放到零”时,空闲数据库可以暂停,通过同一端点的连接恢复该数据库。 考虑启动延迟;不要假设有一个固定的空闲间隔或恢复时间。

后续步骤