Configuring PGD CLI#

PGD CLIは、PGDクラスターに接続できる任意のシステムにインストールできます。 PGD CLIを使用するには、 PGDスーパーユーザー権限または同等のユーザーが必要です。スーパーユーザー権限を持つPGDユーザーは bdr_superuserのロールとレプリケーションです。同等のユーザーの例は、EDB Cloud Service分散高可用性クラスターのedb_adminです。

PGD CLIとデータベース接続文字列#

データベース接続文字列は必要ない場合があります。たとえば、Trused Postgres ArchitectはシステムにPGD CLIをインストールすると、PGDクラスターへの接続も構成します。これは、 PGD CLIが実行時にクラスターに接続できることを意味します。

PGD CLIを手動でインストールする場合は、 PGD CLIにデータベース接続文字列を指定して、どのPGDクラスターに接続するかを認識する必要があります。

.pgpass にエントリを追加します。これには、ホスト、ポート、データベース名、ユーザー名、パスワードが含まれます。

PGPASSWORD 環境変数にパスワードを設定する。 -

接続文字列にパスワードを含めます。

他のオプションは複数のデータベースでうまく拡張できないか、パスワードの機密性が危険にさらされるため、最初のオプションをお勧めします。

その情報を入手したら、続行できます。

接続するデータベースの構成#

PGD CLIは、 PGD CLI構成ファイルまたはコマンドラインからデータベース接続情報を取得します。

コマンドラインでデータベース接続文字列を使用する#

--dsn オプションを使用して、接続文字列をpgd に直接渡すことができます。詳細については、データベース接続文字列を渡すを参照してください。例

pgd --dsn "host=kaboom port=5432 user=enterprisedb dbname=pgddb" nodes show --versions

環境変数でデータベース接続文字列を使用する#

コマンドラインで接続文字列を渡す別の方法として、PGD_CLI_DSN 環境変数を接続文字列に設定できます。例

export PGD_CLI_DSN="host=kaboom port=5432 user=enterprisedb dbname=pgddb"
pgd nodes show --versions

構成ファイルを使用する#

pgd-cli-config.yml 構成ファイルを使用して、クラスターのデータベース接続文字列を指定します。構成ファイルには、クラスター内の少なくとも1つのPGDノードのデータベース接続文字列が含まれている必要があります。クラスター名はオプショナルであり、検証されません。

例

cluster:
  name: cluster-name
  endpoints:
  - "host=host-1 port=5432 dbname=pgddb user=postgres"
  - "host=host-2 port=5432 dbname=pgddb user=postgres"
  - "host=host-3 port=5432 dbname=pgddb user=postgres"

デフォルトでは、 pgd-cli-config.yml は/etc/edb/pgd-cli ディレクトリにあります。 PGD CLIは、次の場所でpgd-cli-config.yml を検索します。優先順位は高から低です。

/etc/edb/pgd-cli デフォルト2.$HOME/.edb/pgd-cli

構成ファイルがこれらのディレクトリのいずれにもない場合は、 pgd コマンドでオプションの-f または--config-file フラグを使用して、構成として読み取るようにファイルを設定できます。データベース接続文字列を渡すを参照してください。

Configuring PGD CLI

目次