用途:浏览与修改 profile schema,包括字段、映射、身份配置和字段排名,帮助用户理解数据模型、新增字段或调整字段映射。需要已认证的 API 访问,凭证解析见 auth 参考。
主要能力:通过 REST API 列出/获取 schema、字段、字段名;创建、更新、删除字段;管理映射(字段、来源 stream、LQL 表达式及可选 guard 条件),未配置映射的字段不会接收数据;查看身份配置;查看和更新字段排名;使用 schema patch 将变更分组、审阅 diff 后应用;从 schema 生成 LQL;发布 schema 变更。
使用方式:读操作直接执行并以表格展示字段名、类型、描述、合并操作、身份/PII 标志。写操作需先判断账户是否启用 schema patches:尝试列出补丁,成功即用补丁流程(创建补丁→添加字段/映射/排名→审阅 diff→确认→应用),否则使用直接发布流程(确认→执行变更→立即发布→验证)。发布必须提供 tag 与 description,且变更在发布前不生效。补丁端点载荷用小写键(id、type、shortdesc、mergeop、is_identifier、is_pii),直接写入用大写键(Field、Type、ShortDesc 等);补丁更新字段需提供完整定义。
适用场景:数据模型梳理、新增或修改字段与映射、身份与 PII 标记管理、字段排序调整、schema 版本化变更审阅。
限制:需有效凭证;无映射字段无效;补丁与直接写入载荷键名不同,混用会报错;写操作在发布成功前不算完成;账户模式决定可用写入路径;字段类型完整参考见 field-types;发布失败时变更仍处于暂存状态。