跳到主要内容

主数据资产

主数据资产

使用场景:用户需将已开发治理完毕的资产发布,供消费人员的进行数据消费。

使用角色:数据消费人员。

功能描述:平台提供资产访问在线申请能力,消费人员申请经审批授权后,即可通过 API、数据库直连的方式访问资产,支持列级、行级多维度的数据消费。

注意
  • 所有申请均有空间管理员审批,当空间管理员自行申请时,审批将自动通过,且默认授予整表所有字段权限;
  • 当用户申请访问后,在该审批通过/不通过或者撤销之前,不可再申请访问;
  • 当用户拥有该数据表的所有字段和所有访问方式的权限时,不可再申请访问;
  • 当前用户如果对一张表进行申请访问通过后,再次提交申请访问并通过后,那么该用户对这张表的访问权限取决于最后一次的申请访问时申请的权限。

列级申请

  1. 进入数据开放 > 本空间资产 > 主数据资产界面,点击目标数据表资产名称跳转至资产详情界面。在“元数据”标签页勾选所需字段后点击右下角的“列级申请”,在弹窗内按要求填写申请信息“保存”后,需等待空间管理员审批。

申请访问

  1. 待审批通过后,即可对主数据表部分列按不同消费方式对数据进行访问。

行级申请

进入数据开放 > 本空间资产 > 主数据资产界面,点击目标数据表资产名称跳转至资产详情界面。在“元数据”标签页勾选所需字段后点击右下角的“行级申请”,在弹窗内按要求填写申请信息“保存”后,需等待空间管理员审批。

注意
  • 个人中心 > 审批管理 > 我已申请中在查看审批详情时行级申请信息显示对应的行级权限视图英文名,后续消费人员通过访问该视图名获取行级权限;

申请访问

  • 行级配置说明
    • 进行行级申请时,需要指定字段名称和字段值,若有多个指定字段值,则所有指定字段值的关系为“且”。
    • 假设指定字段1“性别”,指定字段值为“等于男”,字段2“年龄”,指定字段值为“大于20”,则行级申请的为数据表中性别为男且年龄大于20的所有行数据。
  1. 待审批通过后,即可对主数据表部分行按不同消费方式对数据进行访问。

行列混合

平台支持行列混合的权限申请,即支持消费主数据表部分列的部分行数据,通过行级申请即可实现。

注意
  • 行列混合时不要求过滤条件一定为所申请字段列,如申请列选择“姓名”,但行级过滤条件可选择“年龄”、“性别”等其他列,最终获取的权限为通过“年龄”、“性别”过滤后的“姓名”列部分行数据。

批量申请

进入数据开放 > 本空间资产 > 主数据资产界面,勾选多个目标主数据,点击列表上方的“批量申请”按钮,在弹窗内按要求填写申请信息“保存”后,需等待空间管理员审批。

注意
  • 批量申请会自动申请所选主数据模型最新版本所有列的权限;
  • 申请提交后,系统会自动将每个申请主数据模型拆分为一条独立申请记录,需审批人逐一审批。

申请访问

消费方式

API访问:
通过API访问数据表,支持表级、列级和行级消费。消费人员可在个人中心 > AKSK管理页面下载自己的 AKSK 密钥获取具有时效性的数据访问 token,之后可以使用该 token 多次访问数据 API 接口,获取已授权的数据。

  • 基本步骤如下:
    • 获取密钥:用户在平台中可以创建管理自己的 AKSK,可以进行下载操作获取 AKSK 具体信息;
    • 生成密文:用户使用 AKSK 按规则自行生成密文;
    • 获取令牌:使用上一步骤中生成的密文访问数据登录接口,通过验证后获得数据访问令牌;
    • 访问数据:使用上一步骤中获取的数据访问令牌,可以在有效期内多次访问数据 API 接口,获取数据。

数据库直连:
申请消费审批通过后,自动生成直连数据库所需信息,包含该主数据表在数据库的连接参数,登录数据库的用户名与密码。在个人中心 > 审批管理 > 我已申请页面找到对应申请单在操作栏可查看。

资产搜索

平台提供“模糊搜索、近似搜索”两种模式,默认为模糊搜索,可在搜索按钮处点击切换,并支持自定义搜索范围,具体说明如下:

  1. 搜索范围:默认全部,可下拉选择表中文名、表英文名、字段中文名、字段英文名、表描述,支持多选,选择后将仅对所选范围进行关键字搜索,如选择字段中文名,可通过搜索字段查询所需表
  2. 模糊搜索:支持多关键字输入,单次输入最多10个关键字;触发搜索后将对所输入关键字逐一在所选范围进行模糊匹配,命中后返回搜索结果
  3. 近似搜索:支持多关键字输入,单次输入最多10个关键字;触发搜索后会先进行语料同义词匹配,再对输入关键字+匹配同义词逐一在所选范围进行模糊匹配,命中后返回搜索结果,如搜索关键字“老师”,假设语料库中存在同义词“教师、teacher”,则以上三个同义关键字均会参与搜索,进一步扩大覆盖范围,减少遗漏
  4. 搜索结果:移入搜索结果显示区域,悬浮显示当前搜索结果依据,包括具体是哪个关键字或同义词命中了该表的哪个位置,以辅助判断结果是否为所需表
注意

近似搜索需空间管理员提前在语料管理完成词库的维护,否则将无同义词可匹配,搜索效果与模糊搜索一致

说明:数据消费与资产的状态、内容的变更相关,具体如下表。

资产变更API访问数据库直连
资产下架不可再消费不可再消费
资产再上架(无变更)消费自动恢复消费自动恢复
资产再上架(修改表名)修改表英文名,需消费方同步修改API中表英文名;
修改表中文名,消费自动恢复
消费自动恢复
资产再上架(新增字段)消费自动恢复,新增字段无权限消费消费自动恢复,新增字段无权限消费
资产再上架(修改申请字段)消费自动恢复,修改字段按最新内容消费;
若产生新版本,则恢复消费历史版本
消费自动恢复,修改字段按最新内容消费;
若产生新版本,则恢复消费历史版本
资产再上架(删除申请字段)消费自动恢复,恢复消费历史版本消费自动恢复,恢复消费历史版本

相关术语

本空间资产 目录 AKSK

最佳实践

数据开放-API使用说明