连接HoloWeb

HoloWeb基于实时数仓Hologres,为用户提供一站式进行可视化开发和管理数据库的平台。本文通过示例为您介绍使用HoloWeb的基本流程。

前提条件

已开通Hologres,详情请参见购买Hologres

操作步骤

  1. 登录Hologres管理控制台

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

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

  4. 登录Hologres实例。

    1. 单击元数据管理页签的连接实例

    2. 配置连接实例对话框的参数,单击确定

      参数

      描述

      是否必选

      网络类型

      • 公网:支持华东2(上海)、华南1(深圳)、华北2(北京)、华东1(杭州)、华北3(张家口)、新加坡、中国(香港)、马来西亚(吉隆坡)、印度尼西亚(雅加达)及美国(硅谷)等地域。

        公网实例图标的为公网类型的实例。

      • VPC:仅支持配置为HoloWeb所登录的地域。

        VPC网络图标的为VPC类型的实例,该实例不支持编辑详细信息和删除。

      实例名称

      选择当前账号已创建的实例。

      名称

      选择实例名称后,名称默认显示为所选实例的名称。您也可以重新自定义连接名称。

      描述

      连接的描述信息。

      域名

      Hologres实例的网络域名。

      您可以进入Hologres管理控制台的实例详情页,从网络信息中获取域名。

      如果您配置了实例名称,则系统自动为您匹配该实例的域名。您也可以选择手动输入域名。

      端口

      Hologres实例的网络端口。

      您可以进入Hologres管理控制台的实例详情页,从网络信息获取端口。

      如果您配置了实例名称,则系统自动为您匹配该实例的端口。您也可以选择手动输入端口地址。

      登录方式

      • 当前账户免密登录:无需输入账号及密码,直接使用当前账户登录。

      • 账户密码登录:您可以输入自己或其他账户的账号及密码,并登录。

      账号

      登录方式配置为账户密码登录时,需要配置该参数。

      当前账号的AccessKey ID。

      您可以单击AccessKey 管理,获取AccessKey ID。

      密码

      登录方式配置为账户密码登录时,需要配置该参数。

      当前账号的AccessKey Secret。

      测试连通性

      检测连接是否成功:

      • 显示测试通过表示连接成功。

      • 显示测试不通过表示连接失败。

      连接后登录

      您可以选择是否登录该实例。

      • :该实例会登录并展示在左侧已登录实例列表中。

      • :该实例会展示在左侧未登录实例列表中。

  5. (可选)新建数据库。

    开通Hologres实例后,系统自动创建postgres数据库。该数据库分配到的资源较少,仅用于管理,开发实际业务需要新建数据库。

    说明

    如果您已经新建数据库,请跳过该步骤,直接新建SQL查询。

    1. 单击元数据管理 > 数据库

      您也可以在元数据管理界面的已登录实例列表。鼠标右击目标连接,选择新建数据库数据库

    2. 新建数据库对话框中,填写配置参数,单击确认新建数据库

      参数

      说明

      实例名

      默认展示当前数据库所在的已登录实例的名称。

      数据库名称

      您可以命名当前数据库的名称。

      说明

      配置的数据库名称必须唯一。

      权限策略

      您可以根据业务需求为数据库配置对应权限。更多关于权限策略的说明,请参见:

      立即登录

      • 是:登录后您就可以直接使用创建的数据库。

      • 否:登录数据库之后才可以进行使用。

  6. 新建SQL查询。

    成功连接Hologres实例后,您可以在SQL编辑器模块,使用标准的PostgreSQL语言进行开发。

    1. SQL编辑器页面,单击新建sql查询图标。

      您也可以在左侧导航栏,鼠标右键单击我的SQL查询,选择新建SQL查询。具体操作请参见SQL窗口

    2. 在新增的临时Query查询页面,选择已创建的实例名数据库后,您可以在SQL查询的编辑框输入如下示例语句,单击运行

      BEGIN;
      CREATE TABLE nation (
       n_nationkey bigint NOT NULL,
       n_name text NOT NULL,
       n_regionkey bigint NOT NULL,
       n_comment text NOT NULL,
      PRIMARY KEY (n_nationkey)
      );
      CALL SET_TABLE_PROPERTY('nation', 'bitmap_columns', 'n_nationkey,n_name,n_regionkey');
      CALL SET_TABLE_PROPERTY('nation', 'dictionary_encoding_columns', 'n_name,n_comment');
      CALL SET_TABLE_PROPERTY('nation', 'time_to_live_in_seconds', '31536000');
      COMMIT;
      
      INSERT INTO nation VALUES
      (11,'zRAQ', 4,'nic deposits boost atop the quickly final requests? quickly regula'),
      (22,'RUSSIA', 3  ,'requests against the platelets use never according to the quickly regular pint'),
      (2,'BRAZIL',  1 ,'y alongside of the pending deposits. carefully special packages are about the ironic forges. slyly special '),
      (5,'ETHIOPIA',  0 ,'ven packages wake quickly. regu'),
      (9,'INDONESIA', 2  ,'slyly express asymptotes. regular deposits haggle slyly. carefully ironic hockey players sleep blithely. carefull'),
      (14,'KENYA',  0  ,'pending excuses haggle furiously deposits. pending, express pinto beans wake fluffily past t'),
      (3,'CANADA',  1 ,'eas hang ironic, silent packages. slyly regular packages are furiously over the tithes. fluffily bold'),
      (4,'EGYPT', 4 ,'y above the carefully unusual theodolites. final dugouts are quickly across the furiously regular d'),
      (7,'GERMANY', 3 ,'l platelets. regular accounts x-ray: unusual, regular acco'),
      (20 ,'SAUDI ARABIA',  4 ,'ts. silent requests haggle. closely express packages sleep across the blithely');
      
      SELECT * FROM nation;
      说明

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

    3. 在SQL编辑页面下方的结果[1]区域,查看当前语句的执行结果。

      国内运行结果.png

  7. 新建外部表。

    Hologres与MaxCompute底层资源无缝连通,支持使用新建外部表的方式加速查询MaxCompute数据。HoloWeb使用可视化的方式新建外部表的步骤如下:

    1. 单击元数据管理 > MaxCompute加速 > 创建外部表

      说明

      登录数据库后,才支持使用MaxCompute加速和OSS数据湖加速功能。

    2. 配置新建外部表的各项参数,单击提交

      分类

      参数

      描述

      MaxCompute 源表

      项目名

      MaxCompute的项目(Project)名称。

      Schema Name

      MaxCompute的Schema名称,对于使用两层模型的MaxCompute项目,默认不展示;对于使用三层模型的MaxCompute项目,此处可下拉选择当前项目下有权限的所有Schema。

      表名

      MaxCompute的表名称,支持基于前缀模糊搜索。

      Hologres 目标表

      数据库名

      选择外部表所在的Hologres数据库名称。

      Schema Name

      模式名称。

      您可以选择默认创建的public模式,也可以选择新建的模式名称。

      表名

      新建的Hologres外部表名称。

      选择MaxCompute表后,将会自动填入MaxCompute表名称,您也可以手动重命名。

      目标表描述

      新建的Hologres外部表描述,可自定义修改。

      说明

      创建外部表同步MaxCompute表的数据时,会将数据库中表字段的Comment和列的Comment一并同步至Hologres。

    3. 成功新建外部表后,选择左侧导航栏元数据管理 > 已登录实例。双击目标外部表,在外部表的编辑界面单击数据预览,加速查询MaxCompute数据。