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

前提条件

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

新建SQL查询

  1. 登录Hologres管理控制台。
  2. 在顶部菜单栏左侧，选择相应的地域。地域
  3. 单击前往HoloWeb，进入HoloWeb开发页面。
  4. 在HoloWeb开发页面的顶部菜单栏，单击SQL编辑器 > 新增SQL窗口，单击确认。
    您也可以在左侧导航栏，鼠标右击我的SQL查询，选择新建SQL查询。
    在新建SQL查询对话框，配置各项参数，系统默认会自动填充当前的实例名和数据库名。新建SQL查询参数描述如下表所示。
    参数 描述
    作业名称 新建的SQL查询名称。
    目录 新建SQL查询存放的位置。默认目录为我的SQL查询，您也可以选择存放在已创建的文件夹中。
    实例名 您可以从当前已存在实例的下拉列表中选择目标实例名称。
    说明 当前实例列表会展示已登录和未登录实例名称。当您选择的为未登录实例时，您可以在执行完SQL语句并保存后，登录该实例即可在列表中看到新增的内容。
    数据库名称 Hologres当前实例下的数据库名称。
  5. 新增生成的SQL会展示在左侧我的SQL查询列表中。您可以在页面的表目录列表中选择目标表，查看对应表的字段名和类型。您也可以在SQL编辑区域使用标准的PostgreSQL语言进行开发。
    说明 SQL查询对表名称和字段名称的大小写不敏感。如果您需要精确查询名称大小写完全一致的表，则需要使用双引号将该表名称引起来。
    新增SQL窗口
  6. （可选）设置时区。
    • 针对当前查询页面
      1. 在SQL查询页面右上角，单击文档设定。文档设定
      2. 在文档设定对话框左侧导航栏，单击时区设定。
      3. 在设置时区下拉框选择时区，单击确认完成时区设置。

        运行Query查询时将使用此时区。

        设置时区
    • 针对HoloWeb设置全局时区
      1. 在HoloWeb页面右上角，单击用户名称。
      2. 单击设定，进入用户设定对话框。设置全局时区
      3. 在用户设定对话框左侧导航栏，单击时区设定。
      4. 在设置时区下拉框选择时区，单击保存完成时区设置。
    说明 如果在当前查询页面设置了时区且针对HoloWeb设置了全局时区，当前查询页面设置的时区优先级高。
  7. 单击运行，执行输入的SQL语句。
    说明 HoloWeb支持SQL运行最长60分钟，超过60分钟，会有超时提示：cancel query due to timeout, queryTimeout setting is: 3600s
  8. 单击保存，保存当前SQL查询窗口的相关内容。

表目录

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

  1. 在HoloWeb开发页面的顶部菜单栏，单击SQL编辑器 > 新增SQL窗口，单击确认。
    您也可以在我的SQL查询中打开目标SQL查询。新增SQL窗口
  2. 您可以在页面的表目录列表查看所有的内部表。选择目标表，查看对应表的字段名和类型。
    您也可以在SQL编辑区域使用标准的PostgreSQL语言进行开发。例如，您可以在SQL编辑区域运行新增表语句，并单击刷新图标，在表目录下方可以展示表结构。
    说明 SQL查询对表名称和字段名称的大小写不敏感。如果您需要精确查询名称大小写完全一致的表，则需要使用双引号将该表名称引起来。

编辑SQL查询

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

删除SQL查询

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

复制SQL查询

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

重命名SQL查询

  1. 在左侧导航栏，单击我的SQL查询，查找目标SQL查询。
    如果目标SQL查询存放于文件夹中，您可以在Query查询下方的搜索框输入目标SQL查询名称。文件夹快速查询
  2. 鼠标右击目标SQL查询，单击重命名。
  3. 您可以根据业务需求，配置重命名名称。
  4. 单击确认。