dataops-sdk 0.4.3__tar.gz → 0.4.5__tar.gz

{dataops_sdk-0.4.3 → dataops_sdk-0.4.5}/PKG-INFO

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

{dataops_sdk-0.4.3 → dataops_sdk-0.4.5}/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,
@@ -95,6 +97,7 @@ from .services import (  # noqa: F401
     service_ref_forward,
     service_set_application,
     service_skill_call_by_code,
+    service_skill_download,
     service_skill_update,
     service_skill_upload,
     service_skill_upload_sub_file,
@@ -108,4 +111,4 @@ from .services import (  # noqa: F401
 )
 from .session import dataops_base_url_context, request_context
 
-__version__ = "0.4.3"
+__version__ = "0.4.5"

{dataops_sdk-0.4.3 → dataops_sdk-0.4.5}/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.3 → dataops_sdk-0.4.5}/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,20 @@ 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 +569,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 +598,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.3 → dataops_sdk-0.4.5}/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.3 → dataops_sdk-0.4.5}/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.4.5/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.3 → dataops_sdk-0.4.5}/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 (
@@ -106,9 +123,10 @@ from .skill import (
     service_skill_call_by_code,
     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,
 )
@@ -149,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,