OpenClaw 建表规范

使用流程

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

1. 工作空间确认

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

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

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

数据层级（必选其一）：

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

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

3. 表调度策略确认

表名拼接规则：

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

示例：

• 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) 等

常用字段模板：

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

5. 表注释

必须提供表级 COMMENT，格式：

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

6. 分区字段

推荐分区策略：

分区示例：

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

7. 存储格式

默认使用 ALIORC：

STORED AS ALIORC

特殊情况可选项：

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

8. 生命周期（TTL）

按数据层级设置默认 TTL：

TTL 语法：

TBLPROPERTIES ('lifecycle'='30')

完整建表示例

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');

字段命名规范

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

常见缩写

快速核对清单

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

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