概述 | OceanBase 文档中心

概述

更新时间：2026-05-22 12:31:43

ECOB 支持的嵌入式 SQL 语句包含全部的标准 SQL 语句，并包含若干扩展 SQL 语句用于在宿主程序与 OBServer 节点之间传递数据。

在 ECOB 中使用嵌入式 SQL 语句的语法如下所示，需在语句前添加 EXEC SQL。

EXEC SQL <standard SQL statement>|<extension SQL statement>

其中标准 SQL 语句的语法可查看《OceanBase 数据库 SQL 语法》手册，详情请参见 SQL 语句。下表列举了当前 ECOB 支持的扩展 SQL 语句，本章节将分篇按类型介绍 ECOB 支持的扩展 SQL 语句与 ECOB 特有的 SQL 语句。

类型	语句	说明
建立连接	CONNECT	与数据库实例建立连接。
基础 SQL 语句	SELECT	执行查询语句并输出查询结果到外部宿主变量。
基础 SQL 语句	INSERT	执行插入语句。
基础 SQL 语句	UPDATE	执行更新语句，可以将外部数据变量的值更新到数据库的表列中，也可以选择只更新当前游标列。
基础 SQL 语句	DELETE	删除语句，可以将数据库中的一行或者多行删除，也可以选择只删除当前游标列。
基础 SQL 语句	COMMIT	提交一个事务语句，可以选择是否释放资源并关闭数据库连接。
基础 SQL 语句	ROLLBACK	回滚一个事务语句，可以选择是否释放资源并关闭数据库连接。
基础 SQL 语句	SAVEPOINT	用于设置一个事务保存点，事务结束后，所有保存点都自动释放。
预编译语句	PREPARE	PS 模式下预编译一个 SQL 语句。
预编译语句	EXECUTE	执行编译好的 SQL 语句。
存储过程	CALL	调用存储过程。
游标	DECLARE CURSOR	定义一个游标变量，当前游标变量只支持查询语句。
游标	OPEN	打开一个游标变量。
游标	FETCH	获取游标变量保存的结果集。
游标	CLOSE	关闭游标变量。
游标	ALLOCATE	分配游标变量。
简单动态 SQL	EXECUTE IMMEDIATE	执行动态的 SQL 字符串。
ANSI 动态 SQL	ALLOCATE DESCRIPTOR	分配 SQL 描述区。
ANSI 动态 SQL	DEALLOCATE DESCRIPTOR	释放 SQL 描述区。
ANSI 动态 SQL	DESCRIBE INPUT DESCRIPTOR	绑定变量信息。
ANSI 动态 SQL	DESCRIBE OUTPUT DESCRIPTOR	获取输出列的信息。
ANSI 动态 SQL	GET DESCRIPTOR	获取 SQL 描述区的 Item 信息。
ANSI 动态 SQL	SET DESCRIPTOR	设置 SQL 描述区的 Item 信息。
ANSI 动态 SQL	OPEN USING DESCRIPTOR	在 ANSI 动态 SQL 中打开游标变量。
ANSI 动态 SQL	FETCH INTO DESCRIPTOR	使用动态语句描述符获取游标变量保存的结果集。
Lob 相关 SQL	ALLOCATE	分配一个 LOB 定位器并将其初始化为空。
Lob 相关 SQL	DESCRIBE	获取 LOB 的属性信息。
Lob 相关 SQL	WRITE	将缓冲区的内容写入 LOB。
Lob 相关 SQL	READ	将 LOB 或 BFILE 的全部或部分读入缓冲区。
Lob 相关 SQL	VAR	执行宿主变量等效，或将特定的外部数据类型分配给单个主变量，覆盖默认数据类型分配。
Lob 相关 SQL	TYPE	执行用户定义的类型等效，或者通过将外部数据类型等同于用户定义的数据类型，将外部数据类型分配给整个主变量类。
Lob 相关 SQL	FREE	释放 ALLOCATE 语句保留的内存。