更新时间:2026-11-03 GMT+08:00
分享

元数据和语义

表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

相关文档