EDB Postgres Distributed Command Line Interface (PGD CLI) v6.3.1

The EDB Postgres Distributed Command Line Interface (PGD CLI) is a tool for managing your EDB Postgres Distributed cluster. It's the key tool for inspecting and managing cluster resources.

It allows you to run commands against EDB Postgres Distributed clusters to:

  • Determine the health of the cluster, inspect the cluster's configuration, and manage the cluster's resources.
  • Inspect and manage the cluster's nodes and groups.
  • Perform a write-leader change operation on the group.

You can also install it manually on Linux and macOS systems that can connect to a PGD cluster, including:

  • HCP advanced and distributed high-availability clusters.
  • PGD clusters deployed using the CloudNative Postgres Global Clusters operator.
  • Manually deployed PGD clusters.

PGD Essential constraints

PGD Essential clusters have constraints that apply to certain CLI commands:

  • Cluster architecture: A PGD Essential cluster must have at most three data nodes and must have routing enabled for the global group only. Use pgd cluster verify --arch to check compliance.
  • Compatibility assessment: The pgd assess command skips checks for tables with multiple unique indexes, row level lock usage, lock table usage, and listen/notify usage.
  • Commit scope commands: pgd commit-scope create, pgd commit-scope update, and pgd commit-scope drop are not supported.
  • Group options: pgd group set-option cannot update enable_raft, enable_routing, enable_wal_decoder, or streaming_mode.
  • Node setup: pgd node setup enables routing for the global group and disables it for subgroups.

Installing PGD CLI

Installing the PGD CLI on various systems.

Using PGD CLI

How to use the PGD Command Line Interface (CLI) to manage your EDB Postgres Distributed cluster.

Configuring PGD CLI

Configuring PGD CLI for simpler connections to your PGD cluster

Discovering connection strings

How to obtain the correct connection strings for your PGD deployment.

Command reference

A reference guide to the commands available in the PGD CLI.