在 Microsoft Fabric HorizonDB 中创建表格

本文在 Fabric HorizonDB 中创建一个可重复使用的 PostgreSQL 示例架构。 这些表使用身份列、主键和外键、检查约束、带时区的时间戳以及索引。

Important

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

Prerequisites

  • 一个 HorizonDB 数据库。
  • 访问 SQL 编辑器或其他 PostgreSQL 客户端。
  • 以数据库创建者身份登录。 其他用户和主体无法在当前预览版中连接到 PostgreSQL。

创建示例架构

打开一个新查询并运行:

CREATE SCHEMA IF NOT EXISTS horizon_sample;

使用专用架构可以将示例与服务托管架构和应用架构分开。

创建客户表

CREATE TABLE IF NOT EXISTS horizon_sample.customers (
    customer_id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
    customer_name text NOT NULL UNIQUE,
    segment text NOT NULL,
    created_at timestamptz NOT NULL DEFAULT now()
);

此表使用 PostgreSQL 标识列作为其代理主键。 唯一约束可防止本示例中出现重复的客户名称。

创建订单表

CREATE TABLE IF NOT EXISTS horizon_sample.orders (
    order_id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
    order_reference text NOT NULL UNIQUE,
    customer_id bigint NOT NULL
        REFERENCES horizon_sample.customers (customer_id),
    order_date date NOT NULL DEFAULT current_date,
    status text NOT NULL
        CHECK (status IN ('open', 'processing', 'completed', 'cancelled')),
    total numeric(12, 2) NOT NULL
        CHECK (total >= 0),
    created_at timestamptz NOT NULL DEFAULT now()
);

外键防止订单引用缺失的客户。 检查约束保护状态词汇,防止负总数。

添加索引

主键约束和唯一约束本身已创建索引。 为常见的客户和日期访问模式添加索引:

CREATE INDEX IF NOT EXISTS ix_orders_customer_date
ON horizon_sample.orders (customer_id, order_date DESC);

没有实际工作负载依据,不要添加索引。 每个索引都会占用存储空间,并为插入、更新、VACUUM 和镜像增加工作量。

验证对象

检查列:

SELECT
    table_name,
    column_name,
    data_type,
    is_nullable,
    column_default
FROM information_schema.columns
WHERE table_schema = 'horizon_sample'
  AND table_name IN ('customers', 'orders')
ORDER BY table_name, ordinal_position;

检查约束条件:

SELECT
    table_name,
    constraint_name,
    constraint_type
FROM information_schema.table_constraints
WHERE table_schema = 'horizon_sample'
ORDER BY table_name, constraint_type, constraint_name;

预期结果包括两表上的主键、从 orders 到 customers的外键、唯一约束以及检查约束。

刷新对象资源管理器,展开 “架构”,展开 horizon_sample,然后展开 “表”。 选择 customers 或 orders 检查列和键。

了解所有权和访问权限

创建对象的身份通常拥有该对象。 所有权允许强力更改,包括删除该对象。

在当前预览版中,只有创建数据库的 Microsoft Entra 身份可以连接。 共享 Fabric 项目不会启用额外的 PostgreSQL 用户。 不要为了绕过限制而创建登录角色。

更多信息,请参阅 验证 PostgreSQL 访问。

清理

运行前请检查架构名称:

DROP SCHEMA IF EXISTS horizon_sample CASCADE;

CASCADE 删除该 schema 中的所有对象。 不要在由服务管理的或应用 schema 上使用它。

后续步骤

加载样本数据。