本页面介绍了如何在将 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 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 服务器一样。