psql を使用してクラスターに接続する - Azure Cosmos DB for PostgreSQL

適用対象: Azure Cosmos DB for PostgreSQL (PostgreSQL の Citus データベース拡張機能を利用)

このクイックスタートでは、Azure Cloud Shellpsql 接続文字列を使用して Azure Cosmos DB for PostgreSQL クラスターに接続する方法について説明します。

前提条件

接続する

クラスターには、citus という名前の既定のデータベースがあります。 このデータベースに接続するには、接続文字列と管理者パスワードを使用します。

  1. Azure portal のクラスター ページで、[接続文字列] というメニュー項目を選択し、psql 接続文字列をコピーします。

    psql 接続文字列をコピーしているスクリーンショット。

    psql 文字列は psql "host=c-<cluster>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password={your_password} sslmode=require" という形式になっています。 ホスト名が c. で始まることにご注意ください (例: c-mycluster.12345678901234.postgres.cosmos.azure.com)。 このプレフィックスは、クラスターのコーディネーター ノードを示します。 既定 dbnamecitus であり、クラスターのプロビジョニング時にのみ変更できます。 user には、クラスタ上の任意の有効な Postgres ロールを指定できます。

  2. 上部のメニュー バーにある [Cloud Shell] アイコンを選択して、Azure Cloud Shell を開きます。

    Cloud Shell アイコンを示すスクリーンショット。

    プロンプトが表示されたら、Cloud Shell のデータを格納する Azure サブスクリプションを選択します。

  3. psql 接続文字列をシェルに貼り付けます。

  4. 接続文字列の中の、{your_password} を使用するクラスター パスワードに置き換えて、Enter キーを押します。

    Cloud Shell での psql の実行を示すスクリーンショット。

    psql がデータベースに正常に接続すると、新しい citus=> (またはデータベースのカスタム名) プロンプトが表示されます。

    psql (14.2, server 14.5)
    SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off)
    Type "help" for help.
    
    citus=>
    
  5. テスト クエリを実行します。 次のコマンドを psql プロンプトに貼り付け、Enter キーを押します。

    SHOW server_version;
    

    クラスターの作成時に選択した PostgreSQL のバージョンと一致する結果が表示されます。 次に例を示します。

     server_version
    ----------------
     14.5
    (1 row)
    

次の手順

クラスターへの接続が完了したので、次の手順ではテーブルを作成し、水平方向のスケーリングのためにシャード化します。