---
title: "OceanBase Connector/C | OceanBase 文档中心"
description: OceanBase Connector/C 本文介绍了基于 C/C++ 的 OceanBase 客户端开发组件：OceanBase Connector/C 和 MySQL 官方的客户端开发组件：MySQL C API 的使用说明和配置方法。 建议使用 OceanBase 客户端开发组件：OceanBase Conne…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.0.0 社区版

# OceanBase Connector/C

更新时间：2026-05-23 08:53:11

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.0.0/zh-CN/500.administrator-guide/500.database-connection-and-routing/600.driver-management/400.oceanbase-connector-c.md)  

本文介绍了基于 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

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

  ```
 - MySQL C API

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

  ```

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

库名的查看方式如下：

```shell
[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

```

代码示例如下所示：

```javascript
#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 = "******";                                                        //密码
    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 》** 。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线