大网数据广告活动
数据库部署与 SQL 参考

预准备语句

· 52CE 我爱测

自 3.2 版本起,StarRocks 提供预准备语句(prepared statement),用于多次执行结构相同、仅部分变量不同的 SQL 语句,能显著提升执行效率,并且还能防止 SQL 注入。

预准备语句

自 3.2 版本起,StarRocks 提供预准备语句(prepared statement),用于多次执行结构相同、仅部分变量不同的 SQL 语句,能显著提升执行效率,并且还能防止 SQL 注入。

功能

工作流程

  1. 预准备:准备 SQL 语句。语句中的变量用占位符 ? 表示。FE 解析语句并生成执行计划。
  2. 执行:声明变量后,将变量传递至语句中并执行语句。并且可以使用不同的变量多次执行该语句。

优势

  • 节省解析 SQL 语句的开销。业务中应用程序通常会使用不同变量多次执行结构相同的语句。使用预准备语句后,StarRocks 只需要在预准备阶段解析一次语句,后续多次执行相同语句(变量不同)时直接使用解析结果,因此能显著提高语句(特别是复杂语句)执行性能。
  • 防止 SQL 注入攻击。分离了语句和变量,将用户输入的数据作为参数进行传递,而不是将其直接拼接到语句中。这样可以防止恶意用户利用输入来执行恶意的 SQL 代码。

使用说明

预准备语句仅在当前会话中生效,不适用于其他会话。当前会话退出后,所创建预准备语句会自动删除。

语法

预准备语句如下:

  • PREPARE:准备 SQL 语句,语句中变量用占位符 ? 表示。
  • SET:声明语句中的变量。
  • EXECUTE:传递已声明的变量并执行语句。
  • DROP PREPARE 或 DEALLOCATE PREPARE:删除预准备语句。

PREPARE

语法:

PREPARE <stmt_name> FROM <preparable_stmt>

参数说明:

  • stmt_name:为预准备语句赋予一个名称,以便后续执行和删除语句时引用。该名称在单个会话内必须是唯一的。
  • preparable_stmt:需要进行预准备的 SQL 语句。注意,目前仅支持 SELECT 语句。其中的变量占位符为英文半角问号 (?)。

示例:

准备一个 SELECT 语句,其中变量用 ? 占位。并为该语句赋予一个名称 select_by_id_stmt。

PREPARE select_by_id_stmt FROM 'SELECT * FROM users WHERE id = ?';

SET

语法:

SET @var_name = expr [, ...];

参数说明:

  • var_name:自定义变量名称。
  • expr:自定义变量。

示例:

声明变量。

SET @id1 = 1, @id2 = 2;

详细信息,请参见用户自定义变量。

EXECUTE

语法:

EXECUTE <stmt_name> [USING @var_name [, @var_name] ...]

参数说明:

  • var_name:在 SET 语句中已声明的变量名称。
  • stmt_name:预准备语句名称。

示例:

传递变量并执行 SELECT 语句。

EXECUTE select_by_id_stmt USING @id1;

DEALLOCATE PREPARE 或 DROP PREPARE

{DEALLOCATE | DROP} PREPARE <stmt_name>

参数说明:

stmt_name:预准备语句名称。

示例:

删除一个预准备语句。

DROP PREPARE select_by_id_stmt;

示例

使用预准备语句

本示例介绍如何使用预准备语句增删改查 StarRocks 表的数据。

假设已经创建如下数据库 demo 和表 users。

CREATE DATABASE IF NOT EXISTS demo;
USE demo;
create table users (
  id bigint not null,
  country string,
  city string,
  revenue bigint
)
primary key (id)
distributed by hash(id);
  1. 准备语句以供执行。

    PREPARE select_all_stmt FROM 'SELECT * FROM users';
    PREPARE select_by_id_stmt FROM 'SELECT * FROM users WHERE id = ?';
    
  2. 声明语句中的变量。

    SET @id1 = 1, @id2 = 2;
    
  3. 使用已声明的变量来执行语句。

    -- 查询表中所有数据
    EXECUTE select_all_stmt;
    
    -- 分别查询 ID 为 1 和 2 的数据
    EXECUTE select_by_id_stmt USING @id1;
    EXECUTE select_by_id_stmt USING @id2;
    
  4. 删除预准备语句。

    DROP PREPARE select_all_stmt;
    DROP PREPARE select_by_id_stmt;
    

JAVA 应用程序使用预准备语句

本示例介绍 JAVA 应用程序如何通过 JDBC 驱动使用预准备语句增删改查 StarRocks 表的数据。

  1. 在 JDBC URL 中配置 StarRocks 的连接地址时,需要启用服务端预准备语句。

    jdbc:mysql://<fe_ip>:<fe_query_port>/useServerPrepStmts=true
    
  2. StarRocks Github 项目中提供 JAVA 代码示例,说明如何增删改查 StarRocks 表的数据。

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。