本页面介绍了如何在将 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 端口:
向自定义端口添加
postgresql_port_t标签:sudo /usr/sbin/semanage port -a -t postgresql_port_t -p tcp PORT_NUMBER将
PORT_NUMBER替换为自定义 TCP 端口号,例如5433。确认端口政策已更新:
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 服务的自动重启功能,请执行以下操作:
将以下配置添加到
/etc/systemd/system/alloydbomni18.service.d/override.conf文件中。[Service] Restart=on-failure重新加载
systemd管理器配置并重启alloydbomni18服务,使更改生效。sudo systemctl daemon-reloadsudo 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 服务器一样。
后续步骤