使用限制

• 若您未購買數據標準模塊，不支持設置表中的數據標準字段。

• 若您未購買資產安全模塊，不支持設置表中的數據分級、數據分類字段。

• 若您未購買資產質量模塊，不支持實現主鍵字段的唯一和非空校驗。

前提條件

已完成業務活動對象的創建，具體操作請參見創建并管理業務實體。

操作步驟

步驟一：創建事實邏輯表

1. 在Dataphin首頁，單擊頂部菜單欄研發->數據研發。

2. 按照以下操作指引，進入新建事實邏輯表對話框。

   選擇項目（Dev-Prod 模式需要選擇環境）->單擊事實邏輯表->單擊圖標。

   

3. 在新建事實邏輯表頁面，配置參數。

   參數	描述
   業務活動	選擇需要創建事實邏輯表的業務活動。業務活動分為業務事件、業務快照、業務流程三種。
   表類型	邏輯表類型由業務活動類型決定。 業務活動選擇為業務事件，表類型為事件事實邏輯表。 業務活動選擇為業務快照，表類型為快照事實邏輯表。 業務活動選擇為業務流程，表類型為流程事實邏輯表。
   數據板塊	默認為業務活動所在的數據板塊名稱，不支持修改。
   主題域	默認為業務活動所在的主題域名稱，不支持修改。
   數據時效	數據時效用于定義后續該事實邏輯表任務在生產環境的調度類型。事實邏輯表的數據時效支持選擇離線T+1（天任務）、離線T+h（小時任務）和離線T+m（分鐘任務）。
   邏輯表名	填寫邏輯表名，表名稱總長度需要在100個字符以內。選擇業務對象后，系統將自動填充邏輯表名，填充規則為<數據板塊名稱>.fct_<業務對象編碼>_<數據時效>。 重要 僅允許填寫字母，數字和下劃線（_），且首位必須為字母，大小寫不敏感，輸入大寫字母時，系統將自動轉為小寫。 label_為系統保留前綴，不允許開頭為label_。 數據時效不同，邏輯表名的格式也不同，<數據時效>展示信息不同： di：T+1時效，日增量，每天存儲當天的增量數據。 hi：T+h時效，小時增量，每小時存儲當前小時的增量數據。 thi：T+h時效，小時增量，每小時存儲0點到當前小時的增量。 mi：T+m時效，分鐘增量，每15分鐘分區存儲最近15分鐘的增量。 tmi：T+m時效，分鐘增量，每15分鐘存儲0點到當前分鐘的增量。 df/da: T+1時效, 日全量, 每天存儲歷史截止當天的全量數據。 hf: T+h時效, 小時全量, 每小時存儲歷史截止當前小時的全量數據。 mf: T+m時效, 分鐘全量, 每15分鐘存儲歷史截止最近15分鐘的全量數據。
   中文名稱	自定義名稱的命名規則為： 包含漢字、字母、數字或下劃線（_）或短劃線（-）。 不能超過64個字符。
   描述信息	填寫對事實邏輯表的簡單描述，1000個字符以內。

4. 單擊確定。

步驟二：配置事實邏輯表表結構

1. 在表結構頁面，配置參數。

   

   區域	描述
   ①表字段定位	單擊可定位字段列表的基本配置或資產治理配置。
   ①搜索及篩選區	您可以通過表字段名稱搜索所需字段。 單擊可以根據數據類型、字段類別、有無關聯維度、關聯維度、字段約束、數據分級條件進行篩選。
   ②列表操作	調整字段順序：調整字段順序前，請確保引用該邏輯表的下游沒有使用select * 查詢本邏輯表, 避免造成數據錯誤。 引入字段：為表引入新字段。支持從建表語句引入和從表引入。具體操作，請參見為事實邏輯表引入字段。 添加字段：支持添加數據字段和分區字段，您可根據業務情況編輯字段的名稱、說明、數據類型、字段類別、關聯維度、字段標準、字段約束、數據分類、數據分級及備注信息。 說明 MaxCompute引擎下支持創建不超過6級分區字段。
   ③字段列表	字段列表為您展示字段的序號、字段名稱、說明、數據類型、字段類別、關聯維度、字段標準、字段約束、數據分類、數據分級及備注等字段的詳細信息。 序號：表字段序號。每新增1個字段，自增+1。 字段名稱：表字段名稱。您可輸入字段名稱或中文關鍵詞，將自動匹配標準預置的字段名。 說明：表字段說明信息，僅限填寫512字符以內。 數據類型：支持string、bigint、double、timestamp、decimal、文本、數值、日期時間及其他數據類型。 字段類別：支持設置為主鍵、分區、屬性。 說明 僅允許一個主鍵字段。 僅支持string、varchar、bigint、int、tinyint、smallinit類型字段作為分區字段。 關聯維度：具體操作，請參見添加關聯維度。 字段標準：選擇字段的字段標準。如需創建標準，請參見新建及管理數據標準。 字段約束：選擇字段的字段約束。支持唯一和非空約束。 數據分類：選擇字段的數據分類。如需創建數據分類，請參見新建數據分類。 數據分級：選擇數據分類后，系統將自動識別數據級別。 備注：填寫字段的備注信息。僅限填寫2048字符以內。 同時您可以在操作列下對字段進行刪除操作。 說明 字段刪除后不可撤銷。
   ④批量操作	您可以批量選擇表字段，進行以下操作。 刪除：單擊圖標，批量刪除已經選中的數據字段。 數據類型：單擊圖標，批量修改已經選中的數據類型。 字段類別：單擊圖標，批量修改已經選中的字段類別。 詞根命名：單擊圖標，系統將對字段的說明內容進行分詞并匹配已經創建的詞根，進行字段名稱推薦。您可以在詞根命名對話框中，將選中字段的名稱替換為修改后的值。如下圖所示： 說明 若推薦的字段名稱均不滿足需求，您可以在修復后字段名稱輸入框中進行修改。 單擊重置將重置修改后字段名稱為系統的命中詞根。 字段標準：單擊圖標，系統將根據字段名稱進行字段標準推薦。您可以在字段標準對話框中，將字段設置為推薦的字段標準。 字段約束：單擊圖標，批量設置字段約束。 重要 子維度邏輯表不支持設置字段約束。

2. 單擊保存并下一步。

為事實邏輯表引入字段

• 從表引入

  1. 在上述創建的事實邏輯表的配置頁面，單擊從表引入。

     

  2. 在從表引入對話框中，選擇來源表后，選擇您所需添加的字段。

     參數	描述
     來源表	支持選擇當前租戶下所有具有讀取權限的物理表（非Dataphin自動生成的物理表）、邏輯表、視圖（非參數化視圖）。 如何獲取物理表的讀取權限，請參見申請、續期和交還表權限。
     字段列表	選擇您需要添加的字段。 說明 您可通過切換來源表方式選擇多個來源表中的字段。
     已選擇字段	添加的字段將被添加到已選擇字段。您可對已選擇字段進行刪除操作。

  3. 單擊添加，為事實邏輯表引入某物理表的字段。

     添加至新建字段區域后，您可以根據業務情況編輯字段的名稱、數據類型、字段類別及關聯維度。

• 從建表語句引入

  根據事實邏輯表是否已定義主鍵，選擇度量字段的來源表。如果事實邏輯表已經定義了主鍵，則度量字段僅支持從來源主表中選??；如果事實邏輯表中沒有定義主鍵，則度量字段支持從來源主表及其他數據表中選取。

  1. 在上述創建的事實邏輯表的配置頁面，單擊從建表語句引入。

  2. 在從建表語句引入對話框，填寫建表語句并單擊解析SQL。

     

  3. 在字段列表中選擇您需要的字段，并單擊添加，為事實邏輯表新建字段。

添加關聯維度

事實邏輯表的事實屬性中的外鍵字段關聯維度。

1. 在事實邏輯表的配置頁面，單擊圖標，進入編輯模型關系對話框。

   

2. 在編輯模型關系對話框，配置參數。

   區域	參數	描述
   空值替換值		如果事實邏輯表的外鍵字段和維度表關聯不上，則系統將默認值設定為-110。
   關聯維度	關聯實體、維度邏輯表	選擇您已創建的關聯實體和維度邏輯表。
   編輯關聯邏輯	關聯邏輯	選擇事實邏輯表中的字段，并配置事實邏輯表字段與需要關聯的維度邏輯表中的主鍵的關系。
   	維表版本策略	選擇關聯維表的版本（分區），默認使用與主表相同周期分區版本。
   	缺聯策略	缺聯策略用于定義來源主表（左表）中存在的字段，但在維度邏輯表（右表）中不存在的字段，即無法關聯的字段的計算邏輯。您可以選擇保留原始缺聯數據和缺聯數據使用默認值代替： 保留原始缺聯數據： 創建派生指標時，保留左表原始數據。 缺聯數據使用默認值代替：維表中的字段沒有與事實邏輯表關聯上，則使用默認值-110。
   編輯維度角色	角色英文名、角色名稱	維度角色具有維度別名作用。多次引用同一維度時不可重名定義，起到角色扮演效果。您需要定義角色英文名和角色名稱： 角色英文名的前綴默認為dim，自定義部分的命名規則為： 包含字母、數字或下劃線（_）。 不能超過64個字符。 角色名稱的命名規則： 包含漢字、數字、字母、下劃線（_）或短劃線（-）。 不能超過64個字符。

3. 單擊確定。

步驟三：配置事實邏輯表計算邏輯

1. 在計算邏輯頁面，配置事實邏輯表的來源數據與主鍵間的映射關系。

   

2. 單擊來源配置，進入來源配置對話框并在來源配置對話框中，配置來源參數。

   

   說明

   • 建議不要在過濾條件或自定義SQL中額外設置對事件時間的過濾。

   • 當前邏輯表沒有主鍵，只能設置一個來源。若來源是多個表，請使用自定義SQL預先完成多表的關聯。

   參數	描述
   來源類型	支持物理表、自定義SQL、邏輯表三種來源類型。 來源表類型說明： 有主鍵來源表：有主鍵的邏輯表允許配置多個來源, 第一個固定為主來源, 邏輯表的數據總量（行數）由此來源決定。 無主鍵來源表：無主鍵的邏輯表僅允許配置一個來源,。若來源是多個表，請使用自定義SQL預先完成多表的關聯。 說明 若您需要配置多個來源對象，您可單擊添加來源對象進行新增。
   來源對象	選擇物理表：支持選擇當前租戶下所有具有讀取權限的物理表（非Dataphin自動生成的物理表）、物理視圖（非參數化視圖）。 如何獲取物理表的讀取權限，請參見申請、續期和交還表權限。 選擇自定義SQL：單擊圖標，在編輯框輸入內容，例如： select id, name from project_name_dev.table_name1 t1 join project_name2_dev.table_name2 t2 on t1.id = t2.id 選擇邏輯表：支持選擇當前租戶下所有具有讀取權限的邏輯表。 如何獲取物理表的讀取權限，請參見申請、續期和交還表權限。 重要 使用邏輯表作為另一個邏輯表的數據來源，會增加計算邏輯的復雜度和運維難度，請謹慎選擇。
   對象別名	自定義來源表別名。例如：t1，t2。
   對象描述	請輸入對象的描述信息。僅限1000字符以內。
   過濾條件	單擊圖標，在編輯框輸入內容，例如： ds=${bizdate} and condition1=value1。 自定義SQL無過濾條件。
   關聯字段	來源對象中與邏輯表主鍵相對應的字段，與主鍵可以做等值關聯。
   刪除	主來源不支持刪除。 無主鍵邏輯表，刪除來源將清空字段的計算邏輯。

3. 單擊確定，完成來源配置。

4. 完成來源配置后，將來源字段拖入計算邏輯中。

   您也可以單擊同名字段快速映射按鈕，批量將數據來源字段置入同名的邏輯表字段的計算邏輯中。

   單擊圖標，在編輯框中可以編輯計算邏輯表達式（表達式不支持聚合函數：sum，count，min等），例如：

   • 示例1：substr(t1.column2, 3, 10

   • 示例2：case when t1.column2 != '1' then 'Y' else 'N' end

   • 示例3：t1.column2 + t2.column1

5. 單擊底部圖標，可校驗表達式的有效性。

   單擊預覽SQL按鈕，可查看計算邏輯SQL。

6. 單擊保存并下一步。

步驟四：配置約束

1. 基于字段約束, 系統將在質量模塊中為當前邏輯表創建質量規則。您可在此處設置字段的規則強度，包括強規則和弱規則。更多信息，請參見數據表質量規則。

   

2. 單擊保存并下一步

步驟五：配置事實邏輯表調度配置

1. 在調度&參數配置頁面，配置事實邏輯表的數據延遲、調度屬性、調度依賴、調度參數、運行配置。

   

   參數	描述
   數據延遲	開啟數據延遲，系統將自動重跑本邏輯表在最大延遲天數周期內的全部數據。詳細說明，請參見配置邏輯表數據延遲。
   調度屬性	用于定義事實邏輯表在生產環境的調度方式。您可以通過調度屬性，配置事實邏輯表的調度類型、調度周期、調度邏輯與執行等等。詳情說明，請參見：配置邏輯表調度屬性。
   上游依賴	用于定義邏輯表在調度任務中的節點。Dataphin通過各個節點的調度依賴的配置結果，有序的運行業務流程中各個節點，保障業務數據有效、適時地產出。詳情說明，請參見：配置邏輯表上游依賴。
   參數配置	參數配置是對代碼中所用的變量進行賦值，從而支持節點調度時，參數變量可以自動被替換為相應的變量值。在調度參數配置頁面，您可以對參數配置進行忽略或轉為全局變量的操作。詳情說明，請參見：邏輯表運行參數配置。
   運行配置	您可以根據業務場景為該事實邏輯表配置任務級的運行超時時間和任務運行失敗時的重跑策略，杜絕因計算任務長時間資源占用造成資源浪費的同時提高計算任務運行的可靠性。詳情說明，請參見邏輯表運行配置
   資源配置	您可以為當前邏輯表任務配置調度資源組，邏輯表任務調度時將占用該資源組的資源配額。配置說明，請參見邏輯表資源配置。

步驟六：保存并提交邏輯表

1. 完成事實邏輯表配置后，單擊保存并提交。系統將對表結構、計算邏輯、調度依賴、運行參數進行配置校驗。您可以根據未通過的檢查結果，檢查配置信息并完成配置。

   

2. 檢查結果全部通過后，填寫提交備注，并單擊確定并提交。

   提交時，Dataphin將進行任務的血緣解析及提交檢查。更多信息，請參見規范建模任務提交說明。

后續步驟

• 如果項目的模式為Dev-Prod，則您需要發布邏輯表至生產環境。具體操作，請參見管理發布任務。

• 邏輯表發布至生產環境后，您可在運維中心查看并運維邏輯表任務。具體操作，請參見運維中心概述。