OpenClaw 建表规范#

使用流程#

当用户需要建表时，按以下顺序确认关键信息：

1. 工作空间确认#

询问用户要在哪个工作空间（Schema/数据库）建表：

• 生产环境： prod_workspace
• 测试环境： test_workspace
• 开发环境： dev_workspace

2. 数据层级与数据域确认#

数据层级（必选其一）：

层级代码说明数据仓库明细层dwd清洗后的明细数据数据仓库汇总层dws按主题汇总的轻度汇总表维度表dim维度数据（用户、商品等）应用数据层ads面向应用的数据集市原始数据层ods原始接入数据

数据域（根据业务选择）：

• usr - 用户域
• ord - 订单域
• prd - 商品域
• trd - 交易域
• mkt - 营销域
• log - 日志域
• fin - 财务域
• 其他自定义域

3. 表调度策略确认#

维度选项代码调度周期天级d小时级h分钟级min更新方式全量full增量inc

表名拼接规则：

text

【工作空间】.【数据层】_【数据域】_【业务描述】_【调度周期】【更新方式】

示例：

• prod_workspace.dws_ord_daily_order_stats_df （天级全量）
• prod_workspace.dwd_ord_order_detail_di （天级增量）
• prod_workspace.dws_usr_user_active_hr （小时级）

4. 字段定义收集#

必须提供以下信息：

• 字段英文名：蛇形命名（如 user_id, order_amount）
• 字段中文名：清晰业务含义
• 数据类型：STRING/BIGINT/DOUBLE/DATETIME/DECIMAL(p,s) 等

常用字段模板：

sql

-- 基础审计字段（强烈建议）
`gmt_create`    DATETIME COMMENT '数据创建时间',
`gmt_modified`  DATETIME COMMENT '数据修改时间',
`ds`            STRING   COMMENT '数据日期，格式yyyyMMdd',

5. 表注释#

必须提供表级 COMMENT，格式：

sql

COMMENT '【数据域】_【业务描述】_【调度说明】，【主要字段说明】'

6. 分区字段#

推荐分区策略：

调度类型分区字段说明天级表ds STRING日期分区，格式 yyyyMMdd小时级ds STRING, hr STRING日期+小时分区全量表可选无分区按业务需要

分区示例：

sql

PARTITIONED BY (`ds` STRING COMMENT '数据日期，格式yyyyMMdd')

7. 存储格式#

默认使用 ALIORC：

sql

STORED AS ALIORC

特殊情况可选项：

• STORED AS ALIORC - 推荐，高压缩率
• STORED AS TEXTFILE - 纯文本，调试用

8. 生命周期（TTL）#

按数据层级设置默认 TTL：

层级建议 TTL说明ODS30-90 天原始数据短期保留DWD180-365 天明细数据中期保留DWS365-730 天汇总数据长期保留ADS90-365 天应用数据按需保留DIM365 天或无维度表通常长期保留

TTL 语法：

sql

TBLPROPERTIES ('lifecycle'='30')

---

完整建表示例#

sql

CREATE TABLE IF NOT EXISTS prod_workspace.dws_ord_daily_order_stats_df (
    -- 维度字段
    `stat_date`         STRING      COMMENT '统计日期，格式yyyy-MM-dd',
    `merchant_id`       BIGINT      COMMENT '商家ID',
    `merchant_name`     STRING      COMMENT '商家名称',
    `category_id`       BIGINT      COMMENT '类目ID',

    -- 指标字段
    `order_cnt`         BIGINT      COMMENT '订单笔数',
    `order_amount`      DECIMAL(18,2) COMMENT '订单金额',
    `paid_cnt`          BIGINT      COMMENT '支付笔数',
    `paid_amount`       DECIMAL(18,2) COMMENT '支付金额',
    `refund_cnt`        BIGINT      COMMENT '退款笔数',
    `refund_amount`     DECIMAL(18,2) COMMENT '退款金额',

    -- 衍生指标
    `gmv`               DECIMAL(18,2) COMMENT 'GMV',
    `actual_amt`        DECIMAL(18,2) COMMENT '实际成交金额',

    -- 审计字段
    `gmt_create`        DATETIME    COMMENT '数据创建时间',
    `gmt_modified`      DATETIME    COMMENT '数据修改时间'
)
COMMENT '订单域_商家每日订单统计_天级全量，包含订单数、金额、退款等核心指标'
PARTITIONED BY (`ds` STRING COMMENT '数据日期，格式yyyyMMdd')
STORED AS ALIORC
TBLPROPERTIES ('lifecycle'='365');

---

字段命名规范#

数据类型后缀（可选但推荐）#

类型后缀示例数量/次数_cnt``order_cnt, pv_cnt金额_amt / _amount``order_amt, pay_amount比率/比例_rate / _ratio``conversion_rate标识/ID_id``user_id, order_id时间_time``create_time, pay_time日期_date / _dt``stat_date, birth_dt标记/Flag_flag / _is_xxx``is_vip, del_flag

常见缩写#

全称缩写示例countcntorder_cntamountamtpay_amtnumbernumserial_numidentifieriduser_idtimestamptscreate_tsdatetimedtlog_dt

---

快速核对清单#

建表完成后，确认以下事项：

• 工作空间正确
• 表名格式符合规范： {层}_{域}_{业务}_{调度}
• 所有字段都有 COMMENT
• 表有 COMMENT
• 分区字段已定义（非全量表）
• 存储格式为 ALIORC
• TTL 已设置且合理