实时数仓Hologres：连接HoloWeb

操作步骤

1. 登录Hologres管理控制台。

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

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

4. 登录Hologres实例。

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

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

      参数	描述	是否必选
      网络类型	公网：支持华东2（上海）、华南1（深圳）、华北2（北京）、华东1（杭州）、华北3（张家口）、新加坡、中国（香港）、马来西亚（吉隆坡）、印度尼西亚（雅加达）及美国（硅谷）等地域。 图标的为公网类型的实例。 VPC：仅支持配置为HoloWeb所登录的地域。 图标的为VPC类型的实例，该实例不支持编辑详细信息和删除。	否
      实例名	选择当前账号已创建的实例。 说明 购买实例后，HoloWeb页面需加载实例信息，可能会出现延迟显示实例名称的情况。此时，您可通过手动配置域名等信息连接目标实例。	否
      名称	选择实例名称后，名称默认显示为所选实例的名称。您也可以重新自定义连接名称。	是
      描述	连接的描述信息。	否
      域名	Hologres实例的网络域名。 您可以进入Hologres管理控制台的实例详情页，从网络信息中获取域名。 如果您配置了实例名称，则系统自动为您匹配该实例的域名。您也可以选择手动输入域名。	是
      端口	Hologres实例的网络端口。 您可以进入Hologres管理控制台的实例详情页，从网络信息获取端口。 如果您配置了实例名称，则系统自动为您匹配该实例的端口。您也可以选择手动输入端口地址。	是
      登录方式	当前账户免密登录：无需输入账号及密码，直接使用当前账户登录。 账户密码登录：您可以输入自己或其他账户的账号及密码，并登录。	是
      账号	登录方式配置为账户密码登录时，需要配置该参数。 当前账号的AccessKey ID。 您可以单击AccessKey 管理，获取AccessKey ID。	否
      密码	登录方式配置为账户密码登录时，需要配置该参数。 当前账号的AccessKey Secret。	否
      测试连通性	检测连接是否成功： 显示测试通过表示连接成功。 显示测试不通过表示连接失败。	否
      连接后登录	您可以选择是否登录该实例。 是：该实例会登录并展示在左侧已登录实例列表中。 否：该实例会展示在左侧未登录实例列表中。	是

5. （可选）新建数据库。

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

   说明

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

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

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

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

      参数	说明
      实例名	默认展示当前数据库所在的已登录实例的名称。
      数据库名称	您可以命名当前数据库的名称。 说明 配置的数据库名称必须唯一。
      权限策略	您可以根据业务需求为数据库配置对应权限。更多关于权限策略的说明，请参见： SPM SLPM 专家权限模型
      立即登录	是：登录后您就可以直接使用创建的数据库。 否：登录数据库之后才可以进行使用。

6. 新建SQL查询。

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

   1. 在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]区域，查看当前语句的执行结果。

      

7. 新建外部表，以加速查询MaxCompute数据为例。

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

   说明

   • 确认您已创建MaxCompute项目，并完成原表的创建和数据写入。具体操作，请参见以下两种途径：

     1. 通过使用DataWorks平台，绑定MaxCompute数据源后，再执行表的创建和数据写入。

     2. 通过本地客户端使用MaxCompute执行表的创建和数据写入。

   • 您需要在HoloWeb登录数据库后，方可使用MaxCompute加速和OSS数据湖加速功能。

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

   2. 配置新建外部表的各项参数，根据您的需求选择对应的加速方式，单击提交。

      整库加速

      分类	参数	描述
      加速方式	选择加速方式	Hologres支持三种加速方式： 整库加速 部分加速 单表加速 选择整库加速。
      MaxCompute数据源	项目名	MaxCompute的项目（Project）名称。
      	Schema Name	MaxCompute的Schema名称。 对于已开启Schema的MaxCompute项目，此处可配置当前项目下有权限的所有Schema名称；未开启Schema的项目，无需配置此参数。关于Schema详情，请参见Schema操作。
      目标表位置	Holo Schema	模式名称。 您可以选择默认创建的public模式，也可以选择新建的模式名称。
      高级选项	表名冲突	三种表名冲突解决方式： 忽略，继续创建其他表 更新，修改同名表 报错，不再重复创建
      	数据类型不支持	两种数据类型不支持处理方式： 报错，导入失败 忽略，跳过不支持字段所在表

      部分加速

      分类	参数	描述
      加速方式	选择加速方式	Hologres支持三种加速方式： 整库加速 部分加速 单表加速 选择部分加速。
      MaxCompute数据源	项目名	MaxCompute的项目（Project）名称。
      	Schema Name	MaxCompute的Schema名称。 对于已开启Schema的MaxCompute项目，此处可配置当前项目下有权限的所有Schema名称；未开启Schema的项目，无需配置此参数。关于Schema详情，请参见Schema操作。
      目标表位置	Holo Schema	模式名称。 您可以选择默认创建的public模式，也可以选择新建的模式名称。
      高级选项	表名冲突	三种表名冲突解决方式： 忽略，继续创建其他表 更新，修改同名表 报错，不再重复创建
      	数据类型不支持	两种数据类型不支持处理方式： 报错，导入失败 忽略，跳过不支持字段所在表
      	搜索	通过表名模糊搜索，最多支持200张表，超出将不再显示。

      单表加速

      分类	参数	描述
      加速方式	选择加速方式	Hologres支持三种加速方式： 整库加速 部分加速 单表加速 选择单表加速。
      MaxCompute数据源	项目名	MaxCompute的项目（Project）名称。
      	Schema Name	MaxCompute的Schema名称。 对于已开启Schema的MaxCompute项目，此处可配置当前项目下有权限的所有Schema名称；未开启Schema的项目，无需配置此参数。关于Schema详情，请参见Schema操作。
      	表名	MaxCompute的对应Schema下的数据表。支持基于表前缀模糊搜索。
      Hologres 目标表	Schema	模式名称。 您可以选择默认创建的public模式，也可以选择新建的模式名称。
      	表名	Hologres需要加速的单表表名。
      	目标表描述	Hologres需要加速的单表描述。

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