data-ops-cli 0.4.0__tar.gz → 0.4.2__tar.gz

{data_ops_cli-0.4.0 → data_ops_cli-0.4.2}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: data-ops-cli
-Version: 0.4.0
+Version: 0.4.2
 Summary: Command-line wrapper around dataops_sdk for the DataOps platform.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
-Requires-Dist: dataops-sdk[runner]>=0.4.0
+Requires-Dist: dataops-sdk[runner]>=0.4.1
 Requires-Dist: typer
 Requires-Dist: rich
 Provides-Extra: dev

{data_ops_cli-0.4.0 → data_ops_cli-0.4.2}/pyproject.toml

@@ -9,7 +9,7 @@ description = "Command-line wrapper around dataops_sdk for the DataOps platform.
 requires-python = ">=3.11"
 readme = "README.md"
 dependencies = [
-    "dataops-sdk[runner]>=0.4.0",
+    "dataops-sdk[runner]>=0.4.1",
     "typer",
     "rich",
 ]

{data_ops_cli-0.4.0 → data_ops_cli-0.4.2}/src/data_ops_cli.egg-info/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: data-ops-cli
-Version: 0.4.0
+Version: 0.4.2
 Summary: Command-line wrapper around dataops_sdk for the DataOps platform.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
-Requires-Dist: dataops-sdk[runner]>=0.4.0
+Requires-Dist: dataops-sdk[runner]>=0.4.1
 Requires-Dist: typer
 Requires-Dist: rich
 Provides-Extra: dev

{data_ops_cli-0.4.0 → data_ops_cli-0.4.2}/src/data_ops_cli.egg-info/SOURCES.txt

@@ -31,4 +31,5 @@ src/dataops_cli/cli/skill.py
 src/dataops_cli/cli/table.py
 src/dataops_cli/cli/utils.py
 src/dataops_cli/cli/widget.py
-src/dataops_cli/cli/workflow.py
+src/dataops_cli/cli/workflow.py
+tests/test_table_relation.py

{data_ops_cli-0.4.0 → data_ops_cli-0.4.2}/src/data_ops_cli.egg-info/requires.txt

@@ -1,4 +1,4 @@
-dataops-sdk[runner]>=0.4.0
+dataops-sdk[runner]>=0.4.1
 typer
 rich
 

{data_ops_cli-0.4.0 → data_ops_cli-0.4.2}/src/dataops_cli/__init__.py

@@ -14,4 +14,4 @@ groups command modules under :mod:`dataops_cli.cli` and re-exports the package
     removed in ``dataops_cli`` 1.0.
 """
 
-__version__ = "0.4.0"
+__version__ = "0.4.2"

{data_ops_cli-0.4.0 → data_ops_cli-0.4.2}/src/dataops_cli/cli/auth.py

@@ -9,14 +9,14 @@
 from typing import Annotated
 
 import typer
-from dataops_sdk.constants import USER_INFO_FILE
+from dataops_cli.cli.utils import print_list
+from dataops_sdk.constants import APPLICATION_FILE, USER_INFO_FILE
 from dataops_sdk.exceptions import AuthenticationError
 from dataops_sdk.schemas import UserInfo
 from dataops_sdk.services.auth import (
     service_get_current_application,
     service_list_applications,
     service_login,
-    service_logout,
     service_set_application,
 )
 from dataops_sdk.services.datasource import (
@@ -26,13 +26,20 @@ from dataops_sdk.utils import get_work_dir
 from rich.console import Console
 from rich.table import Table
 
-from dataops_cli.cli.utils import print_list
-
 auth_typer = typer.Typer(name="auth", help="认证相关命令", no_args_is_help=True)
 application_typer = typer.Typer(name="application", help="应用相关命令", no_args_is_help=True)
 auth_typer.add_typer(application_typer)
 
 
+def _require_login() -> None:
+    """未登录时引导登录并退出。"""
+    if not get_work_dir(USER_INFO_FILE).exists():
+        typer.echo("未登录，请先执行登录：")
+        typer.echo("  data-ops-cli auth login <用户名> <密码>")
+        typer.echo("登录后执行 data-ops-cli auth application set <应用code> 设置应用")
+        raise typer.Exit(code=401)
+
+
 @auth_typer.command("status")
 def auth_status() -> None:
     """显示当前认证状态。
@@ -43,22 +50,22 @@ def auth_status() -> None:
     如果已登录但未设置应用，提示用户设置应用；
     否则同时输出应用关联的主/隐患数据源信息。
     """
-    target_path = get_work_dir(USER_INFO_FILE)
-    if not target_path.exists():
-        print("未登录")
-    else:
-        user_info = UserInfo.model_validate_json(target_path.read_bytes())
+    _require_login()
+    user_info = UserInfo.model_validate_json(get_work_dir(USER_INFO_FILE).read_bytes())
     try:
-        # application
         application = service_get_current_application()
         datasource_config = service_get_main_datasource_config_by_application()
     except AuthenticationError:
         print(f"{user_info.true_name}({user_info.user_name})登录过期，请重新登录")
     else:
         if application is None:
-            print(f"{user_info.true_name}({user_info.user_name})已登录, 应用未设置")
+            typer.echo(
+                f"{user_info.true_name}({user_info.user_name})已登录, 应用未设置\n请执行 data-ops-cli auth application set <应用code> 设置应用",
+                err=True,
+            )
+            raise typer.Exit(code=1)
         else:
-            print(
+            typer.echo(
                 f"{user_info.true_name}({user_info.user_name})已登录, 应用设置为{application.LABEL_CN}({application.CODE})"
             )
 
@@ -120,11 +127,11 @@ def logout() -> None:
     Examples:
         >>> data-ops-cli auth logout
     """
-    ret = service_logout()
-    if ret:
-        print("登出成功")
-    else:
-        print("登出失败: 未登录")
+    for filename in (USER_INFO_FILE, APPLICATION_FILE):
+        path = get_work_dir(filename)
+        if path.exists() and path.is_file():
+            path.unlink()
+    print("登出成功，已清除本地登录信息")
 
 
 @application_typer.command("list")
@@ -146,6 +153,7 @@ def application_list(
         通过关键字过滤应用
         >>> data-ops-cli auth application list -q myapp
     """
+    _require_login()
     try:
         applications = service_list_applications(query)
     except Exception as e:
@@ -175,11 +183,12 @@ def application_set(code: Annotated[str, typer.Argument(help="应用编码")]) -
         设置当前应用
         >>> data-ops-cli auth application set myapp_code
     """
+    _require_login()
     try:
         application = service_set_application(code)
-    except ValueError as e:
-        typer.echo(f"错误: {e}")
-        raise typer.Exit(code=1) from None
+    except ValueError:
+        typer.echo("输入的code值错误，请重新输入！")
+        raise typer.Exit(code=1)
 
     table = Table("field", "value", title="应用信息", show_header=False)
     table.add_row("code", application.CODE)
@@ -197,6 +206,7 @@ def application_info() -> None:
     查看当前已设置应用的详细信息，包括编码、标题和备注。
     如果尚未设置应用，提示用户使用 ``auth application set`` 命令进行设置。
     """
+    _require_login()
     application = service_get_current_application()
     if application is None:
         print("未设置应用, 执行 `data-ops-cli auth application set <code>` 进行设置应用.")

{data_ops_cli-0.4.0 → data_ops_cli-0.4.2}/src/dataops_cli/cli/dataset.py

@@ -1,24 +1,40 @@
 """数据集管理命令组.
 
-提供数据集的列表查询、详情、数据量统计与实际数据获取能力。
+提供数据集的列表查询、详情、数据量统计与实际数据获取。
 """
 
+from pathlib import Path
 from typing import Annotated
 
 import typer
+from pydantic_core import to_json
+
 from dataops_sdk.exceptions import DataOpsError
-from dataops_sdk.schemas import PageParam, SqlFilter, SqlQueryParam
+from dataops_sdk.schemas import MetaType, PageParam, SqlFilter, SqlQueryParam
 from dataops_sdk.services import (
+    release_list_get_by_code,
+    release_list_update,
     service_count_dataset_by_code,
     service_get_dataset_data_by_code,
     service_get_dataset_detail_by_code,
     service_list_datasets,
 )
-from dataops_sdk.utils import filter_nodes_by_pattern
+from dataops_sdk.session import get_session
+from dataops_sdk.utils import encrypt_body, filter_nodes_by_pattern
 
 from dataops_cli.cli.utils import print_list, print_table_column_detail
 
+# 数据集 rawData 中承载 SQL 定义的字段名（subType=sql 的数据集均有此字段）。
+SQL_FIELD = "text"
+
+
 dataset_typer = typer.Typer(name="dataset", help="Manage dataset.", no_args_is_help=True)
+update_typer = typer.Typer(name="update", help="变更", no_args_is_help=True)
+dataset_typer.add_typer(update_typer)
+column_typer = typer.Typer(name="column", help="列变更", no_args_is_help=True)
+update_typer.add_typer(column_typer)
+sql_typer = typer.Typer(name="sql", help="SQL 编辑", no_args_is_help=True)
+update_typer.add_typer(sql_typer)
 
 
 @dataset_typer.command("list")
@@ -195,3 +211,125 @@ def get_dataset_data(
     headers = list(data[0].keys())
     rows = (tuple(row.get(header) for header in headers) for row in data)
     print_list(headers, rows)
+
+
+@column_typer.command("base", no_args_is_help=True)
+def update_dataset_column(
+    code: Annotated[str, typer.Argument(help="数据集编码")],
+    column_name: Annotated[str, typer.Argument(help="列名")],
+    title: Annotated[str | None, typer.Option(help="中文名称")] = None,
+    pk: Annotated[bool | None, typer.Option(help="主键")] = None,
+    nullable: Annotated[bool | None, typer.Option(help="是否可为空")] = None,
+    labelKey: Annotated[bool | None, typer.Option(help="名称键")] = None,
+    remark: Annotated[str | None, typer.Option(help="备注")] = None,
+) -> None:
+    """修改数据集的列基础配置."""
+    updates = {
+        attr: value
+        for attr, value in {
+            "title": title,
+            "pk": pk,
+            "nullable": nullable,
+            "labelKey": labelKey,
+            "remark": remark,
+        }.items()
+        if value is not None
+    }
+    if not updates:
+        typer.echo("请输入要修改的列配置", err=True)
+        raise typer.Exit(code=1)
+    try:
+        meta = service_get_dataset_detail_by_code(code)
+        assert meta.data, f"数据集 {code} 不存在"
+        column_item = next((c for c in meta.data.columns if c.name == column_name), None)
+        if column_item is None:
+            typer.echo(f"数据集 {code} 中不存在字段 {column_name}")
+            raise typer.Exit(code=1)
+        for attr, value in updates.items():
+            setattr(column_item, attr, value)
+        release_list_update(meta)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    typer.echo(f"修改数据集 {code} 字段 {column_item.name} 完成")
+
+
+def _load_sql(code: str):
+    """校验数据集存在 SQL 字段并返回 Meta；失败统一报错退出."""
+    try:
+        meta = release_list_get_by_code(MetaType.DATASET, code)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}", err=True)
+        raise typer.Exit(code=1) from None
+    data = meta.data
+    if not isinstance(data, dict) or not isinstance(data.get(SQL_FIELD), str):
+        typer.echo(f"数据集 {code} 未找到 SQL 字段({SQL_FIELD})", err=True)
+        raise typer.Exit(code=1)
+    return meta
+
+
+def _save_sql(meta, sql: str) -> None:
+    """整段替换 SQL 并保存：先解析字段回填 columns（失败仅警告），保存失败统一报错."""
+    meta.data[SQL_FIELD] = sql
+    try:
+        meta_payload = meta.model_dump(mode="json", exclude={"data"})
+        meta_payload["rawData"] = to_json(meta.data).decode()
+        with get_session() as session:
+            resp = session.post(
+                "/data/dataset/analysis",
+                content=to_json(encrypt_body({"meta": meta_payload, "params": []})),
+            )
+            resp.raise_for_status()
+            meta.data["columns"] = resp.json()["data"]["columns"]
+            typer.echo(f"字段解析完成（{len(meta.data['columns'])} 列）")
+    except Exception as e:
+        typer.echo(f"⚠️ 字段解析失败，仅保存 SQL: {e}", err=True)
+    try:
+        release_list_update(meta)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}", err=True)
+        raise typer.Exit(code=1) from None
+
+
+@sql_typer.command("edit", no_args_is_help=True)
+def edit_dataset_sql(
+    code: Annotated[str, typer.Argument(help="数据集编码")],
+    old_texts: Annotated[
+        list[str],
+        typer.Option("--old-text", help="待替换文本（可多次传入，与 --new-text 一一对应）"),
+    ],
+    new_texts: Annotated[
+        list[str],
+        typer.Option("--new-text", help="替换后的文本（与 --old-text 一一对应）"),
+    ],
+) -> None:
+    """按 --old-text/--new-text 成对精准替换 SQL 文本."""
+    if len(old_texts) != len(new_texts):
+        typer.echo("参数 --old-text 与 --new-text 数量不一致", err=True)
+        raise typer.Exit(code=1)
+    meta = _load_sql(code)
+    content = meta.data[SQL_FIELD]
+    for idx, (old, new) in enumerate(zip(old_texts, new_texts), start=1):
+        if old not in content:
+            typer.echo(f"[{idx}] 未找到匹配文本 {old}", err=True)
+            raise typer.Exit(code=1)
+        content = content.replace(old, new, count=1)
+    _save_sql(meta, content)
+    typer.echo(f"数据集 {code} SQL 更新成功")
+
+
+@sql_typer.command("write", no_args_is_help=True)
+def write_dataset_sql(
+    code: Annotated[str, typer.Argument(help="数据集编码")],
+    file: Annotated[Path | None, typer.Argument(help="输入文件路径")] = None,
+    content: Annotated[str | None, typer.Option("--content", help="SQL 内容")] = None,
+) -> None:
+    """整段写入 SQL，file 与 --content 至少指定一个."""
+    if file:
+        content = file.read_text(encoding="utf-8")
+    elif not content:
+        typer.echo("参数 file 或 --content 必须指定一个", err=True)
+        raise typer.Exit(code=1)
+    meta = _load_sql(code)
+    _save_sql(meta, content)
+    typer.echo(f"数据集 {code} SQL 写入成功")

data_ops_cli-0.4.2/src/dataops_cli/cli/dict_.py

@@ -0,0 +1,219 @@
+"""字典（dict）管理命令组.
+
+提供数据源字典的列表查询、详情查看、字典树以及字段增删改能力。
+"""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+from dataops_sdk.exceptions import DataOpsError
+from dataops_sdk.schemas import MetaType
+from dataops_sdk.services.dict_ import (
+    service_get_dict_detail_by_code,
+    service_get_dict_detail_by_name,
+    service_list_dicts,
+    servive_tree_dict,
+)
+from dataops_sdk.services.meta import release_list_get_by_code, release_list_update
+from dataops_sdk.utils import filter_nodes_by_pattern
+
+from dataops_cli.cli.utils import print_group_tree, print_list
+
+dict_typer = typer.Typer(name="dict", help="Manage dict.", no_args_is_help=True)
+field_typer = typer.Typer(name="field", help="字典字段变更", no_args_is_help=True)
+dict_typer.add_typer(field_typer)
+
+
+def _find_option_index(options: list, value: str) -> int | None:
+    """在 options 列表中按 value 查找下标，未找到返回 None."""
+    return next((i for i, o in enumerate(options) if str(o.get("value")) == value), None)
+
+
+@dict_typer.command("list")
+def list_dict(
+    datasource: Annotated[str, typer.Argument(help="数据源")],
+    query: Annotated[str | None, typer.Option("-q", "--query", help="字典名称关键字")] = None,
+) -> None:
+    """列出数据源中的字典列表。
+
+    支持通过关键字过滤字典名称，并支持正则表达式匹配。
+
+    Args:
+        datasource: 数据源名称。
+        query: 可选字典名称关键字（支持正则）。
+
+    Examples:
+        # 列出指定数据源的所有字典
+        >>> data-ops-cli dict list <datasource>
+
+        # 列出数据源中名称包含 "user" 的字典
+        >>> data-ops-cli dict list <datasource> -q user
+
+        # 使用正则过滤字典名
+        >>> data-ops-cli dict list <datasource> -q "^user_.*"
+    """
+    try:
+        group_nodes = service_list_dicts(datasource)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+
+    if not group_nodes:
+        print("未查询到匹配字典")
+        return
+
+    if query:
+        group_nodes = filter_nodes_by_pattern(group_nodes, query)
+
+    print_list(
+        ["code", "name", "alias"],
+        [[column.code, column.name, column.title] for column in group_nodes],
+    )
+
+
+@dict_typer.command("detail", no_args_is_help=True)
+def get_dict_detail(
+    arg1: Annotated[str, typer.Argument(help="编码或数据源")],
+    name: Annotated[str | None, typer.Argument(help="字典名称")] = None,
+) -> None:
+    """获取字典详情信息。
+
+    支持两种查询方式:
+
+    1. 通过字典编码(CODE)直接查询
+    2. 通过数据源名称和字典名称组合查询
+
+    默认只显示字典选项的基本信息(label/value)
+
+    Args:
+        arg1: 字典编码；当同时提供 ``name`` 时为数据源名称。
+        name: 可选字典名称。
+
+    Examples:
+        # 通过字典编码查询字典结构
+        >>> data-ops-cli dict detail dict_code_123
+
+        # 通过数据源和字典名查询
+        >>> data-ops-cli dict detail <datasource> my_dict
+    """
+    try:
+        meta = (
+            service_get_dict_detail_by_name(arg1, name)
+            if name
+            else service_get_dict_detail_by_code(arg1)
+        )
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    print(f"{meta.name}({meta.title})")
+    print_list(["value", "label"], [[option.value, option.label] for option in meta.data.options])
+
+
+@dict_typer.command("tree")
+def tree_dict(
+    query: Annotated[str | None, typer.Option("-q", "--query", help="字典名称关键字")] = None,
+) -> None:
+    """展示字典树结构。
+
+    Args:
+        query: 字典名称关键字（支持正则）。
+    """
+    try:
+        tree = servive_tree_dict()
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    print_group_tree(tree, query)
+
+
+@field_typer.command("add", no_args_is_help=True)
+def add_field(
+    code: Annotated[str, typer.Argument(help="字典编码")],
+    value: Annotated[str, typer.Argument(help="选项值")],
+    label: Annotated[str, typer.Argument(help="选项标签")],
+) -> None:
+    """新增字典字段。
+
+    Args:
+        code: 字典编码。
+        value: 选项值。
+        label: 选项标签。
+
+    Examples:
+        # 单条新增
+        >>> data-ops-cli dict field add dict_code_001 3 第三选项
+    """
+    try:
+        meta = release_list_get_by_code(MetaType.DICT, code)
+        options = meta.data.setdefault("options", []) if meta.data else []
+        if any(str(o.get("value")) == value for o in options):
+            typer.echo(f"字典 {code} 中已存在 value={value}", err=True)
+            raise typer.Exit(code=1)
+        options.append({"value": value, "label": label, "id": ""})
+        release_list_update(meta, datasource=meta.subSystem)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    print(f"新增 {code} {value} 完成")
+
+
+@field_typer.command("edit", no_args_is_help=True)
+def edit_field(
+    code: Annotated[str, typer.Argument(help="字典编码")],
+    value: Annotated[str, typer.Argument(help="选项值")],
+    label: Annotated[str, typer.Argument(help="新标签")],
+) -> None:
+    """编辑字典字段标签。
+
+    Args:
+        code: 字典编码。
+        value: 要修改的选项值。
+        label: 新的标签名。
+
+    Examples:
+        >>> data-ops-cli dict field edit dict_code_001 0 禁用
+    """
+    try:
+        meta = release_list_get_by_code(MetaType.DICT, code)
+        options = meta.data.get("options", []) if meta.data else []
+        idx = _find_option_index(options, value)
+        if idx is None:
+            typer.echo(f"字典中不存在选项: {value}", err=True)
+            raise typer.Exit(code=1)
+        options[idx]["label"] = label
+        release_list_update(meta, datasource=meta.subSystem)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    print(f"修改 {code} {value} 完成")
+
+
+@field_typer.command("delete", no_args_is_help=True)
+def delete_field(
+    code: Annotated[str, typer.Argument(help="字典编码")],
+    value: Annotated[str, typer.Argument(help="选项值")],
+) -> None:
+    """删除字典字段。
+
+    Args:
+        code: 字典编码。
+        value: 要删除的选项值。
+
+    Examples:
+        >>> data-ops-cli dict field delete dict_code_001 0
+    """
+    try:
+        meta = release_list_get_by_code(MetaType.DICT, code)
+        options = meta.data.get("options", []) if meta.data else []
+        idx = _find_option_index(options, value)
+        if idx is None:
+            typer.echo(f"字典中不存在选项: {value}", err=True)
+            raise typer.Exit(code=1)
+        options.pop(idx)
+        release_list_update(meta, datasource=meta.subSystem)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    print(f"删除 {code} {value} 完成")

{data_ops_cli-0.4.0 → data_ops_cli-0.4.2}/src/dataops_cli/cli/metrics.py

@@ -9,12 +9,12 @@
 from typing import Annotated
 
 import typer
-from dataops_sdk.schemas.enums import MetaType
-from dataops_sdk.schemas.query import SqlQueryParam
-from dataops_sdk.services.meta import (
-    DataOpsError,
+from dataops_sdk.exceptions import DataOpsError
+from dataops_sdk.schemas import MetaType, PageParam, SqlFilter, SqlQueryParam
+from dataops_sdk.services import (
     release_list_get_by_code,
     release_list_list,
+    service_get_metrics_data_by_code,
 )
 from dataops_sdk.utils import filter_nodes_by_pattern
 from rich.console import Console
@@ -175,3 +175,67 @@ def get_metrics_detail(
                     style.get("color", ""),
                 )
             console.print(level_table)
+
+
+@metrics_typer.command("data", no_args_is_help=True)
+def get_metrics_data(
+    code: Annotated[str, typer.Argument(help="指标编码")],
+    page_num: Annotated[int, typer.Option("-n", "--page-num", help="页码")] = 0,
+    page_size: Annotated[int, typer.Option("-s", "--page-size", help="每页大小")] = 20,
+    filters: Annotated[
+        list[SqlFilter] | None,
+        typer.Option(
+            "--condition",
+            "-c",
+            parser=SqlFilter.from_str,
+            help='查询条件(可多次传入)，JSON 格式 {"name":"字段名","value":值[,"expression":"eq"]}，expression 缺省 eq',
+        ),
+    ] = None,
+    dimensions: Annotated[
+        list[str] | None,
+        typer.Option(
+            "--dimension",
+            "-d",
+            help="维度字段名",
+        ),
+    ] = None,
+) -> None:
+    """获取指标实际数据。
+
+    通过指标编码查询指标维度下的实际数据行，支持分页与查询条件过滤。
+
+    Args:
+        code: 指标编码。
+        page_num: 页码，默认 0。
+        page_size: 每页大小，默认 20。
+        filters: 查询条件，JSON 格式 ``{"name": 字段名, "value": 值[, "expression": 表达式]}``。
+            可多次传入，多个条件按 AND 组合；``expression`` 缺省为 ``eq``，可选
+            ``eq/ne/gt/ge/lt/le/in/notin/like/notlike/between/notbetween/isnull/isnotnull``。
+
+    Examples:
+        通过指标编码获取指标数据（默认返回前20条）
+        >>> data-ops-cli metrics data 1777544300561_98429
+
+        从第2页开始，每页50条
+        >>> data-ops-cli metrics data 1777544300561_98429 --page-num 2 --page-size 50
+
+        带查询条件过滤（d_cycle_time 等于 2026-04-18）
+        >>> data-ops-cli metrics data 1777544300561_98429 -c '{"name":"d_cycle_time","value":"2026-04-18"}'
+    """
+    pp = PageParam(start=page_num * page_size, limit=page_size)
+
+    qp = SqlQueryParam()
+    if filters:
+        qp.add(*(filter_item.to_condition() for filter_item in filters))
+    try:
+        data = service_get_metrics_data_by_code(code, pp, qp, dimensions)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    if not data:
+        typer.echo("未查询到数据", err=True)
+        return
+    # 使用第一行字段顺序作为表头，保证每行数据与表头位置对应。
+    headers = list(data[0].keys())
+    rows = (tuple(row.get(header) for header in headers) for row in data)
+    print_list(headers, rows)