语义模型和数据来源

使用 Product SDK 管理语义模型、模型条目和数据来源。语义模型的设计内容、表绑定和导入数据由调用方明确提供；SDK 负责在工作区和模型作用域中执行操作。

推荐流程

  1. 在目标工作区创建语义模型，或使用已有模型 ID 获取模型对象。

  2. 创建、查询、更新或删除模型条目，并保存返回的条目 ID。

  3. 对模型执行校验；根据校验结果修正模型或条目定义。

  4. 需要交换定义时，使用模型对象导入或导出。

创建或更新条目不代表模型已经通过校验。将校验作为独立步骤，并根据返回的结果决定是否继续发布或使用。

SDK 调用

model, _, err := workspace.CreateSemanticModel(
	ctx,
	modelName,
	sdk.WithSemanticModelTables([]string{tableName}),
)
entry, _, err := model.CreateEntry(ctx, sdk.SemanticEntryInput{
	Kind: entryKind, Key: entryKey, Spec: entrySpec, Tables: []string{tableName},
})
validated, err := model.Validate(ctx)

model, created_model = workspace.create_semantic_model(
    model_name, sdk.with_semantic_model_tables([table_name])
)
entry, created_entry = model.create_entry(
    sdk.SemanticEntryInput(
        kind=entry_kind, key=entry_key, spec=entry_spec, tables=[table_name]
    )
)
validated = model.validate()

validated 是校验调用的结果；只有它满足调用方的校验要求时，才继续使用模型。

数据来源

数据来源配置与语义模型关联。表、目录和字段绑定应来自工作区中已经确认的资源或用户选择；不要根据显示名称猜测资源 ID，也不要将另一个工作区的资源标识直接复用到当前模型。

导入和导出可能覆盖或暴露模型定义。执行前确认目标模型、输入内容和权限。

下一步

最后更新于