OceanBase的正確使用方法

OceanBase不是設計出來的，而是在使用過程當中不斷進化出來的。所以，系統使用以及運維的方便性相當重要。

OceanBase的使用者是業務系統開發人員，並交由專門的OceanBase 
DBA來運維。爲了方便業務使用，OceanBase實現了SQL接口且兼容MySQL協議，從而融入到MySQL開源生態圈。MySQL大部分管理工具，例如MySQL客戶端，MySQL admin，可以在OceanBase系統中直接使用。另外，OceanBase將系統運維、監控相關的內部信存放到內部的系統表中，從而方便運維、監控系統獲取。

OceanBase早期版本只容許經過Java或者C APl接口訪問，新版本增長了SQL支持，且兼容MySQL客戶端訪問協議。OceanBase推薦用戶使用SQL，但老應用仍然能夠使用之前的JavaAPI訪問OceanBase。下面介紹幾個訪問與使用場景。

MySQL客戶端鏈接

使用者採用MySQL客戶端鏈接OceanBase。經過MySQL客戶端能夠查看系統已有的表格、表格schema，執行select、update、insert、delete等SOL語句，查看系統內部狀態，以及發送OceanBase集羣運維命令。

【例】首先經過create table命令建立一張名稱爲test的表格，表格包含兩列：id和ame，其中id爲主鍵。接着，往表格中寫入兩行記錄（1，「alice」），（2，」tob」）。最後，經過select語句讀取這兩行數據。

JDBC訪問（JDBC template）

Java 應用經過標準JDBC訪問OceanBase，代碼以下所示：

ObGroupDataSource groupSource = new OBGroupDataSource();
groupSource.setUserName("user");//設置用戶名
groupSource.setPasswd("pass");//設置密碼
groupSource.setDbNane("test");// oceanBase不支持db，這裏能夠填任意值
groupSouorce.setConfigURL(ob_addr_url);//設置OceanBase集羣的地址
groupSource.init();//初始化data source
JdbcTemplate jtp = new JdbcTemplate();
jtp.setDatasource(groupsource);//設置 jdbc template依賴的data source
String sql = "select 1 from = dual";
int ret = jtp.queryForInt(sql);//執行SOL查詢

Spring集成

能夠經過將OceanBase DataSource集成到Spring中，配置以下：

<bean id = "groupDataSource" 
        class=」com.alipay.oceanbase,ObGroupDataSource」
        init-method="init">
    <property name="username" value="user" />
    <property name="passwd" value="pass" />
    <property name="dbName" value="test" />
    <property name="configURL" value_ob_addr_url />
</bean>

C 客戶端

C 應用經過OceanBase C客戶端訪間OceanBase，使用方式與MySQL C客戶端徹底一致，代碼以下：

MYSQL mysql;
mysql_init(&mysql); //初始化
Mysql_real_connect(&mysql, ob url, ob user, ob pass, NULL, 0, NULL, 0);  //鏈接OceanBase數據庫
Mysql_real_query(&mysq1, sq1, strlen(sql));  //執行SQL查詢
MYSQL_RES* res = mysql_store_reault(&mysql); //獲取SQL查詢結果集
//處理SQL查詢返回的結果集
while（MYSQL_ROW row = mysql_fetch_row(res); //從結果集讀取一行數據
//處理結果集中的一行結果
Mysql_free_result(res); //釋放結果集
Mysql_close(&mysql);  //關閉鏈接

總結

固然，應用可能會在客戶端維護OceanBase鏈接池，Java應用還可能會使用其餘持久層框架，例如iBatis。因爲OceanBase兼容JDBC和MySQL C客戶端，使用MySQL的應用無須修改代碼就能接入OceanBase。