碼表,也稱lookup表、數據字典表,一般由中英文名稱編碼組成,由可枚舉數據構成,存儲枚舉數據名稱與編碼的映射關系。碼表的作用主要有:
- 在數據清洗中用于標準化業務數據以及補充映射字段。
- 在質量監控中用于監控業務數據的值域范圍。
- 在維度建模中可以引申為枚舉維度。
新建碼表并發布
手動新建碼表,完成新建后可以參考下方“填寫數值到碼表中”添加碼表記錄。
1.在DataArts Studio控制臺首頁,選擇實例,點擊“進入控制臺”,選擇對應工作空間的“數據架構”模塊,進入數據架構頁面。

2.在數據架構控制臺,單擊左側導航樹中的“碼表管理”。
3.在“碼表管理”頁面的碼表目錄樹中,選擇一個目錄,然后單擊
按鈕在所選目錄下新建目錄。首次新建目錄時,可選擇在根目錄下新建目錄。

4.在彈出窗口中進行參數配置,單擊“確定”。

下表為參數描述
| 參數名稱 | 說明 |
|---|---|
| 目錄名稱 | 只能包含中文、英文字母、數字和下劃線。 |
| 選擇目錄 | 在已有的目錄中選擇一個目錄,新建的目錄將創建在所選擇的目錄中。 |
5.在目錄樹中單擊剛建好的目錄,然后單擊“新建”按鈕新建一個碼表。
6.在“新建碼表”頁面中,做如下配置:
在“基礎配置”區域,配置如下參數:

| 參數名稱 | 說明 |
|---|---|
| 表名 | 碼表名稱。只能包含中文、英文字母、數字、左右括號、中劃線和下劃線,且以中文或英文字母開頭。 |
| 編碼 | 碼表的英文名稱。只能包含英文字母、數字和下劃線,且以英文字母開頭。 |
| 描述 | 描述信息。支持的長度為0~600個字符。 |
在“建表配置”中添加所需要的表字段,單擊“新建”或加號可以添加新的字段,單擊某個字段后的刪除按鈕可刪除該字段。

7.單擊“發布”,在提交發布對話框中,選擇審核人,再單擊“確認提交”提交審核。審核通過后,返回“碼表管理”頁面,在列表中可以查看已建好的碼表且狀態顯示為“已發布”,已發布的碼表才可被使用。
說明如果當前用戶已被添加為審核人,則可以勾選“自助審批”,單擊“確認提交”后,碼表狀態顯示為“已發布”。
填寫數值到碼表中
對于已創建的碼表,您可以通過填寫數值,增加碼表記錄。
1.在數據架構控制臺,單擊左側的“碼表管理”,進入碼表管理頁面。
2.在碼表列表,找到所需要的碼表,單擊其所在行的“更多 > 填寫數值”。
3.進入相應頁面后,單擊“新建”,并在彈出窗口中設置各字段的值。

4.完成后單擊“確定”。或者您也可以單擊“確定并繼續”繼續添加更多碼表記錄。
導入碼表
Excel導入碼表時, 碼表名稱需要限制在32個字符以內。
通過導入碼表,可以導入新的碼表,也可以往已有的碼表中批量導入碼表記錄。如果碼表記錄比較多,建議采用導入方式。
1.在數據架構控制臺,單擊左側的“碼表管理”,進入碼表管理頁面。
2.在左側的目錄樹中,選擇一個目錄,再單擊“更多 > 導入”。您也可以在所選擇的碼表目錄上單擊鼠標右鍵,然后選擇菜單“導入”。

3.在“導入碼表”對話框中,根據頁面提示配置參數,然后單擊“上傳文件”。

| 參數名 | 說明 |
|---|---|
| 更新已有表 | 在導入時是否更新已有的碼表信息。在導入時,系統將按編碼進行判斷將要導入的碼表在系統中是否已存在。支持以下選項: 不更新 :當碼表已存在時,將直接跳過,不更新。 更新 :當碼表已存在時,更新已有的碼表信息。如果碼表處于“已發布”狀態,碼表更新后,您需要重新發布碼表,才能使更新后的表生效。 在導入碼表時,只有創建或更新操作,不會刪除已有的碼表。 |
| 上傳模板 | 選擇所需導入的碼表文件。所需導入的碼表文件,可以通過以下兩種方式獲得。 下載碼表模板并填寫模板 在“導入配置”頁簽內,單擊“下載碼表導入模板”下載模板,然后根據業務需求填寫好模板中的相關參數并保存。 碼表模板填寫說明: ? 模板中參數名稱前帶“ * ” 的參數為必填參數,名稱前未帶 “ * ”的參數為可選參數。 ? 一個碼表可以添加多個字段。 ? 如果要導入多個碼表,可以在模板文件中添加多個Sheet頁,Sheet頁的名稱即為碼表名稱。 ? 如果碼表名稱已存在,當“更新已有數據”設置為“更新”時,導入時會更新已有的碼表。 ? 如果碼表名稱不存在,導入時會新建該碼表。 導出的碼表文件 您可以將某個DataArts Studio實例的數據架構中已創建的碼表導出到Excel文件中。導出后的文件可用于碼表導入。碼表導出操作請參見下方“管理碼表”。 |
下表為 碼表導入模板參數
| 參數名稱 | 說明 |
|---|---|
| 目錄 | 碼表所屬的目錄。多級目錄以“/”分隔,例如“dir01/dir02”。 |
| *表名稱 | 碼表名稱。只能包含中文、英文字母、數字、左右括號、中劃線和下劃線,且以中文或英文字母開頭。 |
| *表編碼 | 碼表的英文名稱。只能包含英文字母、數字、下劃線,且以英文字母開頭。 |
| 表描述 | 碼表的描述信息。支持的長度0~600個字符。 |
| *字段名稱 | 字段名稱。只能包含中文、英文字母、數字、左右括號、空格、中劃線和下劃線,且以中文或英文字母開頭。 |
| *字段編碼 | 字段編碼。只能包含英文字母、數字、下劃線,且以英文字母開頭。 |
| *字段數據類型 | 支持的數據類型有:STRING、BIGINT、DOUBLE、TIMESTAMP、DATE、BOOLEAN、DECIMAL。 |
| 字段描述 | 字段的描述信息。支持的長度0~600個字符。 |
| 是否生成標準 | true:生成數據標準。 false:不生成數據標準。默認為false。 注意 如果要自動生成數據標準,還需在“配置中心>標準模板管理”中勾選上“引用碼表”選項。 |
如果導入時,需要同時導入碼表記錄,請在碼表導入模板中新建一個命名為碼表名稱的Sheet頁,并在該Sheet頁中增加碼表字段,每個字段為一列,列名由字段名稱、換行、字段編碼組成,然后再填寫所需導入的碼表數值。如果碼表導入模板中已有碼表名稱的Sheet頁,則無需再新建該Sheet頁,您可以直接在該Sheet中填寫所需導入的碼表數值。
4.導入結果會在“上次導入”頁面中顯示。如果導入成功,單擊“關閉”完成導入。如果導入失敗,您可以查看失敗原因,將模板文件修改正確后,再重新上傳。
通過逆向數據庫導入碼表
通過逆向數據庫,您可以從其他數據源中將一個或多個已創建的數據庫表導入到碼表目錄中,使其變成碼表。
1.在數據架構控制臺,單擊左側導航樹中的“碼表管理”,進入碼表管理頁面。
2.在左側的碼表目錄樹中,選中一個目錄,然后在碼表列表上方,單擊“逆向數據庫”。
3.在“逆向數據庫”對話框中,配置如下參數,然后單擊“確定”。
| 參數名稱 | 說明 |
|---|---|
| 數據連接類型 | 在下拉列表中將顯示逆向數據庫支持的數據連接類型,請選擇所需要的數據連接類型。 |
| 數據連接 | 選擇數據連接。 如需從其他數據源逆向數據庫到碼表目錄中,需要先在DataArts Studio管理中心創建一個數據連接,以便連接數據源。創建數據連接的操作,請參見創建數據連接。 |
| 數據庫 | 選擇數據庫。 |
| Schema | 下拉選擇Schema。該參數僅DWS模型的表有效。 |
| 隊列 | DLI隊列。僅當“數據連接類型”選擇“DLI”時,該參數有效。 |
| 更新已有表 | 如果從其他數據源逆向過來的表,在碼表中已存在同名的表,選擇是否更新已有的碼表。 |
| 逆向表數據 | 不逆向 :逆向數據庫時,將表導入到碼表目錄中,但是不導入表數據。您可以在完成逆向數據庫后,參考下方“填寫數值到碼表中”添加記錄到碼表中。 覆蓋 :逆向數據庫時,將表導入到碼表目錄中,同時將表數據導入到該碼表中。 |
| 數據表 | 選擇一個或多個需導入的數據表。 |
4.逆向數據庫的結果會在“上次逆向”頁面中顯示。如果逆向成功,單擊“關閉”。如果逆向失敗,您可以查看失敗原因,問題解決后,選中失敗的表,然后單擊“重新逆向”進行重試。

導出碼表
Excel導出碼表時, 碼表名稱需要限制在32個字符以內。
1.在數據架構控制臺,單擊左側導航樹中的“碼表管理”,進入碼表管理頁面。
2.導出碼表。
- 導出碼表
在碼表列表中,選中所需導出的碼表,然后單擊“更多 > 導出”。

- 導出碼表目錄中的所有表
在碼表目錄樹中,選中一個目錄,單擊鼠標右鍵,選擇“導出”菜單。

刪除碼表
碼表被刪除后,將無法恢復,請謹慎操作。刪除碼表時,如果碼表為待發布、已發布或待下線狀態,則無法刪除。您需要對碼表進行操作,使其變為其他狀態時,才能刪除該碼表。
1.在數據架構控制臺,單擊左側導航樹中的“碼表管理”,進入碼表管理頁面。
2.在碼表列表中,選擇要刪除的碼表,然后在列表上方單擊“更多 > 刪除”。
3.在彈出的確認對話框中,單擊“是”進行刪除。
刪除碼表目錄
刪除碼表目錄時,如果該目錄或其子目錄包含碼表,則無法刪除。您需要先刪除其中的碼表后,才能刪除該目錄。
1.在數據架構控制臺,單擊左側導航樹中的“碼表管理”,進入碼表管理頁面。
2.在左側碼表目錄樹中,選擇要刪除的目錄,單擊鼠標右鍵,選擇“刪除”菜單。

- 在彈出的確認對話框中,單擊“是”進行刪除。
管理碼表
建立好碼表后,可以對碼表進行查找、編輯、下線或刪除等操作。
在數據架構控制臺,單擊左側導航樹中的“碼表管理”,進入碼表管理頁面。您可以對碼表進行管理。

- 編輯
在碼表列表中,找到所需要的碼表,單擊其所在行的“編輯”,即可編輯指定的碼表。
- 發布
在碼表列表中,對于狀態為“草稿”或“已駁回”的碼表,單擊其所在行的“發布”,并在彈出框中選擇審核人并單擊“確認提交”,即可發布該碼表提交審核。等待審核人員審核通過后,碼表就發布成功了。
- 下線
在碼表列表中,對于狀態為“已發布”的碼表,單擊其所在行的“更多-下線”,并在彈出框中選擇審核人并單擊“確認提交”,即可提交下線申請。等待審核人員審核通過后,碼表就下線成功了。
- 填寫數值
在碼表列表中,找到所需要的碼表,單擊其所在行的“更多-填寫數值”,可以快速設置各字段的值。
- 發布歷史
在碼表列表中,找到所需要的碼表,單擊其所在行的“更多-發布歷史”,可以查看碼表的發布歷史和變更詳情,并支持進行版本對比。