創(chuàng)建Oracle數(shù)據(jù)源
通過(guò)創(chuàng)建Oracle數(shù)據(jù)源能夠?qū)崿F(xiàn)Dataphin讀取Oracle的業(yè)務(wù)數(shù)據(jù)或向Oracle寫(xiě)入數(shù)據(jù)。本文為您介紹如何創(chuàng)建Oracle數(shù)據(jù)源。
背景信息
Oracle是一款可移植好、可靠性好、適應(yīng)高、功能強(qiáng)大的關(guān)系型數(shù)據(jù)庫(kù)。如果您使用的是Oracle，在對(duì)接Dataphin進(jìn)行數(shù)據(jù)開(kāi)發(fā)時(shí)，您需要先完成Oracle數(shù)據(jù)源的創(chuàng)建。更多Oracle信息，請(qǐng)參見(jiàn)Oracle官網(wǎng)。
權(quán)限說(shuō)明
僅支持具備新建數(shù)據(jù)源權(quán)限點(diǎn)的自定義全局角色和超級(jí)管理員、數(shù)據(jù)源管理員、板塊架構(gòu)師、項(xiàng)目管理員角色創(chuàng)建數(shù)據(jù)源。
操作步驟
在Dataphin首頁(yè)的頂部菜單欄中，選擇管理中心 > 數(shù)據(jù)源管理。
在數(shù)據(jù)源頁(yè)面，單擊+新建數(shù)據(jù)源。
在新建數(shù)據(jù)源對(duì)話(huà)框的關(guān)系型數(shù)據(jù)庫(kù)區(qū)域，選擇Oracle。
如果您最近使用過(guò)Oracle，也可以在最近使用區(qū)域選擇Oracle。同時(shí)，您也可以在搜索框中，輸入Oracle的關(guān)鍵詞，快速搜索。
在新建Oracle數(shù)據(jù)源對(duì)話(huà)框中，配置連接數(shù)據(jù)源參數(shù)。
配置數(shù)據(jù)源的基本信息。
參數(shù)
說(shuō)明
數(shù)據(jù)源名稱(chēng)
填寫(xiě)數(shù)據(jù)源的名稱(chēng)。命名規(guī)則如下：
只能包含中文、英文字母大小寫(xiě)、數(shù)字、下劃線(xiàn)（_）或短劃線(xiàn)（-）。
長(zhǎng)度不能超過(guò)64個(gè)字符。
數(shù)據(jù)源編碼
配置數(shù)據(jù)源編碼后，您可以在Flink_SQL任務(wù)或使用Dataphin JDBC客戶(hù)端中，通過(guò)
數(shù)據(jù)源編碼.表名稱(chēng)或數(shù)據(jù)源編碼.schema.表名稱(chēng)的格式直接訪問(wèn)Dataphin數(shù)據(jù)源表，實(shí)現(xiàn)快捷消費(fèi)；如果需要根據(jù)任務(wù)執(zhí)行環(huán)境自動(dòng)切換數(shù)據(jù)源，請(qǐng)通過(guò)${數(shù)據(jù)源編碼}.table或${數(shù)據(jù)源編碼}.schema.table的變量格式訪問(wèn)。更多信息，請(qǐng)參見(jiàn)Flink_SQL任務(wù)開(kāi)發(fā)方式。重要數(shù)據(jù)源編碼配置成功后不支持修改。
版本
選擇需要新建的Oracle數(shù)據(jù)源版本。版本支持Oracle11g、Oracle12c、Oracle18c、Oracle19c、Oracle21c、Oracle23c。
數(shù)據(jù)源描述
對(duì)數(shù)據(jù)源的簡(jiǎn)單描述。不得超過(guò)128個(gè)字符。
數(shù)據(jù)源配置
選擇需要配置的數(shù)據(jù)源：
如果業(yè)務(wù)數(shù)據(jù)源區(qū)分生產(chǎn)數(shù)據(jù)源和開(kāi)發(fā)數(shù)據(jù)源，則選擇生產(chǎn)+開(kāi)發(fā)數(shù)據(jù)源。
如果業(yè)務(wù)數(shù)據(jù)源不區(qū)分生產(chǎn)數(shù)據(jù)源和開(kāi)發(fā)數(shù)據(jù)源，則選擇生產(chǎn)數(shù)據(jù)源。
標(biāo)簽
您可根據(jù)標(biāo)簽給數(shù)據(jù)源進(jìn)行分類(lèi)打標(biāo)，如何創(chuàng)建標(biāo)簽，請(qǐng)參見(jiàn)管理數(shù)據(jù)源標(biāo)簽。
配置數(shù)據(jù)源與Dataphin的連接參數(shù)。
若您的數(shù)據(jù)源配置選擇生產(chǎn)+開(kāi)發(fā)數(shù)據(jù)源，則需配置生產(chǎn)+開(kāi)發(fā)數(shù)據(jù)源的連接信息。如果您的數(shù)據(jù)源配置為生產(chǎn)數(shù)據(jù)源，僅需配置生產(chǎn)數(shù)據(jù)源的連接信息。
說(shuō)明通常情況下，生產(chǎn)數(shù)據(jù)源和開(kāi)發(fā)數(shù)據(jù)源需配置為非同一個(gè)數(shù)據(jù)源，以實(shí)現(xiàn)開(kāi)發(fā)數(shù)據(jù)源與生產(chǎn)數(shù)據(jù)源的環(huán)境隔離，降低開(kāi)發(fā)數(shù)據(jù)源對(duì)生產(chǎn)數(shù)據(jù)源的影響。但Dataphin也支持配置成同一個(gè)數(shù)據(jù)源，即相同參數(shù)值。
配置方式可選擇JDBC URL或主機(jī)兩種方式，默認(rèn)選擇為JDBC URL。
JDBC URL配置方式
參數(shù)
說(shuō)明
JDBC URL
鏈接地址的格式為
jdbc:oracle:thin:@//host:port/dbname。例如，jdbc:oracle:thin:@//192.168.*.1:1521/dataphin。Schema
即Oracle實(shí)例下的數(shù)據(jù)庫(kù)名稱(chēng)。
用戶(hù)名、密碼
登錄Oracle實(shí)例的用戶(hù)名和密碼。
類(lèi)型
支持公網(wǎng)數(shù)據(jù)庫(kù)與ECS(VPC)自建數(shù)據(jù)庫(kù)，您可根據(jù)您數(shù)據(jù)庫(kù)類(lèi)型及業(yè)務(wù)情況進(jìn)行選擇與配置：
公網(wǎng)數(shù)據(jù)庫(kù)：通過(guò)公網(wǎng)可直接訪問(wèn)的數(shù)據(jù)庫(kù)。
ECS(VPC)自建數(shù)據(jù)庫(kù)：您在阿里云ECS上自建的數(shù)據(jù)庫(kù)。支持VPC方式訪問(wèn)。VPC網(wǎng)絡(luò)訪問(wèn)數(shù)據(jù)庫(kù)需配置以下信息：
區(qū)域：據(jù)庫(kù)所在Region。僅支持Dataphin實(shí)例相同區(qū)域的數(shù)據(jù)庫(kù)。如您的Dataphin實(shí)例為華東2（上海），僅支持選擇華東2（上海）區(qū)域。
VPC ID：填寫(xiě)ECS所在VPC網(wǎng)絡(luò)的VPC ID。您可登錄專(zhuān)有網(wǎng)絡(luò)控制臺(tái)進(jìn)行查看。如下圖所示：
ECS ID：填寫(xiě)部署數(shù)據(jù)庫(kù)的ECS服務(wù)器的ECS ID。您可登錄ECS控制臺(tái)進(jìn)行查看。如下圖所示：
主機(jī)配置方式
主機(jī)配置方式
參數(shù)
描述
服務(wù)器地址
輸入服務(wù)器的IP地址和端口號(hào)，僅能添加一組。
服務(wù)類(lèi)型
可選擇服務(wù)名或SID（System Identifier）。
dbname
輸入數(shù)據(jù)庫(kù)名稱(chēng)。
參數(shù)配置
參數(shù)
描述
參數(shù)
參數(shù)名稱(chēng)：僅支持選擇已有參數(shù)名稱(chēng)。
參數(shù)值：當(dāng)已選擇參數(shù)名稱(chēng)時(shí)，參數(shù)值為必填。僅支持英文字母大小寫(xiě)、數(shù)字、半角句號(hào)（.）、下劃線(xiàn)（_）和短劃線(xiàn)（-），長(zhǎng)度不超過(guò)256個(gè)字符。
說(shuō)明支持通過(guò)單擊+添加參數(shù)新增多個(gè)參數(shù)，單擊
圖標(biāo)刪除多余參數(shù)，至多可添加30個(gè)參數(shù)。Schema（非必填）
如果僅用于實(shí)時(shí)整庫(kù)遷移則無(wú)需填寫(xiě)Schema，如果用于離線(xiàn)集成或?qū)崟r(shí)計(jì)算則需填寫(xiě)Schema（Schema信息區(qū)分大小寫(xiě)）。
用戶(hù)名、密碼
登錄Oracle實(shí)例的用戶(hù)名和密碼。
說(shuō)明當(dāng)配置方式選擇為主機(jī)并完成新建數(shù)據(jù)源后，若需要切換為JDBC URL配置方式，系統(tǒng)會(huì)將服務(wù)器的IP地址和端口號(hào)拼接為JDBC URL進(jìn)行填充。
配置數(shù)據(jù)源與Dataphin的高級(jí)設(shè)置。
參數(shù)
說(shuō)明
連接重試次數(shù)
數(shù)據(jù)庫(kù)連接超時(shí)，將自動(dòng)重試連接直到完成設(shè)定的重試次數(shù)。若達(dá)到最大重試次數(shù)仍未連接成功，則連接失敗。
說(shuō)明默認(rèn)重試次數(shù)為1次，支持配置0～10之間參數(shù)。
連接重試次數(shù)將默認(rèn)應(yīng)用于離線(xiàn)集成任務(wù)與全域質(zhì)量（需開(kāi)通資產(chǎn)質(zhì)量功能模塊），離線(xiàn)集成任務(wù)中支持單獨(dú)配置任務(wù)級(jí)別的重試次數(shù)。
說(shuō)明重復(fù)參數(shù)的取值規(guī)則：
若某一參數(shù)同時(shí)存在于JDBC URL、高級(jí)設(shè)置的參數(shù)和主機(jī)配置方式的參數(shù)配置中時(shí)，則以JDBC URL中該參數(shù)的取值為準(zhǔn)。
若某一參數(shù)同時(shí)存在于JDBC URL和高級(jí)設(shè)置的參數(shù)中時(shí)，則以JDBC URL中該參數(shù)的取值為準(zhǔn)。
若某一參數(shù)同時(shí)存在于高級(jí)設(shè)置的參數(shù)和主機(jī)配置方式的參數(shù)配置中時(shí)，則以高級(jí)設(shè)置的參數(shù)配置中該參數(shù)的取值為準(zhǔn)。
單擊測(cè)試連接，測(cè)試數(shù)據(jù)源是否可以和Dataphin正常連通。
完成數(shù)據(jù)源的上述信息配置后，您可以單擊操作列的測(cè)試連接針對(duì)公共調(diào)度集群或已經(jīng)在Dataphin注冊(cè)且正常使用的自定義集群進(jìn)行連接測(cè)試。公共調(diào)度集群為系統(tǒng)默認(rèn)選中，不支持取消選中。自定義集群下不存在資源組時(shí)，不支持進(jìn)行連接測(cè)試，需先創(chuàng)建資源組后再進(jìn)行測(cè)試連接。
所選集群只用于測(cè)試與當(dāng)前數(shù)據(jù)源的網(wǎng)絡(luò)連通，不用于后續(xù)相關(guān)任務(wù)的運(yùn)行。
測(cè)試連接時(shí)長(zhǎng)通常在2分鐘內(nèi)，若超時(shí)，您可以單擊
圖標(biāo)查看具體原因并重試。無(wú)論測(cè)試結(jié)果為連接失敗、連接成功或成功有風(fēng)險(xiǎn)，系統(tǒng)都將為您記錄最終結(jié)果的生成時(shí)間。
測(cè)試結(jié)果為連接失敗時(shí)，您可以單擊
圖標(biāo)查看具體失敗原因。測(cè)試結(jié)果為成功有風(fēng)險(xiǎn)時(shí)，代表應(yīng)用集群連接成功、調(diào)度集群連接失敗，當(dāng)前數(shù)據(jù)源無(wú)法用于數(shù)據(jù)開(kāi)發(fā)和集成。您可以單擊
圖標(biāo)查看日志信息。說(shuō)明僅公共調(diào)度集群的測(cè)試結(jié)果包含成功有風(fēng)險(xiǎn)、連接成功、連接失敗三種連接狀態(tài)；在Dataphin注冊(cè)的自定義集群的測(cè)試結(jié)果僅包含連接成功、連接失敗兩種連接狀態(tài)。
請(qǐng)確保至少存在一個(gè)集群可以與數(shù)據(jù)源連通，否則不支持保存數(shù)據(jù)源信息。
重要如果連接測(cè)試失敗，您可以根據(jù)網(wǎng)絡(luò)連通常見(jiàn)問(wèn)題進(jìn)行排查。詳細(xì)內(nèi)容，請(qǐng)參見(jiàn)網(wǎng)絡(luò)連通解決方案。
測(cè)試成功后，單擊確定，完成Oracle數(shù)據(jù)源的創(chuàng)建。