JDBC または PSQL による Hologres 仮想ウェアハウスへの接続 - Hologres

このトピックでは、Java Database Connectivity (JDBC) および PSQL を使用して計算グループインスタンスに接続する方法について説明します。

JDBC を使用した Hologres インスタンスへの接続

コマンドフォーマット

接続文字列に計算グループが指定されていない場合、ユーザーのデフォルト計算グループを使用して接続されます。
```
jdbc:postgresql:<Endpoint>:<Port>/<database_name>
```

計算グループを指定します。

jdbc:postgresql://<Endpoint>:<Port>/<database_name>@<warehouse_name>

パラメーターの説明

パラメーター	必須	説明
Endpoint	はい	Hologres インスタンスのネットワークアドレスとポートです。 Hologres コンソールにアクセスします。左側のナビゲーションウィンドウで Instances をクリックし、対象のインスタンスをクリックします。Instance Details ページの Network Information セクションでエンドポイントとポートを確認します。重要 SQL コマンドを実行するネットワーク環境に適したネットワークアドレスとポートを選択してください。選択を誤ると接続に失敗します。
Port	はい
database_name	はい	Hologres データベースの名前です。 Hologres インスタンス作成後、システムにより自動的に postgres データベースが作成されます。 Hologres への接続には postgres データベースを使用できますが、このデータベースにはリソースがほとんど割り当てられていません。業務開発用途には、新しいデータベースを作成することを推奨します。詳細については、「データベースの作成」をご参照ください。例：demo
warehouse_name	いいえ	インスタンスへの接続に使用する計算グループの名前です。

使用例

計算グループ未指定

以下の JDBC 接続文字列は、hgpostcn-cn-zz4xxxxxxxxxx インスタンスの demo データベースに接続します。計算グループが指定されていないため、ユーザーのデフォルト計算グループが使用されます。
```
jdbc:postgresql://hgpostcn-cn-zz4xxxxxxxxxx-cn-shenzhen-vpc-st.hologres.aliyuncs.com:80/demo
```
計算グループ指定

以下の JDBC 接続文字列は、hgpostcn-cn-zz4xxxxxxxxxx インスタンスの demo データベースに接続します。接続には指定された計算グループ `warehouse_1` が使用されます。
```
jdbc:postgresql://hgpostcn-cn-zz4xxxxxxxxxx-cn-shenzhen-vpc-st.hologres.aliyuncs.com:80/demo@warehouse_1
```

PSQL を使用した Hologres インスタンスへの接続

コマンドフォーマット

接続文字列に計算グループが指定されていない場合、ユーザーのデフォルト計算グループを使用して接続されます。
```
PGUSER="<AccessKey_ID>" PGPASSWORD="<AccessKey_Secret>" psql -h <Endpoint> -p <Port> -d <database_name>
```

計算グループを指定します。

PGUSER="<AccessKey_ID>" PGPASSWORD="<AccessKey_Secret>" psql -h <Endpoint> -p <Port> -d <database_name>@<warehouse_name>

パラメーターの説明

パラメーター	必須	説明
AccessKey_ID	はい	Alibaba Cloud アカウント：ご利用の Alibaba Cloud アカウントの AccessKey ID です。AccessKey 管理から取得できます。カスタムアカウント：BASIC$abc のようなカスタムアカウントのユーザー名です。
AccessKey_Secret	はい	Alibaba Cloud アカウント：ご利用の Alibaba Cloud アカウントの AccessKey Secret です。カスタムアカウント：カスタムアカウントのパスワードです。
Endpoint	はい	Hologres インスタンスのネットワークアドレスです。 Hologres コンソールの Instance Details ページからネットワークアドレスを取得します。
Port	はい	Hologres インスタンスのネットワークポートです。 Hologres コンソールの Instance Details ページからネットワークポートを取得します。
database_name	はい	Hologres データベースの名前です。 Hologres インスタンス作成後、システムにより自動的に postgres データベースが作成されます。 Hologres への接続には postgres データベースを使用できますが、このデータベースにはリソースがほとんど割り当てられていません。業務開発用途には、新しいデータベースを作成することを推奨します。詳細については、「データベースの作成」をご参照ください。例：demo
warehouse_name	いいえ	インスタンスへの接続に使用する計算グループの名前です。

使用例

計算グループ未指定

以下の PSQL 接続文字列は、hgpostcn-cn-zz4xxxxxxxxxx インスタンスの demo データベースに接続します。計算グループが指定されていないため、ユーザーのデフォルト計算グループが使用されます。
```
PGUSER="xxx" PGPASSWORD="xxx" psql -h hgpostcn-cn-zz4xxxxxxxxxx-cn-shenzhen-vpc-st.hologres.aliyuncs.com -p 80 -d demo
```
計算グループ指定

以下の PSQL 接続文字列は、hgpostcn-cn-zz4xxxxxxxxxx インスタンスの demo データベースに接続します。接続には指定された計算グループ `warehouse_1` が使用されます。
```
PGUSER="xxx" PGPASSWORD="xxx" psql -h hgpostcn-cn-zz4xxxxxxxxxx-cn-shenzhen-vpc-st.hologres.aliyuncs.com -p 80 -d demo@warehouse_1
```

SQL を使用した現在の接続における計算グループの切り替え

Hologres V4.0 以降では、SQL を使用して現在の接続における計算グループを切り替えることができます。

コマンドフォーマット

-- 現在の接続の計算グループを切り替えます
SET current_warehouse = <warehouse_name>;

-- 検証：現在の接続の計算グループを照会します
SHOW current_warehouse;

注意事項

接続の計算グループを切り替える際、Grand Unified Configuration (GUC) 変数やプリペアドステートメントなどの接続状態は変更されません。
この設定はセッションレベルでのみサポートされており、データベースレベルまたはユーザーレベルではサポートされていません。データベースレベルまたはユーザーレベルでこの設定を適用しようとすると、次のエラーが表示されます：'This can only be set at session level.'
現在の接続ユーザーは、移行先の計算グループに対する権限を持っている必要があります。必要な権限がない場合、次のエラーが表示されます：'Permission denied for warehouse "xxx".'
一時テーブル (TEMP TABLE) を含む接続では、計算グループを切り替えることはできません。