主数据资产
主数据资产
使用场景:用户需将已开发治理完毕的资产发布,供消费人员的进行数据消费。
使用角色:数据消费人员。
功能描述:平台提供资产访问在线申请能力,消费人员申请经审批授权后,即可通过 API、数据库直连的方式访问资产,支持列级、行级多维度的数据消费。
注意
- 所有申请均有空间管理员审批,当空间管理员自行申请时,审批将自动通过,且默认授予整表所有字段权限;
- 当用户申请访问后,在该审批通过/不通过或者撤销之前,不可再申请访问;
- 当用户拥有该数据表的所有字段和所有访问方式的权限时,不可再申请访问;
- 当前用户如果对一张表进行申请访问通过后,再次提交申请访问并通过后,那么该用户对这张表的访问权限取决于最后一次的申请访问时申请的权限。
列级申请
- 进入数据开放 > 本空间资产 > 主数据资产界面,点击目标数据表资产名称跳转至资产详情界面。在“元数据”标签页勾选所需字段后点击右下角的“列级申请”,在弹窗内按要求填写申请信息“保存”后,需等待空间管理员审批。
- 待审批通过后,即可对主数据表部分列按不同消费方式对数据进行访问。
行级申请
进入数据开放 > 本空间资产 > 主数据资产界面,点击目标数据表资产名称跳转至资产详情界面。在“元数据”标签页勾选所需字段后点击右下角的“行级申请”,在弹窗内按要求填写申请信息“保存”后,需等待空间管理员审批。
注意
- 个人中心 > 审批管理 > 我已申请中在查看审批详情时行级申请信息显示对应的行级权限视图英文名,后续消费人员通过访问该视图名获取行级权限;
- 行级配置说明
- 进行行级申请时,需要指定字段名称和字段值,若有多个指定字段值,则所有指定字段值的关系为“且”。
- 假设指定字段1“性别”,指定字段值为“等于男”,字段2“年龄”,指定字段值为“大于20”,则行级申请的为数据表中性别为男且年龄大于20的所有行数据。
- 待审批通过后,即可对主数据表部分行按不同消费方式对数据进行访问。
行列混合
平台支持行列混合的权限申请,即支持消费主数据表部分列的部分行数据,通过行级申请即可实现。
注意
- 行列混合时不要求过滤条件一定为所申请字段列,如申请列选择“姓名”,但行级过滤条件可选择“年龄”、“性别”等其他列,最终获取的权限为通过“年龄”、“性别”过滤后的“姓名”列部分行数据。
批量申请
进入数据开放 > 本空间资产 > 主数据资产界面,勾选多个目标主数据,点击列表上方的“批量申请”按钮,在弹窗内按要求填写申请信息“保存”后,需等待空间管理员审批。
注意
- 批量申请会自动申请所选主数据模型最新版本所有列的权限;
- 申请提交后,系统会自动将每个申请主数据模型拆分为一条独立申请记录,需审批人逐一审批。
消费方式
API访问:
通过API访问数据表,支持表级、列级和行级消费。消费人员可在个人中心 > AKSK管理页面下载自己的 AKSK 密钥获取具有时效性的数据访问 token,之后可以使用该 token 多次访问数据 API 接口,获取已授权的数据。
- 基本步骤如下:
- 获取密钥:用户在平台中可以创建管理自己的 AKSK,可以进行下载操作获取 AKSK 具体信息;
- 生成密文:用户使用 AKSK 按规则自行生成密文;
- 获取令牌:使用上一步骤中生成的密文访问数据登录接口,通过验证后获得数据访问令牌;
- 访问数据:使用上一步骤中获取的数据访问令牌,可以在有效期内多次访问数据 API 接口,获取数据。
数据库直连:
申请消费审批通过后,自动生成直连数据库所需信息,包含该主数据表在数据库的连接参数,登录数据库的用户名与密码。在个人中心 > 审批管理 > 我已申请页面找到对应申请单在操作栏可查看。
说明:数据消费与资产的状态、内容的变更相关,具体如下表。
资产变更 | API访问 | 数据库直连 |
---|---|---|
资产下架 | 不可再消费 | 不可再消费 |
资产再上架(无变更) | 消费自动恢复 | 消费不自动恢复,需重新申请 |
资产再上架(新增字段) | 消费自动恢复,新增字段无权限消费 | 消费不自动恢复,需重新申请 |
资产再上架(修改申请字段) | 消费自动恢复,修改字段按最新内容消费; 若产生新版本,则恢复消费历史版本 | 消费不自动恢复,需重新申请 |
资产再上架(删除申请字段) | 消费自动恢复,恢复消费历史版本 | 消费不自动恢复,需重新申请 |