本文为您介绍如何使用HoloWeb新建、编辑、删除、复制及重命名SQL查询。SQL窗口适用于做交互式的短查询,不适合用于大数据量的导入导出等离线作业场景,不支持执行超过60分钟的SQL。
新建SQL查询
- 登录Hologres管理控制台。
- 在顶部菜单栏左侧,选择相应的地域。

- 单击前往HoloWeb,进入HoloWeb开发页面。
- 在HoloWeb开发页面的顶部菜单栏,单击,单击确认。
您也可以在左侧导航栏,鼠标右击我的SQL查询,选择新建SQL查询。
在
新建SQL查询对话框,配置各项参数,系统默认会自动填充当前的实例名和数据库名。

参数描述如下表所示。
参数 |
描述 |
作业名称 |
新建的SQL查询名称。 |
目录 |
新建SQL查询存放的位置。默认目录为我的SQL查询,您也可以选择存放在已创建的文件夹中。
|
实例名 |
您可以从当前已存在实例的下拉列表中选择目标实例名称。
说明 当前实例列表会展示已登录和未登录实例名称。当您选择的为未登录实例时,您可以在执行完SQL语句并保存后,登录该实例即可在列表中看到新增的内容。
|
数据库名称 |
Hologres当前实例下的数据库名称。 |
- 新增生成的SQL会展示在左侧我的SQL查询列表中。您可以在页面的表目录列表中选择目标表,查看对应表的字段名和类型。您也可以在SQL编辑区域使用标准的PostgreSQL语言进行开发。
说明 SQL查询对表名称和字段名称的大小写不敏感。如果您需要精确查询名称大小写完全一致的表,则需要使用双引号将该表名称引起来。

- (可选)设置时区。
说明 如果在当前查询页面设置了时区且针对HoloWeb设置了全局时区,当前查询页面设置的时区优先级高。
- 单击运行,执行输入的SQL语句。
说明 HoloWeb支持SQL运行最长60分钟,超过60分钟,会有超时提示:cancel query due to timeout, queryTimeout setting
is: 3600s
- 单击保存,保存当前SQL查询窗口的相关内容。
表目录
在您完成新建SQL查询和编辑SQL查询之后,您可以查看表目录,方便您查看和了解表内部的结构。
- 在HoloWeb开发页面的顶部菜单栏,单击,单击确认。
您也可以在
我的SQL查询中打开目标
SQL查询。

- 您可以在页面的表目录列表查看所有的内部表。选择目标表,查看对应表的字段名和类型。
您也可以在SQL编辑区域使用标准的PostgreSQL语言进行开发。例如,您可以在SQL编辑区域运行新增表语句,并单击

图标,在表目录下方可以展示表结构。
说明 SQL查询对表名称和字段名称的大小写不敏感。如果您需要精确查询名称大小写完全一致的表,则需要使用双引号将该表名称引起来。
编辑SQL查询
- 在左侧导航栏,单击我的SQL查询,查找目标SQL查询。
如果目标SQL查询存放于文件夹中,您可以在
Query查询下方的搜索框输入目标SQL查询名称。

- 鼠标双击目标SQL查询,可以编辑SQL查询。
- 您可以在SQL编辑框输入需要执行的SQL语句,单击运行。
示例SQL语句如下。
CREATE TABLE test (
"id" bigint NOT NULL,
"name" text NOT NULL,
"age" bigint,
"class" text NOT NULL,
PRIMARY KEY (id)
);
- 单击保存。保存成功后,当前SQL查询会保存所有输入的SQL语句。
删除SQL查询
- 在左侧导航栏,单击我的SQL查询,查找目标SQL查询。
如果目标SQL查询存放于文件夹中,您可以在
Query查询下方的搜索框输入目标SQL查询名称。

- 鼠标右击目标SQL查询,单击删除SQL查询。
- 单击确认。
复制SQL查询
- 在左侧导航栏,单击我的SQL查询,查找目标SQL查询。
如果目标SQL查询存放于文件夹中,您可以在
Query查询下方的搜索框输入目标SQL查询名称。

- 鼠标右击目标SQL查询,单击复制SQL查询。
该操作仅复制当前SQL查询中的SQL语句。
- 您可以将复制的SQL语句粘贴至其他SQL查询窗口使用。
重命名SQL查询
- 在左侧导航栏,单击我的SQL查询,查找目标SQL查询。
如果目标SQL查询存放于文件夹中,您可以在
Query查询下方的搜索框输入目标SQL查询名称。

- 鼠标右击目标SQL查询,单击重命名。
- 您可以根据业务需求,配置重命名名称。
- 单击确认。