Postgresql 中文操作指南

将所有文件安装在目录 PREFIX 下，而不是 /usr/local/pgsql。实际文件将安装到各种子目录中；不会直接将任何文件安装到 PREFIX 目录中。

您可以将与架构相关的文件安装在不同前缀 EXEC-PREFIX 下，而不是 PREFIX 设置到的前缀。这对于在主机之间共享与架构无关的文件非常有用。如果您省略此项，则 EXEC-PREFIX 设置为等于 PREFIX，并且与架构相关的文件和无关的文件都将安装在同一树下，这可能是您想要的。

指定可执行程序的目录。默认值为 _EXEC-PREFIX /bin_, 这通常表示 /usr/local/pgsql/bin 。

设置各种配置文件的目录，默认值为 _PREFIX /etc_。

设置安装库和可动态加载模块的位置。默认值为 _EXEC-PREFIX /lib_.

设置安装 C 和 C++ 头文件的目录。默认值为 _PREFIX /include_。

设置各种只读数据文件的根目录。这仅为以下一些选项设置默认值。默认值为 _PREFIX /share_.

设置已安装程序使用的只读数据文件的目录。默认值为 DATAROOTDIR 。请注意，这与你的数据库文件将放置的位置无关。

设置安装本地数据（特别是消息转换编目文件）的目录。默认值为 _DATAROOTDIR /locale_。

随 PostgreSQL 一起提供的参考手册将安装在这个目录下，在其各自的 man_x subdirectories. The default is DATAROOTDIR /man_ 下。

设置安装文档文件（“man” 页除外）的根目录。这仅为以下选项设置默认值。此选项的默认值为 _DATAROOTDIR /doc/postgresql_。

PostgreSQL 中 HTML 格式的文档将安装在这个目录下。默认值为 DATAROOTDIR 。

启用本地语言支持 (NLS)，即以除英语之外的语言显示程序消息的能力。 LANGUAGES 是一个可选的、由语言代码组成的空格分隔列表，例如 —​enable-nls='de fr' 。（您的列表和实际提供的翻译之间的交集将自动计算。）如果您没有指定列表，则会安装所有可用的翻译。

要使用此选项，您需要 Gettext API 的实现。

构建 PL/Perl 服务器端语言。

构建 PL/Python 服务器端语言。

构建 PL/Tcl 服务端语言。

Tcl 会安装 tclConfig.sh 文件，其中包含构建用于与 Tcl 连接的模块所需配置信息。此文件通常可以在一个众所周知的位置自动找到，但是如果你希望使用其他版本的 Tcl，你可以指定搜索 tclConfig.sh 的目录。

通过对基于 LLVM 的 JIT 编译提供支持进行构建（参见 Chapter 32）。此操作需安装 LLVM 库。当前 LLVM 的最低必需版本是 3.9。

llvm-config 将用于查找所需的编译选项。llvm-config，然后在 PATH 中搜索所有支持的版本，将用于在 llvm-config-$major-$minor 中搜索。如果这不能得到所需的程序，请使用 LLVM_CONFIG 指定一个通往正确 llvm-config 的路径。例如

—​with-lz4 #

—​with-zstd #

—​with-ssl=_LIBRARY_ #

—​with-openssl #

—​with-gssapi #

—​with-ldap #

—​with-pam #

—​with-bsd-auth #

—​with-systemd #

—​with-bonjour #

—​with-uuid=_LIBRARY_ #

—​with-ossp-uuid #

—​with-libxml #

—​with-libxslt #

通过不对 ICU 库提供支持进行构建，从而禁用 ICU 校对功能的使用（参见 Section 24.2）。

阻止使用 Readline 库（以及 libedit）。此选项将禁用 psql 中的命令行编辑和历史记录。

倾向于使用 BSD 许可的 libedit 库，而不是 GPL 许可的 Readline。此选项仅当同时安装了这两个库时才有意义；在这种情况下，默认使用 Readline。

禁止使用 Zlib 库。这会禁用 pg_dump 和 pg_restore 中的压缩存档支持。

即使 PostgreSQL 在平台上没有 CPU 自旋锁支持，也允许构建成功。缺乏自旋锁支持将会导致非常差的性能；因此，仅当构建中止并告知您该平台缺乏自旋锁支持时才应使用此选项。如果在您的平台上构建 PostgreSQL 需要此选项，请将问题报告给 PostgreSQL 开发人员。

禁用使用 CPU 原子操作。缺乏此类操作的平台上，此选项不起作用。拥有此类操作的平台上，此选项将导致差的性能。此选项仅适用于除错或进行性能比较。

禁用客户端库的线程安全性。这将阻止 libpq 和 ECPG 程序中的并发线程安全地控制其私有连接句柄。仅在具有缺陷的线程支持的平台上才使用此选项。

DIRECTORIES 是一个冒号分隔的目录列表，这些目录将添加到编译器搜索头文件的列表中。如果您在非标准位置安装了可选包（如 GNU Readline），您必须使用该选项，并且可能还要使用相应的 —​with-libraries 选项。

Example: —​with-includes=/opt/gnu/include:/usr/sup/include.

DIRECTORIES 是一个冒号分隔的、用于搜索库的目录列表。如果您在非标准位置安装了包，您可能必须使用该选项（和相应的 —​with-includes 选项）。

Example: —​with-libraries=/opt/gnu/lib:/usr/sup/lib.

PostgreSQL 包含它自己的时区数据库，它需要这些数据库进行日期和时间操作。实际上，此时区数据库与 FreeBSD、Linux 和 Solaris 等许多操作系统提供的 IANA 时区数据库兼容，因此再次安装它将是多余的。使用此选项时，将使用 DIRECTORY 中的系统提供的时区数据库，而不是 PostgreSQL 源代码发行版中包含的时区数据库。DIRECTORY 必须指定为绝对路径。/usr/share/zoneinfo 是某些操作系统上的可能目录。请注意，安装例程不会检测不匹配或错误的时区数据。如果你使用此选项，建议运行回归测试以验证你指向的时区数据能与 PostgreSQL 正常工作。

此选项主要面向熟悉其目标操作系统的二进制包发行商。使用此选项的主要优势是每当许多本地夏令时规则更改时，都不需要升级 PostgreSQL 包。另一优势是，如果时区数据库文件不需要在安装过程中构建，那么 PostgreSQL 就可以更加直接地进行交叉编译。

将 STRING 附加到 PostgreSQL 版本号中。例如，你可以使用它来标记从未发布的 Git 快照构建的二进制文件或包含自定义补丁的二进制文件，以及附加版本字符串，例如 git describe 标识符或发行包版本号。

不要标记 PostgreSQL 可执行文件，以指示它们应该在安装的库目录中搜索共享库（参见 —​libdir ）。在大多数平台上，此标记使用库目录的绝对路径，因此在您稍后重新安装时，这将毫无帮助。但您随后需要提供一些其他方法让可执行文件找到共享库。这通常需要配置操作系统动态连接器来搜索库目录；有关详情，参见 Section 17.5.1 。

将 NUMBER 设置为服务器和客户端的默认端口号。默认值为 5432。该端口以后始终可以更改，但如果在此处指定，那么服务器和客户端都会内置相同的默认值，这样很方便。通常，选择非默认值唯一的充分理由是打算在同一台计算机上运行多个 PostgreSQL 服务器。

GSSAPI 使用的 Kerberos 服务主体的默认名称。 postgres 为默认值。通常没有理由更改此项，除非您为 Windows 环境进行构建，在这种情况下它必须设置为大写 POSTGRES 。

设置 segment size（单位为 GB）。大表分为多个操作系统文件，每个大小等于段大小。这避免了在众多平台上存在的文件大小限制问题。默认的段大小为 1 GB，在所有支持的平台上均安全。如果您的操作系统具有“大文件”支持（如今大多数都有），则可以使用更大的段大小。这有助于减少处理超大表时消耗的文件描述符数。但请注意不要选择高于平台和您打算使用的文件系统支持的值。您可能希望使用的其他工具（例如 tar）也可以设置可用文件大小的限制。建议（但不是绝对要求）此值为 2 的幂。请注意，更改此值会中断磁盘数据库兼容性，这意味着您不能使用 pg_upgrade 升级到具有不同段大小的版本。

设置 block size（单位为 KB）。这是表中的存储和 I/O 单位。默认值 8 KB 适用于大多数情况；但在特殊情况下，其他值可能也有用。该值必须是 1 到 32（KB）之间的 2 的幂。请注意，更改此值会中断磁盘数据库兼容性，这意味着您不能使用 pg_upgrade 升级到具有不同块大小的版本。

设置 WAL block size（单位为 KB）。这是 WAL 日志中的存储和 I/O 单位。默认值 8 KB 适用于大多数情况；但在特殊情况下，其他值可能也有用。该值必须是 1 到 64（KB）之间的 2 的幂。请注意，更改此值会中断磁盘数据库兼容性，这意味着您不能使用 pg_upgrade 升级到具有不同 WAL 块大小的版本。

编译所有程序和库并附加调试符号。这意味着您可以在调试器中运行程序以分析问题。这会大幅增加已安装的可执行文件的大小，而且在非 GCC 编译器上通常还会禁用编译器优化，从而导致运行速度变慢。然而，在解决可能出现的问题时，拥有可用符号会非常有帮助。目前，只有在您使用 GCC 时，才建议将此选项用于生产安装。但如果您正在进行开发工作或运行测试版，那么您应始终启用此选项。

启用服务器中的 assertion 检查，测试许多“不可能发生”的情况。这对于代码开发非常宝贵，但测试可能会大大减缓服务器速度。另外，启用测试不一定能增强服务器的稳定性！断言检查未按严重程度分类，因此相对较小的错误可能会触发断言失败，导致服务器重新启动。此选项不推荐用于生产环境，但您应该在开发工作或运行测试版时打开它。

启用使用 Perl TAP 工具的测试。此操作需要 Perl 安装和 Perl 模块 IPC::Run。有关更多信息，请参见 Section 33.4。

启用自动依赖项跟踪。使用此选项会设置 makefile，以便在任何头文件更改时重建所有受影响的对象文件。如果你在进行开发工作时这很有用，但如果你只想编译一次并安装，这就浪费开支。目前，此选项只能与 GCC 配合使用。

在使用 GCC 时，所有程序和库都将使用代码覆盖测试工具进行编译。运行时，它们将在构建目录中生成包含代码覆盖度量的文件。有关更多信息，请参阅 Section 33.5。此选项仅适用于 GCC，并且在执行开发工作时使用。

如果使用 GCC，所有程序和库都将编译成可分析的形式。在后端退出时，将创建一个包含 gmon.out 的子目录，其中包含分析数据的文件。此选项仅用于 GCC 以及在进行开发工作时。

使用对动态跟踪工具 DTrace 的支持编译 PostgreSQL。有关详细信息，请参见 Section 28.5 。

若要指向 dtrace 程序，可以设置环境变量 DTRACE。这通常是必需的，因为 dtrace 通常安装在 /usr/sbin 下，这可能不会存储在您的 PATH 中。

可以在 DTRACEFLAGS 环境变量中指定 dtrace 程序的其他命令行选项。在 Solaris 上，要将 DTrace 支持纳入 64 位二进制文件，你必须指定 DTRACEFLAGS="-64"。例如，使用 GCC 编译器：

以块为单位指定关系段大小。如果 —​with-segsize 和此选项都指定了，则此选项获胜。此选项仅供开发人员使用，用于测试与段相关的代码。