描述

postgres 是 PostgreSQL 数据库服务器。客户端应用要访问数据库时，会（通过网络或本地）连接到一个正在运行的 postgres 实例。该 postgres 实例随后会启动一个独立的服务器进程来处理该连接。

一个 postgres 实例始终只管理一个数据库集簇的数据。数据库集簇是一组存储在同一文件系统位置（“数据区域”）中的数据库。只要使用不同的数据区域和不同的通信端口（见下文），一个系统上就可以同时运行多个 postgres 实例。当 postgres 启动时，它需要知道数据区域的位置。该位置必须通过 -D 选项或 PGDATA 环境变量指定；没有默认值。通常，-D 或 PGDATA 会直接指向由 initdb 创建的数据区域目录。其他可能的文件布局见第 19.2 节。

默认情况下，postgres 在前台启动，并将日志消息打印到标准错误流。在实际应用中，postgres 应作为后台进程启动，例如在系统启动时启动。

postgres 命令也可以在单用户模式下调用。这种模式的主要用途是在 initdb 执行引导期间使用。有时也会用它来调试或进行灾难恢复；但请注意，运行单用户服务器其实并不适合调试服务器，因为不会发生真实的进程间通信和锁定。从 shell 以单用户模式调用时，用户可以输入查询，结果会打印到屏幕上，但其形式对开发者更有用，而非面向终端用户。在单用户模式下，会话用户会被设置为 ID 为 1 的用户，并向该用户隐式授予超级用户权限。该用户实际上不必存在，因此单用户模式可用于手工恢复系统目录遭受某些意外损坏的情况。

选项

postgres 接受以下命令行参数。有关这些选项的详细讨论，请参阅第 19 章。通过设置配置文件，你可以省去键入其中大多数选项的麻烦。某些（安全的）选项还可以由连接的客户端以应用相关的方式设置，并且仅对该会话生效。例如，如果设置了环境变量 PGOPTIONS，那么基于 libpq 的客户端就会将该字符串传给服务器，服务器会将其解释为 postgres 命令行选项。

环境

诊断

提到 semget 或 shmget 的失败消息，很可能表明你需要配置内核，以提供足够的共享内存和信号量。更多讨论见第 18.4 节。你也许可以通过降低 shared_buffers 来减少 PostgreSQL 的共享内存消耗，以及/或通过降低 max_connections 来减少信号量消耗，从而推迟重新配置内核。

表明另一个服务器已经在运行的失败消息应仔细检查，例如可根据你的系统使用下面的命令：

$ ps ax | grep postgres

或

$ ps -ef | grep postgres

如果你确信没有冲突的服务器在运行，可以删除消息中提到的锁文件，然后重试。

表明无法绑定端口的失败消息，可能意味着该端口已经被某个非 PostgreSQL 进程占用。你在终止 postgres 后如果立即使用同一端口重新启动它，也可能会得到这个错误；在这种情况下，你只需等待几秒钟，直到操作系统关闭该端口后再重试。最后，如果你指定了一个操作系统认为是保留的端口号，也可能会收到这个错误。例如，许多版本的 Unix 认为低于 1024 的端口号是“受信任的”，并且只允许 Unix 超级用户访问它们。

注解

实用命令 pg_ctl 可用于安全、便捷地启动和关闭 postgres 服务器。

只要有可能，就不要使用 SIGKILL 杀死主 postgres 服务器。这样会阻止 postgres 在终止前释放其持有的系统资源（例如共享内存和信号量）。这可能会导致新的 postgres 实例在启动时出现问题。

要正常终止 postgres 服务器，可以使用 SIGTERM、SIGINT 或 SIGQUIT 信号。第一个会在退出前等待所有客户端终止，第二个会强制断开所有客户端，而第三个会在不进行正确关闭的情况下立即退出，从而在重启期间导致一次恢复运行。

SIGHUP 信号会重新加载服务器配置文件。也可以向单个服务器进程发送 SIGHUP，但这通常没有意义。

要取消一个正在运行的查询，可以向执行该命令的进程发送 SIGINT 信号。要干净地终止一个后端进程，可以向该进程发送 SIGTERM。这两种操作在 SQL 中可调用的等效形式，见第 9.28.2 节中的 pg_cancel_backend 和 pg_terminate_backend。

postgres 服务器使用 SIGQUIT 通知从属服务器进程在不进行正常清理的情况下终止。用户不应该使用这个信号。向某个服务器进程发送 SIGKILL 也是不明智的 — 主 postgres 进程会将其解释为一次崩溃，并作为其标准崩溃恢复过程的一部分强制所有同级进程退出。

缺陷

--选项在 FreeBSD 或 OpenBSD 上不起作用。请改用 -c。这是受影响操作系统中的一个缺陷；如果这个问题未被修复，未来版本的 PostgreSQL 将提供变通方案。

单用户模式

要启动单用户模式服务器，可以使用类似下面的命令：

postgres --single -D /usr/local/pgsql/data other-options my_database

使用 -D 提供正确的数据库目录路径，或者确保已经设置了环境变量 PGDATA。还要指定你想要操作的那个数据库的名称。

通常，单用户模式服务器将换行视为命令输入终止符；它不像 psql 那样会对分号进行智能处理。要让一个命令跨越多行，必须在除最后一个换行之外的每个换行前输入反斜线。反斜线和紧邻的换行都会从输入命令中删除。注意，即使在字符串字面量或注释中也会如此。

但是，如果你使用 -j 命令行开关，单个换行并不会终止命令输入；取而代之的是使用“分号-换行-换行”这一序列。也就是说，输入一个分号，后面立刻跟着一个完全空白的行。在这种模式下，反斜线-换行不会被特殊处理。同样，对于这种序列出现在字符串字面量或注释中的情况，也不会有特殊处理。

在任一种输入模式中，如果你输入的分号既不恰好位于命令输入终止符之前，也不是命令输入终止符的一部分，那么它就会被视为命令分隔符。当你输入命令输入终止符时，已输入的多条语句会作为单个事务执行。

要退出会话，输入 EOF（通常是 Control+D）。如果自上一个命令输入终止符以来你已经输入了任何文本，那么 EOF 会被视为命令输入终止符，你还需要再输入一次 EOF 才能退出。

请注意，单用户模式服务器不提供复杂的行编辑功能（例如没有命令历史）。单用户模式也不会执行任何后台处理，例如自动检查点或复制。

示例

要使用默认值在后台启动 postgres，输入：

$ nohup postgres >logfile 2>&1 </dev/null &

要用指定端口启动 postgres，例如 1234：

$ postgres -p 1234

要使用 psql 连接到该服务器，请用 -p 选项指定这个端口：

$ psql -p 1234

或者设置环境变量 PGPORT：

$ export PGPORT=1234
$ psql

命名的运行时参数可以采用以下任一种形式设置：

$ postgres -c work_mem=1234
$ postgres --work-mem=1234

两种形式都会覆盖 postgresql.conf 中可能存在的 work_mem 设置。请注意，参数名中的下划线在命令行中既可以写成下划线，也可以写成连字符。除了短期实验之外，与其依赖命令行开关来设置参数，通常更好的做法是直接编辑 postgresql.conf 中的设置。

另见

initdb, pg_ctl