全部产品
Search
文档中心

实时数仓Hologres:SQL窗口

更新时间:Jun 24, 2024

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

前提条件

存在已登录实例,请参见登录实例

新建SQL查询

  1. 登录Hologres管理控制台

  2. 在顶部菜单栏左侧,选择相应的地域。

  3. 单击前往HoloWeb,进入HoloWeb开发页面。

  4. 在HoloWeb开发页面的顶部菜单栏,单击SQL编辑器

  5. 在左侧导航栏,鼠标右击我的SQL查询,选择新建SQL查询

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

    参数

    描述

    作业名称

    新建的SQL查询名称。

    目录

    新建SQL查询存放的位置。默认目录为我的SQL查询,您也可以选择存放在已创建的文件夹中。

    新文件夹

    新建SQL查询存放的位置。可选择放在新建文件夹中。

    实例名

    您可以从当前已存在实例的下拉列表中选择目标实例名称。

    说明

    当前实例列表会展示已登录和未登录实例名称。当您选择的为未登录实例时,您可以在执行完SQL语句并保存后,登录该实例即可在列表中看到新增的内容。

    数据库名称

    Hologres当前实例下的数据库名称。

  7. 新增生成的SQL会展示在左侧我的SQL查询列表中。您可以在页面的表目录列表中选择目标表,查看对应表的字段名和类型。您也可以在SQL编辑区域使用标准的PostgreSQL语言进行开发。

    说明

    SQL查询对表名称和字段名称的大小写不敏感。如果您需要精确查询名称大小写完全一致的表,则需要使用双引号将该表名称引起来。

    新增SQL窗口

  8. (可选)设置时区。

    • 针对当前查询页面

      1. 在SQL查询页面,单击文档设定

      2. 文档设定对话框左侧导航栏,单击时区设定

      3. 设置时区下拉框选择时区,单击确认完成时区设置。

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

        设置时区

    • 针对HoloWeb设置全局时区

      1. 在HoloWeb页面右上角,单击设定,进入用户设定对话框。

      2. 用户设定对话框左侧导航栏,单击时区设定

      3. 设置时区下拉框选择时区,单击保存完成时区设置。

    说明

    如果在当前查询页面设置了时区且针对HoloWeb设置了全局时区,当前查询页面设置的时区优先级高。

  9. 单击运行,执行输入的SQL语句。

    说明
    • HoloWeb支持SQL运行最长60分钟,超过60分钟,会有超时提示cancel query due to timeout, queryTimeout setting is: 3600s

    • 设置statement_timeout大于60分钟对HoloWeb SQL窗口的最长运行时间无效。statement_timeout设置方法请参见修改活跃Query超时时间

  10. 单击保存,保存当前SQL查询窗口的相关内容。

表目录

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

  1. 在HoloWeb开发页面的顶部菜单栏,单击SQL编辑器

  2. 在左侧导航栏单击我的SQL查询,打开目标SQL查询。

    新增SQL窗口

  3. 您可以在页面的表目录列表查看所有的内部表。选择目标表,查看对应表的字段名和类型。

    您也可以在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. 单击确定