Dataphin支援通過批量查詢介面,分頁查詢群組ID及標籤值。群組分頁查詢需要將群組及標籤的資料匯出到Elasticsearch資料來源中,通過系統提供的API即可分頁查詢匯出的群組ID及其標籤值。本文將指導您如何建立及管理群組分頁查詢。
前提條件
建立群組分頁查詢服務前,已在群組資產市場選擇所需群組並申請使用許可權至服務所在應用。具體操作,請參見申請標籤或群組許可權。
已建立群組分頁查詢服務相關 App。具體操作,請參見建立應用。
已配置用於提供查詢服務的Elasticsearch資料來源。具體操作,請參見建立Elasticsearch資料來源。
注意事項
群組分頁服務運行後,系統會先刪除目標索引中的資料,然後寫入新的資料。因此在群組分頁服務運行開始到完成前,分頁查詢的結果為空白,該結果不正確。
若群組分頁查詢中的標籤已從群組分頁中刪除,查詢時則會返回空值。若需替換標籤,建議先保留原始標籤,再增加新標籤,等待調用的應用修改完成後刪除需要移出的標籤。
行為偏好標籤暫不支援匯出。
建立群組分頁查詢服務
在Dataphin首頁的頂部功能表列中,選擇標籤 > 標籤應用。
在左側導覽列中選擇服務管理 > 群組分頁查詢。
在群組分頁查詢頁面,單擊建立查詢服務。
在建立查詢服務配置頁中,配置參數資訊。
參數
說明
基本資料
任務名
填寫任務名稱。
必須以小寫英文字母開頭,且僅包含小寫英文字母、數字和底線(_)。長度不超過64個字元。
應用選擇
選擇已關聯專案的應用。
說明只有已經關聯專案的應用才能建立離線服務。
僅支援選擇具備許可權的應用。
負責人
選擇該離線服務的負責人,可輸入關鍵字搜尋。
調度類型
支援周期調度和手動調度任務類型。
手動調度:一次整合,任務發布後可在工作清單頁選擇手動執行。
周期調度:調度執行,根據配置周期調度執行。
描述
填寫簡單描述資訊,長度不超過1000個字元。
欄位對應
群組選擇
選擇需要進行分頁查詢的群組。
是否需要同步標籤
預設為否,僅同步群組的實體ID;若選擇是,則可以在輸入標籤中選擇需要同步的標籤。
目標資料來源
支援選擇Elasticsearch類型的資料來源執行個體。
索引
選擇目標資料來源Elasticsearch的索引。若無對應索引,選擇輸入標籤後,可以單擊建立索引並在建立索引對話方塊中建立所需的索引。
在建立索引對話方塊中,配置索引資訊。
索引名稱:輸入索引名稱。
不能以短劃線(-)、底線(_)或加號(+)開頭。
不支援中文、大寫英文字母、正斜線(/)、反斜線(\)、豎線(|)、星號(*)、半形問號(?)、半形冒號(:)、半形句號(.)、半形引號(")、井號(#)、角括弧(<>)和空格。
長度不超過255個字元。
映射欄位:輸入欄位名稱並選擇欄位類型,可添加多個欄位。
欄位名稱:必須以小寫英文字母開頭,且僅包含小寫英文字母、數字和底線(_)。長度不超過64個字元。
欄位類型:選擇對應欄位的欄位類型。
說明若標籤有碼錶時,系統將會預設建立標籤的代碼名稱。
單擊確定。
載入策略
預設使用覆蓋策略,不支援修改。
輸入標籤
勾選需要進行映射的標籤,並單擊
按鈕進列欄位映射關係配置。說明僅當選擇需要同步標籤時才需配置此項。
僅支援應用已經擷取許可權的群組實體ID的相關標籤。
映射關係
系統顯示已選的標籤及其映射欄位關係,需選擇輸出標籤映射的映射欄位。
同名映射:單擊同名映射,將相同名稱的標籤及其映射欄位進行關聯。
清除:單擊
表徵圖,將已映射關係清除。輸出內容:選擇已配置碼錶的標籤的輸出內容,可選擇標籤值和代碼名稱。預設全選標籤值。可選中輸出標籤列表下方的標籤值和代碼名稱進行全選(全部頁面)。
說明僅當選擇需要同步標籤時才需配置此項。
營運配置
調度周期
在特定時間範圍內進行任務調度的周期。支援按日調度。標籤離線任務將按照配置的調度時間按日調度運行。
重要開始運行後,索引中的資料將被刪除,在任務運行成功寫入新的資料前,分頁查詢結果為空白,該服務為不可用狀態。建議您將調度時間設定為業務不使用的時間,或通知到使用方可用時間。
單擊發布,即可完成群組分頁服務的建立。
管理群組分頁查詢
群組分頁查詢頁面中展示任務名、負責人、應用程式名稱、群組名、實體、實體ID、任務狀態、執行狀態、調度類型以及支援的操作等資訊。
(可選)可通過選中只看我的、輸入任務名稱或單擊篩選根據應用程式名稱、實體-實體ID、目標源類型、任務狀態、執行狀態、調度類型進行篩選。
在群組分頁查詢頁面列表的操作列中,可執行以下操作。
操作項
描述
編輯
任務狀態不為發布中或下線中時,可單擊
表徵圖,在編輯離線服務頁面編輯後重新發布,不支援修改任務名、調度類型和載入策略。詳情
單擊
表徵圖,在查看離線服務頁面查看當前標籤離線服務的詳細資料。任務狀態為編輯中、發布失敗、發行或已下線時,可單擊頁面底部的編輯,可編輯當前群組分頁查詢服務。查看執行個體
單擊
表徵圖,可查看當前群組分頁查詢服務產生的執行執行個體。下線
任務狀態為發行或下線失敗的群組分頁查詢服務,可單擊
下線表徵圖,下線當前的群組分頁查詢服務。說明下線服務不會刪除目標資料來源中的目標表及中間暫存資料表。
補資料
執行狀態為運行中狀態的群組分頁查詢服務,可單擊
補資料表徵圖進行補資料,預設補業務日期為昨天(T-1)的資料。運行
對於調度類型為手動調度的任務,可以單擊
運行表徵圖,在運行對話方塊中選擇業務日期手動運行。查看調用代碼
查看分頁查詢服務的請求路徑和調用代碼。
刪除
任務狀態為已下線或發布失敗狀態的群組分頁查詢服務,單擊
刪除表徵圖可以刪除當前群組分頁查詢服務。