OceanBase 如何創(chuàng)建連接

本教程介紹在 OceanBase 開(kāi)發(fā)者中心（OceanBase Developer Center，ODC）中創(chuàng)建數(shù)據(jù)庫(kù)連接的詳細(xì)步驟。

背景信息

ODC 作為為 OceanBase 數(shù)據(jù)庫(kù)量身打造的企業(yè)級(jí)數(shù)據(jù)庫(kù)開(kāi)發(fā)平臺(tái)可以與您的 OceanBase 數(shù)據(jù)庫(kù)建立連接，然后對(duì)其中的數(shù)據(jù)庫(kù)對(duì)象和資源進(jìn)行編輯和管理。當(dāng)您安裝客戶端版 ODC 或部署 Web 版 ODC 后，創(chuàng)建連接將是您要進(jìn)行的一步重要操作。ODC 支持連接專有云和公有云環(huán)境中的 OceanBase 數(shù)據(jù)庫(kù)，并支持連接 OceanBase MySQL 模式和 Oracle 模式。

前提條件

• 安裝客戶端版 ODC 或部署 Web 版 ODC。Web 版 ODC 的部署請(qǐng)聯(lián)系您的技術(shù)支持人員。
• 若您使用 Web 版 ODC，在部署后請(qǐng)登錄 ODC 以進(jìn)入連接管理頁(yè)面。詳情請(qǐng)參見(jiàn)登錄 ODC。
• 獲得連接實(shí)例的連接信息或連接串，本教程示例連接的連接串如下所示：

-h100.0.0.0 -P8080 -uodc@oracle_tenant#odc_cluster -Dodc -p'Password01'

操作步驟

1. 在 ODC 首頁(yè) 連接管理 頁(yè)簽中，單擊 新建連接 按鈕以彈出新建連接面板。
2. 選擇 所屬區(qū)域。所屬區(qū)域?yàn)楸贿B接的實(shí)例所在的區(qū)域，有以下兩種區(qū)域：
• 公有云：阿里云上的數(shù)據(jù)庫(kù)實(shí)例。 
• 獨(dú)立部署/專有云：在您自己的環(huán)境中搭建的數(shù)據(jù)庫(kù)實(shí)例。本教程的示例實(shí)例在專有云環(huán)境中，所以選擇專有云。
3. 選擇 連接模式。OceanBase 數(shù)據(jù)庫(kù)支持 MySQL 模式和 Oracle 模式，選擇被連接實(shí)例所屬的模式。本教程的示例實(shí)例屬于 Oracle 模式。所以選擇 Oracle。
4. 指定 連接名稱。連接名稱用來(lái)唯一標(biāo)識(shí)一個(gè)連接，您需要自定義一個(gè)名稱且不允許重復(fù)。本教程中指定名稱為 Connection_Tutorial。
5. 使用 智能解析 功能。若您擁有連接實(shí)例的連接串，可以直接將連接串粘貼進(jìn)智能解析功能的文本框中，單擊文本框中的 智能解析 按鈕后，ODC 會(huì)根據(jù)連接串自動(dòng)解析并填充 連接地址、默認(rèn)數(shù)據(jù)庫(kù)、數(shù)據(jù)庫(kù)用戶名 和 數(shù)據(jù)庫(kù)密碼 等信息。若您沒(méi)有連接串，也可跳過(guò)本步驟，從步驟 6 開(kāi)始手動(dòng)填寫上述信息。
6. 填寫 連接地址。連接地址包含以下信息：
• 主機(jī)名：連接實(shí)例所在服務(wù)器的 IP 信息。若您的實(shí)例在公有云上，可以在公有云控制臺(tái)的租戶信息頁(yè)面獲得主機(jī)名。本教程示例實(shí)例的 IP 信息為 100.0.0.0。
• 端口號(hào)：連接實(shí)例所在服務(wù)器的端口號(hào)信息。若您的實(shí)例在公有云上，可以在公有云控制臺(tái)的租戶信息頁(yè)面獲得端口號(hào)信息。本教程示例實(shí)例的端口號(hào)為 8080。
• 集群：連接實(shí)例所在集群的名稱。本教程示例實(shí)例的集群名稱為 odc_cluster。
• 租戶：連接實(shí)例所在租戶的名稱。本教程示例實(shí)例的集群名稱為 oracle_tenant。
7. 填寫 默認(rèn)數(shù)據(jù)庫(kù)。連接 MySQL 租戶中的數(shù)據(jù)庫(kù)時(shí)，可選填該連接要使用的默認(rèn)數(shù)據(jù)庫(kù)，連接 Oracle 租戶中的數(shù)據(jù)庫(kù)時(shí)則無(wú)需填寫該項(xiàng)。改項(xiàng)為選填項(xiàng)，不填寫時(shí)默認(rèn)連接到實(shí)例 information_schema。
8. 填寫 數(shù)據(jù)庫(kù)用戶名。數(shù)據(jù)庫(kù)用戶名是在租戶中創(chuàng)建的用戶的名稱，Oracle 模式下等同于填寫 Schema 的名稱，MySQL 模式下填寫的數(shù)據(jù)庫(kù)用戶名必須有訪問(wèn)默認(rèn)數(shù)據(jù)庫(kù)的權(quán)限。本教程示例實(shí)例的數(shù)據(jù)庫(kù)名稱為 odc。
9. 填寫 數(shù)據(jù)庫(kù)密碼。步驟 8 填寫的數(shù)據(jù)庫(kù)用戶對(duì)應(yīng)的密碼。本教程示例實(shí)例的數(shù)據(jù)庫(kù)名稱為 Password01。
10. 單擊 測(cè)試連接。單擊 數(shù)據(jù)庫(kù)密碼 項(xiàng)后提供的 測(cè)試連接 按鈕，查看 ODC 是否可以根據(jù)上述連接信息成功連接到目標(biāo)實(shí)例。連接成功與否不影響連接信息的保存。
11. 指定 SQL 查詢超時(shí)時(shí)間，在 高級(jí)配置 中可以配置該項(xiàng)。ODC 支持自定義 SQL 超時(shí)時(shí)間，默認(rèn) 60s，超過(guò)指定的時(shí)間時(shí)查詢自動(dòng)終止。ODC V2.3.2 后事務(wù)默認(rèn)需要手動(dòng)提交（之前版本默認(rèn)自動(dòng)提交），在手動(dòng)提交模式下需要設(shè)置變量 ob_trx_idle_timeout 大于等于設(shè)置的 SQL 查詢超時(shí)時(shí)間，否則一個(gè)事務(wù)內(nèi)兩個(gè) SQL 之間的執(zhí)行間隔超過(guò) ob_trx_idle_timeout 設(shè)置的時(shí)間，連接會(huì)被終止。同時(shí)需要注意 ob_trx_idle_timeout 設(shè)置過(guò)大會(huì)導(dǎo)致該會(huì)話占用內(nèi)存無(wú)法及時(shí)釋放，需謹(jǐn)慎設(shè)置。
12. 指定 查詢 sys 租戶視圖，在 高級(jí)配置 中可以配置該項(xiàng)。在該項(xiàng)中可以指定擁有 sys 租戶視圖查看權(quán)限的賬號(hào)和對(duì)應(yīng)的密碼。ODC V2.3.0 后使用數(shù)據(jù)導(dǎo)入導(dǎo)出功能和查看分區(qū)信息功能時(shí)需要在此項(xiàng)配置 root@sys 賬號(hào)，即 sys 租戶下的 root 賬號(hào)。 本教程示例實(shí)例的 root@sys 賬號(hào)的密碼為默認(rèn)空密碼，所以只在 賬戶 項(xiàng)填寫 root 即可。填寫完成后可單擊該項(xiàng)下的 測(cè)試連接 按鈕測(cè)試 root@sys 賬號(hào)是否可以成功連接。
13. 單擊 保存 以保存連接信息。填寫和配置完上述所有的連接信息后，單擊右下角的 保存 按鈕，可以將當(dāng)前 新建連接 頁(yè)面中填寫的連接信息保存并顯示在 ODC 的首頁(yè) 連接管理 頁(yè)簽中。您下次可直接在 連接管理 頁(yè)簽中找到目標(biāo)連接并進(jìn)入連接實(shí)例。