{"skill":{"slug":"openclawsh","displayName":"Openclaw Ddl Creator","summary":"OpenClaw 数据建表规范与流程指导。当用户需要创建数据仓库表（DDL）时使用，支持 DWS/DWD/DIM/ADS 等层级，引导完成工作空间选择、表命名、字段定义、分区策略、生命周期等完整建表流程。","description":"---\nname: openclaw-ddl-creator\ndescription: OpenClaw 数据建表规范与流程指导。当用户需要创建数据仓库表（DDL）时使用，支持 DWS/DWD/DIM/ADS 等层级，引导完成工作空间选择、表命名、字段定义、分区策略、生命周期等完整建表流程。\n---\n\n# OpenClaw 建表规范\n\n## 使用流程\n\n当用户需要建表时，按以下顺序确认关键信息：\n\n### 1. 工作空间确认\n询问用户要在哪个工作空间（Schema/数据库）建表：\n- 生产环境：`prod_workspace`\n- 测试环境：`test_workspace`\n- 开发环境：`dev_workspace`\n\n### 2. 数据层级与数据域确认\n\n**数据层级**（必选其一）：\n| 层级 | 代码 | 说明 |\n|------|------|------|\n| 数据仓库明细层 | dwd | 清洗后的明细数据 |\n| 数据仓库汇总层 | dws | 按主题汇总的轻度汇总表 |\n| 维度表 | dim | 维度数据（用户、商品等） |\n| 应用数据层 | ads | 面向应用的数据集市 |\n| 原始数据层 | ods | 原始接入数据 |\n\n**数据域**（根据业务选择）：\n- `usr` - 用户域\n- `ord` - 订单域\n- `prd` - 商品域\n- `trd` - 交易域\n- `mkt` - 营销域\n- `log` - 日志域\n- `fin` - 财务域\n- 其他自定义域\n\n### 3. 表调度策略确认\n\n| 维度 | 选项 | 代码 |\n|------|------|------|\n| **调度周期** | 天级 | d |\n| | 小时级 | h |\n| | 分钟级 | min |\n| **更新方式** | 全量 | f |\n| | 增量 | i |\n\n**表名拼接规则**：\n```\n【工作空间】.【数据层】_【数据域】_【业务描述】_【调度周期】【更新方式】\n```\n\n**示例**：\n- `prod_workspace.dws_ord_daily_order_stats_df` （天级全量）\n- `prod_workspace.dwd_ord_order_detail_di` （天级增量）\n- `prod_workspace.dws_usr_user_active_hf\n<!-- @import \"[TOC]\" {cmd=\"toc\" depthFrom=1 depthTo=6 orderedList=false} -->\n` （小时级）\n\n### 4. 字段定义收集\n\n必须提供以下信息：\n- **字段英文名**：蛇形命名（如 `user_id`, `order_amount`）\n- **字段中文名**：清晰业务含义\n- **数据类型**：STRING/BIGINT/DOUBLE/DATETIME/DECIMAL(p,s) 等\n\n**常用字段模板**：\n```sql\n-- 基础审计字段（强烈建议）\n`gmt_create`    DATETIME COMMENT '数据创建时间',\n`gmt_modified`  DATETIME COMMENT '数据修改时间',\n`ds`            STRING   COMMENT '数据日期，格式yyyyMMdd',\n```\n\n### 5. 表注释\n必须提供表级 COMMENT，格式：\n```sql\nCOMMENT '【数据域】_【业务描述】_【调度说明】，【主要字段说明】'\n```\n\n### 6. 分区字段\n\n**推荐分区策略**：\n| 调度类型 | 分区字段 | 说明 |\n|---------|---------|------|\n| 天级表 | `ds STRING` | 日期分区，格式 yyyyMMdd |\n| 小时级 | `ds STRING, hr STRING` | 日期+小时分区 |\n| 全量表 | 可选无分区 | 按业务需要 |\n\n**分区示例**：\n```sql\nPARTITIONED BY (`ds` STRING COMMENT '数据日期，格式yyyyMMdd')\n```\n\n### 7. 存储格式\n\n**默认使用 ALIORC**：\n```sql\nSTORED AS ALIORC\n```\n\n特殊情况可选项：\n- `STORED AS ALIORC` - 推荐，高压缩率\n- `STORED AS TEXTFILE` - 纯文本，调试用\n\n### 8. 生命周期（TTL）\n\n按数据层级设置默认 TTL：\n| 层级 | 建议 TTL | 说明 |\n|------|---------|------|\n| ODS | 30-90 天 | 原始数据短期保留 |\n| DWD | 180-365 天 | 明细数据中期保留 |\n| DWS | 365-730 天 | 汇总数据长期保留 |\n| ADS | 90-365 天 | 应用数据按需保留 |\n| DIM | 365 天或无 | 维度表通常长期保留 |\n\n**TTL 语法**：\n```sql\nTBLPROPERTIES ('lifecycle'='30')\n```\n\n---\n\n## 完整建表示例\n\n```sql\nCREATE TABLE IF NOT EXISTS prod_workspace.dws_ord_daily_order_stats_df (\n    -- 维度字段\n    `stat_date`         STRING      COMMENT '统计日期，格式yyyy-MM-dd',\n    `merchant_id`       BIGINT      COMMENT '商家ID',\n    `merchant_name`     STRING      COMMENT '商家名称',\n    `category_id`       BIGINT      COMMENT '类目ID',\n    \n    -- 指标字段\n    `order_cnt`         BIGINT      COMMENT '订单笔数',\n    `order_amount`      DECIMAL(18,2) COMMENT '订单金额',\n    `paid_cnt`          BIGINT      COMMENT '支付笔数',\n    `paid_amount`       DECIMAL(18,2) COMMENT '支付金额',\n    `refund_cnt`        BIGINT      COMMENT '退款笔数',\n    `refund_amount`     DECIMAL(18,2) COMMENT '退款金额',\n    \n    -- 衍生指标\n    `gmv`               DECIMAL(18,2) COMMENT 'GMV',\n    `actual_amt`        DECIMAL(18,2) COMMENT '实际成交金额',\n    \n    -- 审计字段\n    `gmt_create`        DATETIME    COMMENT '数据创建时间',\n    `gmt_modified`      DATETIME    COMMENT '数据修改时间'\n)\nCOMMENT '订单域_商家每日订单统计_天级全量，包含订单数、金额、退款等核心指标'\nPARTITIONED BY (`ds` STRING COMMENT '数据日期，格式yyyyMMdd')\nSTORED AS ALIORC\nTBLPROPERTIES ('lifecycle'='365');\n```\n\n---\n\n## 字段命名规范\n\n### 数据类型后缀（可选但推荐）\n| 类型 | 后缀 | 示例 |\n|------|------|------|\n| 数量/次数 | `_cnt` | `order_cnt`, `pv_cnt` |\n| 金额 | `_amt` / `_amount` | `order_amt`, `pay_amount` |\n| 比率/比例 | `_rate` / `_ratio` | `conversion_rate` |\n| 标识/ID | `_id` | `user_id`, `order_id` |\n| 时间 | `_time` | `create_time`, `pay_time` |\n| 日期 | `_date` / `_dt` | `stat_date`, `birth_dt` |\n| 标记/Flag | `_flag` / `_is_xxx` | `is_vip`, `del_flag` |\n\n### 常见缩写\n| 全称 | 缩写 | 示例 |\n|------|------|------|\n| count | cnt | `order_cnt` |\n| amount | amt | `pay_amt` |\n| number | num | `serial_num` |\n| identifier | id | `user_id` |\n| timestamp | ts | `create_ts` |\n| datetime | dt | `log_dt` |\n\n---\n\n## 快速核对清单\n\n建表完成后，确认以下事项：\n- [ ] 工作空间正确\n- [ ] 表名格式符合规范：`{层}_{域}_{业务}_{调度}`\n- [ ] 所有字段都有 COMMENT\n- [ ] 表有 COMMENT\n- [ ] 分区字段已定义（非全量表）\n- [ ] 存储格式为 ALIORC\n- [ ] TTL 已设置且合理\n","tags":{"latest":"0.1.0"},"stats":{"comments":0,"downloads":525,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773649873113,"updatedAt":1778491943830},"latestVersion":{"version":"0.1.0","createdAt":1773649873113,"changelog":"openclawsh v0.1.0\n\n- Initial release with comprehensive OpenClaw 数据仓库建表规范。\n- Guidance and templates for DDL creation across DWS, DWD, DIM, ADS, and ODS layers.\n- Standardized table naming, field definitions, partitioning strategies, storage format, and TTL recommendations.\n- Includes detailed field naming conventions and a complete sample CREATE TABLE statement.\n- Quick checklist provided to ensure all best practices are followed during table creation.","license":"MIT-0"},"metadata":null,"owner":{"handle":"jiangyan0722","userId":"s17e4w2hbtcfwj576nsk8kavtx885jbm","displayName":"JiangYan0722","image":"https://avatars.githubusercontent.com/u/165133796?v=4"},"moderation":null}