本文将通过一个实例演示如何在控制台使用预处理查询,具体的语法和详细介绍请参见预处理查询 PREPARED STATEMENT。
前置条件
在使用之前,请确认使用的集群引擎版本已升级到 2.5 或以上。
使用示例
我们以系统表 system.numbers
表为例,演示如何创建一个预处理查询、快速执行一些查询命令,以及删除预处理查询。
创建预处理查询
- 访问 ByteHouse控制台-数据查询 窗口,输入创建预处理查询的命令。
- 将“自动分配节点”,改为“全部节点”。
- 勾选"所有查询",点击运行。
- 系统返回“执行成功”则表示预处理查询创建完成。刷新左侧“数据对象”列表,可以在“预处理查询”中看到创建已完成。
- 鼠标光标指向该预处理查询,可以预览其SQL语句内容。
执行预处理查询
- 在 数据查询 创建新窗口,输入执行预处理查询的命令。我们以“
EXECUTE PREPARED STATEMENT prep USING i = 5;
”为例,输入查询框。 - 勾选“全部节点”、“所有查询”后,点击运行。
- 可以看到系统完成了查询操作。此操作相当于系统执行了以下语句。
SELECT count()
FROM (SELECT number FROM system.numbers LIMIT 10)
WHERE number < 5;
管理预处理查询
- 访问 ByteHouse 控制台“数据管理”页面,在左侧列表中可以查看到所有的预处理查询列表。
- 点击某一条预处理查询,可以在右侧查看对应的SQL语句。
- 点击“去查询”,可以立即跳转到查询窗口页面,并自动填充了查询语句。补充语句
USING
后的部分,可以快速使用预处理查询功能。注意,查询时仍需勾选“全部节点”。
- 在数据管理的预处理查询管理页面,我们也可以点击折叠按钮,来完成“删除”和“克隆”。
删除预处理查询
我们可以通过SQL语句或在控制台管理页面删除预处理查询。
控制台删除
- 访问 ByteHouse 控制台“数据管理”页面,在左侧列表中点击某一条预处理查询进入详情页面。
- 点击折叠按钮,选择“删除”。
- 系统会进行二次确认。如果确认删除操作,请点击“确定”。
- 系统会返回删除成功提示,表示操作执行成功。
SQL 语句删除
- 在 数据查询 创建新窗口,输入删除预处理查询的命令。如“
DROP PREPARED STATEMENT prep
”。 - 勾选“全部节点”、“所有查询”后,点击运行。
- 系统返回"执行成功"则表示操作完成。