毎度、ググっても出てこない小ネタを取り扱っております。
本記事は個人的な見解であり、筆者の所属するいかなる団体にも関係ございません。

0. はじめに

Ubuntu版 PostgreSQL はコミュニティ版のPostgresqlとは違って、pg_*cluster[s]コマンドというのがあります。Ubuntu 上で複数のバージョンのPostgresqlを動かしたり、バックアップできたりリストアできたり、アップグレードできたり、DBを作ったり削除したりできるので、便利なのですが、あまり解説されてないようなのでちょっとまとめてみたいと思います。

1. どんなコマンドがあるか

以下のようなコマンドがあります。

/usr/bin/pg_backupcluster
/usr/bin/pg_createcluster
/usr/bin/pg_ctlcluster
/usr/bin/pg_dropcluster
/usr/bin/pg_renamecluster
/usr/bin/pg_restorecluster
/usr/bin/pg_upgradecluster
/usr/bin/pg_lsclusters

Sonnet3.5にまとめてもらいました。

コマンド名	機能概要
pg_lsclusters	システム上のPostgreSQLクラスタの一覧を表示
pg_createcluster	新しいPostgreSQLクラスタを作成
pg_ctlcluster	PostgreSQLクラスタの起動、停止、再起動、状態確認などの制御を実行
pg_dropcluster	既存のPostgreSQLクラスタを削除
pg_renamecluster	PostgreSQLクラスタの名前を変更
pg_backupcluster	PostgreSQLクラスタのバックアップを作成
pg_restorecluster	バックアップからPostgreSQLクラスタを復元
pg_upgradecluster	PostgreSQLクラスタを新しいメジャーバージョンにアップグレード

これらのコマンドは、Debian/Ubuntuディストリビューション特有のPostgreSQLクラスタ管理ツールであり、システム管理者がPostgreSQLの運用管理を効率的に行うために使用します。

補足：

これらのコマンドは通常、rootユーザーまたはsudo権限を持つユーザーが実行します。
クラスタとは、PostgreSQLのデータベースインスタンスとその設定を含む一連のファイル群を指します。

2. 各コマンドについての説明

2-1. pg_lsclusters

システム上の全PostgreSQLクラスタの一覧と状態を表示します。

使い方

pg_lsclusters

出力例：

Ver Cluster Port Status Owner    Data directory              Log file
14  main    5432 online postgres /var/lib/postgresql/14/main log/postgresql-%Y-%m-%d_%H%M%S.log
16  main    5433 online postgres /var/lib/postgresql/16/main /var/log/postgresql/postgresql-16-main.log

オプション

pg_lsclustersのオプションは以下の通りです。

Usage: /usr/bin/pg_lsclusters [-hjs]

Options:
  -h --no-header   Omit column headers in output
  -j --json        JSON output
  -s --start-conf  Include start.conf information in status column
     --help        Print help

2-2. pg_createcluster

新しいPostgreSQLクラスタを作成します。

使い方

pg_createcluster [バージョン] [クラスタ名]

例：

pg_createcluster 14 test_cluster

オプション

Usage: /usr/bin/pg_createcluster [options] <version> <cluster name> [-- <initdb options>]

Options:
  -u <uid>      cluster owner and superuser (default: 'postgres')
  -g <gid>      group for data files (default: primary group of owner)
  -d <dir>      data directory (default:
                /var/lib/postgresql/<version>/<cluster name>)
  -s <dir>      socket directory (default: /var/run/postgresql for clusters
                owned by 'postgres', /tmp for other clusters)
  -l <dir>      path to desired log file (default:
                /var/log/postgresql/postgresql-<version>-<cluster>.log)
  --locale <encoding>
                set cluster locale (default: inherit from environment)
  --lc-collate/ctype/messages/monetary/numeric/time <locale>
                like --locale, but only set for a particular category
  -e <encoding> Default encoding (default: derived from locale)
  -p <port>     port number (default: next free port starting from 5432)
  --start       start the cluster after creating it
  --start-conf auto|manual|disabled
                Set automatic startup behaviour in start.conf (default: 'auto')
  --createclusterconf=file alternative createcluster.conf to use
  --environment=file alternative environment file to use
  <initdb options> other options to pass to initdb

2-3. pg_ctlcluster

PostgreSQLクラスタの制御（起動、停止、再起動など）を行います。

使い方

pg_ctlcluster [バージョン] [クラスタ名] [アクション] [-- <pg_ctl options>]

例：

pg_ctlcluster 14 main start   # 起動
pg_ctlcluster 14 main stop    # 停止
pg_ctlcluster 14 main restart # 再起動
pg_ctlcluster 14 main status  # 状態確認

2-4. pg_dropcluster

既存のPostgreSQLクラスタを完全に削除します。

使い方

pg_dropcluster [バージョン] [クラスタ名] [--stop]

例：

pg_dropcluster 14 test_cluster --stop

2-5. pg_renamecluster

既存のPostgreSQLクラスタの名前を変更します。

使い方

pg_renamecluster [OPTIONS] [バージョン] [旧クラスタ名] [新クラスタ名]

例：

pg_renamecluster 14 old_name new_name

2-6. pg_backupcluster

PostgreSQLクラスタの完全バックアップを作成します。

使い方

pg_backupcluster [options] [バージョン] [クラスタ名] [アクション]

Syntax: /usr/bin/pg_backupcluster [options] <version> <cluster> <action>
Actions:
  createdirectory        Create /var/backups/version-cluster
  basebackup             Backup using pg_basebackup
  dump                   Backup using pg_dump
  expiredumps <N>        Remove all but last N dumps
  expirebasebackups <N>  Remove all but last N basebackups
  receivewal             Launch pg_receivewal
  compresswal            Compress WAL files in archive
  archivecleanup         Remove obsolete WAL files from archive
  list                   Show dumps, basebackups, and WAL
Options:
  -c --checkpoint <spread|fast>  Passed to pg_basebackup
  -k --keep-on-error     Keep faulty backup directory on error
  -v --verbose           Verbose output

2-7. pg_restorecluster

バックアップからPostgreSQLクラスタを復元します。

使い方

pg_restorecluster [options] [バージョン] [クラスタ名] [バックアップパス]

例：

pg_restorecluster 14 main

オプション

Syntax: /usr/bin/pg_restorecluster [options] <version> <cluster> <backup>
Options:
  -d --datadir DIR  Data directory for restored cluster (default per createcluster.conf)
  -p --port PORT    Use port PORT for restored cluster (default is next free port)
  -s --start        Start cluster after restoring (default for restore from dump)
     --archive      Configure recovery from WAL archive
     --pitr TIMEST  Configure point-in-time recovery to TIMESTAMP from WAL archive
     --wal-archive DIR  Read WAL from archive DIR (default <backup>/../wal)

2-8. pg_upgradecluster

PostgreSQLクラスタを新しいメジャーバージョンにアップグレードします。

使い方

pg_upgradecluster [旧バージョン] [クラスタ名] [<new data directory>]

例：

pg_upgradecluster 13 main

補足事項：

これらのコマンドは通常、root権限またはsudo権限が必要です
クラスタ操作前にはデータのバックアップを推奨します
実行前にpg_lsclustersでクラスタの状態を確認することを推奨します
本番環境での操作は十分な検証と計画の後に実施してください

3. まとめ

コマンドの説明でした。

別記事で、

バックアップ
アップグレード
を実践してみたいと思います。

4. 参照

Ubuntu版 PostgreSQL とコミュニティ版 PostgreSQLの違いのまとめ #Ubuntu - Qiita
https://qiita.com/etaka/items/7e4e392561b5c8109098