前提條件

若您需在Dataphin中創建基于阿里云產品的數據源，創建數據源前，需確保Dataphin的IP已添加至數據庫白名單（或安全組）中，使數據源與Dataphin網絡互通。具體操作，請參見數據源白名單配置。

權限說明

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

操作步驟

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

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

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

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

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

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

      參數	描述
      數據源名稱	填寫數據源的名稱。命名規則如下： 只能包含中文、英文字母大小寫、數字、下劃線（_）或短劃線（-）。 長度不能超過64個字符。
      數據源編碼	配置數據源編碼后，您可以在Flink_SQL任務或使用Dataphin JDBC客戶端中，通過數據源編碼.表名稱或數據源編碼.schema.表名稱的格式直接訪問Dataphin數據源表，實現快捷消費；如果需要根據任務執行環境自動切換數據源，請通過${數據源編碼}.table或${數據源編碼}.schema.table的變量格式訪問。更多信息，請參見Flink_SQL任務開發方式。 重要 數據源編碼配置成功后不支持修改。
      數據源描述	對數據源的簡單描述。不得超過128個字符。
      數據源配置	選擇需要配置的數據源： 如果業務數據源區分生產數據源和開發數據源，則選擇生產+開發數據源。 如果業務數據源不區分生產數據源和開發數據源，則選擇生產數據源。
      標簽	您可根據標簽給數據源進行分類打標，如何創建標簽，請參見管理數據源標簽。

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

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

      說明

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

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

      JDBC URL配置方式

      參數	描述
      JDBC URL	鏈接地址的格式為jdbc:postgresql://host:port/dbname。
      Schema	請填寫與用戶名相關聯的Schema。
      用戶名和密碼	填寫數據庫的用戶名和密碼。
      類型	支持公網數據庫、阿里云數據庫與ECS(VPC)自建數據庫，您可根據您數據庫類型及業務情況進行選擇與配置： 公網數據庫：通過公網可直接訪問的數據庫。 阿里云數據庫：在阿里云購買的數據庫。支持VPC網絡或公網IP進行訪問。VPC網絡訪問數據庫需配置以下信息： 區域：數據庫所在Region。僅支持Dataphin實例相同區域的數據庫。如您的Dataphin實例位于華東2（上海），僅支持選擇華東2（上海）區域。 VPC ID：填寫數據庫所在VPC網絡的VPC ID。您可登錄專有網絡控制臺進行查看。如下圖所示： VPC實例ID：填寫數據庫的專有網絡實例ID，即VpcCloudInstanceId。您可以通過調用DescribeDBInstances API獲取。更多信息，請參見DescribeDBInstances - 查詢實例列表。 ECS(VPC)自建數據庫：您在阿里云ECS上自建的數據庫。支持VPC方式訪問。VPC網絡訪問數據庫需配置以下信息： 區域：據庫所在Region。僅支持Dataphin實例相同區域的數據庫。如您的Dataphin實例位于華東2（上海），僅支持選擇華東2（上海）區域。 VPC ID：填寫ECS所在VPC網絡的VPC ID。您可登錄專有網絡控制臺進行查看。如下圖所示： ECS ID：填寫部署數據庫的ECS服務器的ECS ID。您可登錄ECS控制臺進行查看。如下圖所示：

      主機配置方式

      • 主機配置方式

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

      • 參數配置

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

      說明

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

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

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

   說明

   重復參數的取值規則：

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

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

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

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

   完成數據源的上述信息配置后，您可以單擊操作列的測試連接針對公共調度集群或已經在Dataphin注冊且正常使用的自定義集群進行連接測試。公共調度集群為系統默認選中，不支持取消選中。自定義集群下不存在資源組時，不支持進行連接測試，需先創建資源組后再進行測試連接。

   • 所選集群只用于測試與當前數據源的網絡連通，不用于后續相關任務的運行。

   • 測試連接時長通常在2分鐘內，若超時，您可以單擊圖標查看具體原因并重試。

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

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

   • 測試結果為成功有風險時，代表應用集群連接成功、調度集群連接失敗，當前數據源無法用于數據開發和集成。您可以單擊圖標查看日志信息。

     說明

     僅公共調度集群的測試結果包含成功有風險、連接成功、連接失敗三種連接狀態；在Dataphin注冊的自定義集群的測試結果僅包含連接成功、連接失敗兩種連接狀態。

   • 請確保至少存在一個集群可以與數據源連通，否則不支持保存數據源信息。

   重要

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

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