背景信息

MySQL是一款領(lǐng)先的開源關(guān)系型數(shù)據(jù)庫管理系統(tǒng)，它利用結(jié)構(gòu)化查詢語言（SQL）來存儲、檢索和管理數(shù)據(jù)。常用于網(wǎng)站、應(yīng)用程序和商業(yè)產(chǎn)品，是一種常見的主要關(guān)系數(shù)據(jù)存儲系統(tǒng)。

權(quán)限說明

僅支持擁有新建數(shù)據(jù)源權(quán)限點的自定義全局角色和超級管理員、數(shù)據(jù)源管理員、板塊架構(gòu)師、項目管理員系統(tǒng)角色創(chuàng)建數(shù)據(jù)源。

操作步驟

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

2. 在數(shù)據(jù)源頁面，單擊+新建數(shù)據(jù)源。

3. 在新建數(shù)據(jù)源對話框的關(guān)系型數(shù)據(jù)庫區(qū)域，選擇MySQL。

   如果您最近使用過MySQL，也可以在最近使用區(qū)域選擇MySQL。同時，您也可以在搜索框中，輸入MySQL的關(guān)鍵詞，快速搜索。

4. 在新建MySQL數(shù)據(jù)源對話框中，配置連接數(shù)據(jù)源參數(shù)。

   1. 配置數(shù)據(jù)源的基本信息。

      參數(shù)	說明
      數(shù)據(jù)源名稱	填寫數(shù)據(jù)源名稱。命名規(guī)則如下： 只能包含中文、英文字母大小寫、數(shù)字、下劃線（_）或短劃線（-）。 長度不能超過64個字符。
      數(shù)據(jù)源編碼	配置數(shù)據(jù)源編碼后，您可以在Flink_SQL任務(wù)或使用Dataphin JDBC客戶端中，通過數(shù)據(jù)源編碼.表名稱或數(shù)據(jù)源編碼.schema.表名稱的格式直接訪問Dataphin數(shù)據(jù)源表，實現(xiàn)快捷消費；如果需要根據(jù)任務(wù)執(zhí)行環(huán)境自動切換數(shù)據(jù)源，請通過${數(shù)據(jù)源編碼}.table或${數(shù)據(jù)源編碼}.schema.table的變量格式訪問。更多信息，請參見Dataphin數(shù)據(jù)源表開發(fā)方式。 重要 數(shù)據(jù)源編碼配置成功后不支持修改。
      版本	僅支持選擇MySQL5.1.43、MySQL5.6/5.7、MySQL8、RDS MySQL版本的MySQL數(shù)據(jù)源。 重要 若您使用阿里云的MySQL數(shù)據(jù)源，需要選擇RDS MySQL版本才可以正常連接。
      數(shù)據(jù)源描述	對MySQL數(shù)據(jù)源的簡單描述。不得超過128個字符。
      數(shù)據(jù)源配置	基于業(yè)務(wù)數(shù)據(jù)源是否區(qū)分生產(chǎn)數(shù)據(jù)源和開發(fā)數(shù)據(jù)源： 如果業(yè)務(wù)數(shù)據(jù)源區(qū)分生產(chǎn)數(shù)據(jù)源和開發(fā)數(shù)據(jù)源，則選擇生產(chǎn)+開發(fā)數(shù)據(jù)源。 如果業(yè)務(wù)數(shù)據(jù)源不區(qū)分生產(chǎn)數(shù)據(jù)源和開發(fā)數(shù)據(jù)源，則選擇生產(chǎn)數(shù)據(jù)源。
      標(biāo)簽	您可以根據(jù)標(biāo)簽給數(shù)據(jù)源進(jìn)行分類打標(biāo)，如何創(chuàng)建標(biāo)簽，請參見數(shù)據(jù)源管理標(biāo)簽。

   2. 配置數(shù)據(jù)源與Dataphin的連接參數(shù)。

      若您的數(shù)據(jù)源配置選擇生產(chǎn)+開發(fā)數(shù)據(jù)源，則需配置生產(chǎn)+開發(fā)數(shù)據(jù)源的連接信息。如果您的數(shù)據(jù)源配置為生產(chǎn)數(shù)據(jù)源，僅需配置生產(chǎn)數(shù)據(jù)源的連接信息。

      說明

      通常情況下，生產(chǎn)數(shù)據(jù)源和開發(fā)數(shù)據(jù)源需配置為非同一個數(shù)據(jù)源，以實現(xiàn)開發(fā)數(shù)據(jù)源與生產(chǎn)數(shù)據(jù)源的環(huán)境隔離，降低開發(fā)數(shù)據(jù)源對生產(chǎn)數(shù)據(jù)源的影響。但Dataphin也支持配置成同一個數(shù)據(jù)源，即相同參數(shù)值。

      配置方式可選擇JDBC URL或主機兩種方式，默認(rèn)選擇為JDBC URL。

      JDBC URL配置方式

      參數(shù)	描述
      JDBC URL	JDBC URL鏈接地址的格式為jdbc:mysql://host:port/dbname。 說明 MySQL數(shù)據(jù)源的默認(rèn)端口為3306。
      用戶名、密碼	數(shù)據(jù)庫的用戶名和密碼。
      SSL加密	開啟后，需上傳Truststore證書并填寫Truststore證書密碼。

      主機配置方式

      • 主機配置方式

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

      • 參數(shù)配置

        參數(shù)	描述
        參數(shù)	參數(shù)名稱：支持選擇已有參數(shù)名稱或輸入自定義參數(shù)名稱。 自定義參數(shù)名稱僅支持英文字母大小寫、數(shù)字、半角句號（.）、下劃線（_）和短劃線（-）。 參數(shù)值：當(dāng)已選擇參數(shù)名稱時，參數(shù)值為必填。僅支持英文字母大小寫、數(shù)字、半角句號（.）、下劃線（_）和短劃線（-），長度不超過256個字符。 說明 支持通過單擊+添加參數(shù)新增多個參數(shù)，單擊圖標(biāo)刪除多余參數(shù)，至多可添加30個參數(shù)。
        用戶名、密碼	登錄MySQL實例的用戶名和密碼。
        SSL加密	開啟后，需上傳Truststore證書并填寫Truststore證書密碼。

      說明

      當(dāng)配置方式選擇為主機并完成新建數(shù)據(jù)源后，若需要切換為JDBC URL配置方式，系統(tǒng)會將服務(wù)器的IP地址和端口號拼接為JDBC URL進(jìn)行填充。

   3. 配置數(shù)據(jù)源的高級設(shè)置。

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

   說明

   重復(fù)參數(shù)的取值規(guī)則：

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

   • 若某一參數(shù)同時存在于JDBC URL和高級設(shè)置的參數(shù)中時，則以JDBC URL中該參數(shù)的取值為準(zhǔn)。

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

5. 單擊測試連接，測試數(shù)據(jù)源是否可以和Dataphin進(jìn)行正常的連通。

   完成數(shù)據(jù)源的上述信息配置后，您可以單擊操作列的測試連接針對默認(rèn)集群或已經(jīng)在Dataphin注冊且正常使用的自定義集群進(jìn)行連接測試。默認(rèn)集群為系統(tǒng)默認(rèn)選中，不支持取消選中。自定義集群下不存在資源組時，不支持進(jìn)行連接測試，需先創(chuàng)建資源組后再進(jìn)行測試連接。

   • 所選集群只用于測試與當(dāng)前數(shù)據(jù)源的網(wǎng)絡(luò)連通，不用于后續(xù)相關(guān)任務(wù)的運行。

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

   • 無論測試結(jié)果為連接失敗、連接成功或成功有風(fēng)險，系統(tǒng)都將為您記錄最終結(jié)果的生成時間。

   • 測試結(jié)果為連接失敗時，您可以單擊圖標(biāo)查看具體失敗原因。

   • 測試結(jié)果為成功有風(fēng)險時，代表應(yīng)用集群連接成功、調(diào)度集群連接失敗，當(dāng)前數(shù)據(jù)源無法用于數(shù)據(jù)開發(fā)和集成。您可以單擊圖標(biāo)查看日志信息。

     說明

     僅默認(rèn)集群的測試結(jié)果包含成功有風(fēng)險、連接成功、連接失敗三種連接狀態(tài)；在Dataphin注冊的自定義集群的測試結(jié)果僅包含連接成功、連接失敗兩種連接狀態(tài)。

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

6. 測試成功后，單擊確定，完成MySQL數(shù)據(jù)源的創(chuàng)建。