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 --archto check compliance. - Compatibility assessment: The
pgd assesscommand 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, andpgd commit-scope dropare not supported. - Group options:
pgd group set-optioncannot updateenable_raft,enable_routing,enable_wal_decoder, orstreaming_mode. - Node setup:
pgd node setupenables routing for theglobalgroup 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.
- On this page
- PGD Essential constraints