准资产列表为您展示通过采集适配器指定数据源采集的资产和从数据中台获取的资产。本文为您介绍如何查看及管理准资产。
前提条件
表资产:已开通智能研发版或已购买资产运营-标准版增值模块。
指标资产/仪表板资产:已开通智能研发版或已购买资产运营-高级版增值模块。
API资产:已开通智能研发版或已购买资产运营-高级版增值模块,并购买数据服务功能。
权限说明
超级管理员、运营管理员和具有上架管理-管理权限的自定义全局角色支持新建、上架及管理准资产。
业务系统的运营人员、具有资产维护权限的维护人员支持管理自己所负责的业务系统下的资产。
操作说明
在Dataphin首页的顶部菜单栏,选择资产 > 目录管理。
单击左侧导航栏手动上架 > 对应资产类型,进入准资产页面。
准资产列表为您展示通过采集适配器指定数据源采集的资产和从数据中台获取的资产,包括:资产名称、指标类型、关联技术指标、资产来源、归属目录、最新状态、信息是否完善、是否曾上架、资产引入时间、最新数据时间、最近更新时间等信息。
资产来源:为您展示资产对象所属的来源;其中:Dataphin数据板块下仅包含逻辑表;API资产的资产来源为数据服务项目;Quick BI仪表板的资产来源为Quick BI工作空间。
最新状态:针对最新状态为上架失败的资产,您可以将鼠标悬停状态后的
图标,查看上架失败的原因,修改后重新上架资产。
信息是否完善:为您展示资产的必填属性是否填写完整及是否合法。
是否曾上架:为您展示资产是否下架后再上架。
(可选)您可以根据指标类型、资产来源、BI空间/目录、最新状态、归属目录、信息是否完善、是否曾上架、资产引入时间、最新数据时间、最近更新时间进行精确筛选,也可以根据指定条件搜索资产。
在目标资产操作列下可进行如下操作。不同类型资产可执行的操作相同,下面以表资产为例进行说明。单次批量操作最多可选择10000条资产。
操作项
描述
编辑
支持修改资产的基本信息、使用说明以及配置资产的可见权限等信息,详情请参见编辑资产信息。
上架
单击上架,可将资产上架到目录前台展示。仅必填信息配置完整的资产支持上架。
说明当表资产上架后,该表下的自定义指标资产才能上架。
仅具有资产维护权限的用户及角色可上架资产。
仅最新状态为未上架、上架失败的准资产支持上架。
已上架状态的业务指标名称需在租户内唯一。
暂不上架
单击暂不上架并填写暂不上架原因,可将资产状态修改为暂不上架。暂不上架的资产不会在资产目录前台展示。
如您需要编辑暂不上架资产,请先将其修改为准资产状态。
说明暂不上架表资产操作将同步对其包含的自定义指标生效,但会跳过无维护权限的指标。上架自定义指标时,如所属表状态为暂不上架,需先将表资产变更为准资产后,再上架指标资产。
设置维护权限
业务指标不支持该操作。
单个操作:单击设置维护权限,支持配置资产的维护人员,负责资产的日常维护,包括修改信息及上下架。
批量操作:单击底部设置维护权限,支持批量追加或修改维护人员。
修改:将选中资产的维护人员替换为本次指定的维护人员。
追加:保留选中资产的已配置的维护人员并追加本次指定的维护人员。
查看变更记录
为您展示单个资产最近30天的变更记录,包括属性变更、状态变更等,以便追溯。
说明对于自定义指标,统计粒度变更对应所属表中定义为维度的字段变更,且跟随表上架操作生效。
删除
仅业务指标支持该操作。当业务指标的状态为未上架、暂不上架失败、上架失败时,支持删除业务指标,并同步取消相关业务指标和相关技术指标的关联关系。
修改属性
选中资产后,单击底部的修改属性,在批量修改资产属性页面,修改资产的属性。
与编辑单个资产相比,部分属性支持更灵活的配置。
添加所有必填属性:单击可快速添加当前资产类型上架必须配置的属性。
展示名称:可选是否仅对展示名称为空的资产生效,若未选中,将覆盖更新选中表已配置的展示名。
归属目录/资产标签/相关业务指标:支持在已有配置上追加更新,或按照最新当前配置修改已有配置。
业务负责人:仅业务指标支持修改业务负责人。
可见范围/数据探查报告:控制是否在资产目录的资产详情页展示对应内容。
原子指标/业务限定/统计周期/度量单位:仅自定义技术指标支持修改。
是否可累加/关联业务指标:仅技术指标支持修改。
血缘关系/质量概况:仅表资产和指标资产支持修改,控制是否在资产目录的资产详情页展示对应内容。
指标关系图:仅规范建模指标资产支持修改,控制是否在资产目录的资产详情页展示对应内容。
元数据变更记录:仅表资产支持修改,控制是否在资产目录的资产详情页展示对应内容。
其他自定义属性:您可在规划 > 属性管理中为表/指标配置其他自定义属性,以丰富资产信息。
说明API资产、仪表板资产的系统属性支持修改归属目录、资产标签、可见范围。
业务指标资产支持修改归属目录、资产标签、业务负责人、可见范围、相关业务指标。
说明部分资产属性的变更需重新上架才会更新目录前台的展示,如:归属目录、标签;部分属性变更则无需重新上架,即目录前台仅展示最新的属性(如字段、仪表板图表信息等)
若已上架资产被删除,则需重新上架列会展示为是,建议您重新上架以保持数据一致性和可用性。
若资产被删除,仅支持查看。
编辑资产信息
表资产保存后,相关指标将自动生成对应的指标资产。
在底部选中保存并上架时,同步上架相关指标,则会同步上架表资产和相关指标资产。
请先上架表,再上架表的自定义指标。
表资产
参数 | 描述 | |
基本信息 | 名称 | 为您展示资产的名称,不支持修改。 |
展示名称 | 填写资产的展示名称,不超过256个字符。您可以单击填入资产名称或填入资产描述,快捷填充资产的名称或描述作为展示名称。 | |
归属目录 | 选择表专题下已发布的目录,支持多选。 | |
标签 | 填写资产的标签,支持设置不超过20个标签。 | |
描述 | 填写资产的相关描述,不超过1000个字符。 | |
属性信息 | 业务属性/管理属性/技术属性 | 为您展示资产的系统属性及自定义属性信息,您可以在右上角选中隐藏只读属性,聚焦于需编辑的信息。
|
字段信息 | 序号 | 您可以单击序号后的排序 |
字段名 | 您可以单击字段名后的排序 | |
数据类型 | 为您展示字段的数据类型。 | |
字段展示名 | 填写字段的展示名称,不超过512个字符。鼠标悬停快速填充,选择填入描述或填入名称,快捷填充字段的名称或描述作为展示名称。 | |
描述 | 填写字段的描述信息,不超过2048个字符。 | |
业务类型 | 支持选择维度、指标、统计周期三种业务类型。 | |
关联实体 |
| |
数据分类 | 需要开通数据安全模块,支持查看字段的数据分类信息。 | |
数据分级 | 需要开通数据安全模块,支持查看字段的数据分级信息。您可以单击数据分级后的排序 | |
操作 |
| |
相关指标 | 当指定部分字段的业务类型为指标时,可查看相关指标列表。该列表展示指标的名称、上架状态、目录、标签、原子指标、业务限定、统计周期、度量单位信息。您可对指标执行如下操作(需有指标资产的维护权限才能操作)。
| |
使用说明 | 是否开启 | 默认关闭,开启后,可在资产目录的资产详情页面查看使用说明。您可以为资产添加使用说明,为数据浏览者提供资产介绍和使用引导,为使用者评估资产可用性、申请消费权限提供依据。 说明
|
权限控制 | 可见范围 | 影响在资产目录是否可见该资产。支持三种可见范围:
|
数据探查报告 | 需要在资产清单中开启数据探查(需开通数据质量功能)才能查看数据探查报告。支持全部用户可见、部分用户可见、全部用户不可见三种公开范围。配置说明与可见范围一致。 | |
血缘关系 | 开启后可在资产目录的资产详情页面查看完整的直接血缘链路,包括未上架和无查看权限的对象,但无法查看该对象的详情信息。 | |
质量概况 | 开启后可在资产目录的资产详情页面查看质量六性评分(完整性、唯一性、及时性、有效性、一致性、稳定性)和监控规则统计结果。 若您选中隐藏质量规则校验明细,则在资产目录 > 资产详情页的质量概况中无法查看质量规则校验明细。 | |
元数据变更记录 | 需在元数据 > 元数据变更记录页面开启元数据变更版本记录,才能在此处进行配置。开启后,可在资产目录的资产详情页面查看元数据的版本变更记录。如需修改最多可保留的版本数量,请参见元数据变更记录。 | |
已关联的行级权限 | 若您开通了行级权限功能。支持查看该资产关联的行级权限信息,包括权限名称、管控规则、关联字段。支持查看管控规则和去编辑操作。
|
技术指标
参数 | 描述 | |
基本信息 | 名称 | 为您展示资产的名称,不支持修改。 |
展示名称 | 填写资产的展示名称,不超过1000个字符。您可以单击填入资产名称或填入资产描述,快捷填充资产的名称或描述作为展示名称。 | |
归属目录 | 选择指标专题下已发布的目录,支持多选。 | |
标签 | 填写资产的标签,支持设置不超过20个标签。 | |
指标口径 | 仅建模指标支持展示。为您展示在研发 > 开发 > 指标中所填写的指标口径。 | |
描述 | 填写资产的相关描述,不超过1000个字符。 | |
属性信息 | 业务属性/技术属性 | 为您展示资产的系统属性及自定义信息,您可以在右上角选择隐藏只读属性,聚焦于需编辑的信息。
|
使用说明 | 是否开启 | 默认关闭,开启后,可在资产目录的资产详情页面查看使用说明。您可以为资产添加使用说明,为数据浏览者提供资产介绍和使用引导,为使用者评估资产可用性、申请消费权限提供依据。 说明
|
权限控制 | 可见范围 | 控制在资产目录中该资产是否可见,不影响该指标在汇总表中是否可见。支持三种可见范围:
|
数据探查报告 | 需要在资产清单中开启数据探查(需开通数据质量功能)才能查看数据探查报告。支持全部用户可见、部分用户可见、全部用户不可见三种公开范围。配置说明与可见范围一致。 | |
血缘关系 | 开启后,可在资产目录的资产详情页面查看完整的直接血缘链路,包括未上架和无查看权限的对象,但无法查看该对象的详情信息。 | |
指标关系图 | 开启后,可在资产目录的资产详情页面查看以该指标为根节点的指标关系拆解图,便于更加清晰的理解指标加工逻辑。 若您选中隐藏SQL计算逻辑,则在资产目录 > 资产详情页的指标详情对话框中无法查看计算逻辑。 | |
质量概况 | 开启后,可在资产目录的资产详情页面查看质量六性评分(完整性、唯一性、及时性、有效性、一致性、稳定性)和监控规则统计结果。 若您选中隐藏质量规则校验明细,则在资产目录 > 资产详情页的质量概况中无法查看质量规则校验明细。 |
业务指标
业务指标可作为业务需求的载体,桥接开发和业务需求,以更标准化的方式,让开发人员更好地理解业务需求,也可以通过业务指标和技术指标的关联关系,提供一定的指标分析思路,让业务人员更容易理解指标、使用指标。
在准资产页面,单击新建业务指标按钮,创建业务指标。新建及编辑操作一致。
参数 | 描述 | |
基本信息 | 名称 | 输入业务指标的名称,全局唯一,支持输入英文、数字以及特殊符号 |
展示名称 | 填写资产的展示名称,不超过1000个字符。您可以单击填入资产名称或填入资产描述,快捷填充资产的名称或描述作为展示名称。 | |
归属目录 | 选择指标专题下已发布的目录,支持多选。 | |
标签 | 填写资产的标签,支持设置不超过20个标签。 | |
描述 | 填写资产的相关描述,不超过1000个字符。 | |
指标口径 | 指标口径 | 填写指标的口径,使用简洁明了的表达式,便于业务人员了解指标。不超过2000个字符。 |
相关业务指标 |
| |
指标关系图 | 支持基于已添加的相关业务指标配置关系图,能够清晰直观地拆解业务指标的加工口径。默认关闭,开启后,单击编辑图标,在配置指标关系图对话框中,展示以当前指标节点为起点的指标关系图,您可在右侧配置相关业务指标的加工口径,单击确定,完成指标关系配置,可在编辑业务指标时查看已配置的指标关系图。
说明
| |
属性信息 | 业务属性 | 为您展示资产的系统属性及自定义信息,您可以在右上角选择隐藏只读属性,聚焦于需编辑的信息。
|
关联技术指标 | 关联技术指标 |
|
使用说明 | 是否开启 | 默认关闭,开启后,可在资产目录的资产详情页面查看使用说明。您可以为资产添加使用说明,为数据浏览者提供资产介绍和使用引导,为使用者评估资产可用性、申请消费权限提供依据。 说明
|
权限控制 | 可见范围 | 影响在资产目录中该资产是否可见,不影响该指标在汇总表中是否可见。支持三种可见范围:
|
API资产
参数 | 描述 | |
基本信息 | API_ID | 为您展示资产的ID,不支持修改。 |
API名称 | 为您展示资产的名称,不支持修改。 | |
归属目录 | 选择API专题下已发布的目录,支持多选。 | |
标签 | 填写资产的标签,支持设置不超过20个标签。 | |
描述 | 默认展示API创建时的描述,支持修改,不超过128个字符。 | |
属性信息 | 业务属性/管理属性/技术属性 | 为您展示资产的系统属性及自定义属性信息,您可以在右上角选中隐藏只读属性,聚焦于需编辑的信息。
|
业务参数请求列表、公共参数请求列表、返回参数列表 | 为您展示当前API被调用时的业务参数请求、公共参数请求以及返回参数信息,您可以在服务 > 市场 > API页签,选择目标API文档查看更多详细信息。 | |
行级权限列表 | 为您展示当前API已关联且已开启的行级权限信息。您可以在服务 > 开发 > API页面,选择目标API查看更多详细信息。 | |
使用说明 | 是否开启 | 默认关闭,开启后,可在资产目录的资产详情页面查看使用说明。您可以为资产添加使用说明,为数据浏览者提供资产介绍和使用引导,为使用者评估资产可用性、申请消费权限提供依据。 说明
|
权限控制 | 可见范围 | 影响在资产目录是否可见该资产。支持三种可见范围:
|
仪表板资产
参数 | 描述 | |
基本信息 | 仪表板名称 | 为您展示资产的名称,不支持修改。 |
归属目录 | 选择仪表板专题下已发布的目录(不包括根目录),支持多选。 | |
标签 | 填写资产的标签,支持设置不超过20个标签。 | |
描述 | 填写资产的相关描述,不超过1000个字符。 | |
属性信息 | 业务属性/管理属性/技术属性 | 为您展示资产的系统属性及自定义属性信息,您可以在右上角选中隐藏只读属性,聚焦于需编辑的信息。
|
图表信息 | 为您展示当前仪表板的图表详情信息,您可以在治理 > 元数据 > 元数据清单 > 仪表板页签中查看详细信息。
| |
使用说明 | 是否开启 | 默认关闭,开启后,可在资产目录的资产详情页面查看使用说明。您可以为资产添加使用说明,为数据浏览者提供资产介绍和使用引导,为使用者评估资产可用性、申请消费权限提供依据。 说明
|
权限控制 | 可见范围 | 影响在资产目录是否可见该资产。支持三种可见范围:
|
智能生成
Dataphin基于AI大模型能力智能生成表和字段的基本信息,并可从表资产中准确探索有业务价值的指标以及为指标资产生成全面、准确的信息,极大地提升数据配置效率。
智能生成页面的第一行为已存在的配置信息,第二行为智能生成的配置信息,仅可对已生成的智能配置信息进行修改。
智能生成字段/技术指标数量过多,需等待较长的时间,请耐心等待。
在准资产页签,单击目标资产操作列下的编辑图标,进入资产编辑页面。
在资产编辑页面,单击右上角的智能生成按钮,跳转至智能生成页面,系统将为您生成当前资产的基本信息(技术指标资产仅支持编辑基本信息)、字段信息和表相关指标信息,您可以修改已生成的信息。
表资产
参数
描述
基本信息
展示名称
系统智能生成表的展示名称,支持修改,不超过256个字符。
归属目录
系统智能推荐表专题下已发布的目录,支持多选。
标签
系统智能推荐生成的标签,支持创建不超过20个标签。
描述
系统智能生成资产相关描述,支持修改,不超过1000个字符。
字段信息
字段展示名
系统智能生成字段的展示名称,支持修改,不超过512个字符。
描述
系统智能生成字段的相关描述,支持修改,不超过2048个字符。
业务类型
支持选择维度、指标、统计周期三种业务类型,您可以单击清空,一键清除业务类型信息。
维度:当字段为
id
时(不区分大小写),将默认为您填充该字段的业务类型为维度,支持修改。指标:
非度量型字段,系统根据字段名、字段展示名、描述特征信息进行判断,默认为您填充该字段的业务类型为指标,支持修改。如:退款率、退款总金额、人均前3名购买量等。
度量型字段,当字段的数据类型为
bigint、double、int、smallint、tinyint、float
时,将默认为您填充该字段的业务类型为指标,支持修改。
统计周期:当字段的数据类型为
date、datetime、timestamp
时,将默认为您填充该字段的业务类型为统计周期,支持修改。
关联实体
仅当字段的业务类型为维度时,系统会默认填充所属数据板块下的业务实体,支持修改。
若该字段已关联业务实体,更换数据板块后,业务实体将随之变更。
智能生成相关指标
仅当字段的业务类型有指标时,支持单击智能生成相关指标按钮;若字段的业务类型同时拥有维度,需先在字段信息区域选择数据板块后,才能单击智能生成相关指标按钮,单击即为您生成相关指标列表。
智能生成相关指标
指标
业务类型为指标的字段将同步为指标信息,支持在指标编辑页面进行修改。
目录
系统智能推荐表专题下已发布的5个目录(含已添加目录),支持多选。
标签
系统智能推荐生成8个标签(含已创建标签),支持创建不超过20个标签。
技术指标
参数
描述
基本信息
展示名称
系统智能生成指标的展示名称,支持修改,不超过256个字符。
归属目录
系统智能推荐指标专题下已发布的目录,支持多选。
标签
系统智能推荐生成的标签,支持创建不超过20个标签。
描述
系统智能生成资产相关描述,支持修改,不超过1000个字符。
确认智能生成相关指标信息无误后,单击保存,保存后,若该信息不符合您的需求,可在右上角单击清空,一键清除指标的目录和标签信息。
确认全部信息无误后,单击应用,快捷填充信息至资产编辑页面。
您可以对智能生成的信息执行如下操作,包括智能生成的相关指标以及智能推荐生成的全部信息。
重试:重新生成智能生成的相关指标/全部信息。
弃用:不使用此次智能生成的相关指标/全部信息。
终止:停止正在生成中的相关指标/全部信息。
继续生成:将继续智能生成停止的相关指标/全部信息。