全部產品
Search
文件中心

Dataphin:建立TiDB資料來源

更新時間:May 29, 2025

通過建立TiDB資料來源能夠實現Dataphin讀取TiDB的業務資料或向TiDB寫入資料。本文為您介紹如何建立TiDB資料來源。

許可權說明

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

操作步驟

  1. 在Dataphin首頁,單擊頂部功能表列管理中心 > 資料來源管理

  2. 資料來源頁面,單擊+建立資料來源

  3. 建立資料來源頁面的關係型資料庫地區,選擇TiDB。

    如果您最近使用過TiDB,也可以在最近使用地區選取項目TiDB。同時,您也可以在搜尋方塊中,輸入TiDB的關鍵詞,快速搜尋。

  4. 建立TiDB資料來源頁面中,配置串連資料來源的參數。

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

      參數

      描述

      資料來源名稱

      命名規則如下:

      • 只能包含中文、英文字母大小寫、數字、底線(_)或短劃線(-)。

      • 長度不能超過64字元。

      資料來源編碼

      配置資料來源編碼後,您可以在Flink_SQL任務中通過資料來源編碼.表名稱資料來源編碼.schema.表名稱的格式引用資料來源中的表;如果需要根據所處環境自動訪問對應環境的資料來源,請通過${資料來源編碼}.table${資料來源編碼}.schema.table的變數格式訪問。更多資訊,請參見Dataphin資料來源表開發方式

      重要
      • 資料來源編碼配置成功後不支援修改。

      • 資料來源編碼配置成功後,才能在資產目錄和資產清單的對象詳情頁面進行資料預覽。

      • Flink SQL中,目前僅支援MySQL、Hologres、MaxCompute、Oracle、StarRocks、Hive、SelectDB資料來源。

      版本

      僅支援選擇TiDB v4TiDB v5TiDB v6版本。

      資料來源描述

      對TiDB資料來源的描述。不超過128字元。

      即時研發

      開啟後該資料來源可用於即時研發,但需填寫即時研發相關配置項。

      資料來源配置

      基於業務資料來源是否區分生產資料來源和開發資料來源:

      • 如果業務資料來源區分生產資料來源和開發資料來源,則選擇生產+開發資料來源

      • 如果業務資料來源不區分生產資料來源和開發資料來源,則選擇生產資料來源

      標籤

      您可根據標籤給資料來源進行分類打標,如何建立標籤,請參見管理資料來源標籤

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

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

      說明

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

      參數

      描述

      JDBC URL

      連結地址的格式為: jdbc:mysql://host:port/dbname。例如:jdbc:mysql//192.168.*.212.4000/dataphin。

      使用者名稱、密碼

      登入資料庫的使用者名稱和密碼。

      pd-addresses

      開啟即時研發後,需輸入資料庫TIKV叢集的pd-addresses資訊。

    3. 配置資料來源的進階設定。

      參數

      描述

      connectTimeout

      資料庫的connectTimeout時間長度(單位:毫秒),預設900000毫秒(15分鐘)。

      說明
      • 若您在JDBC URL中帶有connectTimeout配置,則connectTimeout為JDBC URL中配置的逾時時間。

      • Dataphin V3.11版本之前的建立資料來源,connectTimeout預設為-1,表示無逾時限制。

      socketTimeout

      資料庫的socketTimeout時間長度(單位:毫秒),預設1800000毫秒(30分鐘)。

      說明
      • 若您在JDBC URL中帶有socketTimeout配置,則socketTimeout為JDBC URL中配置的逾時時間。

      • Dataphin V3.11版本之前的建立資料來源,socketTimeout預設為-1,表示無逾時限制。

      串連重試次數

      資料庫連接逾時,將自動重試串連直到完成設定的重試次數。若達最大重試次數仍未串連成功,則串連失敗。

      說明
      • 預設重試次數為1次,支援配置0~10之間參數。

      • 串連重試次數將預設應用於離線整合任務全域品質(需開通資產品質功能模組),離線整合任務中支援單獨配置任務層級的重試次數。

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

  6. 進行測試連接或直接單擊確定進行儲存,完成TiDB資料來源的建立。

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