---
title: Multi-Query 与 COM_SET_OPTION-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于Multi-Query 与 COM_SET_OPTION相关的常见问题和使用技巧，帮助您快速解决Multi-Query 与 COM_SET_OPTION的难题。
---
切换语言

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

划线反馈

# Multi-Query 与 COM_SET_OPTION

更新时间：2026-06-03 03:01

适用版本： V4.2.x、V4.3.x 内容类型：TechNote  

从 OceanBase 数据库 V4.2.2 版本、OBProxy V4.2.3 版本开始，OceanBase 数据库支持 `MYSQL_SET_OPTION` 协议命令来控制 `Multi-Query` 功能的开启与关闭。

## 详细说明

### Multi-Query

`Multi-Query` 功能允许客户端在一个请求中发送多个 SQL 语句，通过分号(;)分隔。这有助于减少客户端与服务器之间的通信次数，提高批量操作的效率。 在 OceanBase 数据库中，要启用 `Multi-Query` 功能，通常需要在 JDBC URL 中设置以下参数：

- **rewriteBatchedStatements=true：** 启用批量执行的关键参数，确保多个 SQL 语句能够被组合在一起发送。
 - **allowMultiQueries=true：** 允许在一条语句中使用分号（;）分割多个请求。

对于批量 INSERT 执行，在 `rewriteBatchedStatements=true` 时，无论是否设置 `allowMutiQueries=true`，JDBC 都会尝试调用 `executeBatchedInserts` 方法，将多条 INSERT 语句拼接为 `INSERT ... VALUES (),(),()...` 的形式。但是，如果每条 INSERT 语句的格式不完全相同，则无法拼接为一个 INSERT 带多个 VALUE 的语句，这时 JDBC 会尝试使用 `executePreparedBatchAsMultiStatement` 方法，即使用分号（;）拼接多条语句，而这就需要使用 `Multi-Query` 功能。

### COM_SET_OPTION

在 MySQL 数据库中，有一个称为 `COM_SET_OPTION` 的客户端/服务器通信协议命令，用于在客户端和服务器之间设置特定选项。

### C API

`MYSQL_SET_OPTION` 是 MySQL C API 的一部分，基于 `COM_SET_OPTION` 协议通过 `mysql_options()` 函数设置连接选项，其作用是在连接数据库前配置额外选项，比如开启 `Multi-Query` 功能。

C 程序的示例：

```shell
#include <mysql.h>
#include <stdio.h>

int main() {
    MYSQL *conn;
    MYSQL_RES *res;
    MYSQL_ROW row;

    // 初始化连接句柄
    conn = mysql_init(NULL);

    // 启用 multi-statements
    mysql_options(conn, MYSQL_OPT_MULTI_STATEMENTS_ON, NULL);

    // 连接到数据库（
    mysql_real_connect(conn, "localhost", "root", "your_password", "test", 0, NULL, 0);

    // 执行多语句 SQL（
    mysql_query(conn, "SELECT 'Hello' AS msg; SELECT 'World' AS msg;");

    mysql_close(conn);
    return 0;
}

```

### JDBC

虽然 JDBC 没有暴露 `COM_SET_OPTION` 这个命令的接口，但 MySQL 的 JDBC 驱动内部确实会使用 `COM_SET_OPTION` 协议命令来启用某些功能。比如，当 JDBC 连接字符串中设置 `allowMultiQueries=true` 时，在连接时 JDBC 内部会通过 `COM_SET_OPTION` 启用 `CLIENT_MULTI_STATEMENTS` 标志，从而允许执行 `Multi-Query` 语句。

JDBC 示例：

```shell
jdbc:mysql://x.x.x.x:port/dbname?rewriteBatchedStatements=true&allowMultiQueries=true

```

MySQL JDBC 内部调用 COM_SET_OPTION：

![image](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/connection/20250728multi-query-and-com-set-option.png)

### OceanBase 支持 COM_SET_OPTION 协议

如果初始连接未开启 `Multi-Query` 功能，而在后面使用 Batch 接口时，OceanBase JDBC 的早期版本以及社区版本均会通过 `COM_SET_OPTION` 命令开启 `Multi-Query` 状态。如果 OceanBase 数据库版本不兼容 `COM_SET_OPTION` 通信协议，则会出现问题。

**示例：** 客户使用 DataWorks 向 OceanBase 数据库导入数据，初始连接串中配置 `rewriteBatchedStatements=true` 和 `allowMutiQueries=false`，且设置了 BatchSize 来进行批量插入。但在使用时发现 Batch Insert 会被降级为单条记录的插入，而且有以下报错信息。

```shell
2022-12-02 16:05:15,534 [http-nio-8096-exec-6] WARN  c.z.h.p.ProxyConnection:157 - HikariPool-1 - Connection com.mysql.cj.jdbc.ConnectionImpl@1df265f6 marked as broken because of SQLSTATE(0A000), ErrorCode(1235)
java.sql.SQLException: Not supported feature or function
    at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:129)
    at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:97)
    at com.mysql.cj.jdbc.exceptions.SQLExceptionsMapping.translateException(SQLExceptionsMapping.java:122)
    at com.mysql.cj.jdbc.ClientPreparedStatement.executePreparedBatchAsMultiStatement(ClientPreparedStatement.java:603)
    at com.mysql.cj.jdbc.ClientPreparedStatement.executeBatchInternal(ClientPreparedStatement.java:431)
    at com.mysql.cj.jdbc.StatementImpl.executeBatch(StatementImpl.java:796)
    at com.zaxxer.hikari.pool.ProxyStatement.executeBatch(ProxyStatement.java:128)
    at com.zaxxer.hikari.pool.HikariProxyPreparedStatement.executeBatch(HikariProxyPreparedStatement.java)
    at sun.reflect.GeneratedMethodAccessor673.invoke(Unknown Source)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.lang.reflect.Method.invoke(Method.java:498)
    at org.apache.ibatis.logging.jdbc.PreparedStatementLogger.invoke(PreparedStatementLogger.java:78)
    at com.sun.proxy.$Proxy317.executeBatch(Unknown Source)
    at com.baomidou.mybatisplus.core.executor.MybatisBatchExecutor.doFlushStatements(MybatisBatchExecutor.java:133)
    at org.apache.ibatis.executor.BaseExecutor.flushStatements(BaseExecutor.java:129)
    at org.apache.ibatis.executor.BaseExecutor.flushStatements(BaseExecutor.java:122)
    at com.baomidou.mybatisplus.core.executor.MybatisCachingExecutor.flushStatements(MybatisCachingExecutor.java:216)

```

这个报错显示 JDBC 使用 `executePreparedBatchAsMultiStatement` 方法执行 `Multi-Query`，但数据库不支持该功能。为了解决这个问题，OceanBase 数据库从 V4.2.2 版本、OBProxy 从 V4.2.3 版本开始支持 `COM_SET_OPTION` 协议，目前仅支持设置 `Multi-Query` 功能开关。

| Option | Description |
| --- | --- |
| MYSQL_OPTION_MULTI_STATEMENTS_ON | Enable multiple-statement support |
| MYSQL_OPTION_MULTI_STATEMENTS_OFF | Disable multiple-statement support |

## 适用版本

- OceanBase 数据库 V4.2.2 GA（oceanbase-4.2.2.0-100000082024011317）及之后版本。
 - OBProxy V4.2.3 及之后版本。

上一篇

[MySQL 命令行工具里 default-character-set 参数在 V2.x、V3.x 不生效的原因与解决方法](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000927584)

下一篇

[OceanBase 数据库中使用 Service Name 服务名来实现周末测试的需求场景](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000001687221) ![有帮助](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) 咨询热线