运行并连接到 AlloyDB Omni

选择文档版本:

本页面介绍了如何在将 AlloyDB Omni 安装到您自己的机器上后运行并连接到 AlloyDB Omni。

运行 AlloyDB Omni

您用于运行 AlloyDB Omni 的过程取决于您是在单个服务器上的容器中运行 AlloyDB Omni。

启动 AlloyDB Omni

如需启动已停止的 AlloyDB Omni 容器,请运行 docker container start 命令podman container start 命令

Docker

docker container start CONTAINER_NAME

CONTAINER_NAME 替换为您在安装 AlloyDB Omni 容器时为其分配的名称。

Podman

podman container start CONTAINER_NAME

CONTAINER_NAME 替换为您在安装 AlloyDB Omni 容器时为其分配的名称。

检查 AlloyDB Omni 的状态

如需检查您所运行的所有容器的状态,请运行 docker container ls 命令podman container ls 命令

Docker

docker container ls

Podman

podman container ls

如果 AlloyDB Omni 容器正在运行,则其名称将显示在输出表的 NAMES 列中。相应的行会总结容器的状态。

如果容器的名称未显示在 NAMES 列中,则表示 AlloyDB Omni 未运行。

停止 AlloyDB Omni

如需停止 AlloyDB Omni 容器,请运行 docker container stop 命令podman container stop 命令

Docker

  docker container stop CONTAINER_NAME

CONTAINER_NAME 替换为您在安装 AlloyDB Omni 容器时为其分配的名称。

Podman

  podman container stop CONTAINER_NAME

CONTAINER_NAME 替换为您在安装 AlloyDB Omni 容器时为其分配的名称。

连接到在单个服务器上运行的 AlloyDB Omni

AlloyDB Omni 容器包含自己的 psql 副本,可让您打开与其数据库服务器的交互式 SQL shell 会话。

您还可以使用自己选择的与 PostgreSQL 兼容的软件,从容器外部连接到 AlloyDB Omni。

如需了解如何连接到 Kubernetes 集群上运行的 AlloyDB Omni 数据库集群,请参阅连接到 Kubernetes 上运行的 AlloyDB Omni

使用容器化 psql 进行连接

如需使用其自己的容器化 psql 副本连接到 AlloyDB Omni 数据库服务器,请运行以下命令:

Docker

  docker exec -it CONTAINER_NAME psql -U postgres

CONTAINER_NAME 替换为您在安装 AlloyDB Omni 容器时为其分配的名称。

Podman

  podman exec -it CONTAINER_NAME psql -U postgres

CONTAINER_NAME 替换为您在安装 AlloyDB Omni 容器时为其分配的名称。

此命令会将您以 postgres 用户角色连接到服务器,并显示 postgres=# 命令提示符。现在,您可以运行 psql 命令和 SQL 查询。

如需退出 psql,请运行 \q 命令。

使用您自己的应用进行连接

任何与 PostgreSQL 搭配使用的应用也可以与 AlloyDB Omni 搭配使用,而无需进行任何修改。

如需连接到 AlloyDB Omni 数据库服务器,请在启动 AlloyDB Omni 时向 docker runpodman 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 服务器一样。

后续步骤