# 元数据和语义
表1**元数据查询** 
| 子命令                                            | 说明                                                                                        |
|:---|:---|
| meta list-schemas                                 | 列出所有 schema。                                                                             |
| meta list-tables \[--schema \<s\>\]                | 列出表（可按 schema 过滤）。                                                                      |
| meta list-databases                              | 列出所有数据库。                                                                                  |
| meta describe \<table\> \[--schema \<s\>\]        | 表结构富信息（8 段：基本信息 / 时间戳 / 存储 / 分布 / 分区 / 列 / 索引 / 扩展信息），支持 schema.table 输入与 cache-first 描述。 |
| meta search-tables \<keyword\>                   | 按名称关键词搜索表（ILIKE）。                                                                         |
| meta search-columns \<keyword\>                   | 按名称关键词搜索列（ILIKE）。                                                                        |
| meta list-partitions \<table\> \[--schema \<s\>\] | 列出表分区。                                                                                    |
| meta export-ddl \<table\> \[--schema \<s\>\]     | 导出表 DDL（CREATE TABLE）。                                                                 |
| meta export-meta \<table\> \[--schema \<s\>\]    | 导出单表元数据（类型、估算行数、页数）。                                                                     |
   
```
# 列出 schema / 表 / 数据库
hwc-dws-cli meta list-schemas
hwc-dws-cli meta list-tables --schema public
hwc-dws-cli meta list-databases --format table
# 表结构富信息（两种等价写法）
hwc-dws-cli meta describe ads_live.ads_anchor_ranking --format table
hwc-dws-cli meta describe ads_anchor_ranking --schema ads_live
# 搜索 / 分区 / 导出
hwc-dws-cli meta search-tables order
hwc-dws-cli meta search-columns user_id
hwc-dws-cli meta list-partitions fact_sales --schema dwd
hwc-dws-cli meta export-ddl fact_sales --schema dwd
hwc-dws-cli meta export-meta fact_sales --schema dwd
```
**标注** ：meta semantic 系列命令为**体验功能**，接口与行为可能随版本演进调整，不建议在正式自动化流程中依赖。
表2**语义元数据** 
| 子命令                                                                                                | 说明                      |
|:---|:---|
| meta semantic build \[--schema \<s\>\] \[--db-name \<n\>\] \[--no-progress\]                        | 触发 8 阶段语义构建 pipeline。     |
| meta semantic get \<table\> \[--schema \<s\>\]                                                      | 获取表的语义元数据。              |
| meta semantic set \<table\> \[--description\] \[--use-cases\] \[--schema \<s\>\]                     | 存储表的语义描述。                |
| meta semantic list-missing \[--schema \<s\>\]                                                        | 列出尚无语义元数据的表。             |
| meta semantic search \<pattern\>                                                                    | 按模式搜索语义元数据（LIKE / FTS5）。 |
| meta semantic delete \<table\> \[--schema \<s\>\]                                                 | 删除表的语义元数据。              |
| meta semantic show \[\<table\>\] \[--schema \<s\>\] \[--scope overview\\\|table\\\|joins\\\|udfs\] | 语义概览或表详情。               |
   
```
# 触发 8 阶段语义构建（可限定 schema）
hwc-dws-cli meta semantic build --schema public
# 查看语义概览 / 表详情
hwc-dws-cli meta semantic show --scope overview
hwc-dws-cli meta semantic show demo --schema public --scope table
hwc-dws-cli meta semantic show --schema public --scope joins
# 读写单表语义
hwc-dws-cli meta semantic set demo --description "订单明细表" --use-cases "电商订单分析"
hwc-dws-cli meta semantic get demo --schema public
# 检索与维护
hwc-dws-cli meta semantic search "订单"
hwc-dws-cli meta semantic list-missing --schema public
hwc-dws-cli meta semantic delete demo --schema public
```