AlloyDB Omni を実行して接続する

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

AlloyDB Omni を実行する

AlloyDB Omni の実行手順は、AlloyDB Omni を単一サーバーのコンテナで実行するかどうかによって異なります。

AlloyDB Omni を起動する

停止した AlloyDB Omni コンテナを起動するには、docker container start コマンドまたは podman container start コマンドを実行します。

docker container start CONTAINER_NAME

podman container start CONTAINER_NAME

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

実行中のすべてのコンテナのステータスを確認するには、docker container ls コマンドまたは podman container ls コマンドを実行します。

docker container ls

podman container ls

AlloyDB Omni コンテナが実行されている場合、その名前が出力テーブルの NAMES 列に表示されます。対応する行には、コンテナの状態の要約が表示されます。

コンテナの名前が NAMES 列に表示されない場合は、AlloyDB Omni が実行されていません。

AlloyDB Omni を停止する

AlloyDB Omni コンテナを停止するには、docker container stop コマンドまたは podman container stop コマンドを実行します。

  docker container stop CONTAINER_NAME

  podman container stop CONTAINER_NAME

単一サーバーで実行されている AlloyDB Omni に接続する

AlloyDB Omni コンテナには、データベース サーバーとの対話型 SQL シェル セッションを開くことができる独自の psql のコピーが含まれています。

任意の PostgreSQL 互換ソフトウェアを使用して、コンテナの外部から AlloyDB Omni に接続することもできます。

Kubernetes クラスタで実行されている AlloyDB Omni データベース クラスタに接続する方法については、Kubernetes で実行されている AlloyDB Omni に接続するをご覧ください。

コンテナ化された psql を使用して接続する

コンテナ化された独自の psql のコピーを使用して AlloyDB Omni データベース サーバーに接続するには、次のコマンドを実行します。

  docker exec -it CONTAINER_NAME psql -U postgres

  podman exec -it CONTAINER_NAME psql -U postgres

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

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

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

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

AlloyDB Omni データベース サーバーに接続するには、AlloyDB Omni の起動時に docker run コマンドまたは podman run コマンドに --network=host または -p 5432:5432 を追加して、AlloyDB Omni Docker コンテナからホストマシンへのネットワーキングを公開します。

カスタムポート番号を選択するには、AlloyDB Omni の起動時に -p [HOST_PORT]:5432 を使用します。次に、PostgreSQL 互換のクライアントまたはコード ライブラリを使用して、ポート 5432 または指定したカスタムポート番号に接続します。

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

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

次のステップ

• AlloyDB Omni の管理とモニタリング