Dataphin：建立及管理標準代碼（碼錶）

許可權說明

• 超級管理員、資料標準管理員支援建立及管理所有碼錶、碼錶目錄及引入模板庫。

• 標準集維護人員可以在已加入的碼錶下編輯或刪除碼錶。

使用限制

• 建立碼錶目錄層級不超過10級。

• 所有層級的碼錶目錄總數不超過1000層。

• 支援建立不超過10萬張碼錶。

• 每個碼錶最多添加10000個碼值，並且單個碼錶下的碼值不可重複。

碼錶列表

碼錶列表為您提供編輯和查看兩種展示模式，在碼錶頁面，單擊右上方表徵圖進行切換查看。

在查看模式下，可以查看已配置的碼錶目錄和碼錶資訊，但不支援操作，適用於瀏覽的情境。

在編輯模式下，除了查看已配置的碼錶目錄和碼錶外，支援對碼錶執行查看引用、編輯、匯出碼錶、刪除操作，可對碼錶目錄執行編輯、刪除等操作。僅有碼錶系統管理權限的帳號可以進入編輯模式。

1. 在碼錶列表頁面，您可以查看碼錶目錄及碼錶資訊，左側碼錶目錄從業務或組織架構視角出發，對碼錶進行分類、分層管理，選中某一層級目錄後，右側列表為您展示歸屬目前的目錄的碼錶資訊，包括碼錶的名稱、所屬目錄、描述、狀態、定義方式、碼值數、負責人、最新動向人/時間。您也可以單擊全部碼錶，查看全量碼錶資訊。

2. （可選）您可根據碼錶的名稱、編碼搜尋目標，也可根據碼錶所屬目錄、負責人等對碼錶範圍進行篩選。

3. 您可以對目標碼錶目錄及碼錶執行如下操作。

   操作項		描述
   碼錶目錄	建立碼錶	單擊目錄行右側的建立碼錶表徵圖，可在目前的目錄下建立碼錶，特殊的，若定位在全部碼錶目錄，則建立的碼錶直接歸屬於全部碼錶目錄下。
   	從模板庫引入碼錶	單擊目錄行右側的從模板庫引入碼錶表徵圖或滑鼠移至上方建立碼錶按鈕後的下拉式箭頭單擊從模板庫引入碼錶，可在目前的目錄下引入碼錶模板。
   碼錶列表	查看詳情	單擊操作列下的查看詳情，查看碼錶詳情、引用資訊。
   	編輯	單擊操作列下的編輯，支援修改碼錶的配置資訊。 若定義方式變更、來源表及欄位變更，僅資料擷取成功，儲存發布後才會覆蓋更新已有配置，否則保留已有配置不更新。
   	匯出	單擊操作列下的匯出或選中碼錶列表的碼錶後單擊底部的大量匯出，可將碼錶及碼值資訊匯出為Excel檔案，方便資訊維護和發送給相關業務人員查詢。匯出配置詳情請參見大量匯入匯出碼錶。
   	更新碼值	僅定義方式為從表引入時支援操作。單擊操作列下的更多，選擇更新碼值，系統將按照引入配置自動擷取最新的碼值資料，擷取成功後，需儲存發布才會更新已有碼值配置。
   	編輯碼值	僅定義方式為從表引入時支援操作。單擊操作列下的更多，選擇編輯碼值，可以直接修改碼值定義，適用於需要對從表引入的原始碼值資訊進行簡單修改的情境。
   	查看引用	單擊操作列下的更多，選擇查看引用，查看碼錶被標準模板引用的詳情，單擊標準模板的名稱，可快捷查看標準模板資訊，包括模板的屬性資訊、引用資訊、歷史版本。
   	刪除	單擊操作列下的更多，選擇刪除，碼錶刪除後不可撤銷，請謹慎操作。

管理碼錶目錄

1. 在Dataphin首頁的頂部功能表列，選擇治理 > 資料標準。

2. 在左側導覽列選擇參考資料 > 標準代碼（碼錶），在碼錶目錄頁簽，單擊編輯表徵圖。

3. 在碼錶目錄管理面板，您可以對碼錶目錄執行建立、移動、編輯、刪除操作。

   操作項	描述
   建立	請填寫目錄的名稱。同一目錄下的同級目錄不支援重名。不支援輸入字元正斜杠（/），128個字元以內。 支援添加目錄至指定層級的下一級。若未選擇歸屬目錄，將直接歸屬碼錶根目錄。
   編輯	可修改目錄的名稱。
   移動	支援移動碼錶的所屬上級目錄。
   刪除	若目前的目錄下有子目錄或碼錶，則不支援刪除。

建立碼錶

1. 在碼錶列表頁面，單擊+建立碼錶按鈕。

2. 在建立自訂碼錶對話方塊中，配置參數。

   參數	描述
   碼錶名稱	碼錶的名稱，不超過128個字元，且在所屬上級目錄下名稱唯一。例如：全國地區代碼錶。
   碼錶編碼	用於唯一識別碼錶，輸入不超過128個字元，支援輸入英文字母、數字和任意半形符號。例如：DQ001。
   所屬目錄	選擇碼錶歸屬的目錄，若當前定位在某個碼錶目錄下，建立碼錶時預設填充該碼錶目錄；若未選擇歸屬目錄，將直接歸屬根目錄。如需建立目錄，請參見管理碼錶目錄。
   負責人	選擇碼錶的負責人。
   描述	可添加碼錶含義的描述，輸入不超過1000個字元。
   代碼資訊	支援自訂及從表引入兩種定義方式。 自訂建立碼錶 填寫碼錶的資訊，同時可對代碼資訊進行編輯和刪除操作。您可單擊新增碼值按鈕，增加碼值數量，也可以單擊批量輸入按鈕，批量增加碼值，或單擊全部清空按鈕，清空全部碼值內容。 批量輸入：在批量輸入對話方塊中，可輸入或粘貼碼值資訊，系統最多解析前10000行資料。單行內容依次解析代碼值、代碼名稱、代碼英文名、代碼描述；單個參數之間（即列）可用tab（\t）或空格（\s）分隔；單行內容可用分行符號（\n）或shift+斷行符號鍵進行換行。 例如：代碼值：2900，代碼名稱：上海市，代碼英文名稱：Shanghai City，代碼描述：用2900標識上海市。 代碼值：必填，碼錶內唯一，最多輸入64個字元。 代碼名稱：必填，最多輸入64個字元。 代碼英文名：非必填，最多輸入64個字元，支援輸入英文大小寫字母、數字以及特殊符號()^~`!@#$%&*_+\-=[]{}|;':",./<>·?。 代碼描述：非必填，最多可輸入256個字元。 單擊儲存並發布，完成碼錶的建立。 從表引入 說明 擷取碼值資料時，不會基於行級許可權進行過濾，也不會進行脫敏查詢，請選擇可公開的資料來源。 碼錶的定義方式為從表引入時，不建議使用分區表，如果需要，建議使用每個分區均儲存全量資料的表。 由於每個碼錶最多添加10000個碼值，僅查詢合格前10000條表資料。 當前操作人需對選中的來源表欄位具有select許可權。 系統會將從來源表讀取到的資料自動轉換為string類型進行儲存。如果代碼名稱和碼值的來源欄位類型無法轉換，則整行記錄添加失敗；如果英文名和描述的來源欄位無法轉換，則對應配置項留空，不影響整條記錄的添加。 支援引用不同資料錶快速建立碼錶，降低配置成本。 在代碼資訊地區，配置如下資訊。 來源表（必填）：支援引用除元表、鏡像表之外的Dataphin表以及支援資料預覽的資料來源表。您可以根據表全名、表描述進行模糊搜尋，也可以單擊篩選圖示，根據所屬板塊/專案/資料來源、表類型快速篩選所需資料表。 代碼值（必填）：選擇所屬來源表的欄位，代碼值需在碼錶內唯一，若來源欄位值重複，系統則自動擷取第一條記錄對應的資料，如果來來源資料輸入超過64個字元，則整條記錄添加失敗。 代碼名稱（必填）：選擇所屬來源表的欄位，如果來來源資料輸入超過64個字元，則整條記錄添加失敗。 代碼英文名（可選）：選擇所屬來源表的欄位，支援輸入英文大小寫字母、數字以及特殊符號()^~`!@#$%&*_+\-=[]{}|;':",./<>·?，如果來來源資料輸入超過64個字元，系統則自動截斷或留空。 代碼描述（可選）：選擇所屬來源表的欄位，如果來來源資料輸入超過256個字元，系統則自動截斷或留空。 資料過濾（可選）：支援基於已選表的欄位添加分區、空值或重複值等過濾條件對來來源資料進行過濾。當表為MaxCompute計算源表或Dataphin邏輯表，系統將自動開啟並填充分區過濾條件；若為其他源類型，可按需開啟。 配置完成後，單擊預覽資料按鈕，對本次填寫的參數、許可權及文法進行校正。 參數：校正必填參數是否填寫完整。 許可權：校正當前操作人是否具有建立碼錶許可權。 過濾條件：校正過濾條件陳述式是否正確。 校正通過後，擷取碼錶資料，將碼錶添加至Dataphin。 當碼錶資料擷取中，您可單擊取消或關閉對話方塊，終止查詢並退出，已配置資料將不儲存；若單擊上一步，將返回上一步並終止查詢，您需要重新擷取資料。 當碼錶資料擷取失敗，您可單擊重試，重新擷取資料，或單擊查看日誌，查看失敗原因。 當碼錶資料擷取成功，您可以預覽碼值資訊，單擊儲存並發布，將碼錶添加至Dataphin。如果存在部分記錄資料擷取失敗，將為您展示異常列表，您可在異常列表查看具體原因。

後續步驟

碼錶建立完成後，您可以在配置標準模板屬性的取值約束時，選擇對應的碼錶，詳情請參見建立及管理標準模板。