本文在 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 上使用它。