使用 RPM 运行并连接到 AlloyDB Omni

选择文档版本:

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

准备工作

在系统上安装 AlloyDB Omni。

运行 AlloyDB Omni

使用以下部分中的信息来启动和停止 AlloyDB Omni 以及检查状态。

可选:更新 SELinux 政策

如果您的系统上启用了 SELinux,并且您修改了 postgresql.conf 文件中的某些全局统一配置 (GUC) 参数,则必须先更新 SELinux 政策,然后才能启动 AlloyDB Omni 服务。更新这些政策可防止资源访问被拒,从而避免数据库服务器不可用或备份等操作中断。

运行 semanage 和 restorecon 命令需要 policycoreutils-python-utils 软件包。

下表列出了在您将 GUC 参数从默认值更改时需要更新 SELinux 政策的参数:

GUC 参数 资源类型 未更新 SELinux 政策的影响 解决方法
port 端口 数据库服务器无法启动,并且变得不可用。 将 postgresql_port_t 标签分配给自定义 TCP 端口。
external_pid_file 文件 数据库服务器仍然可用,但 SELinux 会拒绝在 /var/run/postgresql/ 之外创建外部 PID 文件的访问权限。 将 postgresql_db_t 标签分配给自定义 PID 文件目录。
unix_socket_directories 文件 数据库服务器无法创建套接字文件,并且变得不可用。 将 postgresql_db_t 标签分配给自定义 Unix 套接字目录。
log_directory 文件 数据库服务器无法写入日志,并变得不可用。 将 postgresql_db_t 标签分配给自定义日志目录。
archive_command 文件 数据库服务器仍可正常运行,但 SELinux 会拒绝向目标目录写入数据,这可能会导致预写式日志 (WAL) 归档和备份中断。 将 postgresql_db_t 标签分配给自定义归档目录。

更新自定义端口的 SELinux 政策

如果您更改 postgresql.conf 文件中的 port 参数,请运行以下命令,以允许 AlloyDB Omni 绑定到自定义 TCP 端口:

  1. 向自定义端口添加 postgresql_port_t 标签:

    sudo /usr/sbin/semanage port -a -t postgresql_port_t -p tcp PORT_NUMBER

    将 PORT_NUMBER 替换为自定义 TCP 端口号,例如 5433。

  2. 确认端口政策已更新:

    sudo /usr/sbin/semanage port -l | grep postgresql_port_t

更新自定义目录的 SELinux 政策

如果您更改 postgresql.conf 文件中的 external_pid_file、unix_socket_directories、log_directory 或 archive_command 参数以使用自定义目录,请运行以下命令,将 postgresql_db_t 上下文应用于该目录:

sudo /usr/sbin/semanage fcontext -a -t postgresql_db_t "DIRECTORY_PATH(/.*)?"
sudo /sbin/restorecon -R -F DIRECTORY_PATH

将 DIRECTORY_PATH 替换为自定义 PID 文件目录、Unix 套接字目录、日志目录或 WAL 归档目录的完整路径。

启动 AlloyDB Omni

  sudo systemctl start alloydbomni18

可选:启用自动服务重启功能

如需启用 AlloyDB Omni 服务的自动重启功能,请执行以下操作:

  1. 将以下配置添加到 /etc/systemd/system/alloydbomni18.service.d/override.conf 文件中。

      [Service]
        Restart=on-failure
  2. 重新加载 systemd 管理器配置并重启 alloydbomni18 服务,使更改生效。

    sudo systemctl daemon-reload
    sudo systemctl restart alloydbomni18

检查 AlloyDB Omni 的状态

   sudo systemctl status alloydbomni18

停止 AlloyDB Omni

  sudo systemctl stop alloydbomni18

连接到 AlloyDB Omni

AlloyDB Omni RPM 软件包还包含 psql 客户端,可让您打开与数据库服务器的交互式 SQL shell 会话。

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

使用捆绑的 psql 进行连接

  /usr/lib/postgresql/18/bin/psql -h localhost -U postgres

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

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

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

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

使用任何与 PostgreSQL 兼容的客户端或代码库连接到 AlloyDB Omni。

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

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

后续步骤