本文介绍了基于 C/C++ 的 OceanBase 客户端开发组件：OceanBase Connector/C 和 MySQL 官方的客户端开发组件：MySQL C API 的使用说明和配置方法。

建议使用 OceanBase 客户端开发组件：OceanBase Connector/C。

连接 MySQL 租户也可以使用 MySQL 官方的客户端开发组件：MySQL C API。

使用说明

C APIs 包含在  mysqlclient 库文件当中，GCC 编译时使用  -I 选项指定头文件，  -L 指定库文件目录，  -l 指定库名。示例如下：

• OceanBase Connector/C

  gcc test.c -I/u01/obclient/include -L/u01/obclient/lib -lobclnt

• MySQL C API

  gcc test.c -I/usr/include/mysql/ -L/usr/lib64/mysql -lmysqlclient

注意

把库文件名开头的 lib 和结尾的  .so.xx去掉即为库名。

库名的查看方式如下：

[jayhart.xj@OceanBase008059.gtjsqa /usr] 
$ ls -l /usr/lib64/mysql/ |grep mysqlclient
lrwxrwxrwx 1 root root      17 Dec 13  2015 libmysqlclient_r.so -> libmysqlclient.so
lrwxrwxrwx 1 root root      20 Dec 13  2015 libmysqlclient.so -> libmysqlclient.so.18 
lrwxrwxrwx 1 root root      24 Dec 13  2015 libmysqlclient.so.18 -> libmysqlclient.so.18.0.0
-rwxrwxrwx 1 root root 3133560 Dec 13  2015 libmysqlclient_r.so.18.0.0

代码示例如下所示：

#include <mysql.h>
#include <stdio.h>
#include <string.h>
void main(void) {
    MYSQL conn;
    char server = "xxx.xxx.xxx.xxx";
    char user = "root@test#obtest";                                                //用户名@租户名#集群名称
    char password = "test";                                                        //密码
    char *database = "test";                                                       //数据库名
    char str_sqls;
    int status;
    int result;
    int i;
    conn = mysql_init(NULL); / Connect to database /
    / connect to server with the CLIENT_MULTI_STATEMENTS option /
    if (mysql_real_connect (conn, server, user, password,
            database, 3306, NULL, CLIENT_MULTI_STATEMENTS) == NULL)
    {
        printf("mysql_real_connect() failed\n");
        mysql_close(conn);
        exit(1);
    }
    / execute multiple statements /
    strcat(str_sqls, "DROP TABLE IF EXISTS test_table;");
    strcat(str_sqls, "CREATE TABLE test_table(id BIGINT);");
    strcat(str_sqls, "INSERT INTO test_table VALUES(10);");
    status = mysql_query(conn, str_sqls);
    if (status)
    {
        printf("Could not execute statement(s)");
        mysql_close(conn);
        exit(0);
    }
    mysql_close(conn);
}

更多信息

有关 OceanBase Connector/C 的详细介绍和使用方法，请参见  《 OceanBase Connector/C 》 。