Postgresql 中文操作指南

所有参数名称都不区分大小写。每个参数接受五种类型之一的值：布尔值、字符串、整数、浮点或枚举（enum）。类型决定了设置参数的语法：

设置这些参数的最基本方法是编辑文件 postgresql.conf，该文件通常保留在数据目录中。初始化数据库集群目录时，会安装一个默认副本。此文件的外观示例如下：

每行指定一个参数。名称和值之间的等号是可选的。空格无关紧要（引用的参数值内除外），并且会忽略空行。哈希标记（#）将该行的其余部分指定为注释。不是简单标识符或数字的参数值必须用单引号引起来。要在参数值中嵌入单引号，请写两个引号（推荐）或反斜杠引号。如果文件中为同一参数包含多个条目，则除最后一个条目之外的所有条目都将被忽略。

通过这种方式设置的参数为集群提供了默认值。除非覆盖了这些值，否则活动会话看到的设置将是这些值。以下部分描述了管理员或用户如何覆盖这些默认值。

每当主服务器进程接收到 SIGHUP 信号时，就会重新读取配置文件；从命令行运行 pg_ctl reload 或调用 SQL 函数 pg_reload_conf() 可以最容易地发送此信号。主服务器进程还将此信号传播到所有当前运行的服务器进程，以便现有会话也采用新值（这将在它们完成任何当前执行的客户端命令后发生）。或者，您可以直接向单个服务器进程发送信号。一些参数只能在服务器启动时设置；在服务器重新启动之前，将忽略对其在配置文件中的条目的任何更改。在 SIGHUP 处理期间，配置文件中的无效参数设置也会被忽略（但会记录）。

除了 postgresql.conf ，PostgreSQL 数据目录还包含一个文件 postgresql.auto.conf ，其格式与 postgresql.conf 相同，但旨在自动编辑，而不是手动编辑。此文件保存通过 ALTER SYSTEM 命令提供的设置。每当 postgresql.conf 时都会读取此文件，并且其设置以相同的方式生效。 postgresql.auto.conf 中的设置会覆盖 postgresql.conf 中的设置。

外部工具也可以修改 postgresql.auto.conf。建议在服务器运行时不要这样做，因为并发的 ALTER SYSTEM 命令可能会覆盖这些更改。此类工具可能会简单地将新设置追加到末尾，或者可能会选择删除重复的设置和/或注释（如 ALTER SYSTEM 将要执行的操作）。

系统视图 pg_file_settings 有助于对配置文件的更改进行预测试，或者在 SIGHUP 信号未产生预期效果时诊断问题。

PostgreSQL 提供三个 SQL 命令来建立配置默认值。上述 ALTER SYSTEM 命令提供了一种通过 SQL 访问的方法来更改全局默认值；它在功能上等效于编辑 postgresql.conf。此外，还有两个命令允许在每个数据库或每个角色的基础上设置默认值：

使用 ALTER DATABASE 和 ALTER ROLE 设置的值仅在启动新的数据库会话时应用。它们会覆盖从配置文件或服务器命令行获取的值，并构成会话其余部分的默认值。请注意，有些设置在服务器启动后无法更改，因此无法使用这些命令（或下面列出的命令）进行设置。

一旦客户端连接到数据库，PostgreSQL 就提供了两个额外的 SQL 命令（和等效的功能）来与会话局部配置设置进行交互：

此外，可以将系统视图 pg_settings 用于查看并更改会话局部值：

除了设置全局默认值或在数据库或角色级别附加覆盖之外，您还可以通过 shell 设施向 PostgreSQL 传递设置。服务器和 libpq 客户端库都通过 shell 接受参数值。

PostgreSQL 提供了几种功能，用于将复杂 postgresql.conf 文件分解为子文件。在管理具有相关但并非完全相同的配置的多个服务器时，这些功能特别有用。

除了单个参数设置外， postgresql.conf 文件可以包含 include directives ，其指定另一文件，以便将其读取并处理，就像在此处插入到配置文件中。此特性允许配置文件划分为物理分离部分。包含指令只是如下所示：

如果文件名不是绝对路径，则它将相对于包含引用配置文件的目录。可以嵌套包括。

还有一个 include_if_exists 指令，其作用与 include 指令的作用相同，但当引用的文件不存在或无法读取时除外。规则 include 将此视为错误条件，但 include_if_exists 只是记录一条消息并继续处理引用配置文件。

postgresql.conf 文件还包含 include_dir 指令，该指令指定整个配置文件目录以纳入其中。它们如下所示：

非绝对目录名被视为相对于包含引用配置文件的目录。在指定的目录中，只有名称以后缀 .conf 结尾的非目录文件才会被包含。以 . 字符开头的文件名也被忽略，以避免错误，因为此类文件在某些平台上是隐藏的。包含目录中的多个文件按文件名顺序（根据 C 区域规则，即数字在字母之前，大写字母在小写字母之前）进行处理。

包含文件或目录可用于逻辑地分隔数据库配置的部分，而不是使用单个大型 postgresql.conf 文件。考虑一家有两台数据库服务器的公司，每台服务器的内存量不同。配置可能有一些元素是两台服务器都将共享的，例如日志记录。但两台服务器的内存相关参数会有所不同。服务器也可能会有特定于服务器的自定义。处理这种情况的一种方法是将您网站的自定义配置更改分解为三个文件。您可以在 postgresql.conf 文件的末尾添加以下内容来将其包括在内：

所有系统都会有相同的 shared.conf。具有特定内存量的每台服务器都可以共享相同的 memory.conf；对于拥有 8GB RAM 的所有服务器，您可能有一个，对于拥有 16GB RAM 的服务器，您可能有一个。最后，server.conf 可以包含真正特定于服务器的配置信息。

另一种可能性是创建一个配置文件目录，并将此信息放入该目录中的文件。例如，可以在 postgresql.conf 的末尾引用一个 conf.d 目录：

然后，您可以像这样为 conf.d 目录中的文件命名：

此命名约定建立了将加载这些文件的清晰顺序。这很重要，因为在服务器读取配置文件时，针对特定参数遇到的最后一个设置才会被使用。在此示例中，conf.d/02server.conf 中设置的内容将覆盖 conf.d/01memory.conf 中设置的值。

相反，您可以使用此方法对文件进行描述性命名：

此类排列为每个配置文件变体提供一个唯一名称。当多台服务器将其配置全部存储在一个地方时，例如存储在版本控制库中，这有助于消除歧义。（将数据库配置文件存储在版本控制之下是另一个值得考虑的好做法。）