如何使用HoloWeb新建、编辑、删除、复制及重命名SQL查询 - 实时数仓Hologres

本文为您介绍如何使用HoloWeb新建、编辑、删除、复制及重命名SQL查询。SQL窗口适用于做交互式的短查询，不适合用于大数据量的导入导出等离线作业场景，不支持执行超过60分钟的SQL。

前提条件

存在已登录实例，请参见登录实例。

新建SQL查询

登录Hologres管理控制台。
在顶部菜单栏左侧，选择相应的地域。
单击前往HoloWeb，进入HoloWeb开发页面。
在HoloWeb开发页面的顶部菜单栏，单击SQL编辑器。
在左侧导航栏，鼠标右击我的SQL查询，选择新建SQL查询。

在新建SQL查询对话框，配置各项参数，系统默认会自动填充当前的实例名和数据库名。参数描述如下表所示。

参数	描述
作业名称	新建的SQL查询名称。
目录	新建SQL查询存放的位置。默认目录为我的SQL查询，您也可以选择存放在已创建的文件夹中。
新文件夹	新建SQL查询存放的位置。可选择放在新建文件夹中。
实例名	您可以从当前已存在实例的下拉列表中选择目标实例名称。说明当前实例列表会展示已登录和未登录实例名称。当您选择的为未登录实例时，您可以在执行完SQL语句并保存后，登录该实例即可在列表中看到新增的内容。
数据库名称	Hologres当前实例下的数据库名称。

新增生成的SQL会展示在左侧我的SQL查询列表中。您可以在页面的表目录列表中选择目标表，查看对应表的字段名和类型。您也可以在SQL编辑区域使用标准的PostgreSQL语言进行开发。
说明
SQL查询对表名称和字段名称的大小写不敏感。如果您需要精确查询名称大小写完全一致的表，则需要使用双引号将该表名称引起来。
（可选）设置时区。
- 针对当前查询页面
  1. 在SQL查询页面，单击文档设定。
  2. 在文档设定对话框左侧导航栏，单击时区设定。
  3. 在设置时区下拉框选择时区，单击确认完成时区设置。
    运行Query查询时将使用此时区。
- 针对HoloWeb设置全局时区
  1. 在HoloWeb页面右上角，单击设定，进入用户设定对话框。
  2. 在用户设定对话框左侧导航栏，单击时区设定。
  3. 在设置时区下拉框选择时区，单击保存完成时区设置。
说明
如果在当前查询页面设置了时区且针对HoloWeb设置了全局时区，当前查询页面设置的时区优先级高。
单击运行，执行输入的SQL语句。
说明
- HoloWeb支持SQL运行最长60分钟，超过60分钟，会有超时提示cancel query due to timeout, queryTimeout setting is: 3600s。
- 设置statement_timeout大于60分钟对HoloWeb SQL窗口的最长运行时间无效。statement_timeout设置方法请参见修改活跃Query超时时间。
单击保存，保存当前SQL查询窗口的相关内容。

表目录

在您完成新建SQL查询和编辑SQL查询之后，您可以查看表目录，方便您查看和了解表内部的结构。

在HoloWeb开发页面的顶部菜单栏，单击SQL编辑器。
在左侧导航栏单击我的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查询，单击重命名。
您可以根据业务需求，配置重命名名称。
单击确定。