psql による接続
Databases for EnterpriseDB は非推奨です。 2025年6月16日現在、新しいインスタンスを展開することはできません。 既存のインスタンスは2025年10月15日までサポートされます。 その日までにまだ存在しているインスタンスはすべて削除されます。 詳細は 、 Databases for EnterpriseDB の廃止 を参照してください。
コマンド・ライン・クライアント psql から直接、IBM Cloud® Databases for EnterpriseDB のデータベースにアクセスすることができます。 psql を使用すると、データベース内に作成されたデータ構造を直接的に操作およびモニターできます。 また、照会およびパフォーマンスのテストとモニター、スクリプトのインストールと変更、およびその他の管理アクティビティーにも役立ちます。
管理者ユーザーには、Databases for EnterpriseDB のデフォルトの役割 pg_monitor が割り当てられているので、Databases for EnterpriseDB のモニタリングのためのビューと機能にアクセスできます。 デフォルトでは、管理者ユーザーには、他のユーザーが作成したオブジェクトに対する権限はありません。
管理者を使用してデータベースに接続する前に、管理者のパスワードを設定しておく必要があります。 詳しくは、管理者パスワードの設定のページを参照してください。
psql のインストール
Databases for EnterpriseDB のコマンド・ライン・クライアント、psql をインストールします。 psql を使用するには、ローカル・システムに Databases for EnterpriseDB クライアント・ツールをインストールしておく必要があります。 postgresql.org から提供されているフル
PostgreSQL パッケージを使用してインストールすることも、オペレーティング・システムのパッケージ・マネージャーのパッケージとしてインストールすることもできます。
psql について詳しくは、PostgreSQL の資料を参照してください。
psql 接続ストリング
接続ストリングは、デプロイメントの_「概要」_ にある_「エンドポイント」_ペインに表示されます。また、クラウド・データベース CLI プラグインおよび API から取得することもできます。
psql との接続を確立するために必要な情報は、接続文字列の「cli」セクション内にあります。 参照用に、接続文字列の構成要素を次の表に示します。
| フィールド名 | 索引 | 説明 |
|---|---|---|
Bin |
接続を作成するための推奨バイナリー。この場合は psql になります。 |
|
Composed |
デプロイメントへの接続を確立するための構成済みのコマンド。 このコマンドは、 Bin 実行可能ファイル、 Environment 変数設定、および使用法を結合します。 |
|
Environment |
環境変数として設定したキーまたは値のリスト。 | |
Arguments |
0 ... | Bin フィールドに示されているコマンドに引数として渡される情報 |
Certificate |
Base64 | アプリケーションが適切なサーバーに接続することを確認するために使用する自己署名証明書。 base64 でエンコードされています。 |
Certificate |
名前 | 自己署名証明書に割り当てられた名前。 |
Type |
この接続情報を使用するパッケージのタイプ。この場合は cli です。 |
0...配列にこれらのエントリーが 1 つ以上含まれている可能性があることを示します。
接続中
ibmcloud cdb deployment-connections コマンドは、コマンド・ライン・クライアントの接続の確立に関係するあらゆる処理を行います。 例えば、「example-postgres」という名前のデプロイメントに接続するには、次のコマンドを使用します。
ibmcloud cdb deployment-connections example-postgres --start
それとも
ibmcloud cdb cxn example-postgres -s
このコマンドは、admin パスワードの入力を求めるプロンプトを出し、psql コマンド・ライン・クライアントを実行してデータベースに接続します。
Cloud Databases プラグインをインストールしていない場合は、psql を使用し、「composed」の接続文字列を指定して Databases for EnterpriseDB データベースに接続します。 環境変数 PGPASSWORD および PGSSLROOTCERT が提供されます。 PGPASSWORD を admin のパスワードに設定し、PGSSLROOTCERT を自己署名証明書のパスまたはファイル名に設定します。
PGPASSWORD=$PASSWORD PGSSLROOTCERT=0b22f14b-7ba2-11e8-b8e9-568642342d40 psql 'host=4a8148fa-3806-4f9c-b3fc-6467f11b13bd.8f7bfd7f3faa4218aec56e069eb46187.databases.appdomain.cloud port=32325 dbname=ibmclouddb user=admin sslmode=verify-full'
自己署名証明書の使用
- _「エンドポイント」_ペインまたは接続情報の Base64 フィールドから証明書情報をコピーします。
- 必要に応じて、Base64 ストリングをテキストにデコードします。
- 証明書をファイルに保存します (提供される名前、または独自のファイル名を使用できます)。
- 証明書のパスを
ROOTCERT環境変数に指定します。
コマンド ibmcloud cdb deployment-cacert "your-service-name" を使用して、デプロイメントのデコードされた証明書を CLI プラグインと共に表示することができます。 これにより、base64 がテキストにデコードされます。 コマンドの出力をコピーしてファイルに保存し、そのファイルのパスを ROOTCERT 環境変数に指定してください。