RPM を使用して AlloyDB Omni を実行して接続する

ドキュメントのバージョンを選択してください。

このページでは、AlloyDB Omni を自分のマシンにインストールした場合の AlloyDB Omni の実行方法と接続方法について説明します。

始める前に

システムに AlloyDB Omni をインストールします。

AlloyDB Omni を実行する

以降のセクションでは、AlloyDB Omni の起動、ステータスの確認、停止について説明します。

省略可: SELinux ポリシーを更新する

システムで SELinux が有効になっていて、postgresql.conf ファイルの特定の Grand Unified Configuration（GUC）パラメータを変更する場合は、AlloyDB Omni サービスを開始する前に SELinux ポリシーを更新する必要があります。これらのポリシーを更新すると、データベース サーバーが使用できなくなったり、バックアップなどのオペレーションが中断されたりする可能性があるリソース アクセスの拒否を防ぐことができます。

semanage コマンドと restorecon コマンドを実行するには、policycoreutils-python-utils パッケージが必要です。

次の表に、デフォルト値から変更するときに SELinux ポリシーの更新が必要な GUC パラメータを示します。

GUC パラメータ リソースの種類 SELinux ポリシーが更新されない場合の影響 解決策
port ポート データベース サーバーが起動せず、使用できなくなる。 カスタム TCP ポートに postgresql_port_t ラベルを割り当てます。
external_pid_file ファイル データベース サーバーは引き続き使用できますが、SELinux は /var/run/postgresql/ の外部に外部 PID ファイルを作成するためのアクセスを拒否します。 カスタム PID ファイル ディレクトリに postgresql_db_t ラベルを割り当てます。
unix_socket_directories ファイル データベース サーバーがソケット ファイルを作成できず、使用できなくなります。 カスタム Unix ソケット ディレクトリに postgresql_db_t ラベルを割り当てます。
log_directory ファイル データベース サーバーがログを書き込めず、使用できなくなる。 カスタムログ ディレクトリに postgresql_db_t ラベルを割り当てます。
archive_command ファイル データベース サーバーは引き続き使用できますが、SELinux がターゲット ディレクトリへの書き込みアクセスを拒否するため、write-ahead log（WAL）のアーカイブとバックアップが中断される可能性があります。 カスタム アーカイブ ディレクトリに postgresql_db_t ラベルを割り当てます。

カスタムポートの SELinux ポリシーを更新する

postgresql.conf ファイルの port パラメータを変更する場合は、次のコマンドを実行して、AlloyDB Omni がカスタム TCP ポートにバインドできるようにします。

  1. カスタムポートに postgresql_port_t ラベルを追加します。

    sudo /usr/sbin/semanage port -a -t postgresql_port_t -p tcp PORT_NUMBER

    PORT_NUMBER は、カスタム TCP ポート番号（例: 5433）に置き換えます。

  2. ポートポリシーが更新されていることを確認します。

    sudo /usr/sbin/semanage port -l | grep postgresql_port_t

カスタム ディレクトリの SELinux ポリシーを更新する

postgresql.conf ファイルの external_pid_file、unix_socket_directories、log_directory、archive_command パラメータを変更してカスタム ディレクトリを使用する場合は、次のコマンドを実行して、postgresql_db_t コンテキストをそのディレクトリに適用します。

sudo /usr/sbin/semanage fcontext -a -t postgresql_db_t "DIRECTORY_PATH(/.*)?"
sudo /sbin/restorecon -R -F DIRECTORY_PATH

DIRECTORY_PATH は、カスタム PID ファイル ディレクトリ、Unix ソケット ディレクトリ、ログ ディレクトリ、WAL アーカイブ ディレクトリのフルパスに置き換えます。

AlloyDB Omni を起動する

  sudo systemctl start alloydbomni18

省略可: サービスの自動再起動を有効にする

AlloyDB Omni サービスの自動再起動を有効にするには、次の操作を行います。

  1. /etc/systemd/system/alloydbomni18.service.d/override.conf ファイルに次の構成を追加します。

      [Service]
    Restart=on-failure

  2. systemd マネージャー構成を再読み込みし、alloydbomni18 サービスを再起動して変更を反映します。

    sudo systemctl daemon-reload
sudo systemctl restart alloydbomni18

AlloyDB Omni のステータスを確認する

   sudo systemctl status alloydbomni18

AlloyDB Omni を停止する

  sudo systemctl stop alloydbomni18

AlloyDB Omni に接続する

AlloyDB Omni RPM パッケージには、データベース サーバーとの対話型 SQL シェル セッションを開くことができる psql クライアントも含まれています。

任意の PostgreSQL 互換ソフトウェアを使用して AlloyDB Omni に接続することもできます。

バンドルされた psql を使用して接続する

  /usr/lib/postgresql/18/bin/psql -h localhost -U postgres

このコマンドは、postgres ユーザーロールとしてサーバーに接続し、postgres=# コマンド プロンプトを表示します。これで、psql コマンドと SQL クエリを実行できるようになりました。

psql を終了するには、\q コマンドを実行します。

独自のアプリケーションを使用して接続する

PostgreSQL と連携するクライアント アプリケーションは、変更なしで AlloyDB Omni とも連携できます。

PostgreSQL 互換のクライアントまたはコード ライブラリを使用して AlloyDB Omni に接続します。

データベース サーバーに接続すると、標準の PostgreSQL 通信プロトコルを介して DML クエリと SQL クエリを送信することで、データベースを定義、クエリ、変更できます。

AlloyDB Omni はお客様の環境内で実行されるため、AlloyDB Omni への接続方法を制御できます。通常の PostgreSQL サーバーと同様に、アプリケーションのニーズに応じて AlloyDB Omni へのネットワーク アクセスを許可または制限できます。

次のステップ