dataops-sdk 0.4.4__tar.gz → 0.5.0__tar.gz

{dataops_sdk-0.4.4 → dataops_sdk-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dataops-sdk
-Version: 0.4.4
+Version: 0.5.0
 Summary: Python SDK for the DataOps platform.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{dataops_sdk-0.4.4 → dataops_sdk-0.5.0}/src/dataops_sdk/__init__.py

@@ -44,7 +44,9 @@ from .services import (  # noqa: F401
     service_get_data_table_by_code,
     service_get_data_table_by_name,
     service_get_data_table_data_by_code,
+    service_get_data_table_data_ext_by_code,
     service_get_data_table_data_by_name,
+    service_get_data_table_data_ext_by_name,
     service_get_data_table_record_by_id,
     service_get_data_table_reference_list,
     service_get_data_table_total,
@@ -109,4 +111,4 @@ from .services import (  # noqa: F401
 )
 from .session import dataops_base_url_context, request_context
 
-__version__ = "0.4.4"
+__version__ = "0.5.0"

{dataops_sdk-0.4.4 → dataops_sdk-0.5.0}/src/dataops_sdk/schemas/__init__.py

@@ -40,10 +40,20 @@ from .meta import (
     MetaRef,
     MetaUpdate,
 )
+from .ontology import (
+    OntologyConstraint,
+    OntologyMeta,
+    OntologyMetaData,
+    OntologyOnCondition,
+    OntologyOnOperand,
+    OntologyRef,
+    OntologyRelation,
+    OntologyRelationJoin,
+    OntologyScenario,
+)
 from .query import PageParam, SqlCondition, SqlFilter, SqlQueryParam, SqlSort
 from .report import ReportMeta, ReportMetaData
 from .skill import DataSkill, DataSkillSubFile, MetaSkill, SkillCallResult
-from .tag import TagBrief, TagEntityType, TagTreeNode
 from .table import (
     ColumnItem,
     DataBaseColumnDictExternal,
@@ -52,14 +62,7 @@ from .table import (
     DataBaseColumnTableExternal,
     DataDataBase,
 )
+from .tag import TagBrief, TagEntityType, TagTreeNode
 from .user import Application, UserInfo
 from .widget import WidgetMeta, WidgetMetaData
-from .wiki import (
-    KbType,
-    KnowledgeBase,
-    KnowledgeDocument,
-    KnowledgeSearchResult,
-    WikiPage,
-    WikiPageResult,
-)
 from .workflow import DataWorkflow, MetaWorkflow

{dataops_sdk-0.4.4 → dataops_sdk-0.5.0}/src/dataops_sdk/schemas/data_table.py

@@ -387,11 +387,14 @@ class DataTableField(BaseModel):
 
     Attributes:
         id: 字段唯一标识 (UUID)。
-        dbName: 存储在数据库中的字段/列名。
-        dbType: 字段类型。
+        dbName: 存储在数据库中的字段/列名（主表物理列）。
+        dbType: 数据库列类型（虚拟列 lookup/rollup 可为空）。
         title: 前端显示标题。
         name: 前端显示的字段/列名。
         type: 字段类型。
+        source: 字段来源（main/aux）。
+        table_alias: 附属表别名（source=aux）。
+        column_name: 附属表物理列名（source=aux，替代 dbName）。
         pk: 是否主键。
         label: 是否标签字段（用于卡片/记录展示）。
         visible: 是否在表格中可见。
@@ -401,17 +404,45 @@ class DataTableField(BaseModel):
         align: 文本对齐方式。
         default_value: 新增记录时的默认值。
         type_ext: 类型扩展配置。
+        readonly: 是否只读。
+        join_key: 是否为附属表关联键。
+        maintain_permission: 维护权限。
     """
 
     id: Annotated[str | None, Field(description="字段唯一标识 (UUID)", exclude=True)] = None
 
-    dbName: Annotated[str, Field(description="字段名称/列名 (存储在数据库中的名称)")]
-    dbType: Annotated[ColumnType, Field(description="字段类型")]
+    dbName: Annotated[
+        str | None,
+        Field(description="字段名称/列名 (存储在数据库中的名称)", default=None),
+    ] = None
+    dbType: Annotated[
+        ColumnType | str | None,
+        Field(description="字段类型", default=None),
+    ] = None
 
     title: Annotated[str | None, Field(description="显示标题")]
     name: Annotated[str, Field(description="字段名称/列名 (前端显示的名称)")]
     type: Annotated[str | None, Field(description="字段类型")] = None
 
+    source: Annotated[
+        Literal["main", "aux"] | None,
+        Field(description="字段来源"),
+    ] = None
+    table_alias: Annotated[
+        str | None,
+        Field(
+            description="附属表别名",
+            validation_alias=AliasChoices("tableAlias", "table_alias"),
+        ),
+    ] = None
+    column_name: Annotated[
+        str | None,
+        Field(
+            description="附属表物理列名",
+            validation_alias=AliasChoices("columnName", "column_name"),
+        ),
+    ] = None
+
     # 数据属性
     pk: Annotated[bool, Field(description="是否主键")] = False
     label: Annotated[bool, Field(description="是否标签字段 (用于卡片/记录展示)")] = False
@@ -435,7 +466,22 @@ class DataTableField(BaseModel):
         Field(description="类型扩展配置", validation_alias=AliasChoices("typeExt", "type_ext")),
     ] = None
 
-    model_config = ConfigDict(extra="allow")
+    readonly: Annotated[bool | None, Field(description="是否只读")] = None
+    join_key: Annotated[
+        bool | None,
+        Field(
+            description="是否为附属表关联键", validation_alias=AliasChoices("joinKey", "join_key")
+        ),
+    ] = None
+    maintain_permission: Annotated[
+        str | None,
+        Field(
+            description="维护权限",
+            validation_alias=AliasChoices("maintainPermission", "maintain_permission"),
+        ),
+    ] = None
+
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
 
 
 # ---------------------------------------------------------------------------
@@ -525,6 +571,28 @@ class CustomButton(BaseModel):
 # ---------------------------------------------------------------------------
 
 
+class QueryPlugin(BaseModel):
+    """查询组件插件配置.
+
+    Attributes:
+        type: 插件类型，如 ``field``。
+    """
+
+    type: Annotated[str, Field(description="插件类型")] = "field"
+
+
+class QueryConditionExpression(BaseModel):
+    """查询条件表达式配置.
+
+    Attributes:
+        expression: 条件表达式。
+    """
+
+    expression: Annotated[SqlExpression | None, Field(description="条件表达式")] = None
+
+    model_config = ConfigDict(extra="allow")
+
+
 class QueryCondition(BaseModel):
     """查询条件 (公开级别).
 
@@ -532,15 +600,25 @@ class QueryCondition(BaseModel):
         id: 条件 ID。
         name: 字段名。
         title: 显示标题。
-        condition: 条件表达式和值的映射。
+        condition: 条件表达式配置。
+        plugin: 查询组件插件。
+        db_type: 字段数据库类型。
     """
 
     id: Annotated[str | None, Field(description="条件ID")] = None
     name: Annotated[str, Field(description="字段名")]
     title: Annotated[str | None, Field(description="显示标题")]
-    condition: Annotated[dict[SqlExpression, Any], Field(description="条件表达式和值")] = Field(
-        default_factory=dict
-    )
+    condition: Annotated[
+        QueryConditionExpression | None,
+        Field(description="条件表达式配置"),
+    ] = None
+    plugin: Annotated[QueryPlugin | None, Field(description="查询组件插件")] = None
+    db_type: Annotated[
+        ColumnType | str | None,
+        Field(description="字段数据库类型", validation_alias=AliasChoices("dbType", "db_type")),
+    ] = None
+
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
 
 
 class QueryFormParams(BaseModel):

{dataops_sdk-0.4.4 → dataops_sdk-0.5.0}/src/dataops_sdk/schemas/enums.py

@@ -76,6 +76,9 @@ class MetaType(StrEnum):
     # 字典
     DICT = "dict"
     """字典。"""
+    # 本体
+    ONTOLOGY = "ontology"
+    """本体。"""
 
     def __repr__(self):
         return self.value

{dataops_sdk-0.4.4 → dataops_sdk-0.5.0}/src/dataops_sdk/schemas/group.py

@@ -6,7 +6,7 @@
 
 from typing import Annotated
 
-from pydantic import AliasChoices, BaseModel, Field, JsonValue
+from pydantic import AliasChoices, BaseModel, ConfigDict, Field, JsonValue
 
 
 class GroupTree(BaseModel):
@@ -31,16 +31,24 @@ class GroupTree(BaseModel):
 
 
 class GroupNode(BaseModel):
+    """分组树节点.
+
+    与前端 ``addGroupNode`` 请求体对齐：``pid`` / ``parentId`` / ``digest`` 等字段可选；
+    展示名称通过 ``label`` 传入，模型内部字段名为 ``title``。
+    """
+
+    model_config = ConfigDict(populate_by_name=True)
+
     id: Annotated[
         str, Field(description="元数据ID", validation_alias=AliasChoices("id", "cuid", "CUID"))
     ]
-    pid: Annotated[str | None, Field(description="父ID")]
+    pid: Annotated[str | None, Field(description="父ID")] = None
     parentId: Annotated[
         str | None,
         Field(
             description="父ID", validation_alias=AliasChoices("parentId", "parent_id", "PARENT_ID")
         ),
-    ]
+    ] = None
 
     type: Annotated[str, Field(description="类型", validation_alias=AliasChoices("type", "TYPE"))]
     subType: Annotated[
@@ -48,18 +56,23 @@ class GroupNode(BaseModel):
         Field(
             description="子类型", validation_alias=AliasChoices("subType", "sub_type", "SUB_TYPE")
         ),
-    ]
+    ] = None
 
     name: Annotated[str, Field(description="名称", validation_alias=AliasChoices("name", "NAME"))]
     title: Annotated[
-        str, Field(description="中文名称", validation_alias=AliasChoices("label", "title", "TITLE"))
+        str,
+        Field(
+            description="中文名称",
+            validation_alias=AliasChoices("label", "title", "TITLE"),
+            serialization_alias="label",
+        ),
     ]
     digest: Annotated[
         str | None, Field(description="摘要", validation_alias=AliasChoices("digest", "DIGEST"))
-    ]
+    ] = None
     remark: Annotated[
         str | None, Field(description="备注", validation_alias=AliasChoices("remark", "REMARK"))
-    ]
+    ] = None
 
     attrs: Annotated[dict[str, JsonValue] | None, Field(description="扩展属性")] = None
     params: Annotated[dict[str, JsonValue] | None, Field(description="参数")] = None

dataops_sdk-0.5.0/src/dataops_sdk/schemas/ontology.py

@@ -0,0 +1,146 @@
+"""本体 (Ontology) Meta Schema 定义.
+
+对应前端 ``pages/ontology/constants.js`` 中 rawData 结构：
+``data_table`` / ``scenarios`` / ``constraints`` / ``relations`` / ``notes``。
+"""
+
+from __future__ import annotations
+
+from typing import Annotated, Literal
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from .meta import Meta
+
+RELATION_REF_TYPE_ONTOLOGY = "ontology"
+ON_OPERAND_FIELD = "field"
+ON_OPERAND_CONST = "const"
+ON_TABLE_SOURCE = "source"
+ON_TABLE_TARGET = "target"
+JOIN_TABLE_MAIN = "main"
+
+
+class OntologyRef(BaseModel):
+    """关联对象引用."""
+
+    model_config = ConfigDict(extra="allow")
+
+    type: Annotated[str, Field(description="引用类型，固定 ontology")] = RELATION_REF_TYPE_ONTOLOGY
+    code: Annotated[str, Field(description="关联本体编码", default="")]
+
+
+class OntologyOnOperand(BaseModel):
+    """ON 条件操作数.
+
+    ``table`` 仅 type=field 时有意义；缺失时按位置解析（左 source / 右 target），
+    等于位置默认值时不落库。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    type: Annotated[
+        Literal["field", "const"],
+        Field(description="操作数类型：field / const"),
+    ] = ON_OPERAND_FIELD
+    table: Annotated[
+        Literal["source", "target"] | None,
+        Field(description="表侧：source=本表 / target=目标表（默认不落库）"),
+    ] = None
+    field: Annotated[str | None, Field(description="字段名（type=field）")] = None
+    value: Annotated[str | None, Field(description="常量值（type=const）")] = None
+
+
+class OntologyOnCondition(BaseModel):
+    """关系 ON 条件."""
+
+    model_config = ConfigDict(extra="allow")
+
+    op: Annotated[str, Field(description="运算符", default="eq")]
+    left: Annotated[OntologyOnOperand, Field(description="左操作数")]
+    right: Annotated[OntologyOnOperand, Field(description="右操作数")]
+
+
+class OntologyRelationJoin(BaseModel):
+    """关系 JOIN 物理表.
+
+    两侧均为 ``main`` 时不落库整个 join 对象。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    sourceTable: Annotated[
+        str, Field(description="本侧物理表：main 或附属表 alias", default=JOIN_TABLE_MAIN)
+    ] = JOIN_TABLE_MAIN
+    targetTable: Annotated[
+        str, Field(description="目标侧物理表：main 或附属表 alias", default=JOIN_TABLE_MAIN)
+    ] = JOIN_TABLE_MAIN
+
+
+class OntologyRelation(BaseModel):
+    """本体关联关系."""
+
+    model_config = ConfigDict(extra="allow")
+
+    id: Annotated[str, Field(description="关系项 ID")]
+    name: Annotated[str, Field(description="关系名称", default="")]
+    ref: Annotated[OntologyRef, Field(description="关联目标本体")]
+    type: Annotated[str, Field(description="关系类型", default="")]
+    cardinality: Annotated[str, Field(description="基数（1-1 / 1-N / N-1）", default="")]
+    remark: Annotated[str, Field(description="备注", default="")]
+    join: Annotated[
+        OntologyRelationJoin | None,
+        Field(description="JOIN 物理表；两侧 main 时 omit"),
+    ] = None
+    on: Annotated[
+        list[OntologyOnCondition], Field(description="JOIN ON 条件", default_factory=list)
+    ]
+
+
+class OntologyScenario(BaseModel):
+    """本体场景（绑定技能）."""
+
+    model_config = ConfigDict(extra="allow")
+
+    id: Annotated[str, Field(description="场景项 ID")]
+    name: Annotated[str, Field(description="场景名称", default="")]
+    skill: Annotated[str, Field(description="绑定技能编码", default="")]
+
+
+class OntologyConstraint(BaseModel):
+    """本体约束."""
+
+    model_config = ConfigDict(extra="allow")
+
+    id: Annotated[str, Field(description="约束项 ID")]
+    type: Annotated[str, Field(description="约束类型", default="")]
+    rule: Annotated[str, Field(description="约束规则", default="")]
+
+
+class OntologyMetaData(BaseModel):
+    """本体 rawData 配置.
+
+    Attributes:
+        data_table: 绑定的多维表格编码。
+        scenarios: 场景列表。
+        constraints: 约束列表。
+        relations: 关联关系列表。
+        notes: 其他说明。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    data_table: Annotated[str, Field(description="绑定的多维表格编码", default="")]
+    scenarios: Annotated[
+        list[OntologyScenario], Field(description="场景列表", default_factory=list)
+    ]
+    constraints: Annotated[
+        list[OntologyConstraint], Field(description="约束列表", default_factory=list)
+    ]
+    relations: Annotated[
+        list[OntologyRelation], Field(description="关联关系列表", default_factory=list)
+    ]
+    notes: Annotated[str, Field(description="其他说明", default="")]
+
+
+class OntologyMeta(Meta[OntologyMetaData]):
+    """本体详情 Meta."""

{dataops_sdk-0.4.4 → dataops_sdk-0.5.0}/src/dataops_sdk/services/__init__.py

@@ -37,7 +37,9 @@ from .data_table import (
     service_get_data_table_by_code,
     service_get_data_table_by_name,
     service_get_data_table_data_by_code,
+    service_get_data_table_data_ext_by_code,
     service_get_data_table_data_by_name,
+    service_get_data_table_data_ext_by_name,
     service_get_data_table_record_by_id,
     service_get_data_table_reference_list,
     service_get_data_table_total,
@@ -93,6 +95,21 @@ from .metrics import (
     service_get_metrics_data_by_code,
     service_list_metrics,
 )
+from .ontology import (
+    normalize_ontology_meta,
+    service_get_ontology_by_code,
+    service_get_ontology_by_name,
+    service_list_ontologies,
+    service_resolve_ontology,
+    service_tree_ontology,
+    service_update_ontology,
+    service_update_ontology_basic,
+    service_update_ontology_constraints,
+    service_update_ontology_notes,
+    service_update_ontology_relations,
+    validate_ontology_name,
+    validate_ontology_relations,
+)
 from .ref import service_ref_backward, service_ref_forward
 from .report import service_get_report, service_list_reports, servive_tree_report
 from .skill import (
@@ -107,9 +124,9 @@ from .skill import (
     service_skill_call_by_name,
     service_skill_delete_sub_file,
     service_skill_download,
+    service_skill_update,
     service_skill_get_subfile_by_code,
     service_skill_get_subfile_by_name,
-    service_skill_update,
     service_skill_upload,
     service_skill_upload_sub_file,
 )
@@ -150,14 +167,6 @@ from .widget import (
     service_update_widget,
     servive_tree_widget,
 )
-from .wiki import (
-    service_get_knowledge_base,
-    service_list_knowledge_bases,
-    service_list_knowledge_documents,
-    service_search_knowledge,
-    service_search_wiki_pages,
-    service_upload_knowledge_file,
-)
 from .workflow import (
     service_get_workflow_by_code,
     service_get_workflow_by_name,

{dataops_sdk-0.4.4 → dataops_sdk-0.5.0}/src/dataops_sdk/services/data_table.py

@@ -29,7 +29,9 @@ __all__ = [
     "service_get_data_table_by_code",
     "service_create_data_table",
     "service_get_data_table_data_by_code",
+    "service_get_data_table_data_ext_by_code",
     "service_get_data_table_data_by_name",
+    "service_get_data_table_data_ext_by_name",
     "service_get_data_table_total",
     "service_get_data_table_reference_list",
     "service_get_data_table_record_by_id",
@@ -99,6 +101,49 @@ def service_create_data_table(meta: MetaCreate[DataTableData]) -> Meta[DataTable
 
 
 def service_get_data_table_data_by_code(
+    code: str,
+    page_param: PageParam | None = None,
+    query_param: SqlQueryParam | None = None,
+    *,
+    meta: Meta[DataTableData] | None = None,
+) -> list[Mapping[str, JsonValue]]:
+    """根据编码查询多维表格数据（原始字段名，无额外转换）.
+
+    Args:
+        code: 数据表编码
+        page_param: 分页参数，默认为 PageParam()（第一页，每页 20 条）
+        query_param: 查询过滤条件，默认为 SqlQueryParam()
+        meta: 多维表格元数据（可选，用于获取 subSystem）
+
+    Returns:
+        字典列表，key 为后端返回的原始字段名
+
+    Raises:
+        NotFoundError: 找不到对应多维表格时
+        DataOpsError: API 返回错误时
+        AuthenticationError: 未认证或认证失败时
+    """
+    if page_param is None:
+        page_param = PageParam()
+    if query_param is None:
+        query_param = SqlQueryParam()
+
+    meta = meta or service_get_data_table_by_code(code)
+
+    with get_session(timeout=15, sub_system=meta.subSystem) as session:
+        resp = session.post(
+            f"/data/table/list/{code}",
+            content=to_json(
+                encrypt_body(dict(pageParam=page_param, queryParam=query_param, code=code))
+            ),
+        )
+        body = vaild_respone(resp, True)
+
+    adapter = TypeAdapter(list[Mapping[str, JsonValue]])
+    return adapter.validate_python(body.data or [])
+
+
+def service_get_data_table_data_ext_by_code(
     code: str,
     page_param: PageParam | None = None,
     query_param: SqlQueryParam | None = None,
@@ -107,7 +152,7 @@ def service_get_data_table_data_by_code(
     *,
     meta: Meta[DataTableData] | None = None,
 ) -> list[Mapping[str, JsonValue]]:
-    """根据编码获取多维表格的数据.
+    """根据编码获取多维表格数据（拓展：字段标题映射、字典翻译、可见性过滤）.
 
     Args:
         code: 数据表编码
@@ -115,6 +160,7 @@ def service_get_data_table_data_by_code(
         query_param: 查询过滤条件，默认为 SqlQueryParam()
         show_invisible: 是否显示未标记 visible 的字段，默认为 False
         translate: 是否对 DICT 类型字段进行值翻译，默认为 True
+        meta: 多维表格元数据（可选）
 
     Returns:
         字典列表，每条记录 key 为中文字段标题，value 已做字典翻译
@@ -150,10 +196,15 @@ def service_get_data_table_data_by_code(
     else:
         datas = adapter.validate_python(body.data or [])
 
-    # 过滤不需要显示的字段，建立字段名映射
+    # 过滤不需要显示的字段，建立字段名映射（附属表/虚拟列可能无 dbName，回退到 name）
     all_fields = meta.data.fields
     show_fields = all_fields if show_invisible else [f for f in all_fields if f.visible]
-    field_name_map = {f.dbName: f.title for f in show_fields}
+
+    def _field_db_key(field) -> str | None:
+        key = field.dbName or field.name
+        return key.lower() if key else None
+
+    field_name_map = {key: f.title for f in show_fields if (key := _field_db_key(f)) is not None}
     show_db_names = frozenset(field_name_map.keys())
 
     # 预处理字典字段映射（只执行一次过滤）
@@ -171,14 +222,17 @@ def service_get_data_table_data_by_code(
                     None,
                 )
                 if field and isinstance(relation, Mapping):
-                    dict_field_map[field.dbName] = {
+                    field_key = _field_db_key(field)
+                    if field_key is None:
+                        continue
+                    dict_field_map[field_key] = {
                         str(relation_key): str(relation_value)
                         for relation_key, relation_value in relation.items()
                     }
-                    dict_fields_name.add(field.dbName)
+                    dict_fields_name.add(field_key)
 
     # 单次遍历完成所有转换
-    datas = [
+    return [
         {
             field_name_map[k_lower]: (
                 dict_field_map[k_lower][str(v)]["_LABEL"] if k_lower in dict_fields_name else v
@@ -189,18 +243,52 @@ def service_get_data_table_data_by_code(
         for data in datas
     ]
 
-    return datas
-
 
 def service_get_data_table_data_by_name(
+    datasource: str,
+    name: str,
+    page_param: PageParam | None = None,
+    query_param: SqlQueryParam | None = None,
+    *,
+    meta: Meta[DataTableData] | None = None,
+) -> list[Mapping[str, JsonValue]]:
+    """按数据源与名称查询多维表格数据（原始字段名，无额外转换）.
+
+    Args:
+        datasource: 数据源.
+        name: 多维表格名称.
+        page_param: 分页参数，默认为 ``PageParam()``.
+        query_param: 查询过滤条件，默认为 ``SqlQueryParam()``.
+        meta: 多维表格元数据（可选）.
+
+    Returns:
+        字典列表，key 为后端返回的原始字段名.
+
+    Raises:
+        NotFoundError: 找不到对应多维表格时.
+        DataOpsError: API 返回错误时.
+        AuthenticationError: 未认证或认证失败时.
+    """
+    resolved_meta = meta or service_get_data_table_by_name(datasource, name)
+    return service_get_data_table_data_by_code(
+        resolved_meta.code,
+        page_param=page_param,
+        query_param=query_param,
+        meta=resolved_meta,
+    )
+
+
+def service_get_data_table_data_ext_by_name(
     datasource: str,
     name: str,
     page_param: PageParam | None = None,
     query_param: SqlQueryParam | None = None,
     show_invisible: bool = False,
     translate: bool = True,
-):
-    """按数据源与名称获取多维表格数据.
+    *,
+    meta: Meta[DataTableData] | None = None,
+) -> list[Mapping[str, JsonValue]]:
+    """按数据源与名称获取多维表格数据（拓展：字段标题映射、字典翻译、可见性过滤）.
 
     Args:
         datasource: 数据源.
@@ -209,6 +297,7 @@ def service_get_data_table_data_by_name(
         query_param: 查询过滤条件，默认为 ``SqlQueryParam()``.
         show_invisible: 是否显示未标记 visible 的字段.
         translate: 是否对 DICT 字段进行值翻译.
+        meta: 多维表格元数据（可选）.
 
     Returns:
         字典列表，每条记录 key 为中文字段标题，value 已做字典翻译.
@@ -218,14 +307,14 @@ def service_get_data_table_data_by_name(
         DataOpsError: API 返回错误时.
         AuthenticationError: 未认证或认证失败时.
     """
-    meta = service_get_data_table_by_name(datasource, name)
-    return service_get_data_table_data_by_code(
-        meta.code,
+    resolved_meta = meta or service_get_data_table_by_name(datasource, name)
+    return service_get_data_table_data_ext_by_code(
+        resolved_meta.code,
         page_param=page_param,
         query_param=query_param,
         show_invisible=show_invisible,
         translate=translate,
-        meta=meta,
+        meta=resolved_meta,
     )