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

表名拼接规则：

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

示例： - 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. 分区字段

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

分区示例：

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

7. 存储格式

默认使用 ALIORC：

STORED AS ALIORC

特殊情况可选项： - STORED AS ALIORC - 推荐，高压缩率 - STORED AS TEXTFILE - 纯文本，调试用

8. 生命周期（TTL）

按数据层级设置默认 TTL： | 层级 | 建议 TTL | 说明 | |------|---------|------| | ODS | 30-90 天 | 原始数据短期保留 | | DWD | 180-365 天 | 明细数据中期保留 | | DWS | 365-730 天 | 汇总数据长期保留 | | ADS | 90-365 天 | 应用数据按需保留 | | DIM | 365 天或无 | 维度表通常长期保留 |

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

---

字段命名规范

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

类型	后缀	示例
数量/次数	_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

常见缩写

全称	缩写	示例
count	cnt	order_cnt
amount	amt	pay_amt
number	num	serial_num
identifier	id	user_id
timestamp	ts	create_ts
datetime	dt	log_dt

---

快速核对清单

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