全部產品
Search
文件中心

Dataphin:建立及管理群組分頁查詢

更新時間:Mar 06, 2025

Dataphin支援通過批量查詢介面,分頁查詢群組ID及標籤值。群組分頁查詢需要將群組及標籤的資料匯出到Elasticsearch資料來源中,通過系統提供的API即可分頁查詢匯出的群組ID及其標籤值。本文將指導您如何建立及管理群組分頁查詢。

前提條件

  • 建立群組分頁查詢服務前,已在群組資產市場選擇所需群組並申請使用許可權至服務所在應用。具體操作,請參見申請標籤或群組許可權

  • 已建立群組分頁查詢服務相關 App。具體操作,請參見建立應用

  • 已配置用於提供查詢服務的Elasticsearch資料來源。具體操作,請參見建立Elasticsearch資料來源

注意事項

  • 群組分頁服務運行後,系統會先刪除目標索引中的資料,然後寫入新的資料。因此在群組分頁服務運行開始到完成前,分頁查詢的結果為空白,該結果不正確。

  • 若群組分頁查詢中的標籤已從群組分頁中刪除,查詢時則會返回空值。若需替換標籤,建議先保留原始標籤,再增加新標籤,等待調用的應用修改完成後刪除需要移出的標籤。

  • 行為偏好標籤暫不支援匯出。

建立群組分頁查詢服務

  1. 在Dataphin首頁的頂部功能表列中,選擇標籤 > 標籤應用

  2. 在左側導覽列中選擇服務管理 > 群組分頁查詢

  3. 群組分頁查詢頁面,單擊建立查詢服務

  4. 建立查詢服務配置頁中,配置參數資訊。

    參數

    說明

    基本資料

    任務名

    填寫任務名稱。

    必須以小寫英文字母開頭,且僅包含小寫英文字母、數字和底線(_)。長度不超過64個字元。

    應用選擇

    選擇已關聯專案的應用。

    說明
    • 只有已經關聯專案的應用才能建立離線服務。

    • 僅支援選擇具備許可權的應用。

    負責人

    選擇該離線服務的負責人,可輸入關鍵字搜尋。

    調度類型

    支援周期調度和手動調度任務類型。

    • 手動調度:一次整合,任務發布後可在工作清單頁選擇手動執行。

    • 周期調度:調度執行,根據配置周期調度執行。

    描述

    填寫簡單描述資訊,長度不超過1000個字元。

    欄位對應

    群組選擇

    選擇需要進行分頁查詢的群組。

    是否需要同步標籤

    預設為,僅同步群組的實體ID;若選擇,則可以在輸入標籤中選擇需要同步的標籤。

    目標資料來源

    支援選擇Elasticsearch類型的資料來源執行個體。

    索引

    選擇目標資料來源Elasticsearch的索引。若無對應索引,選擇輸入標籤後,可以單擊建立索引並在建立索引對話方塊中建立所需的索引。

    1. 建立索引對話方塊中,配置索引資訊。

      • 索引名稱:輸入索引名稱。

        • 不能以短劃線(-)、底線(_)或加號(+)開頭。

        • 不支援中文、大寫英文字母、正斜線(/)、反斜線(\)、豎線(|)、星號(*)、半形問號(?)、半形冒號(:)、半形句號(.)、半形引號(")、井號(#)、角括弧(<>)和空格。

        • 長度不超過255個字元。

      • 映射欄位:輸入欄位名稱並選擇欄位類型,可添加多個欄位。

        • 欄位名稱:必須以小寫英文字母開頭,且僅包含小寫英文字母、數字和底線(_)。長度不超過64個字元。

        • 欄位類型:選擇對應欄位的欄位類型。

        說明

        若標籤有碼錶時,系統將會預設建立標籤的代碼名稱。

    2. 單擊確定

    載入策略

    預設使用覆蓋策略,不支援修改。

    輸入標籤

    勾選需要進行映射的標籤,並單擊image按鈕進列欄位映射關係配置。

    說明
    • 僅當選擇需要同步標籤時才需配置此項。

    • 僅支援應用已經擷取許可權的群組實體ID的相關標籤。

    映射關係

    系統顯示已選的標籤及其映射欄位關係,需選擇輸出標籤映射的映射欄位。

    • 同名映射:單擊同名映射,將相同名稱的標籤及其映射欄位進行關聯。

    • 清除:單擊image.png表徵圖,將已映射關係清除。

    • 輸出內容:選擇已配置碼錶的標籤的輸出內容,可選擇標籤值代碼名稱。預設全選標籤值。可選中輸出標籤列表下方的標籤值代碼名稱進行全選(全部頁面)。

    說明

    僅當選擇需要同步標籤時才需配置此項。

    營運配置

    調度周期

    在特定時間範圍內進行任務調度的周期。支援按日調度。標籤離線任務將按照配置的調度時間按日調度運行。

    重要

    開始運行後,索引中的資料將被刪除,在任務運行成功寫入新的資料前,分頁查詢結果為空白,該服務為不可用狀態。建議您將調度時間設定為業務不使用的時間,或通知到使用方可用時間。

  5. 單擊發布,即可完成群組分頁服務的建立。

管理群組分頁查詢

  1. 群組分頁查詢頁面中展示任務名、負責人、應用程式名稱、群組名、實體、實體ID、任務狀態、執行狀態、調度類型以及支援的操作等資訊。

  2. (可選)可通過選中只看我的、輸入任務名稱或單擊篩選根據應用程式名稱實體-實體ID目標源類型任務狀態執行狀態調度類型進行篩選。

  3. 在群組分頁查詢頁面列表的操作列中,可執行以下操作。

    操作項

    描述

    編輯

    任務狀態不為發布中下線中時,可單擊image.png表徵圖,在編輯離線服務頁面編輯後重新發布,不支援修改任務名、調度類型和載入策略。

    詳情

    單擊image.png表徵圖,在查看離線服務頁面查看當前標籤離線服務的詳細資料。任務狀態為編輯中發布失敗發行已下線時,可單擊頁面底部的編輯,可編輯當前群組分頁查詢服務。

    查看執行個體

    單擊image.png表徵圖,可查看當前群組分頁查詢服務產生的執行執行個體。

    下線

    任務狀態發行下線失敗的群組分頁查詢服務,可單擊image.png下線表徵圖,下線當前的群組分頁查詢服務。

    說明

    下線服務不會刪除目標資料來源中的目標表及中間暫存資料表。

    補資料

    執行狀態運行中狀態的群組分頁查詢服務,可單擊image補資料表徵圖進行補資料,預設補業務日期為昨天(T-1)的資料。

    運行

    對於調度類型為手動調度的任務,可以單擊image.png運行表徵圖,在運行對話方塊中選擇業務日期手動運行。

    查看調用代碼

    查看分頁查詢服務的請求路徑和調用代碼。

    刪除

    任務狀態為已下線發布失敗狀態的群組分頁查詢服務,單擊image..png刪除表徵圖可以刪除當前群組分頁查詢服務。