PSQL クライアントを使用して Hologres に接続し、データを開発する - Hologres

Hologres は PostgreSQL エコシステムと互換性があります。PostgreSQL をサポートするほとんどの開発ツールや BI ツールは、Hologres に直接接続できます。任意のツールを使用して、エンタープライズレベルのリアルタイムデータウェアハウスを迅速に構築できます。このトピックでは、PSQL クライアントを使用して Hologres に接続し、標準の PostgreSQL 文でデータを開発する方法について説明します。

PSQL クライアントのインストール

PSQL クライアントを使用する前に、公式サイトからダウンロードしてインストールしてください。PSQL クライアントがすでにインストールされている場合は、このセクションをスキップできます。インストール手順は次のとおりです。

PSQL クライアントのダウンロード

Postgres 公式サイトにアクセスします。ご利用のオペレーティングシステムに合った PostgreSQL 11 以降のクライアントインストールパッケージをダウンロードします。その後、プロンプトに従ってインストールします。
環境変数の設定
- Windows システム。
  1. [システムのプロパティ] > [システムの詳細設定] ページで、[環境変数] をクリックします。
  2. PostgreSQL の bin ディレクトリへのパスを Path 変数に追加します。
  3. OK をクリックします。
- macOS の場合、通常、環境変数を設定する必要はありません。詳細については、「環境変数の設定」をご参照ください。

Hologres への接続と開発

PSQL クライアントをダウンロードしてインストールした後、Hologres インスタンスに接続してデータを開発します。

Hologres への接続

PSQL クライアントのコマンドラインインターフェイスを開き、接続情報を入力します。構文は PostgreSQL データベースへの接続と同じです。

Linux の文は次のとおりです。
```
psql -h <Endpoint> -p <Port> -U <AccessKey ID> -d <Database>
```
文を実行した後、AccessKey Secret を入力します。

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>
Password for user <AccessKey ID>: <AccessKey Secret>

パラメータ	説明
AccessKey ID	Alibaba Cloud アカウント：ご利用の Alibaba Cloud アカウントの AccessKey ID。[AccessKey 管理] をクリックして AccessKey ID を取得します。カスタムアカウント：カスタムアカウントのユーザー名 (例：`BASIC$abc`)。
AccessKey Secret	Alibaba Cloud アカウント：ご利用の Alibaba Cloud アカウントの AccessKey Secret。カスタムアカウント：カスタムアカウントのパスワード。
ポート	Hologres インスタンスのパブリックネットワークまたは VPC ポート。値の例：`80`。説明パブリックネットワークの詳細については、「インスタンスの詳細」をご参照ください。
エンドポイント	Hologres インスタンスのパブリックネットワークまたは VPC アドレス。値の例：`xxx-cn-hangzhou.hologres.aliyuncs.com`。説明パブリックネットワークの詳細については、「インスタンスの詳細」をご参照ください。
データベース	Hologres データベースの名前。 Hologres インスタンスが有効になると、システムは自動的に postgres データベースを作成します。 postgres データベースを使用して Hologres に接続します。ただし、このデータベースに割り当てられるリソースはわずかです。ビジネス開発には、新しいデータベースを作成してください。詳細については、「データベースの作成」をご参照ください。値の例：`mydb`。

使用例

Alibaba Cloud アカウントでログインします。文は次のとおりです：

PGUSER="xxx" PGPASSWORD="xxx" psql -h hgpostcn-cn-xxx-cn-hangzhou.hologres.aliyuncs.com -p 80 -d demo

阿里云账号登录

カスタムアカウントでログイン
- カスタムアカウントのユーザー名が次の図に示すように abc の場合。
- ログイン文は次のとおりです：
```
PGUSER="BASIC\$abc" PGPASSWORD="xxx" psql -h hgpostcn-cn-xxx-cn-hangzhou.hologres.aliyuncs.com -p 80 -d demo
```

説明

DataWorks や HoloWeb などの他の開発ツールを使用して Hologres に接続することもできます。詳細については、「DataWorks クイックスタート」または「HoloWeb に接続してクエリを実行」をご参照ください。

(任意) データベースの作成
Hologres インスタンスが有効になると、システムは自動的に postgres データベースを作成します。このデータベースはリソースが限られており、運用管理のみを目的としています。ビジネス開発には、新しいデータベースを作成してください。

説明
すでにビジネスデータベースを作成している場合は、このステップをスキップしてください。
- コマンド構文。
```
CREATE Database <DatabaseName>;
```
  DatabaseName は作成するデータベースの名前です。
- 例。
```
-- test という名前のデータベースを作成します。
CREATE Database test; 
```

データ開発

PSQL クライアントで標準の PostgreSQL 文を使用してデータ開発を行います。

次の例は、テーブルを作成してデータを書き込む方法を示しています。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;

ビジネスシナリオに基づいてジョブを開発します。以下に例を示します。

MaxCompute からのデータ読み取りを高速化します。詳細については、「外部テーブルを使用して MaxCompute データクエリを高速化」をご参照ください。
Flink を使用して Hologres にリアルタイムでデータを書き込みます。詳細については、「Hologres 結果テーブル」をご参照ください。