运行并连接到 AlloyDB Omni

选择文档版本:

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

准备工作

本页面上的大多数命令都使用 AlloyDB Omni CLI。

如需在您的机器上安装此命令行工具,请参阅安装 AlloyDB Omni CLI

运行 AlloyDB Omni

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

安装 AlloyDB Omni 会设置一个名为 alloydb-dataplane 的系统服务,该服务配置为在每次机器启动时启动。

如需对 AlloyDB Omni 进行基本控制和监控,请使用 sudo alloydb 命令,如以下各部分所示。

启动 AlloyDB Omni

sudo alloydb database-server start

如需执行测试连接,请参阅使用容器化的 psql 进行连接

检查 AlloyDB Omni 的状态

sudo alloydb database-server status

停止 AlloyDB Omni

sudo alloydb database-server stop

停用开机时启动

运行以下命令可防止 AlloyDB Omni 在机器启动时自动启动。

sudo systemctl disable alloydb-dataplane

重新启用开机时启动

  sudo systemctl enable alloydb-dataplane

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

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

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

使用容器化 psql 进行连接

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

单个服务器

docker exec -it pg-service psql -h localhost -U postgres

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

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

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

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

如需连接到 AlloyDB Omni 数据库服务器,请使用任何与 PostgreSQL 兼容的客户端或代码库连接到运行 AlloyDB Omni 的机器的端口 5432(默认 PostgreSQL 数据库服务器端口)。

之所以能正常运行,是因为 AlloyDB Omni 容器将其自己的端口 5432 公开给其所运行的机器的同一端口。

连接到数据库服务器后,您可以使用标准 PostgreSQL 通信协议,通过 DML 和 SQL 查询来定义、查询和修改数据库。

由于 AlloyDB Omni 在您自己的环境中运行,因此您可以控制连接到 AlloyDB Omni 的方式。这包括根据应用需求允许或限制对此服务的网络访问,就像使用普通 PostgreSQL 服务器一样。

后续步骤