Hologres兼容PostgreSQL生态，这意味着大多数PostgreSQL兼容的开发工具或BI工具都能直接连接Hologres，您可以选择熟悉的工具进行开发，帮助您快速构建企业级实时数仓。本文为您介绍PSQL客户端如何连接Hologres，并使用标准的PostgreSQL语句进行数据开发。

安装PSQL客户端

在使用PSQL客户端之前需要官网下载并安装。若您已经安装好PSQL客户端，可忽略本步骤，安装步骤如下。

  1. 下载PSQL客户端
    您需要进入Postgres官网，下载与电脑系统相匹配的PostgreSQL 11及以上版本的客户端安装包，并根据提示安装。
  2. 设置环境变量
    • Windows系统。
      1. 在系统属性 > 高级系统设置界面，单击环境变量。huanj
      2. 添加PostgreSQL的bin文件路径至Path中。配置
      3. 单击确定。
    • 设置macOS系统的环境变量，一般无需设置环境变量，如果需要请参见设置环境变量。

连接Hologres并开发

下载安装完成PSQL客户端之后，可以连接Hologres实例并进行开发。

  1. 连接Hologres
    进入PSQL客户端命令行界面，输入连接信息，语法与连接PostgreSQL数据库一致。
    • Linux系统语句如下。
      psql -h <Endpoint> -p <Port> -U <AccessKey ID> -d <Database>

      执行完上述语句后，您需要输入AccessKey Secret。

      LIN
    • macOS系统语句如下。
      PGUSER=<AccessKey ID> PGPASSWORD=<AccessKey Secret> psql -p <Port> -h <Endpoint> -d <Database>
      linux
    • Windows系统语句如下。
      Server [localhost]: Endpoint
Database [postgres]: Database
Port [5432]: Port
Username [postgres]: <AccessKey ID>
用户 <AccessKey ID> 的口令：<AccessKey Secret>
      连接psql
    参数 描述
    AccessKey ID 当前阿里云账号的AccessKey ID。

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

    AccessKey Secret 当前阿里云账号的AccessKey Secret。

    您可以单击AccessKey 管理，获取AccessKey Secret。

    Port Hologres实例的公共网络端口。

    示例取值80。

    Endpoint Hologres实例的公共网络地址。

    示例取值xxx-cn-hangzhou.hologres.aliyuncs.com。

    Database Hologres的数据库名称。

    开通Hologres实例后，系统自动创建postgres数据库。

    您可以使用postgres数据库链接Hologres，但是该数据库分配到的资源较少，开发实际业务建议您新建数据库。详情请参见创建数据库。

    示例取值mydb。

    说明 您也可以使用熟悉的开发工具连接Hologres，例如使用DataWorks或HoloWeb进行数据开发，详情请参见DataWorks快速入门或连接HoloWeb。
  2. （可选）创建数据库
    开通Hologres实例后，系统自动创建postgres数据库。该数据库分配到的资源较少，仅用于运维管理，开发实际业务建议您新建数据库。
    说明 若您在此之前已经创建业务数据库，可忽略此步骤。
    • 命令语法。
      CREATE Database <DatabaseName>;
      DatabaseName为要创建的数据库名称。
    • 使用示例。
      --创建一个名为test的数据库。
CREATE Database test;
  3. 数据开发
    使用标准的PostgreSQL语句，在PSQL客户端进行数据开发。
    示例在数据库中创建一张表并写入数据，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;
    您可以根据业务场景进行作业开发，示例如下。