JDBC および psql を使用して計算グループインスタンスに接続する方法 - 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 コンソールにログインします。左側のナビゲーションウィンドウで、[インスタンス] をクリックします。インスタンスページで、インスタンスの ID をクリックします。[インスタンス詳細] ページで、[ネットワーク情報] セクションのエンドポイントとポート番号を表示します。重要 SQL が実行されるネットワーク環境に基づいて、正しいネットワークアドレスとポートを選択してください。そうしないと、接続は失敗します。
Port	はい
database_name	はい	Hologresデータベースの名前。 Hologres インスタンスをアクティブ化すると、システムは自動的に postgres という名前のデータベースを作成します。 postgres データベースを使用して Hologres に接続できます。ただし、このデータベースに割り当てられるリソースは限られています。ビジネス開発のためには、新しいデータベースを作成してください。詳細については、「データベースの作成」をご参照ください。例: demo。
warehouse_name	いいえ	インスタンスへの接続に使用される計算グループの名前。

例

計算グループが明示的に指定されていない
次の JDBC 接続文字列を使用すると、Hologres はユーザーのデフォルトの計算グループを使用して、hgpostcn-cn-zz4xxxxxxxxxx インスタンスの demo データベースに接続します。
```
jdbc:postgresql://hgpostcn-cn-zz4xxxxxxxxxx-cn-shenzhen-vpc-st.hologres.aliyuncs.com:80/demo
```
計算グループが明示的に指定されている
次の JDBC 接続文字列を使用すると、Hologres は指定された warehouse_1 計算グループを使用して、hgpostcn-cn-zz4xxxxxxxxxx インスタンスの demo データベースに接続します。
```
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 管理] をクリックして AccessKey ID を取得できます。カスタムアカウント: カスタムアカウントのユーザー名。例: BASIC$abc。
AccessKey_Secret	はい	Alibaba Cloud アカウント: Alibaba Cloud アカウントの AccessKey Secret。カスタムアカウント: カスタムアカウントのパスワード。
Endpoint	はい	Hologres インスタンスのネットワークアドレス。 Hologresコンソールの [インスタンスの詳細] ページで、Hologresインスタンスのエンドポイントを取得できます。
Port	はい	Hologres インスタンスのネットワークポート。 Hologres コンソールの [インスタンス詳細] ページでポート番号を取得できます。
database_name	はい	Hologresデータベースの名前。 Hologres インスタンスをアクティブ化すると、システムは自動的に postgres という名前のデータベースを作成します。 postgres データベースを使用して Hologres に接続できます。ただし、このデータベースに割り当てられるリソースは限られています。ビジネス開発のためには、新しいデータベースを作成してください。詳細については、「データベースの作成」をご参照ください。例: demo。
warehouse_name	いいえ	インスタンスへの接続に使用される計算グループの名前。

例

計算グループが明示的に指定されていない
次の psql 接続文字列を使用すると、Hologres はユーザーのデフォルトの計算グループを使用して、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 接続文字列を使用すると、Hologres は指定された warehouse_1 計算グループを使用して、hgpostcn-cn-zz4xxxxxxxxxx インスタンスの demo データベースに接続します。
```
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) が存在する場合、計算グループを切り替えることはできません。