Dataphin：建立飛書多維表格式資料源

前提條件

• 已完成飛書自建應用的建立，並擷取相關授權資訊。操作詳情請參見擷取應用授權資訊。

• 已擷取待接入Dataphin的飛書多維表格分享連結。操作詳情請參見擷取多維表格連結。

使用限制

• 飛書多維表格的資料表支援多種欄位類型，您可以通過飛書多維表格解析規則，查看飛書多維表格欄位與Dataphin欄位類型的映射關係。

• 由于飛書側限制，自2024年10月31日起，飛書基礎免費版介面累計可調用次數為1萬次/月。若該調用量無法滿足需求，您可升級至其他飛書版本擴容調用次數。具體請參見飛書自建應用API調用量上限調整說明。

許可權說明

僅支援擁有建立資料來源許可權點的自訂全域角色和超級管理員、資料來源管理員、板塊架構師、專案系統管理員系統角色建立資料來源。

操作步驟

1. 在Dataphin首頁，在頂部功能表列選擇管理中心 > 資料來源管理。

2. 在資料來源頁面，單擊+建立資料來源。

3. 在建立資料來源頁面，選擇飛書多維表格。

   如果您最近使用過飛書多維表格，也可以在最近使用地區選取項目飛書多維表格。同時，您也可以在搜尋方塊中，輸入飛書多維表格的關鍵詞，快速搜尋。

4. 在建立飛書多維表格式資料源頁面中，配置串連資料來源參數。

   1. 配置資料來源的基本資料。

      參數	說明
      資料來源名稱	填寫資料來源名稱。命名規則如下： 只能包含中文、英文字母大小寫、數字、底線（_）或短劃線（-）。 長度不能超過64個字元。
      資料來源編碼	配置資料來源編碼後，您可以在Flink_SQL任務或使用Dataphin JDBC用戶端中，通過資料來源編碼.表名稱或資料來源編碼.schema.表名稱的格式直接存取Dataphin資料來源表，實現快捷消費；如果需要根據任務執行環境自動切換資料來源，請通過${資料來源編碼}.table或${資料來源編碼}.schema.table的變數格式訪問。更多資訊，請參見Dataphin資料來源表開發方式。 重要 資料來源編碼配置成功後不支援修改。 資料來源編碼配置成功後，才能在資產清單的對象詳情頁面進行資料預覽。 Flink SQL中，目前僅支援MySQL、Hologres、MaxCompute、Oracle、StarRocks、Hive、SelectDB、GaussDB（DWS）資料來源。
      資料來源描述	對飛書多維表格式資料源的簡單描述。不得超過128個字元。
      資料來源配置	基於業務資料來源是否區分生產資料來源和開發資料來源： 如果業務資料來源區分生產資料來源和開發資料來源，則選擇生產+開發資料來源。 如果業務資料來源不區分生產資料來源和開發資料來源，則選擇生產資料來源。
      標籤	您可以根據標籤給資料來源進行分類打標，如何建立標籤，請參見管理資料來源標籤。

   2. 配置資料來源與Dataphin的串連參數。

      若您的資料來源配置選擇生產+開發資料來源，則需配置生產+開發資料來源的串連資訊。如果您的資料來源配置為生產資料來源，僅需配置生產資料來源的串連資訊。

      說明

      通常情況下，生產資料來源和開發資料來源需配置為非同一個資料來源，以實現開發資料來源與生產資料來源的環境隔離，降低開發資料來源對生產資料來源的影響。但Dataphin也支援配置成同一個資料來源，即相同參數值。

      參數	描述
      飛書多維表格URL	飛書多維表格地址，例如https://base.feishu.cn/base/appxxxx。詳細擷取步驟請參見擷取多維表格連結。
      APP ID、APP Secret	輸入企業版內部應用的唯一標識key和密鑰。詳細擷取步驟請參見擷取應用授權資訊。

5. 選擇預設資源群組，該資源群組用於運行與當前資料來源相關任務，包括資料庫SQL、離線整庫遷移、資料預覽等。

6. 進行測試連接或直接單擊確定進行儲存，完成飛書多維表格式資料源的建立。

   單擊測試連接，系統將測試資料來源是否可以和Dataphin進行正常的連通。若直接單擊確定，系統將自動對所有已選中的叢集進行測試連接，但即使所選中的叢集均串連失敗，資料來源依然可以正常建立。

   測試連接針對預設叢集或已經在Dataphin註冊且正常使用的註冊調度叢集進行串連測試。預設叢集為系統預設選中，不支援取消選中。註冊調度叢集下不存在資源群組時，不支援進行串連測試，需先建立資源群組後再進行測試連接。

   • 所選叢集只用於測試與當前資料來源的網路連通，不用於後續相關任務的運行。

   • 測試連接時間長度通常在2分鐘內，若逾時，您可以單擊表徵圖查看具體原因並重試。

   • 無論測試結果為串連失敗、串連成功或成功有風險，系統都將為您記錄最終結果的產生時間。

     說明

     僅預設叢集的測試結果包含成功有風險、串連成功、串連失敗三種串連狀態；在Dataphin註冊的註冊調度叢集的測試結果僅包含串連成功、串連失敗兩種串連狀態。

   • 測試結果為串連失敗時，您可以單擊表徵圖查看具體失敗原因。

   • 測試結果為成功有風險時，代表應用叢集串連成功、調度叢集串連失敗。您可以單擊表徵圖查看日誌資訊。

附錄