このページでは、AlloyDB Omni を自分のマシンにインストールした場合の AlloyDB Omni の実行方法と接続方法について説明します。
AlloyDB Omni を実行する
AlloyDB Omni の実行手順は、AlloyDB Omni を単一サーバーのコンテナで実行するかどうかによって異なります。
AlloyDB Omni を起動する
停止した AlloyDB Omni コンテナを起動するには、docker container start コマンドを実行します。
docker container start CONTAINER_NAMECONTAINER_NAME は、AlloyDB Omni コンテナのインストール時に割り当てた名前に置き換えます。
AlloyDB Omni のステータスを確認する
実行中のすべてのコンテナのステータスを確認するには、docker container ls コマンドを実行します。
docker container lsAlloyDB Omni コンテナが実行されている場合、その名前が出力テーブルの NAMES 列に表示されます。対応する行には、コンテナの状態の要約が表示されます。
コンテナの名前が NAMES 列に表示されない場合は、AlloyDB Omni が実行されていません。
AlloyDB Omni を停止する
AlloyDB Omni コンテナを停止するには、docker container stop コマンドを実行します。
docker container stop CONTAINER_NAMECONTAINER_NAME は、AlloyDB Omni コンテナのインストール時に割り当てた名前に置き換えます。
単一サーバーで実行されている 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 postgresCONTAINER_NAME は、AlloyDB Omni コンテナのインストール時に割り当てた名前に置き換えます。
このコマンドは、postgres ユーザーロールとしてサーバーに接続し、postgres=# コマンド プロンプトを表示します。これで、psql コマンドと SQL クエリを実行できるようになりました。
psql を終了するには、\q コマンドを実行します。
独自のアプリケーションを使用して接続する
PostgreSQL と連携するアプリケーションは、変更なしで AlloyDB Omni とも連携できます。
AlloyDB Omni データベースサーバーに接続するには、AlloyDB Omni の Docker コンテナからホストマシンへのネットワーキングを公開するために、AlloyDB Omni を起動する際に --network=host または -p 5432:5432 を docker run コマンドに追加します。
カスタムポート番号を選択するには、AlloyDB Omni の起動時に -p [HOST_PORT]:5432 を使用します。次に、PostgreSQL 互換のクライアントまたはコード ライブラリを使用して、ポート 5432 または指定したカスタムポート番号に接続します。
データベース サーバーに接続すると、標準の PostgreSQL 通信プロトコルを使用して DML クエリと SQL クエリを使用してデータベースを定義、クエリ、変更できます。
AlloyDB Omni はお客様の環境内で実行されるため、AlloyDB Omni への接続方法を制御できます。たとえば、通常の PostgreSQL サーバーと同様に、このサービスへのネットワーク アクセスをアプリケーションのニーズに応じて許可または制限できます。