支持通过Excel批量导入或导出码表,提升配置效率。本文为您介绍如何批量配置码表。
权限说明
超级管理员、数据标准管理员和导入导出记录的操作人可查看导入详情或下载导出文件。
批量导入码表
在Dataphin首页的顶部菜单栏,选择治理 > 数据标准。
在左侧导航栏选择参考数据 > 标准代码(码表),在码表列表页面,单击批量导入导出,选择批量导入码表。
在批量导入码表对话框,配置相关参数。
参数
描述
导入场景
不同导入场景对应的配置模板不同,其中下载的更新模板文件将包含所有已选中的码表信息,您只需要修改需要修订的信息,再重新导入即可。支持新增、更新两种导入场景。
导入场景仅影响配置模板的生成,实际导入过程中,将根据码表编码是否存在决定是新增还是更新。
STEP 1 下载配置模板--新增
配置模板
若没有模板,可点击文件名称或下载图标下载.xlsx文件;若已有模板,可直接执行上传配置文件并导入。
说明导入码表需要有创建或编辑码表的权限,否则会使权限校验失败,无法导入。
STEP 1 下载配置模板--更新
更新范围
选择需要更新的码表,单次选择码表个数不超过20个。
配置模板
根据所选的码表范围生成,点击生成模板,生成.xlsx格式的模板文件后下载。
说明若没有模板,可点击文件名称或下载图标下载.xlsx文件;若已有模板,可直接执行上传配置文件并导入。
导入码表需要有创建或编辑码表的权限,否则会使权限校验失败,无法导入。
STEP 2 上传配置文件
上传文件
每个码表对应一个单独的.xlsx文件,如果文件类型不一致则无法导入。
单次上传不超过20个文件,单个文件不超过20M。
每个码表支持填写10000个码值。
填写模板时,请遵循每个字段的填写规范,如果移动了行列位置、修改了列名称、或增删行列,会导致解析失败无法导入。
码表基本信息:导入过程中,会首先针对码表的基本信息进行校验,只有校验通过的文件才可以执行码值的导入。
码表名称:必填,需要和码表编码一一匹配,最多输入128字符,在所属目录下唯一;仅支持导入有操作权限的码表。
码表编码:必填,全局唯一,根据码表编码识别码表对象,最多输入128个字符,区分大小写。导入时将根据码表编码识别码表对象,如果码表编码已经存在,则视为更新码表操作,结合冲突策略配置执行导入;如果码表编码不存在,则视为新增码表操作。
码表目录:非必填,请按照/一级目录名称/二级目录名称.../的样式填写,如未填写或填写/,将直接归属根目录。
码表负责人:非必填,请填写用户名称(可在成员管理页面获取ID);新增场景下如未填写,默认以批量导入操作人作为负责人进行校验;更新场景下如未填写,则保留线上已有的负责人信息。
码表描述:非必填,最多输入1000个字符。
码值信息:每个码值1行。码表基本信息校验通过后,会针对码值的基本信息进行校验,只有校验通过的文件才会最终导入。
代码值:必填,最多输入64个字符,支持输入中文、英文字母、数字和特殊字符:
-、_、()、空格’
,码表内唯一。代码名称:必填,最多输入64个字符,支持输入中文、英文字母、数字和特殊字符
-、_、()、空格’
。代码英文名:非必填,最多输入64个字符,支持输入英文字母、数字和任意半角符号。
代码描述:非必填,最多输入256个字符。
STEP 3 冲突解决策略
校验字段
代码值(码表内唯一,不区分大小写)。
处理策略
针对本次导入的代码值若和码表内已有的代码值相同时的处理策略,支持选择冲突则跳过或冲突则覆盖更新。
冲突则跳过:如果导入的代码值和码表下已有的代码值重复,则跳过记录不处理。
冲突则覆盖更新:如果导入的代码值和码表下已有的代码值重复,以本次导入的内容为准更新线上已有的代码值的其他信息,如代码名称、描述等。
单击开始解析,对本次导入的文件格式、码表信息进行校验。
文件格式:校验本次导入的文件是否为空、文件是否包含多张码值或码表的sheet、文件格式和模板是否一致。
码表信息:校验当前操作人是否具有管理码表的权限、是否超过码表可创建的个数及码表配置信息的合法性(包括码表编码、码表名称、码表目录、指定码表目录下是否存在同名码表、码表负责人、码表描述)。
解析通过后,对码值信息进行校验,校验通过后打开导入结果页面。
码值:校验代码值/代码名称是否完整、代码值/代码名称/代码英文名/代码描述是否符合输入规范、代码值是否重复、代码值个数是否超过系统限制。
参数
描述
导入结果
可查看导入进度、导入结果、执行时间。
异常记录
为您展示校验不通过而无法导入的代码值记录,包括记录在原始文件中对应的代码值、代码名称、代码英文名称、代码描述和异常提示。
在异常记录页签下,可单击下载异常记录,将对应的原始记录下载成文件,根据异常提示修改后重新导入。
跳过记录
如果冲突策略配置为冲突则跳过,则针对在指定码表中已经存在的代码值记录会被跳过,展示在跳过记录列表中,包括记录在原始文件中对应的代码值、代码名称、代码英文名称、代码描述和异常提示。
在跳过记录页签下,可单击下载跳过记录,将对应的原始记录下载成Excel文件。
执行日志
可查看导入过程的执行日志并复制。
导入完成后,若您想快速查看导入结果,可关闭导入配置对话框,关闭对话框不会终止导入任务的执行。您可以在码表列表,单击批量操作记录,并选择需要查看的历史导入记录。
批量导出码表
在码表列表页面,单击批量导入导出,选择批量导出码表。
在批量导出码表对话框,根据导出范围导出码表。
导出范围:选择需要导出的码表范围,支持选择导出全部码表或指定选择的码表。
说明单次导出最多选择1000个码表。
每个码表为1个单独的.xlsx格式的文件,单次导出多个码表将整体压缩为.zip格式。
单击确定,完成码表的导出。您可以在批量操作记录中查看本次导出操作信息,并下载导出文件。
码表批量操作记录
支持查看每个码表的导入、导出操作记录详情。
在码表列表页面,单击批量导入导出,选择批量操作记录。
在码表批量操作记录面板,查看码表的导入、导出操作记录。
批量导入:为您展示码表导入的操作记录详情,包括序号、创建人、导入场景、码表名称、导入的状态、创建时间、结束时间信息。同时,您可单击操作列下的查看图标,查看导入详情。
批量导出:为您展示码表导出的操作记录详情,包括序号、创建人、导出范围、导出的状态、创建时间、结束时间信息。同时,您可单击操作列下的下载图标,下载导出文件至本地。
说明导出的码表文件系统存储7天,超过7天将无法下载。
仅导出成功状态的记录支持下载导出文件。
后续步骤
码表导入后,您可在码表列表管理码表。详情请参见码表列表。