權限說明

僅支持擁有新建數據源權限點的自定義全局角色和超級管理員、數據源管理員、板塊架構師、項目管理員系統角色創建數據源。

操作步驟

1. 在Dataphin首頁，在頂部菜單欄選擇管理中心 > 數據源管理。

2. 在數據源頁面，單擊+新建數據源。

3. 在新建數據源對話框的關系型數據庫區域，選擇KingbaseES。

   如果您最近使用過KingbaseES，也可以在最近使用區域選擇KingbaseES。同時，您也可以在搜索框中，輸入KingbaseES的關鍵詞，快速篩選。

4. 在新建KingbaseES數據源對話框中，配置連接數據源的參數。

   1. 配置數據源的基本信息。

      參數	描述
      數據源名稱	命名規則如下： 只能包含中文、英文字母大小寫、數字、下劃線（_）或短劃線（-）。 長度不能超過64個字符。
      數據源編碼	配置數據源編碼后，您可以在Flink_SQL任務中通過數據源編碼.表名稱或數據源編碼.schema.表名稱的格式引用數據源中的表；如果需要根據所處環境自動訪問對應環境的數據源，請通過${數據源編碼}.table或${數據源編碼}.schema.table的變量格式訪問。更多信息，請參見Flink_SQL任務開發方式。 重要 目前僅支持MySQL、Hologres、MaxCompute數據源。 數據源編碼配置成功后不支持修改。
      版本	僅支持選擇V8R3和V8R6版本。
      數據源描述	對KingbaseES數據源的描述。不超過128個字符。
      數據源配置	基于業務數據源是否區分生產數據源和開發數據源： 如果業務數據源區分生產數據源和開發數據源，則選擇生產+開發數據源。 如果業務數據源不區分生產數據源和開發數據源，則選擇生產數據源。
      標簽	您可根據標簽給數據源進行分類打標，如何創建標簽，請參見管理數據源標簽。

   2. 配置數據源與Dataphin的連接參數。

      若您的數據源配置選擇生產+開發數據源，則需配置生產+開發數據源的連接信息。如果您的數據源配置為生產數據源，僅需配置生產數據源的連接信息。

      說明

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

      配置方式可選擇JDBC URL或主機兩種方式，默認選擇為JDBC URL。

      JDBC URL配置方式

      參數	描述
      JDBC URL	鏈接地址的格式為： jdbc:kingbase8://host:port/dbname。例如：jdbc:kingbase8//192.168.*.212:54321/dataphin。
      Schema	Schema即KingbaseES實例的數據庫名稱。在KingbaseES實例的數據管理頁面獲取數據庫名稱，如下圖所示。
      用戶名和密碼	登錄數據庫的用戶名和密碼。

      主機配置方式

      • 主機配置方式

        參數	描述
        服務器地址	輸入服務器的IP地址和端口號。 支持單擊+新增來添加多組IP地址和端口號，單擊圖標刪除多余的IP地址和端口號，但需至少保留一組。
        dbname	輸入數據庫名稱。

      • 參數配置

        參數	描述
        參數	參數名稱：僅支持選擇已有參數名稱。 參數值：當已選擇參數名稱時，參數值為必填。僅支持英文字母大小寫、數字、半角句號（.）、下劃線（_）和短劃線（-），長度不超過256個字符。 說明 支持通過單擊+添加參數新增多個參數，單擊圖標刪除多余參數，至多可添加30個參數。
        用戶名、密碼	登錄kingbaseES數據庫的用戶名和密碼。

      說明

      當配置方式選擇為主機并完成新建數據源后，若需要切換為JDBC URL配置方式，系統會將服務器的IP地址和端口號拼接為JDBC URL進行填充。

   3. 配置數據源的高級設置。

      參數	描述
      socketTimeout	數據庫的socketTimeout時長（單位：秒），默認1800秒（30分鐘）。 說明 若您在JDBC URL中帶有socketTimeout配置，則socketTimeout為JDBC URL中配置的超時時間。 Dataphin V3.11版本之前的創建數據源，socketTimeout默認為-1，表示無超時限制。
      connectTimeout	數據庫的connectTimeout時長（單位：秒），默認900秒（15分鐘）。 說明 若您在JDBC URL中帶有connectTimeout配置，則connectTimeout為JDBC URL中配置的超時時間。 Dataphin V3.11版本之前的創建數據源，connectTimeout默認為-1，表示無超時限制。
      連接重試次數	數據庫連接超時，將自動重試連接直到完成設定的重試次數。若達最大重試次數仍未連接成功，則連接失敗。 說明 默認重試次數為1次，支持配置0～10之間參數。 連接重試次數將默認應用于離線集成任務與全域質量（需開通資產質量功能模塊），離線集成任務中支持單獨配置任務級別的重試次數。

   說明

   重復參數的取值規則：

   • 若某一參數同時存在于JDBC URL、高級設置的參數和主機配置方式的參數配置中時，則以JDBC URL中該參數的取值為準。

   • 若某一參數同時存在于JDBC URL和高級設置的參數中時，則以JDBC URL中該參數的取值為準。

   • 若某一參數同時存在于高級設置的參數和主機配置方式的參數配置中時，則以高級設置的參數配置中該參數的取值為準。

5. 單擊測試連接，測試數據源是否可以和Dataphin進行正常的連通。

   重要

   如果連接測試失敗，您可以根據網絡連通常見問題進行排查。詳細內容，請參見網絡連通解決方案。

6. 測試成功后，單擊確定，完成KingbaseES數據源的創建。