DataOps 命令行参考
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_1618a396/data-ops-cli-usage。
技能介绍
你会碰到的具体场景
在 DataOps 平台上维护数据源、物理表、逻辑数据集、工作流或指标时,实体类型多、REST 路径分散:列表和详情往往走统一的 /meta/release/*,而执行类能力又有各自控制器。若不清楚 meta-type 与 CLI 命令组的对应关系,很容易查错接口或在 datasource、table、dataset 之间选错子命令。
本技能整理 data-ops-cli 的用法骨架:命令树、认证方式、环境变量,以及平台把元数据统一建模为 meta release 行 时用 type(meta-type)区分的规则。文中用表格对照 datasource、table、dataset、data_table、dict、widget、metrics、api、report、workflow、template、skill 的业务含义与应使用的命令组,便于判断「这类对象该走哪条 CLI 路径」。
技能覆盖的核心内容
- 通用元数据路径:理解列表/详情/引用关系如何通过 meta release 接口完成,再按 meta-type 落到具体命令组。
- 环境与认证:
DATA_OPS_USERNAME、DATA_OPS_PASSWORD、DATA_OPS_BASE_URL等变量的含义与默认服务地址约定。 - 与 SDK 的分工:需要写 Python 调用平台 SDK 时,应使用 data-ops-sdk-usage 技能,本技能专注命令行侧。
- 延伸文档索引:完整 CLI 参考、核心传输表速查、
SqlQueryParam格式、统一分析链路组合方式等,可按任务再深入查阅。
边界与注意点
alarm(告警规则) 与 hazard(隐患) 不是 meta-type,由 data-ops-guard 的 /alarm/*、/hazard/* 提供,不走 /meta/release/*。ref(引用关系) 也不是独立 meta-type,而是任意 meta 之间的正向/反向引用查询。datasource 在枚举上还可能涉及 SDK 中的 InnerMetaType,与常规 MetaType 并列理解时以技能内说明为准。
使用场景
- 新接入 MySQL 或 Doris 后,要用 CLI 登记数据源并核对 table 元数据是否与物理 DDL 一致
- 需要从多张物理表 join 出逻辑 dataset,先确认 meta-type 与 dataset 命令组,再查数据或统计量
- 编排 ETL 工作流前,用 workflow 相关命令查看流程定义、模板与实例是否已发布
- 维护看板卡片时,区分 widget 与 metrics 命令组,避免把指标定义和展示组件混在同一条 meta 路径里查
适合人员
- 平台元数据管理员:日常通过 CLI 批量查看 datasource、dict、api 等 meta release 详情
- 数据工程师:要在不改 Python 的前提下用命令行触发工作流同步/异步运行并核对节点配置
- 运维值班人员:仅持有账号密码与环境变量,需在跳板机上快速定位某张传输表该用 table 还是 dataset 命令
- 分析实施同学:依赖 SqlQueryParam 与统一分析链路文档,把 CLI 查询步骤串成可复现的排查脚本