大安市网站,网络建设股票有哪些,html网页游戏制作,自学网站开发设计一、设置参数
1.1 参数名称和值
所有参数名都是大小写不敏感的。每个参数都可以接受五种类型之一的值#xff1a; 布尔、字符串、整数、 浮点数或枚举。该类型决定了设置该参数的语法#xff1a; 布尔: 值可以被写成 on, off, true, false, yes, no, 1, 0 #xff08;都是…一、设置参数
1.1 参数名称和值
所有参数名都是大小写不敏感的。每个参数都可以接受五种类型之一的值 布尔、字符串、整数、 浮点数或枚举。该类型决定了设置该参数的语法 布尔: 值可以被写成 on, off, true, false, yes, no, 1, 0 都是大小写不敏感的或者这些值的任何无歧义前缀。 字符串: 通常值被包括在单引号内值内部的任何单引号都需要被双写。不过如果值是一个简单数字或者 标识符引号通常可以被省略。 数字整数和浮点: 只对浮点参数允许一个小数点。不要使用千位分隔符。不要求引号。 带单位的数字: 一些数字参数具有隐含单位因为它们描述内存或时间量。单位可能是字节、千字节、块通常是 8KB、 毫秒、秒或分钟。这些设置之一的一个未修饰的数字值将使用该设置的默认单位默认单位可以通 过引用pg_settings.unit来找到。为了方便也可以 显式地指定一个不同的单位例如时间值可以是120 ms并且它们将被转换到参数的实际单位。要使用这个特性注意值必须被写成一个字符 串带有引号。单位名称是大小写敏感的并且在数字值和单位之间可以有空白。 可用的内存单位是B字节、kB千字节、MB兆字节和GB吉字节。内存单位的乘数是 1024 而不是 1000。 可用的时间单位是ms毫秒、s秒、min分钟、 h小时和d天。 枚举: 枚举类型的参数以与字符串参数相同的方式指定但被限制到一组有限的值。 这样一个参数可用的值可以在pg_settings.enumvals 中找到。枚举参数值是大小写无关的。
1.2. 通过配置文件影响参数
设置这些参数最基本的方法是编辑postgresql.conf文件 它通常被保存在数据目录中当数据库集簇目录被初始化时一个默认的拷贝将会被安装在那里。一个该文件的例子看起来是
# This is a comment
log_connections yes
log_destination syslog
search_path $user, public
shared_buffers 128MB
每一行指定一个参数。名称和值之间的等号是可选的。空白是无意义的除了在一个引号引用的参数值内并且空行被忽略。井号#指示该行的剩余部分是一个注释。非简单标识符或者数字的参数值必须用单引号包围。要在参数值里嵌入单引号 要么写两个单引号首选或者在引号前放反斜线。
以这种方式设定的参数为集簇提供了默认值。除非这些设置被覆盖活动会话看到的就是这些设置。 下面的小节描述了管理员或用户覆盖这些默认值的方法。
主服务器进程每次收到SIGHUP信号最简单的方法是从命令行运行pg_ctl reload或调用 SQL 函数pg_reload_conf()来发送这个信号后都会重新读取这个配置 文件。主服务器进程还会把这个信号传播给所有正在运行的服务器进程这样现有的会话也能采用新 值要等待它们完成当前正在执行的客户端命令之后才会发生。另外你可以直接向一个单一服务 器进程发送该信号。有些参数只能在服务器启动时设置在配置文件中对这些条目的修改将被忽略 直到下次服务器重启。配置文件中的非法参数设置也会在SIGHUP处理过程中被 忽略但是会记录日志。
除postgresql.conf之外PostgreSQL 数据目录还包含一个文件 postgresql.auto.conf它具有和postgresql.conf相同的格式但是不应该被手工编辑。这个 文件保存了通过ALTER STSTEM命令提供的设置。每当postgresql.conf被读 取时这个文件会被自动读取并且它的设置会以同样的方式生效。 postgresql.auto.conf中的设置会覆盖postgresql.conf 中的设置。
系统视图pg_file_settings可以有助于对配置文件中的更改进行提前测试或者在SIGHUP 信号没有达到预期效果时用来诊断问题。
1.3 通过SQL影响参数
PostgreSQL提供了三个SQL命令来建立配置默认值。 已经提到过的ALTER STSTEM命令提供了一种改变全局默认值的从SQL可 访问的方法它在功效上等效于编辑postgresql.conf。此外还有两个命令 可以针对每个数据库或者每个角色设置默认值 ALTER DATABASE命令允许针对一个数据库覆盖其全局设置。 ALATER ROLE命令允许用用户指定的值来覆盖全局设置和数据库设置。
只有当开始一个新的数据库会话时用ALTER DATABASE和 ALTER ROLE设置的值才会被应用。它们会覆盖从配置文件或服务器命令行 获得的值并且作为该会话后续的默认值。注意某些设置在服务器启动后不能被更改并且因此 不能被这些命令或者下文列举的命令设置。
一旦一个客户端连接到数据库PostgreSQL会提供两个额外的SQL命令 以及等效的函数用以影响会话本地的配置设置 SHOW命令允许察看所有参数的当前值。对应的函数是 current_setting(setting_name text)。 SET命令允许修改对于一个会话可以本地设置的参数的当前值 它对其他会话没有影响。对应的函数是 set_config(setting_name, new_value, is_local)。
此外系统视图pg_settings可以被用来查看和改变 会话本地的值 查询这个视图与使用SHOW ALL相似但是可以提供更多细节。它也更加灵活 因为可以为它指定过滤条件或者把它与其他关系进行连接。 在这个视图上使用UPDATE并且指定更新setting 列其效果等同于发出SET命令。例如下面的命令 SET configuration_parameter TO DEFAULT; 等效于 UPDATE pg_settings SET setting reset_val WHERE name configuration_parameter; 1.4. 通过 Shell 影响参数 除了在数据库或者角色层面上设置全局默认值或者进行覆盖你还可以通过 shell 工具把设置 传递给PostgreSQL。服务器和libpq 客户端库都能通过 shell 接受参数值。 在服务器启动期间可以通过-c命令行参数把参数设置传递给 postgres命令。例如 postgres -c log_connectionsyes -c log_destinationsyslog 这种方式提供的设置会覆盖通过postgresql.conf或者 ALTER SYSTEM提供的设置因此除了重启服务器之外无法从全局上改变它们。 当通过libpq启动一个客户端会话时可以使用PGOPTIONS 环境变量指定参数设置。这种方式建立的设置构成了会话生存期间的默认值但是不会影响 其他的会话。由于历史原因PGOPTIONS的格式和启动 postgres命令时用到的相似特别是-c标志必须被指定。 例如
env PGOPTIONS-c geqooff -c statement_timeout5min psql 通过 shell 或者其他方式其他客户端和库可能提供它们自己的机制以便允许用户在不直接 使用SQL命令的前提下修改会话设置。
1.5. 管理配置文件内容
PostgreSQL提供了一些特性用于把复杂的 postgresql.conf文件分解成子文件。在管理多个具有相关但不完全相同 配置的服务器时这些特性特别有用。
除了单个参数设置postgresql.conf文件可以包含包括指令它指定要读入和处理的另一个文件就好像该文件被插入到配置文件的这个点。这个特性允许一个配置文件被划分成物理上独立的部分。包括指令看起来像
include filename
如果文件名不是一个绝对路径它将作为包含引用配置文件的目录的相对位置。包括可以被嵌套。
也有一个include_if_exists指令它的作用和include指令一样不过当被引用的文件不存在或者无法被读取时其行为不同。一个通常的include将认为这是一个错误情况而include_if_exists仅仅记录一个消息并且继续处理引用配置文件。
postgresql.conf文件也可以包含include_dir指令它指定要被包含的配置文件的一整个目录。它的用法类似 include_dir directory
非绝对目录名被当做包含引用配置文件的目录的相对路径。在该指定目录中只有以后缀名 .conf结尾的非目录文件才会被包括。以. 字符开头的文件名也会被忽略因为在某些平台上它们是隐藏文件。一个包括目录中的多个文件 被以文件名顺序处理根据 C 区域规则排序即数字在字母之前并且大写字母在小写字母 之前。
包括文件或目录可以被用来在逻辑上分隔数据库配置的各个部分而不是用一个很大的postgresql.conf文件。考虑一个有两台数据库服务器的公司每一个都有不同的内存量。很可能配置的元素都会被共享例如用于日志的参数。但是两者关于内存的参数将会不同。并且还可能会有服务器相关的自定义。一种管理这类情况的方法是将你的站点的自定义配置修改分成三个文件。你可以把下面的内容加入到你的postgresql.conf文件末尾来包括它们 include shared.confinclude memory.confinclude server.conf
所有的系统将会有相同的shared.conf。每个有特定内存量的服务器可以共享相同的memory.conf。你可能对所有 8GB 内存的服务器有一个而对那些 16GB 内存的服务器有另一个。并且最后server.conf可以装有真正服务器相关的配置信息。
另一中可能性是创建一个配置文件目录并把这个信息放到其中的文件里。例如一个conf.d目录可以在postgresql.conf的末尾被引用 include_dir conf.d
然后你可以这样命名conf.d目录中的文件 00shared.conf01memory.conf02server.conf
这种命名习惯建立了这些文件将被载入的清晰顺序。这是很重要的因为在服务器读取配置 文件时对于一个特定的参数只有最后碰到的一个设置才会被使用。在这个例子中 conf.d/02server.conf设置的东西将会覆盖在 conf.d/01memory.conf中相同参数的值。
你还可以使用这种配置目录方法在命名文件时更有描述性 00shared.conf01memory-8GB.conf02server-foo.conf
这种形式的安排为每个配置文件变体给定了一个唯一的名称。当多个服务器把它们的配置全部存储在一个位置例如在一个版本控制仓库中时这可以帮助消除歧义在版本控制下存储数据库配置文件是另一个值得考虑的好方法。
二、文件位置
除了已经提到过的postgresql.conf文件之外PostgreSQL还使用另外两个手工编辑的配置文件它们控制客户端认证。默认情况下所有三个配置文件都存放在数据库集簇的数据目录中。 本节描述的参数允许配置文件放在别的地方这么做可以简化管理特别是如果配置文件被独立放置可以很容易保证它得到恰当的备份。
data_directory (string) 指定用于数据存储的目录。这个选项只能在服务器启动时设置。
config_file (string) 指定主服务器配置文件通常叫postgresql.conf。这个参数只能在postgres命令行上设置。
hba_file (string) 指定基于主机认证配置文件通常叫pg_hba.conf。这个参数只能在服务器启动的时候设置。
ident_file (string) 指定用于用户名称映射的配置文件通常叫pg_ident.conf。这个参数只能在服务器启动的时候设。
external_pid_file (string) 指定可被服务器创建的用于管理程序的额外进程 IDPID文件。这个参数只能在服务器启动的时候设置。
在默认安装中不会显式设置以上参数。相反命令行参数-D或者环境变量PGDATA指定数据目录并且上述配置文件都能在数据目录中找到。
如果你想把配置文件放在别的地方而不是数据目录中那么postgres -D命令行选项或者环境变量PGDATA必须指向包含配置文件的目录并且postgresql.conf中或者命令行上的data_directory参数必须显示数据目录实际存放的地方。请注意data_directory将覆盖-D和PGDATA指定的数据目录位置但是不覆盖配置文件的位置。
如果你愿意可以使用选项config_file、hba_file和/或ident_file单独指定配置文件名称和位置。config_file只能在postgres命令行上指定但是其他文件可以在主配置文件中设置。如果所有三个参数外加data_directory被显式地设置则不必指定-D或PGDATA。
在设置任何这些参数时相对路径将被解释为相对于postgres启动路径的路径。
三、连接和认证
3.1. 连接设置
listen_addresses (string) 指定服务器在哪些 TCP/IP 地址上监听客户端连接。值的形式是一个逗号分隔的主机名和/或数字 IP 地址列表。特殊项*对应所有可用 IP 接口。项0.0.0.0允许监听所有 IPv4 地址并且::允许监听所有 IPv6 地址。如果列表为空服务器将根本不会监听任何 IP 接口在这种情况中只能使用 Unix 域套接字来连接它。默认值是localhost它只允许建立本地 TCP/IP “环回”连接。虽然客户端认证允许细粒度地控制谁能访问服务器listen_addresses控制哪些接口接受连接尝试这能帮助在不安全网络接口上阻止重复的恶意连接请求。这个参数只能在服务器启动时设置。
port (integer) 服务器监听的 TCP 端口默认是 5432 。请注意服务器会同一个端口号监听所有的 IP 地址。这个参数只能在服务器启动时设置。
max_connections (integer) 决定数据库的最大并发连接数。默认值通常是 100 个连接但是如果内核设置不支持initdb时决定可能会比这个 数少。这个参数只能在服务器启动时设置。 当运行一个后备服务器时你必须设置这个参数等于或大于主服务器上的参数。否则后备服务器上可能无法允许查询。
superuser_reserved_connections (integer) 决定为PostgreSQL超级用户连接而保留的连接“槽”数。 同时活跃的并发连接最多max_connectionsmax_connections个。任何时候活跃的并发连接数最多为max_connections减去 superuser_reserved_connections新连接就只能由超级用户发起了并且不会有新的复制连接被接受。 默认值是 3 。这个值必须小于max_connections减去max_wal_senders的值。 这个参数只能在服务器启动时设置。
unix_socket_directories (string) 指定服务器用于监听来自客户端应用的连接的 Unix 域套接字目录。通过列出用逗号分隔的多个目录可以建立多个套接字。项之间的空白被忽略如果你需要在名字中包括空白或逗号在目录名周围放上双引号。一个空值指定在任何 Unix 域套接字上都不监听在这种情况中只能使用 TCP/IP 套接字来连接到服务器。默认值通常是/tmp但是在编译时可以被改变。这个参数只能在服务器启动时设置。 除了套接字文件本身名为.s.PGSQL.nnnn其中nnnn是服务器的端口号一个名为.s.PGSQL.nnnn.lock的普通文件会在每一个unix_socket_directories目录中被创建。任何一个都不应该被手工移除。 Windows下没有 Unix 域套接字因此这个参数与 Windows 无关。
unix_socket_group (string) 设置 Unix 域套接字的所属组套接字的所属用户总是启动服务器的用户。可以与选项unix_socket_permissions一起用于对 Unix域连接进行访问控制。默认是一个空字符串表示服务器用户的默认组。这个参数只能在服务器启动时设置。 Windows 下没有 Unix 域套接字因此这个参数与 Windows 无关。
unix_socket_permissions (integer) 设置 Unix 域套接字的访问权限。Unix 域套接字使用普通的 Unix 文件系统权限集。这个参数值应该是数字的形式也就是系统调用chmod和umask接受的 形式如果使用自定义的八进制格式数字必须以一个0零开头。 默认的权限是0777意思是任何人都可以连接。合理的候选是0770只有用户和同组的人可以访问 又见unix_socket_group和0700只有用户自己可以访问请注意对于 Unix 域套接字只有写权限有麻烦因此没有对读取和执行权限的设置和收回。 这个访问控制机制用户认证没有关系。 这个参数只能在服务器启动时设置。 这个参数与完全忽略套接字权限的系统无关尤其是自版本10以上的Solaris。 在那些系统上可以通过把unix_socket_directories指向一个把搜索权限 限制给指定用户的目录来实现相似的效果。 因为 Windows 下没有 Unix 域套接字因此这个参数也与 Windows 无关。
bonjour (boolean) 通过Bonjour广告服务器的存在。默认值是关闭。 这个参数只能在服务器启动时设置。
bonjour_name (string) 指定Bonjour服务名称。空字符串默认值表示使用计算机名。 如果编译时没有打开Bonjour支持那么将忽略这个参数。这个参数只能在服务器启动时设置。
tcp_keepalives_idle (integer) 指定不活动多少秒之后通过 TCP 向客户端发送一个 keepalive 消息。 0 值表示使用默认值。这个参数只有在支持TCP_KEEPIDLE或等效套接字选项的系统或 Windows 上才可以使用。在其他系统上它必须为零。在通过 Unix 域套接字连接的会话中这个参数被忽略并且总是读作零。 注意 在 Windows 上值若为 0系统会将该参数设置为 2 小时因为 Windows 不支持读取系统默认值。 tcp_keepalives_interval (integer) 指定在多少秒之后重发一个还没有被客户端告知已收到的 TCP keepalive 消息。0 值表示使用系统默认值。这个参数只有在支持TCP_KEEPINTVL或等效套接字选项的系统或 Windows 上才可以使用。在其他系统上必须为零。在通过 Unix域套接字连接的会话中这个参数被忽略并总被读作零。 注意 在 Windows 上值若为 0系统会将该参数设置为 1 秒因为 Windows 不支持读取系统默认值。 tcp_keepalives_count (integer) 指定与客户端的服务器连接被认为死掉之前允许丢失的 TCP keepalive 数量。0 值表示使用系统默认值。这个参数只有在支持TCP_KEEPCNT或等效套接字选项的系统上才可以使用。在其他系统上必须为零。在通过 Unix 域套接字连接的会话中这个参数被忽略并总被读作零。 注意 Windows 不支持该参数且必须为零。 3.2. 安全和认证
authentication_timeout (integer) 完成客户端认证的最长时间以秒计。如果一个客户端没有在这段时间里完成 认证协议服务器将关闭连接。这样就避免了出问题的客户端无限制地占有一个连接。默认值是 1分钟1m。这个参数只能在服务器命令行上或者在postgresql.conf文件中设置。
password_encryption (enum) 当在CREATE ROLE或者ALTER ROLE中指定了口令时这个参数决定用于加密该口令的算法。默认值是md5它会将口令存为一个MD5哈希on也会被接受它是md5的别名。将这个参数设置为scram-sha-256将使用SCRAM-SHA-256来加密口令。 注意老的客户端可能缺少对SCRAM认证机制的支持因此无法使用用SCRAM-SHA-256加密的口令。
krb_server_keyfile (string) 设置Kerberos服务器密钥文件的位置。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
krb_caseins_users (boolean) 设置是否应该以大小写不敏感的方式对待GSSAPI用户名。默认值是off大小写敏感。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
db_user_namespace (boolean) 这个参数启用针对每个数据库的用户名。这个参数默认是关掉的。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。 如果这个参数为打开应该把用户创建成usernamedbname的形式。当一个连接客户端传来username时和数据库名会被追加到用户名并且服务器会查找这个与数据库相关的用户名。注意在SQL环境中用含有的名称创建用户时需要把用户名放在引号内。 在这个参数被启用时仍然可以创建平常的全局用户。而在客户端中指定这种用户时只需要简单地追加例如joe。在服务器查找该用户名之前会被剥离掉。 db_user_namespace会导致客户端和服务器的用户名表达形式不同。认证检查总是会以服务器的用户名表达形式来完成因此认证方法必须针对服务器用户名而不是客户端用户名来配置。由于md5方法在客户端和服务器两端都使用用户名作为saltmd5不能与db_user_namespace同时使用。 注意 这种特性的目的是在找到完整的解决方案之前提供一种临时的措施。在找到完整解决方案时这个选项将被去除。 3.3. SSL
ssl (boolean) 启用SSL连接。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。默认值是off。
ssl_ca_file (string) 指定包含 SSL 服务器证书颁发机构CA的文件名。相对路径是相对于数据目录的。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。默认值为空表示没有载入CA文件并且客户端证书验证没有被执行。
ssl_cert_file (string) 指定包含 SSL 服务器证书的文件名。相对路径是相对于数据目录的。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。默认值是server.crt。
ssl_crl_file (string) 指定包含 SSL 服务器证书撤销列表CRL的文件名。其中的相对路径是相对于数据目录的。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。默认值是空表示没有载入CRL文件。
ssl_key_file (string) 指定包含 SSL 服务器私钥的文件名。相对路径是相对于数据目录。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。默认值是server.key。
ssl_ciphers (string) 指定一个SSL密码列表用于安全连接。这个设置的语法和所支持的值列表可以 参见OpenSSL包中的 ciphers手册页。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。默认值是 HIGH:MEDIUM:3DES:!aNULL。默认值通常是一种合理的选择除非用户有特定的安全性需求。 默认值的解释 HIGH 使用来自HIGH组的密码的密码组例如 AES, Camellia, 3DES MEDIUM 使用来自MEDIUM组的密码的密码组例如 RC4, SEED 3DES OpenSSL 对HIGH的默认排序是有问题的因为它认为 3DES 比 AES128 更高。这是错误的因为 3DES 提供的安全性比 AES128 低并且它也更加慢。 3DES把它重新排序在所有其他HIGH和 MEDIUM密码之后。 !aNULL 禁用不做认证的匿名密码组。这类密码组容易收到中间人攻击因此不应被使用。 可用的密码组细节可能会随着 OpenSSL 版本变化。可使用命令 openssl ciphers -v HIGH:MEDIUM:3DES:!aNULL来查看 当前安装的OpenSSL版本的实际细节。注意这个列表是根据服务器密钥类型 在运行时过滤过的。
ssl_prefer_server_ciphers (boolean) 指定是否使用服务器的 SSL 密码首选项而不是用客户端的。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。默认值是true。 老的PostgreSQL版本没有这个设置并且总是使用客户端的首选项。这个设置主要用于与那些版本 的向后兼容性。使用服务器的首选项通常会更好因为服务器更可能会被合适地配置。
ssl_ecdh_curve (string) 指定用在ECDH密钥交换中的曲线名称。它需要被所有连接的客户端支持。 它不需要与服务器椭圆曲线密钥使用的曲线相同。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。默认值是prime256v1。 OpenSSL 命名了最常见的曲线 prime256v1 (NIST P-256)、 secp384r1 (NIST P-384)、 secp521r1 (NIST P-521)。 openssl ecparam -list_curves命令可以显示可用曲线的完 整列表。不过并不是所有的都在TLS中可用。
ssl_dh_params_file (string) 指定含有用于SSL密码的所谓临时DH家族的Diffie-Hellman参数的文件名。默认值为空这种情况下将使用内置的默认DH参数。使用自定义的DH参数可以降低攻击者破解众所周知的内置DH参数的风险。可以用命令openssl dhparam -out dhparams.pem 2048创建自己的DH参数文件。 这个参数只能在 postgresql.conf文件中或服务器命令行上进行设置。
ssl_passphrase_command (string) 设置当需要一个密码例如一个私钥来解密SSL文件时会调用的一个外部命令。默认情况下这个参数为空表示使用内建的提示机制。 该命令必须将密码打印到标准输出并且以代码0退出。在该参数值中%p被替换为一个提示字符串要得到文字%应该写成%%。注意该提示字符串将可能含有空格因此要确保加上适当的引号。如果输出的末尾有单一的新行它会被剥离掉。 该命令实际上并不一定要提示用户输入一个密码。它可以从文件中读取密码、从钥匙链得到密码等等。确保选中的机制足够安全是用户的责任。 这个参数只能在 postgresql.conf文件中或服务器命令行上进行设置。
ssl_passphrase_command_supports_reload (boolean) 这个参数决定在配置重载期间如果一个密钥文件需要口令时是否也调用ssl_passphrase_command设置的密码命令。如果这个参数为假默认那么在重载期间将忽略ssl_passphrase_command如果在此期间需要密码则SSL配置将不会被重载。对于要求一个TTY当服务器正在运行时可能是不可用的来进行提示的命令这种设置是合适的。例如如果密码是从一个文件中得到的将这个参数设置为真可能是合适的。 这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
四、资源消耗
4.1. 内存
shared_buffers (integer) 设置数据库服务器将使用的共享内存缓冲区量。默认通常是 128 兆字节128MB但是如果你的内核设置不支持在initdb时决定那么可以会更少。这个设置必须至少为 128 千字节BLCKSZ的非默认值将改变最小值。不过为了更好的性能通常会使用明显高于最小值的设置。 如果有一个专用的 1GB 或更多内存的数据库服务器一个合理的shared_buffers开始值是系统内存的 25%。即使更大的shared_buffers有效也会造成一些工作负载 但因为PostgreSQL同样依赖操作系统的高速缓冲区将shared_buffers设置为超过 40% 的RAM不太可能比一个小点值工作得更好。为了能把对写大量新的或改变的数据的处理分布在一个较长的时间段内shared_buffers更大的设置通常要求对max_wal_size也做相应增加。 如果系统内存小于 1GB一个较小的 RAM 百分数是合适的这样可以为操作系统留下足够的空间。
huge_pages (enum) 控制是否为主共享内存区域请求巨型页。有效值是try默认、on以及off。如果huge_pages被设置为try则服务器将尝试请求巨型页但是如果失败会退回到默认的方式。如果为on请求巨型页失败将使得服务器无法启动。如果为off则不会请求巨型页。 当前只有Linux和Windows上支持这个设置。在其他系统上这个参数被设置为try时它会被忽略。 巨型页面的使用会导致更小的页面表以及花费在内存管理上的 CPU 时间更少从而提高性能。 巨型页在Windows上被称为大页面。要使用大页面需要为运行PostgreSQL的Windows用户账号分配Lock Pages in Memory的用户权限。可以使用Windows的组策略工具gpedit.msc来分配用户权限Lock Pages in Memory。为了在命令窗口以单进程而不是Windows服务的方式启动数据库服务器命令窗口必须以管理员身份运行或者禁用用户访问控制UAC。当UAC被启用时普通的命令窗口会在启动时收回用户权限Lock Pages in Memory。 注意这种设置仅影响主共享内存区域。Linux、FreeBSD以及Illumos之类的操作系统也能为普通内存分配自动使用巨型页也被称为“超级”页或者“大”页面而不需要来自PostgreSQL的显式请求。在Linux上这被称为“transparent huge pages”THP透明巨型页。已知这种特性对某些Linux版本上的某些用户会导致PostgreSQL的性能退化因此当前并不鼓励使用它与huge_pages的显式使用不同。
temp_buffers (integer) 设置每个数据库会话使用的临时缓冲区的最大数目。这些都是会话的本地缓冲区只用于访问临时表。默认是 8 兆字节8MB。这个设置可以在独立的会话内部被改变但是只有在会话第一次使用临时表之前才能改变 在会话中随后企图改变该值是无效的。 一个会话将按照temp_buffers给出的限制根据需要分配临时缓冲区。如果在一个并不需要大量临时缓冲区的会话里设置一个大的数值 其开销只是一个缓冲区描述符或者说temp_buffers每增加一则增加大概 64 字节。不过如果一个缓冲区被实际使用那么它就会额外消耗 8192 字节或者BLCKSZ字节。
max_prepared_transactions (integer) 设置可以同时处于“prepared”状态的事务的最大数目见PREPARE TRANSACTION。把这个参数设置 为零这是默认设置将禁用预备事务特性。这个参数只能在服务器启动时设置。 如果你不打算使用预备事务可以把这个参数设置为零来防止意外创建预备事务。如果你正在使用预备事务你将希望把max_prepared_transactions至少设置为max_connections一样大因此每一个会话可以有一个预备事务待处理。 当运行一个后备服务器时这个参数必须至少与主服务器上的一样大。否则后备服务器上将不会执行查询。
work_mem (integer) 指定在写到临时磁盘文件之前被内部排序操作和哈希表使用的内存量。该值默认为四兆字节4MB。注意对于一个复杂查询 可能会并行运行好几个排序或者哈希操作每个操作都会被允许使用这个参数指定的内存量然后才会开始写数据到临时文件。同样几个正在运行的会话可能并发进行这样的操作。因此被使用的总内存可能是work_mem值的好几倍在选择这个值时一定要记住这一点。ORDER BY、DISTINCT和归并连接都要用到排序操作。哈希连接、基于哈希的聚集以及基于哈希的IN子查询处理中都要用到哈希表。
maintenance_work_mem (integer) 指定在维护性操作例如VACUUM、CREATE INDEX和ALTER TABLE ADD FOREIGN KEY中使用的 最大的内存量。其默认值是 64 兆字节64MB。因为在一个数据库会话中一个时刻只有一个这样的操作可以被执行并且一个数据库安装通常不会有太多这样的操作并发执行 把这个数值设置得比work_mem大很多是安全的。 更大的设置可以改进清理和恢复数据库转储的性能。 注意当自动清理运行时可能会分配最多达这个内存的autovacuum_max_workers倍因此要小心不要把该默认值设置得太高。 通过独立地设置autovacuum_worker_mem可能会对控制这种情况 有所帮助。
autovacuum_work_mem (integer) 指定每个自动清理工作者进程能使用的最大内存量。其默认值为 -1表示转而使用 autovacuum_worker_mem的值。当运行在其他上下文环境中时 这个设置对VACUUM的行为没有影响。
max_stack_depth (integer) 指定服务器的执行堆栈的最大安全深度。这个参数的理想设置是由内核强制的实际栈尺寸限制ulimit -s所设置的或者本地等价物减去大约一兆字节的安全边缘。需要这个安全边缘是因为在服务器中并非所有例程都检查栈深度只是在关键的可能递规的例程例如表达式计算中才进行检查。默认设置是两兆字节2MB这个值相对比较小并且不可能导致崩溃。但是这个值可能太小了以至于无法执行复杂的函数。只有超级用户可以修改这个设置。 把max_stack_depth参数设置得高于实际的内核限制将意味着一个失控的递归函数可能会导致一个独立的后端进程崩溃。 在PostgreSQL能够检测内核限制的平台上 服务器将不允许把这个参数设置为一个不安全的值。不过并非所有平台都能提供该信息所以我们还是建议你在选择值时要小心。
dynamic_shared_memory_type (enum) 指定服务器应该使用的动态共享内存实现。可能的值是posix用于使用 shm_open分配的 POSIX 共享内存、sysv 用于通过shmget分配的 System V 共享内存、 windows用于 Windows 共享内存、mmap 使用存储在数据目录中的内存映射文件模拟共享内存以及none禁用 这个特性。并非所有平台上都支持所有值平台上第一个支持的选项就是其默认值。 在任何平台上mmap选项都不是默认值通常不鼓励使用它因为操作系统会 反复地把修改过的页面写回到磁盘上从而增加了系统的I/O负载。不过当 pg_dynshmem目录被存储在一个 RAM 盘时或者没有其他共享内存功能可用时 它还是有用的。
4.2. 磁盘
temp_file_limit (integer) 指定一个进程能用于临时文件如排序和哈希临时文件或者用于保持游标的存储文件的最大磁盘空间量。一个试图超过这个限制的事务将被取消。这个值以千字节计并且-1默认值意味着没有限制。只有超级用户能够修改这个设置。 这个设置约束着一个给定PostgreSQL进程在任何瞬间所使用的所有临时文件的总空间。应该注意的是与在查询执行中在幕后使用的临时文件相反显式临时表所用的磁盘空间不被这个设置所限制。
4.3. 内核资源使用
max_files_per_process (integer) 设置每个服务器子进程允许同时打开的最大文件数目。默认是 1000 个文件。如果内核强制一个安全的针对每个进程的限制那么你不用操心这个设置。但是在 一些平台上特别是大多数 BSD 系统如果很多进程都尝试打开很多文件内核将允许独立进程打开比个系统真正可以支持的数目大得多得文件数。如果你发现自己看到了“Too many open files”这样的失败可尝试减小这个设置。这个参数只能在服务器启动时设置。
4.4. 基于代价的清理延迟 在VACUUM和ANALYZE命令的执行过程中系统维持着一个内部计数器来跟踪各种被执行的I/O操作的估算开销。当累计的代价达到一个限制由vacuum_cost_limit指定执行这些操作的进程将按照vacuum_cost_delay所指定的休眠一小段时间。然后它将重置计数器并继续执行。 这个特性的出发点是允许管理员降低这些命令对并发的数据库活动产生的I/O影响。在很多情况下VACUUM和ANALYZE等维护命令能否快速完成并不重要而非常重要的是这些命令不会对系统执行其他数据库操作的能力产生显著的影响。基于代价的清理延迟提供了一种方式让管理员能够保证这一点。 对于手动发出的VACUUM命令该特性默认被禁用。要启用它只要把vacuum_cost_delay变量设为一个非零值。
vacuum_cost_delay (integer) 进程超过代价限制后将休眠的时间长度以毫秒计。其默认值为0这将禁用基于代价的清理延迟特性。正值将启用基于代价的清理。注意在很多系统上实际的休眠延迟单位是10毫秒将vacuum_cost_delay设置成不为10的倍数的值和将它设置为比该值大的10的倍数的效果相同。 在使用基于代价的清理时vacuum_cost_delay的合适值通常很小也许是10或20毫秒。调整清理时资源消耗最好的方法是调整其他清理代价参数。
vacuum_cost_page_hit (integer) 清理一个在共享缓存中找到的缓冲区的估计代价。它表示锁住缓冲池、查找共享哈希表和扫描页内容的代价。默认值为1。
vacuum_cost_page_miss (integer) 清理一个必须从磁盘上读取的缓冲区的代价。它表示锁住缓冲池、查找共享哈希表、从磁盘读取需要的块以及扫描其内容的代价。默认值为10。
vacuum_cost_page_dirty (integer) 当清理修改一个之前干净的块时需要花费的估计代价。它表示再次把脏块刷出到磁盘所需要的额外I/O。默认值为20。
vacuum_cost_limit (integer) 将导致清理进程休眠的累计代价。默认值为200。 注意 有些操作会保持关键性的锁这样可以尽快完成。基于代价的清理延迟在这类操作期间不会发生。因此有可能代价会累计至大大超过指定的限制。为了防止在这种情况下的无意义的长时间延迟实际延迟的计算方式是vacuum_cost_delay * accumulated_balance / vacuum_cost_limit且最大值是vacuum_cost_delay * 4。 4.5. 后台写入器
有一个独立的服务器进程叫做后台写入器它的功能就是发出写“脏”新的或修改过的共享缓冲区的命令。它写出共享缓冲区这样让处理用户查询的服务器进程很少或者永不等待写动作的发生。不过后台写入器确实会增加 I/O 的总负荷因为虽然在每个检查点间隔中一个重复弄脏的页面可能只会写出一次但在同一个间隔中后台写入器可能会把它写出好几次。在这一小节讨论的参数可以被用于调节本地需求的行为。
bgwriter_delay (integer) 指定后台写入器活动轮次之间的延迟。在每个轮次中写入器都会为一定数量的脏缓冲区发出写操作可以用下面的参数控制。然后它就休眠 bgwriter_delay毫秒 然后重复动作。默认值是 200 毫秒200ms。注意在许多系统上休眠延迟的有效解析度是 10 毫秒因此为bgwriter_delay设置一个 不是 10 的倍数的值与把它设置为下一个更高的 10 的倍数是一样的效果。这个选项只能在服务器命令行上或者在postgresql.conf文件中设置。
bgwriter_lru_maxpages (integer) 在每个轮次中不超过这么多个缓冲区将被后台写入器写出。把这个参数设置为零可禁用后台写出注意被一个独立、专用辅助进程管理的检查点不受影响。默认值是 100 个缓冲区。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
bgwriter_lru_multiplier (floating point) 每一轮次要写的脏缓冲区的数目基于最近几个轮次中服务器进程需要的新缓冲区的数目。 最近所需的平均值乘以bgwriter_lru_multiplier可以估算下一轮次中将会需要的缓冲区数目。脏缓冲区将被写出直到有很多干净可重用的缓冲区然而每一轮次中写出的缓冲区数不超过bgwriter_lru_maxpages。 因此设置为 1.0 表示一种“刚刚好的”策略这种策略会写出正好符合预测值的数目的缓冲区。 更大大的值可以为需求高峰提供某种缓冲而更小的值则需要服务进程来处理一些写出操作。默认值是 2.0。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
bgwriter_flush_after (integer) 不管何时 bgwriter 写入了超过bgwriter_flush_after字节尝试强制 OS 把这些写发送到底层存储上。这样做将限制内核页缓存中脏数据的量降低了在检查点末尾发出一个 fsync 时或者 OS 在后台大批量写回数据时卡住的可能性。那常常会导致大幅度压缩的事务延迟但是也有一些情况特别是负载超过shared_buffers但小于 OS 页面高速缓存的性能会降低。这种设置可能会在某些平台上没有效果。合法的范围在0禁用受控写回和2MB之间。Linux 上的默认值是512kB其他平台上是0如果BLCKSZ不是8kB则默认值和最大值会按比例缩放至这个值。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
较小的bgwriter_lru_maxpages和bgwriter_lru_multiplier可以降低由后台写入器造成的额外 I/O 开销。但更可能的是服务器进程将必须自己发出写入操作这会延迟交互式查询。
4.6. 异步行为
effective_io_concurrency (integer) 设置PostgreSQL可以同时被执行的并发磁盘 I/O 操作的数量。调高这个值可以增加任何单个PostgreSQL会话试图并行发起的 I/O 操作的数目。 允许的范围是 1 到 1000或 0 表示禁用异步 I/O 请求。当前这个设置仅影响位图堆扫描。 对于磁盘驱动器这个设置的一个很好的出发点是组成一个被用于该数据库的 RAID 0 条带或 RAID 1 镜像的独立驱动器数量对 RAID 5 而言校验驱动器不计入。但是 如果数据库经常忙于在并发会话中发出的多个查询较低的值可能足以使磁盘阵列繁忙。比保持磁盘繁忙所需的值更高的值只会造成额外的 CPU 开销。SSD 以及其他基于内存的存储常常能处理很多并发请求因此它们的最佳值可能是数百。 异步 I/O 依赖于一个有效的posix_fadvise函数一些操作系统可能没有。 如果不存在这个函数将这个参数设置为除 0 之外的任何东西将导致错误。在一些操作系统上如Solaris虽然提供了这个函数但它不会做任何事情。 在支持的系统上默认值为 1否则为 0。对于一个特定表空间中的表可以通过设定该表空间的同名参数见ALTER TABLESPACE可以覆盖这个值。
max_worker_processes (integer) 设置系统能够支持的后台进程的最大数量。这个参数只能在服务器启动时设置。默认值为 8。 在运行一个后备服务器时你必须把这个参数设置为等于或者高于主控服务器上的值。否则 后备服务器上可能不会允许查询。 在更改这个值时考虑也对max_parallel_workers、max_parallel_maintenance_workers以及max_parallel_workers_per_gather进行调整。
max_parallel_workers_per_gather (integer) 设置单个Gather或者Gather Merge节点能够开始的工作者的最大数量。并行工作者会从max_worker_processes建立的进程池中取得数量由max_parallel_workers限制。注意所要求的工作者数量在运行时可能实际无法被满足。如果这种事情发生该计划将会以比预期更少的工作者运行这可能会不太高效。默认值是2。把这个值设置为0将会禁用并行查询执行。 注意并行查询可能消耗比非并行查询更多的资源因为每一个工作者进程时一个完全独立的进程它对系统产生的影响大致和一个额外的用户会话相同。在为这个设置选择值时以及配置其他控制资源利用的设置例如work_mem时应该把这个因素考虑在内。work_mem之类的资源限制会被独立地应用于每一个工作者这意味着所有进程的总资源利用可能会比单个进程时高得多。例如一个使用 4 个工作者的并行查询使用的 CPU 时间、内存、I/O 带宽可能是不使用工作者时的 5 倍之多。
max_parallel_maintenance_workers (integer) 设置单一工具性命令能够启动的并行工作者的最大数目。当前唯一一种支持使用并行工作者的工具性命令是CREATE INDEX并且只有在构建B-树索引时才能并行。并行工作者从由max_worker_processes创建的进程池中取出数量由max_parallel_workers控制。注意实际在运行时所请求数量的工作者可能不可用。如果发生这种情况工具性操作将使用比预期数量少的工作者运行。默认值为2。将这个值设置为0可以禁用工具性命令对并行工作者的使用。 注意并行工具性命令不应该消耗比同等数量非并行操作更多的内存。这种策略与并行查询不同并行查询的资源限制通常是应用在每个工作者进程上。并行工具性命令把资源限制maintenance_work_mem当作对整个工具性命令的限制而不管其中用到了多少个并行工作者进程。不过并行工具性命令实际上可能仍会消耗更多的CPU资源和I/O带宽。
max_parallel_workers (integer) 设置系统为并行操作所支持的工作者的最大数量。默认值为8。在增加或者减小这个值时也要考虑对max_parallel_maintenance_workers以及max_parallel_wokers_per_gather进行调整。此外要注意将这个值设置得大于max_worker_processes将不会产生效果因为并行工作者进程都是从max_worker_processes所建立的工作者进程池中取出来的。
backend_flush_after (integer) 只要一个后端写入了超过backend_flush_after字节就会尝试强制 OS 把这些写发送到底层存储。这样做将会限制内核页高速缓存中的脏数据数量降低在检查点末尾发出fsync时或者 OS 在后台大批写回数据时卡住的可能性。这常常会导致极大降低的事务延迟但是也有一些情况中特别是负载超过shared_buffers但低于 OS 的页面高速缓存时性能可能会下降。这个设置可能在某些平台上没有效果。合法的范围位于0禁用受控写回和2MB之间。默认是0即没有强制写回。如果BLCKSZ不是8kB最大值会按比例缩放到它。
old_snapshot_threshold (integer) 设置在使用快照时一个快照可以被使用而没有发生snapshot too old错误风险的最小时间。这个参数只能在服务器启动时设置。 如果超过该阈值旧数据将被清理掉。这可以有助于阻止长时间使用的快照造成的快照膨胀。为了阻止由于本来对该快照可见的数据被清理导致的不正确结果当快照比这个阈值更旧并且该快照被用来读取一个该快照建立以来被修改过的页面时将会产生一个错误。 值为-1会禁用这个特性并且这个值是默认值。对于生产工作有用的值可能从几个小时到几天。该设置将被转换成分钟粒度并且小数字例如0或者1min被允许只是因为它们有时对于测试有用。虽然允许高达60d的设置但是请注意很多负载情况下很短的时间帧里就可能发生极大的膨胀或者事务 ID 回卷。 当这个特性被启用时关系末尾的被清出的空间不能被释放给操作系统因为那可能会移除用于检测snapshot too old情况所需的信息。所有分配给关系的空间还将与该关系关联在一起便于重用除非它们被显式地释放例如用VACUUM FULL。 这个设置不会尝试保证在任何特殊情况下都会生成错误。事实上如果例如可以从一个已经物化了一个结果集的游标中生成正确的结果即便被引用表中的底层行已经被清理掉也不会生成错误。某些表不能被过早地安全清除并且因此将不受这个设置的影响例如系统目录。对于这些表这个设置将不能降低膨胀也不能降低在扫描时产生snapshot too old错误的可能性。
五、预写式日志
5.1 设置
wal_level (enum) wal_level决定多少信息写入到 WAL 中。默认值是replica它会写入足够的数据以支持WAL归档和复制包括在后备服务器上运行只读查询。minimal会去掉除从崩溃或者立即关机中进行恢复所需的信息之外的所有记录。最后logical会增加支持逻辑解码所需的信息。每个层次包括所有更低层次记录的信息。这个参数只能在服务器启动时设置。 在minimal级别中某些批量操作的 WAL 日志可以被安全地跳过这可以使那些操作更快。这种优化可以应用的操作包括
CREATE TABLE ASCREATE INDEXCLUSTERCOPY到在同一个事务中被创建或截断的表中 但最少的 WAL 不会包括足够的信息来从基础备份和 WAL 日志中重建数据因此要启用 WAL 归档archive_mode和流复制必须使用replica或更高级别。 在logical层与replica相同的信息会被记录外加上 允许从 WAL 抽取逻辑修改集所需的信息。使用级别 logical将增加 WAL 容量特别是如果为了REPLICA IDENTITY FULL配置了很多表并且执行了很多UPDATE和DELETE 语句时。 在 9.6 之前的版本中这个参数也允许值archive和hot_standby。现在仍然接受这些值但是它们会被映射到replica。
fsync (boolean) 如果打开这个参数PostgreSQL服务器将尝试确保更新被物理地写入到磁盘做法是发出fsync()系统调用或者使用多种等价的方法见wal_sync_method。这保证了数据库集簇在一次操作系统或者硬件崩溃后能恢复到一个一致的状态。 虽然关闭fsync常常可以得到性能上的收益但当发生断电或系统崩溃时可能造成不可恢复的数据损坏。因此只有在能很容易地从外部数据中重建整个数据库时才建议关闭fsync。 能安全关闭fsync的环境的例子包括从一个备份文件中初始加载一个新数据库集簇、使用一个数据库集簇来在数据库被删掉并重建之后处理一批数据或者一个被经常重建并却不用于失效备援的只读数据库克隆。单独的高质量硬件不足以成为关闭fsync的理由。 当把fsync从关闭改成打开时为了可靠的恢复需要强制在内核中的所有被修改的缓冲区进入持久化存储。这可以在多个时机来完成在集簇被关闭时或在 fsync 因为运行initdb --sync-only而打开时、运行sync时、卸载文件系统时或者重启服务器时。 在很多情况下为不重要的事务关闭synchronous_commit可以提供很多关闭fsync的潜在性能收益并不会有的同时 关闭fsync可以提供很多潜在的性能优势而不会有伴随着的数据损坏风险。 fsync只能在postgresql.conf文件中或在服务器命令行上设置。如果你关闭这个参数请也考虑关闭full_page_writes。
synchronous_commit (enum)
指定在命令返回“success”指示给客户端之前一个事务是否需要等待 WAL 记录被写入磁盘。合法的值是on、remote_apply、remote_write、local和off。默认的并且安全的设置是on。当设置为off时在向客户端报告成功和真正保证事务不会被服务器崩溃威胁之间会有延迟最大的延迟是wal_writer_delay的三倍。不同于fsync将这个参数设置为off不会产生数据库不一致性的风险一个操作系统或数据库崩溃可能会造成一些最近据说已提交的事务丢失但数据库状态是一致的就像这些事务已经被干净地中止。因此当性能比完全确保事务的持久性更重要时关闭synchronous_commit可以作为一个有效的代替手段。 如果synchronous_standby_names为非空这个参数也控制事务提交是否将等待它们的 WAL 记录被复制到后备服务器上。当这个参数被设置为on时直到来自于当前同步的后备服务器的回复指示它们已经收到了事务的提交记录并将其刷入了磁盘主服务器上的事务才会提交。这保证事务将不会被丢失除非主服务器和所有同步后备都遭受到了数据库存储损坏的问题。当被设置为remote_apply时提交将会等待直到来自当前的同步后备的回复指示它们已经收到了该事务的提交记录并且已经应用了该事务这样该事务才变得对后备上的查询可见。当这个参数被设置为remote_write时提交将等待直到来自当前的同步后备的回复指示它们已经收到了该事务的提交记录并且已经把该记录写出到它们的操作系统这种设置足以保证数据在后备服务器的PostgreSQL实例崩溃时得以保存但是不能保证后备服务器遭受操作系统级别崩溃时数据能被保持因为数据不一定必须要在后备机上达到稳定存储。最后设置local会导致提交等待本地刷写到磁盘而不是复制完成。在使用同步复制时这通常不是我们想要的效果但是为了完整性还是提供了这样一个选项。 如果synchronous_standby_names为空设置on、remote_apply、remote_write和local都提供了同样的同步级别事务提交只等待本地刷写磁盘。 这个参数可以随时被修改任何一个事务的行为由其提交时生效的设置决定。因此可以同步提交一些事务同时异步提交其他事务。例如当默认是相反时实现一个单一多语句事务的异步提交在事务中发出SET LOCAL synchronous_commit TO OFF。
wal_sync_method (enum)
用来向强制 WAL 更新到磁盘的方法。如果fsync是关闭的那么这个设置就不相关因为 WAL 文件更新将根本不会被强制。可能的值是 open_datasync用open()选项O_DSYNC写 WAL 文件 fdatasync在每次提交时调用fdatasync() fsync在每次提交时调用fsync() fsync_writethrough在每次提交时调用fsync()强制任何磁盘写高速缓存的直通写 open_sync用open()选项O_SYNC写 WAL 文件 open_* 选项也可以使用O_DIRECT如果可用。不是在所有平台上都能使用所有这些选择。默认值是列表中第一个被平台支持的那个 不过fdatasync是 Linux 中的默认值。默认值不一定是最理想的有可能需要修改这个设置或系统配置的其他方面来创建一个崩溃-安全的配置或达到最佳性能。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
full_page_writes (boolean) 当这个参数为打开时PostgreSQL服务器在一个检查点之后的页面的第一次修改期间将每个页面的全部内容写到 WAL 中。这么做是因为在操作系统崩溃期间正在处理的一次页写入可能只有部分完成从而导致在一个磁盘页面中混合有新旧数据。在崩溃后的恢复期间通常存储在 WAL 中的行级改变数据不足以完全恢复这样一个页面。存储完整的页面映像可以保证页面被正确存储但代价是增加了必须被写入 WAL 的数据量因为 WAL 重放总是从一个检查点开始所以在检查点后每个页面的第一次改变时这样做就够了。因此一种减小全页面写开销的方法是增加检查点间隔参数值。 把这个参数关闭会加快正常操作但是在系统失败后可能导致不可恢复的数据损坏或者静默的数据损坏。其风险类似于关闭fsync 但是风险较小。并且只有在可关闭fsync的情况下才应该关闭它。 关闭这个选项并不影响用于时间点恢复PITR的 WAL 归档使用。 这个参数只能在postgresql.conf文件中或在服务器命令行上设置。默认值是on。
wal_log_hints (boolean) 当这个参数为on时PostgreSQL服务器一个检查点之后页面被第一次修改期间把该磁盘页面的整个内容都写入 WAL即使对所谓的提示位做非关键修改也会这样做。 如果启用了数据校验和提示位更新总是会被 WAL 记录并且这个设置会被忽略。你可以使用这个 设置测试如果你的数据库启用了数据校验和会有多少额外的 WAL 记录发生。 这个参数只能在服务器启动时设置。默认值是off。
wal_compression (boolean) 当这个参数为on时如果full_pages_writes 为打开或者处于基础备份期间PostgreSQL服务器 会压缩写入到 WAL 中的完整页面镜像。压缩页面镜像将在 WAL 重放时 被解压。默认值为off。只有超级用户可以更改这个设置。 打开这个参数可以减小 WAL 所占的空间且无需承受不可恢复的数据损坏风险 但是代价是需要额外的 CPU 开销以便在 WAL 记录期间进行压缩以及在 WAL 重放时解压。
wal_buffers (integer) 用于还未写入磁盘的 WAL 数据的共享内存量。默认值 -1 选择等于shared_buffers的 1/32 的尺寸大约3%但是不小于64kB也不大于 WAL 段的尺寸通常为。如果自动的选择太大或太小可以手工设置该值但是任何小于32kB的正值都将被当作32kB。这个参数只能在服务器启动时设置。 在每次事务提交时WAL 缓冲区的内容被写出到磁盘因此极大的值不可能提供显著的收益。不过把这个值设置为几个兆字节可以在一个繁忙的服务器其中很多客户端会在同一时间提交上提高写性能。由默认设置 -1 选择的自动调节将在大部分情况下得到合理的结果。
wal_writer_delay (integer) 指定 WAL 写入器刷写 WAL 的频繁程度。在刷写 WAL 之后它会睡眠wal_writer_delay毫秒除非被一个异步提交事务唤醒。假如上一次刷写发生在少于wal_writer_delay毫秒以前并且从上一次刷写发生以来产生了少于wal_writer_flush_after字节的 WAL则WAL将只被写入到操作系统而不是被刷到磁盘。默认值是 200 毫秒200ms。注意在很多系统上有效的睡眠延迟粒度是 10 毫秒把wal_writer_delay设置为一个不是 10 的倍数的值其效果和把它设置为大于该值的下一个 10 的倍数产生的效果相同。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
wal_writer_flush_after (integer) 指定 WAL 写入器刷写 WAL 的频繁程度。如果上一次刷写发生在少于wal_writer_delay毫秒以前并且从上一次刷写发生以来产生了少于wal_writer_flush_after字节的 WAL则WAL将只被写入到操作系统而不是被刷到磁盘。如果wal_writer_flush_after被设置为0则WAL数据会被立即刷写。默认是1MB。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
commit_delay (integer) 在一次 WAL 刷写被发起之前commit_delay增加一个时间延迟以微妙计。如果系统负载足够高使得在一个给定间隔内有额外的事务准备好提交那么通过允许更多事务通过一个单次 WAL 刷写来提交能够提高组提交的吞吐量。但是它也把每次 WAL 刷写的潜伏期增加到了最多commit_delay微秒。因为如果没有其他事务准备好提交就会浪费一次延迟只有在当一次刷写将要被发起时有至少commit_siblings个其他活动事务时才会执行一次延迟。另外如果fsync被禁用则将不会执行任何延迟。默认的commit_delay是零无延迟。只有超级用户才能修改这个设置。 在PostgreSQL的 9.3 发布之前commit_delay的行为不同并且效果更差它只影响提交而不是所有 WAL 刷写并且即使在 WAL 刷写马上就要完成时也会等待一整个配置的延迟。从PostgreSQL 9.3 中开始第一个准备好刷写的进程会等待配置的间隔而后续的进程只等到领先者完成刷写操作。
commit_siblings (integer) 在执行commit_delay延迟时要求的并发活动事务的最小数目。大一些的值会导致在延迟间隔期间更可能有至少另外一个事务准备好提交。默认值是五个事务。
5.2. 检查点
checkpoint_timeout (integer) 自动 WAL 检查点之间的最长时间以秒计。合理的范围在 30 秒到 1 天之间。默认是 5 分钟5min。增加这个参数的值会增加崩溃恢复所需的时间。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
checkpoint_completion_target (floating point) 指定检查点完成的目标作为检查点之间总时间的一部分。默认是 0.5。 这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
checkpoint_flush_after (integer) 在执行检查点时只要有checkpoint_flush_after字节被写入就尝试强制 OS 把这些写发送到底层存储。这样做将会限制内核页面高速缓存中的脏数据数量降低在检查点末尾发出fsync或者 OS 在后台大批量写回数据时被卡住的可能性。那常常会导致大幅度压缩的事务延迟但是也有一些情况特别是负载超过shared_buffers但小于 OS 页面高速缓存的性能会降低。这种设置可能会在某些平台上没有效果。合法的范围在0禁用强制写回和2MB之间。Linux 上的默认值是256kB其他平台上是0如果BLCKSZ不是8kB则默认值和最大值会按比例缩放到它。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
checkpoint_warning (integer) 如果由于填充WAL段文件导致的检查点之间的间隔低于这个参数表示的秒数那么就向服务器日志写一个消息它建议增加max_wal_size的值。默认值是 30 秒30s。零则关闭警告。如果checkpoint_timeout低于checkpoint_warning则不会有警告产生。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
max_wal_size (integer) 在自动 WAL 检查点之间允许 WAL 增长到的最大尺寸。这是一个软限制 在特殊的情况下 WAL 尺寸可能会超过max_wal_size 例如在重度负荷下、archive_command失败或者高的 wal_keep_segments设置。默认为 1 GB。增加这个参数 可能导致崩溃恢复所需的时间。这个参数只能在postgresql.conf 或者服务器命令行中设置。
min_wal_size (integer) 只要 WAL 磁盘用量保持在这个设置之下在检查点时旧的 WAL 文件总是 被回收以便未来使用而不是直接被删除。这可以被用来确保有足够的 WAL 空间被保留来应付 WAL 使用的高峰例如运行大型的批处理任务。 默认是 80 MB。这个参数只能在postgresql.conf 或者服务器命令行中设置。
5.3. 归档
archive_mode (enum) 当启用archive_mode时可以通过设置 archive_command命令将完成的 WAL 段发送到 归档存储。除用于禁用的off之外还有两种模式 on和always。在普通操作期间这两种模式之间 没有区别但是当设置为always时WAL 归档器在归档恢复 或者后备模式下也会被启用。在always模式下所有从归档恢复 的或者用流复制传来的文件将被再次归档。 archive_mode和archive_command是独立的变量这样可以在不影响归档模式的前提下修改archive_command。这个参数只能在服务器启动时设置。当wal_level被设置为minimal时archive_mode不能被启用。
archive_command (string) 本地 shell 命令被执行来归档一个完成的 WAL 文件段。字符串中的任何%p被替换成要被归档的文件的路径名 而%f只被文件名替换路径名是相对于服务器的工作目录 即集簇的数据目录。如果要在命令里嵌入一个真正的%字符可以使用%%。有一点很重要该命令只在成功时返回一个零作为退出状态。 这个参数只能在postgresql.conf文件中或在服务器命令行上设置。除非服务器启动时启用了archive_mode否则它会被忽略。如果archive_mode被启用时archive_command是一个空字符串默认WAL 归档会被临时禁用但服务器仍会继续累计 WAL 段文件期待着一个命令被提供。将archive_command设置为一个只返回真但不做任何事的命令例如/bin/true或 Windows 上的REM实际上会禁用归档也会打破归档恢复所需的 WAL 文件链因此只有在极少数情况下才能用。
archive_timeout (integer)
archive_command archive_command仅在已完成的 WAL 段上调用。因此如果你的服务器只产生很少的 WAL 流量或产生流量的周期很长那么在事务完成和它被安全地记录到归档存储之间将有一个很长的延迟。为了限制未归档数据存在的时间你可以设置archive_timeout来强制服务器来周期性地切换到一个新的 WAL 段文件。当这个参数被设置为大于零时只要从上次段文件切换后过了参数所设置的那么多秒并且已经有过任何数据库活动包括一个单一检查点服务器将切换到一个新的段文件如果没有数据库活动则会跳过检查点。注意由于强制切换而提早关闭的被归档文件仍然与完整的归档文件长度相同。因此使用非常短的archive_timeout是不明智的 — 它将占用巨大的归档存储。一分钟左右的archive_timeout设置通常比较合理。如果你希望数据能被更快地从主服务器上复制下来你应该考虑使用流复制而不是归档。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
六、复制
这些设置控制内建流复制特性的行为。服务器将可以是主控服务器或后备服务器。主控机能发送数据而后备机总是被复制数据的接收者。当使用级联复制时后备服务器也可以是发送者同时也是接收者。这些参数主要用于发送服务器和后备服务器尽管某些只在主服务器上有意义。如果有必要设置可以在集群中变化而不出问题。
6.1. 发送服务器 这些参数可以在任何发送复制数据给一个或多个后备服务器的服务器上设置。主控机总是一个发送服务器因此这些参数总是要在主控机上设置。这些参数的角色和含义不会在一个后备机变成主控机后改变。
max_wal_senders (integer) 指定来自后备服务器或流式基础备份客户端的并发连接的最大数量即同时运行 WAL 发送进程 的最大数。默认值是10。值0意味着禁用复制。WAL 发送进程被计算在连接总数内因此该参数的值必须小于max_connections减去superuser_reserved_connections的值。突然的流客户端断开 连接可能留下一个孤立连接槽知道达到超时因此这个参数应该设置得略高于最大客户端 连接数这样断开连接的客户端可以立刻重新连接。这个参数只能在服务器启动时被设置。此外wal_level必须设置为replica或更高级别以允许来自后备服 务器的连接。
max_replication_slots (integer) 指定服务器可以支持的复制槽 最大数量。默认值为10。这个参数只能在服务器启动时设置。将它设置为一个比当前已有复制槽要少的值会阻碍服务器启动。此外要允许使用复制槽 wal_level必须被设置为replica或 更高。
wal_keep_segments (integer) 指定在后备服务器需要为流复制获取日志段文件的情况下pg_wal目录下所能保留的过去日志文件段的最小数目。每个段通常是 16 兆字节。如果一个连接到发送服务器的后备服务器落后了超过wal_keep_segments个段发送服务器可以移除一个后备机仍然需要的 WAL 段在这种情况下复制连接将被中断。最终结果是下行连接也将最终失败不过如果在使用 WAL 归档后备服务器可以通过从归档获取段来恢复。 只设置pg_wal中保留的文件段的最小数目系统可能需要为 WAL 归档或从一个检查点恢复保留更多段。如果wal_keep_segments为零默认值 更多的空间来 存放WAL归档或从一个检查点恢复。如果wal_keep_segments是零缺省 系统不会为后备目的保留任何多余的段因此后备服务器可用的旧 WAL 段的数量是一个上个检查点位置和 WAL 归档状态的函数。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
wal_sender_timeout (integer) 中断那些停止活动超过指定毫秒数的复制连接。这对发送服务器检测一个后备机崩溃或网络中断有用。零值将禁用该超时机制。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。默认值是 60 秒。
track_commit_timestamp (boolean) 记录事务的提交时间。这个参数只能在postgresql.conf 文件中或在服务器命令行上设置。默认值是off。
6.2. 主服务器
这些参数可以在发送复制数据给一个或多个后备服务器的主控/主要服务器上设置。注意除了这些参数之外在主控服务器上必须设置合适的wal_level并且也启用可选的 WAL 归档。这些参数值与后备服务器无关尽管你可能希望为了准备好一个后备机转变成主控机来设置这些参数。
synchronous_standby_names (string) 这个参数指定一个支持同步复制的后备服务器的列表。可能会有一个或者多个活动的同步后备服务器在这些后备服务器确认收到它们的数据之后等待提交的事务将被允许继续下去。同步后备服务器是那些名字出现在这个列表前面并且当前已连接并且正在实时流传输数据如pg_stat_replication视图中streaming的状态所示的服务器。指定多于一台同步后备可以得到非常高的可用性并且能防止数据丢失。 用于这一目的的后备服务器的名称是其application_name设置它在后备服务器的连接信息中设置。在物理复制后备的情况下这应该被设置在recovery.conf文件的primary_conninfo设置中默认是walreceiver。对于逻辑复制可以在订阅的连接信息中设置。对于其他复制流消费者请参考其文档。 这个参数使用下面的语法之一来指定一个后备服务器列表 [FIRST] num_sync ( standby_name [, ...] )
ANY num_sync ( standby_name [, ...] )
standby_name [, ...] 其中num_sync是事务需要等待其回复的同步后备服务器的数量standby_name是一个后备服务器的名称。FIRST以及ANY指定从所列服务器中选取同步后备的方法。 关键词FIRST加上num_sync指定一种基于优先的同步复制并且会让事务提交等待直到它们的WAL记录被复制到基于优先级选择的num_sync台同步后备上为止。例如设置FIRST 3 (s1, s2, s3, s4)将导致每次提交都等待来自三台较高优先级的后备机的答复这三台后备机将从后备服务器s1、s2、s3以及s4中选出。在该列表中出现较早的后备服务器将被给予较高的优先级并且将被考虑为同步后备。列表中出现的其他后备服务器表示潜在的同步后备。如果当前的任何同步后备因为某种原因断开连接它将立刻被下一个最高优先级的后备服务器替代。关键词FIRST是可选的。 关键词ANY加上num_sync指定一种基于规定数量的同步复制并且会让事务提交等待直到它们的WAL记录被复制到所列出后备服务器中的至少num_sync台上为止。例如设置ANY 3 (s1, s2, s3, s4)将导致每次提交会在收到s1、s2、s3以及s4中任意三台后备服务器的回答后立刻继续下去。 FIRST和ANY是大小写不敏感的。如果这些关键词被用作后备服务器的名字其standby_name必须被放在双引号内。 PostgreSQL版本 9.6 之前使用过第三种语法目前也仍然支持。它和FIRST和num_sync等于1的第一种语法相同。例如FIRST 1 (s1, s2)和s1, s2具有相同的含义s1或者s2会被选中作为同步后备服务器。 特殊项*匹配任意后备名称。 没有机制强制后备服务器名称的唯一性。在出现重复的情况下匹配的后备之一将被认为是较高优先级不过无法弄清到底是哪一个。 注意 每一个standby_name都应该具有合法 SQL 标识符的形式除非它是*。如果必要你可以使用双引号。但是注意在比较standby_name和后备机应用程序名称时是大小写不敏感的不管有没有双引号。 如果这里没有指定同步后备机名称那么同步复制不能被启用并且事务提交将不会等待复制。这是默认的配置。即便当同步复制被启用时个体事务也可以被配置为不等待复制做法是将synchronous_commit参数设置为local或off。
这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
vacuum_defer_cleanup_age (integer) 指定VACUUM和HOT更新在清除死亡行版本之前应该推迟多久以事务数量计。默认值是零个事务表示死亡行版本将被尽可能快地清除即当它们不再对任何打开的事务可见时尽快清除。在一个支持热后备服务器的主服务器上你可能希望把这个参数设置为一个非零值。这允许后备机上的查询有更多时间来完成而不会由于先前的行清除产生冲突。但是由于该值是用在主服务器上发生的写事务的数目衡量的很难预测对后备机查询可用的附加时间到底是多少。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。 你也可以考虑设置后备服务器上的hot_standby_feedback作为使用这个参数的一种替代方案。 这无法阻止已经达到old_snapshot_threshold所指定年龄的死亡行被清除。
6.3. 后备服务器
这些设置空值接收复制数据的一个后备服务器的行为。它们的值与主服务器无关。
hot_standby (boolean) 指定在恢复期间你是否能够连接并运行查询。默认值是on。这个参数只能在服务器启动时设置。它只在归档恢复期间或后备机模式下才有效。
max_standby_archive_delay (integer) 当热后备机处于活动状态时这个参数决定取消那些与即将应用的 WAL 项冲突的后备机查询之前后备服务器应该等待多久。当 WAL 数据被从 WAL 归档并且因此不是当前的 WAL时max_standby_archive_delay可以应用。默认值是 30 秒。如果没有指定衡量单位是毫秒。值 -1 允许后备机一直等到冲突查询结束。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。 注意max_standby_archive_delay与取消之前一个查询能够运行的最长时间不同它表示应用任何一个 WAL 段数据能够被允许的最长总时间。因此如果一个查询早于 WAL 段导致了显著的延迟后续冲突查询将只有更少的时间。
max_standby_streaming_delay (integer) 当热后备机处于活动状态时这个参数决定取消那些与即将应用的 WAL 项冲突的后备机查询之前后备服务器应该等待多久。当 WAL 数据正在通过流复制被接收时max_standby_streaming_delay可以应用。默认值是 30 秒。如果没有指定衡量单位是毫秒。值 -1 允许后备机一直等到冲突查询结束。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。 注意max_standby_streaming_delay与取消之前一个查询能够运行的最长时间不同它表示在从主服务器接收到 WAL 数据并立刻应用它能够被允许的最长总时间。因此如果一个查询导致了显著的延迟后续冲突查询将只有更少的时间直到后备服务器再次赶上进度。
wal_receiver_status_interval (integer) 指定在后备机上的 WAL 接收者进程向主服务器或上游后备机发送有关复制进度的信息的最小频度它可以使用pg_stat_replication视图看到。后备机将报告它已经写入的上一个预写式日志位置、它已经刷到磁盘的上一个位置以及它已经应用的最后一个位置。这个参数的值是报告之间的最大间隔以秒计。每次写入或刷出位置改变时会发送状态更新或者至少按这个参数的指定的频度发送。因此应用位置可能比真实位置略微滞后。将这个参数设置为零将完全禁用状态更新。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。默认值是 10 秒。
hot_standby_feedback (boolean) 指定一个热后备机是否将会向主服务器或上游后备机发送有关于后备机上当前正被执行的查询的反馈。这个参数可以被用来排除由于记录清除导致的查询取消但是可能导致在主服务器上用于某些负载的数据库膨胀。反馈消息的发送频度不会高于每个wal_receiver_status_interval周期发送一次。默认值是off。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。 如果使用级联复制反馈将被向上游传递直到它最后到达主服务器。后备机在接收到反馈之后除了传递给上游不会做任何其他操作。 这个设置不会覆盖主服务器上的old_snapshot_threshold的行为后备服务器上一个超过了主服务器年龄阈值的快照可能会变得不可用导致后备服务器上事务的取消。这是因为old_snapshot_threshold是为了对死亡行能够存在的时间给出一个绝对限制不然就会因为一个后备服务器的配置而被违背。
wal_receiver_timeout (integer) 中止处于非活动状态超过指定毫秒数的复制链接。这对于正在接收的后备服务器检测主服务器崩溃或网络断开有用。值零会禁用超时机制。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。默认值是 60 秒。
wal_retrieve_retry_interval (integer) 指定当从任何来源流复制、本地pg_wal或者 WAL 归档都得不到 WAL 数据时后备服务器应该等待多久才去重新尝试 获取 WAL 数据。这个参数只能在postgresql.conf文件 或者服务器命令行中设置。默认值是 5 秒。如果没有指定则单位是毫秒。 这个参数对恢复中的节点需要为新 WAL 数据可用等待多少时间的配置有用。 例如在归档恢复中通过减小这个参数的值可以让恢复更积极地检测新的 WAL 日志文件。在一个 WAL 活动较低的系统上增加这个参数的值可以减 少访问 WAL 归档所必需的请求数量这对于例如云环境是有用的在其中 对于基础设施的访问时间也是被考虑的。
6.4. 订阅者 这些设置控制逻辑复制订阅者的行为。它们在发布者上的值与此无关。 注意配置参数wal_receiver_timeout、wal_receiver_status_interval以及wal_retrieve_retry_interval也影响逻辑复制工作者。
max_logical_replication_workers (int) 指定逻辑复制工作者的最大数目。这同时包括应用工作者和表同步工作者。 逻辑复制工作者是从max_worker_processes定义的池中取出的。 默认值是4。
max_sync_workers_per_subscription (integer) 每个订阅的同步工作者的最大数目。这个参数控制订阅初始化期间或者新表增加时的初始数据拷贝的并行度。 当前每个表只能有一个同步工作者。 同步工作者是从max_logical_replication_workers定义的池中取出的。 默认值为2。
七、查询规划
7.1 规划器方法配置
这些配置参数提供了影响查询优化器选择查询规划的原始方法。如果优化器 为特定的查询选择的缺省规划并不是最优那么我们就可以通过使用这些 配置参数强制优化器选择一个更好的规划来temporary解决这个 问题。不过永久地关闭这些设置几乎从不是个好主意。更好的改善优化器 选择规划的方法包括调节Section 18.6.2、 更频繁运行ANALYZE、增大配置参数 default_statistics_target的值、使用 ALTER TABLE SET STATISTICS为某个字段增加收集的 统计信息。 这些配置参数影响查询优化器选择查询计划的暴力方法。如果优化器为一个特定查询选择的默认计划不是最优的一种临时解决方案是使用这些配置参数之一来强制优化器选择一个不同的计划。提高优化器选择的计划质量的更好的方式包括调整规划器的代价常数、手工运行ANALYZE、增加default_statistics_target配置参数的值以及使用ALTER TABLE SET STATISTICS增加为特定列收集的统计信息量。
enable_bitmapscan (boolean) 允许或禁止查询规划器使用位图扫描计划类型。默认值是on。
enable_gathermerge (boolean) 启用或者禁用查询规划器对收集归并计划类型的使用。默认值是on。
enable_hashagg (boolean) 允许或禁用查询规划器使用哈希聚集计划类型。默认值是on。
enable_hashjoin (boolean) 允许或禁止查询规划器使用哈希连接计划类型。默认值是on。
enable_indexscan (boolean) 允许或禁止查询规划器使用索引扫描计划类型。默认值是on。
enable_indexonlyscan (boolean) 允许或禁止查询规划器使用只用索引扫描计划类型。默认值是on。
enable_material (boolean) 允许或者禁止查询规划器使用物化。它不可能完全禁用物化但是关闭这个变量将阻止规划器插入物化节点除非为了保证正确性。默认值是on。
enable_mergejoin (boolean) 允许或禁止查询规划器使用归并连接计划类型。默认值是on。
enable_nestloop (boolean) 允许或禁止查询规划器使用嵌套循环连接计划。它不可能完全禁止嵌套循环连接但是关闭这个变量将使得规划器尽可能优先使用其他方法。默认值是on。
enable_parallel_append (boolean) 允许或禁止查询规划器使用并行追加计划类型。默认值是on。
enable_parallel_hash (boolean) 允许或禁止查询规划器对并行哈希使用哈希连接计划类型。如果哈希连接计划也没有启用这个参数没有效果。默认值是on。
enable_partition_pruning (boolean) 允许或者禁止查询规划器从查询计划中消除一个分区表的分区。这也控制着规划器产生允许执行器在查询执行期间移除忽略分区的查询计划的能力。默认值是on。
enable_partitionwise_join (boolean) 允许或者禁止查询规划器使用面向分区的连接这使得分区表之间的连接以连接匹配的分区的方式来执行。面向分区的连接当前只适用于连接条件包括所有分区键的情况连接条件必须是相同的数据类型并且子分区集合要完全匹配。由于面向分区的连接规划在规划期间会使用可观的CPU时间和内存所以默认值为off。
enable_partitionwise_aggregate (boolean) 允许或者禁止查询规划器使用面向分区的分组或聚集这使得在分区表上的分组或聚集可以在每个分区上分别执行。如果GROUP BY子句不包括分区键只有部分聚集能够以基于每个分区的方式执行并且finalization必须最后执行。由于面向分区的分组或聚集在规划期间会使用可观的CPU时间和内存所以默认值为off。
enable_seqscan (boolean) 允许或禁止查询规划器使用顺序扫描计划类型。它不可能完全禁止顺序扫描但是关闭这个变量将使得规划器尽可能优先使用其他方法。默认值是on。
enable_sort (boolean) 允许或禁止查询规划器使用显式排序步骤。它不可能完全禁止显式排序但是关闭这个变量将使得规划器尽可能优先使用其他方法。默认值是on。
enable_tidscan (boolean) 允许或禁止查询规划器使用TID扫描计划类型。默认值是on。
7.2. 规划器代价常量
这一节中描述的代价变量可以按照任意尺度衡量。我们只关心它们的相对值将它们以相同的因子缩放不会影响规划器的选择。默认情况下这些代价变量是基于顺序页面获取的代价的即seq_page_cost被设置为1.0并且其他代价变量都参考它来设置。不过你可以使用你喜欢的不同尺度例如在一个特定机器上的真实执行时间。 注意 不幸的是没有一种良定义的方法来决定代价变量的理想值。它们最好被作为一个特定安装将接收到的查询的平均值来对待。这意味着基于少量的实验来改变它们是有风险的。 seq_page_cost (floating point)
设置规划器计算一次顺序磁盘页面抓取的开销。默认值是1.0。 通过设置同名的表空间参数这个值可以重写为一个特定的表空间。 参阅ALTER TABLESPACE。 设置规划器对一系列顺序磁盘页面获取中的一次的代价估计。默认值是 1.0。通过把表和索引放在一个特殊的表空间要设置该表空间的同名参数中可以覆盖这个值见ALTER TABLESPACE。
random_page_cost (floating point)
设置规划器对一次非顺序获取磁盘页面的代价估计。默认值是 4.0。通过把表和索引放在一个特殊的表空间要设置该表空间的同名参数中可以覆盖这个值见ALTER TABLESPACE。
减少这个值相对于seq_page_cost将导致系统更倾向于索引扫描提高它将让索引扫描看起来相对更昂贵。你可以一起提高或降低两个值来改变磁盘 I/O 代价相对于 CPU 代价的重要性后者由下列参数描述。
对磁盘存储的随机访问通常比顺序访问要贵不止四倍。但是由于对磁盘的大部分随机访问例如被索引的读取都被假定在高速缓冲中进行所以使用了一个较低的默认值4.0。默认值可以被想成把随机访问建模为比顺序访问慢 40 倍而期望 90% 的随机读取会被缓存。
如果你相信 90% 的缓冲率对你的负载是一个不正确的假设你可以增加 random_page_cost 来更好的反映随机存储读取的真正代价。相应地如果你的数据可以完全放在高速缓存中例如当数据库小于服务器总内存时降低 random_page_cost 可能是合适的。为具有很低的随机读取代价的存储例如固态驱动器采用较低的 random_page_cost 值可能更好。 提示 虽然允许你将random_page_cost设置的比 seq_page_cost小但是物理上的实际情况并不受此影响。 然而当所有数据库都位于内存中时两者设置为相等是非常合理的因为 在此情况下乱序抓取并不比顺序抓取开销更大。同样在缓冲率很高的 数据库上你应当相对于 CPU 开销同时降低这两个值因为获取内存中 的页比通常情况下的开销小许多。 尽管系统可以是你把random_page_cost设置得小于seq_page_cost但是实际上没有意义。不过如果数据库被整个缓存在 RAM 中将它们设置为相等是有意义的因为在那种情况中不按顺序访问页面是没有惩罚值的。同样在一个高度缓存化的数据库中你应该相对于 CPU 参数降低这两个值因为获取一个已经在 RAM 中的页面的代价要远小于通常情况下的代价。 cpu_tuple_cost (floating point)
设置规划器对一次查询中处理每一行的代价估计。默认值是 0.01。
cpu_index_tuple_cost (floating point)
设置规划器对一次索引扫描中处理每一个索引项的代价估计。默认值是 0.005。
cpu_operator_cost (floating point)
设置规划器对于一次查询中处理每个操作符或函数的代价估计。默认值是 0.0025。
parallel_setup_cost (floating point)
设置规划器对启动并行工作者进程的代价估计。默认是 1000。
parallel_tuple_cost (floating point)
设置规划器对于从一个并行工作者进程传递一个元组给另一个进程的代价估计。默认是 0.1。
min_parallel_table_scan_size (integer)
为必须扫描的表数据量设置一个最小值扫描的表数据量超过这一个值才会考虑使用并行扫描。对于并行顺序扫描被扫描的表数据量总是等于表的尺寸但是在使用索引时被扫描的表数据量通常会更小。默认值是8兆字节8MB。
min_parallel_index_scan_size (integer)
为必须扫描的索引数据量设置一个最小值扫描的索引数据量超过这一个值时才会考虑使用并行扫描。注意并行索引扫描通常并不会触及整个索引它是规划器认为该扫描会实际用到的相关页面的数量。默认值是512千字节512kB。
effective_cache_size (integer)
设置规划器对一个单一查询可用的有效磁盘缓冲区尺寸的假设。这个参数会被考虑在使用一个索引的代价估计中更高的数值会使得索引扫描更可能被使用更低的数值会使得顺序扫描更可能被使用。在设置这个参数时你还应该考虑PostgreSQL的共享缓冲区以及将被用于PostgreSQL数据文件的内核磁盘缓冲区尽管有些数据可能在两个地方都存在。另外还要考虑预计在不同表上的并发查询数目因为它们必须共享可用的空间。这个参数对PostgreSQL分配的共享内存尺寸没有影响它也不会保留内核磁盘缓冲它只用于估计的目的。系统也不会假设在查询之间数据会保留在磁盘缓冲中。默认值是 4吉字节4GB。
jit_above_cost (floating point)
设置激活JIT编译的查询代价如果查询代价超过这个值就会激活JIT编译。执行JIT会消耗一些规划时间但是能够加速查询执行。将这个值设置为-1会禁用JIT编译。默认值是100000。
jit_inline_above_cost (floating point)
设置JIT编译尝试内联函数和操作符的查询代价阈值如果查询代价超过这个值JIT编译就会尝试内联。内联会增加规划时间但是可以提高执行速度。将这个参数设置成小于jit_above_cost是没有意义的。将这个参数设置为-1会禁用内联。默认值是500000。
jit_optimize_above_cost (floating point)
设置JIT编译应用优化的查询代价阈值如果查询代价超过这个值JIT编译就会应用开销较大的优化。这类优化会增加规划时间但是更能够改进执行速度。将这个参数设置成小于jit_above_cost是没有意义的并且将它设置成大于jit_inline_above_cost也未必有益。将这个参数设置为-1会禁用开销较大的优化。默认值是500000。
7.3 遗传查询优化
GEQO是一个使用探索式搜索来执行查询规划的算法。它可以降低负载查询的规划时间。 同时GEQO的检索是随机的因此它的规划可能会不可确定。 更多信息参阅Chapter 50。 遗传查询规划器GEQO是一种使用启发式搜索来进行查询规划的算法。它可以降低对于复杂查询连接很多表的查询的规划时间但是代价是它产生的计划有时候要差于使用穷举搜索算法找到的计划。
geqo (boolean)
允许或禁止遗传查询优化。默认是启用。在生产环境中通常最好不要关闭它。geqo_threshold变量提供了对 GEQO 更细粒度的空值。
geqo_threshold (integer)
只有当涉及的FROM项数量至少有这么多个的时候才使用遗传查询优化注意一个FULL OUTER JOIN只被计为一个FROM项。默认值是 12。对于更简单的查询通常会使用普通的穷举搜索规划器但是对于有很多表的查询穷举搜索会花很长时间通常比执行一个次优的计划带来的惩罚值还要长。因此在查询尺寸上的一个阈值是管理 GEQO 使用的一种方便的方法。
geqo_effort (integer)
控制 GEQO 里规划时间和查询规划的有效性之间的平衡。这个变量必须是 一个范围从 1 到 10 的整数。缺省值是 5 。大的数值增加花在进行查询 规划上面的时间但是也很可能会提高选中更有效的查询规划的几率。 控制 GEQO 中规划时间和查询计划质量之间的折中。这个变量必须是位于 1 到 10 之间的一个整数。默认值是 5。更大的值会增加花在查询规划上的时间但是同时也增加了选择一个高效查询计划的可能性。
geqo_effort实际并不直接做任何事情它只是被用来计算其他影响 GEQO 行为的变量如下所述的默认值。如果你愿意你可以手工设置其他参数。
geqo_pool_size (integer)
控制 GEQO 使用的池尺寸它就是遗传种群中的个体数目。它必须至少为 2且有用的值通常在 100 到 1000 之间。如果它被设置为零默认设置则会基于geqo_effort和查询中表的数量选择一个合适的值。
geqo_generations (integer)
控制 GEQO 使用的子代数目。子代的意思是算法的迭代次数。它必须至少 是 1 有用的值范围和池大小相同。如果设置为零(缺省)那么将基于 geqo_pool_size选取合适的值。 控制 GEQO 使用的代数也是算法的迭代次数。它必须至少为 1并且有用值的范围和池尺寸相同。如果它被设置为零默认设置则会基于geqo_pool_size选择一个合适的值。
geqo_selection_bias (floating point)
控制 GEQO 使用的选择偏好。选择偏好是种群中的选择压力。值可以是 1.5 到 2.0 之间后者是默认值。
geqo_seed (floating point)
控制 GEQO 使用的随机数生成器的初始值随机数生成器用于在连接顺序搜索空间中选择随机路径。该值可以从 0 默认值到 1。变化该值会改变被探索的连接路径集合并且可能导致找到一个更好或更差的路径。
7.4. 其他规划器选项
default_statistics_target (integer)
为没有通过ALTER TABLE SET STATISTICS设置列相关目标的表列设置默认统计目标。更大的值增加了需要做ANALYZE的时间但是可能会改善规划器的估计质量。默认值是 100。有关PostgreSQL查询规划器使用的统计信息的更多内容。
constraint_exclusion (enum)
constraint_exclusion的允许值是on对所有表检查约束、off从不检查约束和partition只对继承的子表和UNION ALL子查询检查约束。partition是默认设置。它通常被用于继承和分区表来提高性能。
当对一个特定表允许这个参数规划器比较查询条件和表的CHECK约束并且忽略那些条件违反约束的表扫描。例如
CREATE TABLE parent(key integer, ...);
CREATE TABLE child1000(check (key between 1000 and 1999)) INHERITS(parent);
CREATE TABLE child2000(check (key between 2000 and 2999)) INHERITS(parent);
...
SELECT * FROM parent WHERE key 2400;
在启用约束排除时这个SELECT将完全不会扫描child1000从而提高性能。
目前约束排除只在通过继承表实现表分区的情况中被默认启用。为所有表启用它会增加额外的规划开销特别是在简单查询上并且不会产生任何好处。如果没有继承分区表时最好是完全关闭它。
cursor_tuple_fraction (floating point)
设置规划器对将被检索的一个游标的行的比例的估计。默认值是 0.1。更小的值使得规划器偏向为游标使用“快速开始”计划它将很快地检索前几行但是可能需要很长时间来获取所有行。更大的值强调总的估计时间。最大设置为 1.0游标将和普通查询完全一样地被规划只考虑总估计时间并且不考虑前几行会被多快地返回。
from_collapse_limit (integer)
如果生成的FROM列表不超过这么多项规划器将把子查询融合到上层查询。较小的值可以减少规划时间但是可能 会生成较差的查询计划。默认值是 8。
将这个值设置为geqo_threshold或更大可能触发使用 GEQO 规划器从而产生非最优计划。
jit (boolean)
决定如果可用PostgreSQL是否可以使用JIT编译。默认值是off。
join_collapse_limit (integer)
如果得出的列表中不超过这么多项那么规划器将把显式JOIN除了FULL JOIN结构重写到 FROM项列表中。较小的值可减少规划时间但是可能会生成差些的查询计划。
默认情况下这个变量被设置成和from_collapse_limit相同 这样适合大多数使用。把它设置为 1 可避免任何显式JOIN的重排序。因此查询中指定的显式连接顺序就是关系被连接的实际顺序。因为查询规划器并不是总能 选取最优的连接顺序高级用户可以选择暂时把这个变量设置为 1然后显式地指定他们想要的连接顺序。
将这个值设置为geqo_thresholdgeqo_thresholdgeqo_threshold或更大可能触发使用 GEQO 规划器从而产生非最优计划。
parallel_leader_participation (boolean)
允许领导者进程执行Gather和Gather Merge节点之下的查询计划而不是等待工作者进程。默认值是on。将这个值设置为off会降低工作者由于领导者读取元组速度不够快而被阻塞的可能性但是要求领导者在产生第一个元组之前等待工作者进程启动。领导者能够帮助或者阻碍性能的程度取决于计划的类型、工作者的数量以及查询时长。
force_parallel_mode (enum)
允许为测试目的使用并行查询即便是并不期望在性能上得到效益。force_parallel_mode的允许值是off只在期望改进性能时才使用并行模式、on只要查询被认为是安全的就强制使用并行查询以及regress和on相似但是有如下文所解释的额外行为改变。
更具体地说把这个值设置为on会在任何一个对于并行查询安全的查询计划顶端增加一个Gather节点这样查询会在一个并行工作者中运行。即便当一个并行工作者不可用或者不能被使用时诸如开始一个子事务等在并行查询环境中会被禁止的操作将会被禁止除非规划器相信这样做会导致查询失败。当这个选项被设置时如果出现失败或者意料之外的结果查询使用的某些函数可能需要被标记为PARALLEL UNSAFE或者可能是PARALLEL RESTRICTED。
把这个值设置为regress具有设置成on所有相同的效果外加一些有助于自动回归测试的额外的效果。一般来说来自于一个并行工作者的消息会包括一个上下文行指出这一点但是设置为regress会消除这一行这样输出就和非并行执行完全一样。同样被这个设置加到计划上的Gather节点在EXPLAIN输出终会被隐藏起来这样产生的输出匹配设置为off时产生的输出。
八、错误报告和日志
8.1. 在哪里做日志
log_destination (string)
PostgreSQL支持多种方法来记录服务器消息包括stderr、csvlog和syslog。在 Windows 上还支持eventlog。设置这个参数为一个由想要的日志目的地的列表之间用逗号分隔。默认值是只记录到stderr。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
如果csvlog被包括在log_destination中日志项会以“逗号分隔值” CSV格式被输出这样可以很方便地把日志载入到程序中。要产生 CSV 格式的日志输出必须启用logging_collector。
当包括有stderr或csvlog时会创建文件current_logfiles来记录当前正在被日志收集器使用的日志文件的位置以及相关的日志目的地。这提供了一种查找实例当前使用的日志的便利手段。这里是该文件内容的一个例子
stderr log/postgresql.log
csvlog log/postgresql.csv
当由于轮转效应创建一个新的日志文件时以及log_destination被重载时current_logfiles文件会被重建。当log_destination中不包括stderr和csvlog时以及当日志收集器被禁用时这个文件会被删除。 注意 在大多数 Unix 系统上你将需要修改系统的syslog守护进程的配置来使用log_destination的syslog选项。PostgreSQL可以在syslog设备LOCAL0到LOCAL7中记录见syslog_facility但是大部分平台上的默认syslog配置会丢弃所有这种消息。你将需要增加这样的内容 local0.* /var/log/postgresql到syslog守护进程的配置文件来让它工作。 在 Windows 上当你使用log_destination的eventlog选项时你应该在操作系统中注册一个事件源极其库这样 Windows 事件查看器能够清楚地显示事件日志消息。 logging_collector (boolean)
这个参数启用日志收集器它是一个捕捉被发送到stderr的日志消息的后台进程并且它会将这些消息重定向到日志文件中。这种方法比记录到syslog通常更有用因为某些类型的消息不会在syslog输出中出现一个常见的例子是动态链接器错误消息另一个例子是由archive_command等脚本产生的错误消息。这个参数只能在服务器启动时设置。 注意 也可以不使用日志收集器而把日志记录到stderr日志消息将只会去到服务器的stderr被定向到的位置。不过那种方法只适合于低日志量因为它没有提供方法来轮转日志文件。还有在某些不使用日志收集器的平台上可能会导致丢失或者混淆日志输出因为多个进程并发写入同一个日志文件时会覆盖彼此的输出。 注意 日志收集器被设计成从来不会丢失消息。这意味着在极高的负载下如果服务器进程试图在收集器已经落后时发送更多的日志消息那么它会被阻塞。相反syslog倾向于在无法写入消息时丢掉消息这意味着在这样的情况下它可能会无法记录某些消息但是它不会阻塞系统的其他部分。 log_directory (string)
当logging_collector被启用时这个参数决定日志文件将被在哪个目录下创建。它可以被指定为一个绝对路径也可以被指定为一个相对于集簇数据目录的相对路径。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。 默认是log。
log_filename (string)
当logging_collector被启用时这个参数设置被创建的日志文件的文件名。该值被视为一种strftime模式因此%转义可以被用来指定根据时间变化的文件名注意如果有任何时区独立的%转义计算将在由log_timezone指定的时区中完成。被支持的%转义和开放组织的strftime说明中列举的类似。注意系统的strftime不会被直接使用因此平台相关非标准的扩展无法工作。 默认是postgresql-%Y-%m-%d_%H%M%S.log。
如果你不使用转义来指定一个文件名你应该计划使用一个日志轮转工具来避免最终填满整个磁盘。在 8.4 发行之前如果不存在%转义PostgreSQL将追加新日志文件创建时间的纪元但是现在已经不再这样做了。
如果在log_destination中启用了 CSV 格式输出.csv将会被追加到时间戳日志文件名中来创建 CSV 格式输出如果log_filename以.log结尾该后缀会被替换。
这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
log_file_mode (integer)
在 Unix 系统上当logging_collector被启用时这个参数设置日志文件的权限在微软 Windows 上这个参数将被忽略。这个参数值应当是一个数字形式的模式它可以被chmod和umask系统调用接受要使用通常的十进制格式该数字必须以一个0零开始。
默认的权限是0600表示只有服务器拥有者才能读取或写入日志文件。其他常用的设置是0640它允许拥有者的组成员读取文件。不过要注意你需要修改log_directory为将文件存储在集簇数据目录之外的某个位置才能利用这个设置。在任何情况下让日志文件变成任何人都可读是不明智的因为日志文件中可能包含敏感数据。
这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
log_rotation_age (integer)
当logging_collector被启用时这个参数决定一个个体日志文件的最长生命期。当这些分钟过去后一个新的日志文件将被创建。将这个参数设置为零将禁用基于时间的新日志文件创建。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
log_rotation_size (integer)
当logging_collector被启用时这个参数决定一个个体日志文件的最大尺寸。当这么多千字节被发送到一个日志文件后将创建一个新的日志文件。将这个参数设置为零将禁用基于尺寸的新日志文件创建。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
log_truncate_on_rotation (boolean)
当logging_collector被启用时这个参数将导致PostgreSQL截断覆盖而不是追加任何已有的同名日志文件。不过截断只在一个新文件由于基于时间的轮转被打开时发生在服务器启动或基于尺寸的轮转时不会发生。如果被关闭在所有情况下以前存在的文件将被追加。例如使用这个设置和一个类似postgresql-%H.log的log_filename将导致产生 24 个每小时的日志文件并且循环地覆盖它们。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
例子要保留 7 天的日志每天的一个日志文件被命令为server_log.Mon、server_log.Tue等等并且自动用本周的日志覆盖上一周的日志。可以这样做将log_filename设置为server_log.%a、将log_truncate_on_rotation设置为on并且将log_rotation_age设置为1440。
例子要保留 24 小时的日志每个小时一个日志文件但是在日志文件尺寸超过 1GB 时轮转。可以这样做将log_filename设置为server_log.%H%M、 将log_truncate_on_rotation设置为on、 将log_rotation_age设置为60并且 将log_rotation_size设置为1000000。 在log_filename中包括%M允许发生任何尺寸驱动的轮转来选择一个不同于每个小时的初始文件名的新文件名。
syslog_facility (enum)
当启用了向syslog记录时这个参数决定要使用的syslog“设备”。你可以在LOCAL0、LOCAL1、LOCAL2、LOCAL3、LOCAL4、 LOCAL5、LOCAL6、LOCAL7中选择默认值是LOCAL0。还请参阅系统的syslog守护进程的文档。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
syslog_ident (string)
当启用了向syslog记录时这个参数决定用来标识syslog中的PostgreSQL消息的程序名。默认值是postgres。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
syslog_sequence_numbers (boolean)
当日志被记录到syslog并且这个设置为 on 默认时每一个消息会被加上一个增长的序号作为前缀例如[2]。这种行为避开了很多 syslog 实现默认采用的“--- 上一个消息重复 N 次 ---”形式。在现代 syslog 实现中抑制重复消息是可以配置的例如rsyslog中的$RepeatedMsgReduction因此这个参数可能不是必需的。此外如果你真的想抑制重复消息你可以把这个参数设置为 off。
这个参数只能在postgresql.conf文件或者服务器命令行上设置。
syslog_split_messages (boolean)
当启用把日志记录到syslog时这个参数决定消息如何送达 syslog。当设置为 on默认时消息会被分成行并且长的行也会被划分以便能够放到 1024 字节中这是传统 syslog 实现一种典型的尺寸限制。当设置为 off 时PostgreSQL 服务器日志消息会被原样送达 syslog 服务而处理可能的大体量消息的任务由 syslog 服务负责。
如果 syslog 最终被记录到一个文本文件中那么两种设置的效果是一样的但最好设置为 on因为大部分 syslog 实现要么不能处理大型消息要么需要做特殊的配置以处理大型消息。但是如果 syslog 最终写入到某种其他媒介有必要让消息保持逻辑上的整体性也更加有用。
这个参数只能在postgresql.conf文件或者服务器命令行上设置。
event_source (string)
当启用了向事件日志记录时这个参数决定用来标识日志中PostgreSQL消息的程序名。默认值是PostgreSQL。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
8.2. 什么时候记录日志
log_min_messages (enum)
控制哪些消息级别 被写入到服务器日志。有效值是DEBUG5、DEBUG4、 DEBUG3、DEBUG2、DEBUG1、 INFO、NOTICE、WARNING、 ERROR、LOG、FATAL和 PANIC。每个级别都包括以后的所有级别。级别越靠后被发送的消息越少。默认值是WARNING。注意LOG在这里有与client_min_messages中不同的排名。只有超级用户可以改变这个设置。
log_min_error_statement (enum)
控制哪些导致一个错误情况的 SQL 语句被记录在服务器日志中。任何指定 严重级别 或更高级别的消息的当前 SQL 语句将被包括在日志项中。有效值是DEBUG5、 DEBUG4、DEBUG3、 DEBUG2、DEBUG1、 INFO、NOTICE、 WARNING、ERROR、 LOG、 FATAL和PANIC。默认值是ERROR它表示导致错误、日志消息、致命错误或恐慌错误的语句将被记录在日志中。要有效地关闭记录失败语句将这个参数设置为PANIC。只有超级用户可以改变这个设置。
log_min_duration_statement (integer)
如果语句运行至少指定的毫秒数将导致记录每一个这种完成的语句的持续时间。将这个参数设置为零将打印所有语句的执行时间。设置为 -1 默认值将停止记录语句持续时间。例如如果你设置它为250ms那么所有运行 250ms 或更久的 SQL 语句将被记录。启用这个参数可以有助于追踪应用中未优化的查询。只有超级用户可以改变这个设置。
对于使用扩展查询协议的客户端解析、绑定和执行步骤的持续时间将被独立记录。 注意 当把这个选项和log_statement一起使用时已经被log_statement记录的语句文本不会在持续时间日志消息中重复。如果你没有使用syslog我们推荐你使用log_line_prefix记录 PID 或会话 ID这样你可以使用进程 ID 或会话 ID 把语句消息链接到后来的持续时间消息。 表8.2.1解释了PostgreSQL所使用的消息严重级别。如果日志输出被发送到syslog或 Windows 的eventlog严重级别会按照表中所示进行转换。
表 8.2.1. 消息严重级别
严重性用法syslogeventlogDEBUG1..DEBUG5为开发者提供连续的更详细的信息。DEBUGINFORMATIONINFO提供用户隐式要求的信息例如来自VACUUM VERBOSE的输出。INFOINFORMATIONNOTICE提供可能对用户有用的信息例如长标识符截断提示。NOTICEINFORMATIONWARNING提供可能出现的问题的警告例如在一个事务块外COMMIT。NOTICEWARNINGERROR报告一个导致当前命令中断的错误。WARNINGERRORLOG报告管理员可能感兴趣的信息例如检查点活动。INFOINFORMATIONFATAL报告一个导致当前会话中断的错误。ERRERRORPANIC报告一个导致所有数据库会话中断的错误。CRITERROR
8.3. 记录什么到日志
application_name (string)
application_name可以是任意小于NAMEDATALEN个字符标准编译中是 64 个字符的字符串。这通常由一个应用通过到服务器的连接设置。该名称将被显示在pg_stat_activity视图中并被包括在 CSV 日志项中。它也会被通过log_line_prefix包括在普通日志项中。只有可打印 ASCII 字符能被使用在application_name之中。其他字符将被替换为问号?。
debug_print_parse (boolean)debug_print_rewritten (boolean)debug_print_plan (boolean)
这个参数启用发出各种调试输出。当设置时会打印生成的解析树 查询重写输出或执行的每个查询的执行计划。这些信息是在LOG 信息级别发出因此默认的它们会出现在服务器日志中但不会发送给客户端。 可以通过 client_min_messages和/或log_min_messages 来设置。这些参数缺省是off。 这些参数将会让多种调试输出被发出。当被设置时它们为每一个被执行的查询打印结果分析树、查询重写器输出或执行计划。这些消息在LOG消息级别上被发出因此默认情况下它们将出现在服务器日志中但不会被发送到客户端。你可以通过调整client_min_messages和/或log_min_messages来改变这种情况。这些参数默认是关闭的。
debug_pretty_print (boolean)
当被设置时debug_pretty_print会缩进由debug_print_parse、 debug_print_rewritten或 debug_print_plan产生的输出。这将导致比关闭参数时使用的“紧凑”模式可读性更强但是更长的输出。它默认是打开的。
log_checkpoints (boolean)
导致检查点和重启点被记录在服务器日志中。一些统计信息也被包括在日志消息中包括写入缓冲区的数据和写它们所花的时间。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。默认值是关闭。
log_connections (boolean)
导致每一次尝试对服务器的连接被记录客户端认证的成功完成也会被记录。 只有超级用户能在会话开始时更改这个参数在会话中它不能被更改。默认 为off。 注意 某些客户端程序例如psql在要求密码时会尝试连接两次因此重复的“收到连接”消息并不一定表示一个错误。 log_disconnections (boolean)
导致会话终止被记录。日志输出提供的信息类似于 log_connections不过还外加会话的持续时间。 只有超级用户能在会话开始时更改这个参数在会话中它不能被更改。默认 为off。
log_duration (boolean)
导致每一个完成的语句的持续时间被记录。默认值是off。只有超级用户可以改变这个设置。
对于使用扩展查询协议的客户端解析、绑定和执行步骤的持续时间将被独立记录。 注意 设置这个选项和设置log_min_duration_statement为零之间的区别是超过log_min_duration_statement强制查询的文本被记录但这个选项不会。因此如果log_duration为on并且log_min_duration_statement为正值所有持续时间都将被记录但是只有超过阈值的语句才会被记录查询文本。这种行为有助于在高负载安装中收集统计信息。 log_error_verbosity (enum)
控制为每一个被记录的消息要写入到服务器日志的细节量。有效值是TERSE、DEFAULT和VERBOSE每一个都为显示的消息增加更多域。TERSE排除记录DETAIL、HINT、QUERY和CONTEXT错误信息。VERBOSE输出包括SQLSTATE错误码以及产生错误的源代码文件名、函数名和行号。只有超级用户能够更改这个设置。
log_hostname (boolean)
默认情况下连接日志消息只显示连接主机的 IP 地址。打开这个参数将导致也记录主机名。注意根据你的主机名解析设置这可能会导致很微小的性能损失。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
log_line_prefix (string)
这是一个printf风格的字符串它在每个日志行的开头输出。%字符开始“转义序列”它将被按照下文描述的替换成状态信息。未识别的转义被忽略。其他字符被直接复制到日志行。某些转义只被会话进程识别并且被主服务器进程等后台进程当作空。通过指定一个在%之后和该选项之前的数字可以让状态信息左对齐或右对齐。 负值将导致在右边用空格填充状态信息已达到最小宽度而正值则在左边填充。填充对于日志文 件的人类可读性大有帮助。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。默认值是%m [%p] 它记录时间戳和进程ID。
转义效果只限会话%a应用名是%u用户名是%d数据库名是%r远程主机名或 IP 地址以及远程端口是%h远程主机名或 IP 地址是%p进程 ID否%t无毫秒的时间戳否%m带毫秒的时间戳否%n带毫秒的时间戳作为 Unix 时间戳no%i命令标签会话当前命令的类型是%eSQLSTATE 错误代码否%c会话 ID见下文否%l对每个会话或进程的日志行号从 1 开始否%s进程开始的时间戳否%v虚拟事务 ID (backendID/localXID)否%x事务 ID 如果未分配则为 0否%q不产生输出但是告诉非会话进程在字符串的这一点停止会话进程忽略否%%纯文字 %否
%c转义打印一个准唯一的会话标识符它由两个 4 字节的十六进制数不带先导零组成以点号分隔。这些数字是进程启动时间和进程 ID因此%c也可以被用作保存打印这些项的方式的空间。例如要从pg_stat_activity生成会话标识符使用这个查询
SELECT to_hex(trunc(EXTRACT(EPOCH FROM backend_start))::integer) || . ||to_hex(pid)
FROM pg_stat_activity; 提示 如果你为log_line_prefix设置了非空值你通常应该让它的最后一个字符为空格这样用以提供和日志行的剩余部分的视觉区别。也可以使用标点符号。 提示 Syslog产生自己的时间戳和进程 ID 信息因此如果你记录到syslog你可能不希望包括哪些转义。 提示 在包括仅在会话后端上下文中可用的信息如用户名或者数据库名时%q转义很有用。例如 log_line_prefix %m [%p] %q%u%d/%a log_lock_waits (boolean)
控制当一个会话为获得一个锁等到超过deadlock_timeoutdead时是否要产生一个日志消息。这有助于决定是否所等待造成了性能低下。默认值是off。只有超级用户可以更改这个设置。
log_statement (enum)
控制哪些 SQL 语句被记录。有效值是 none (off)、ddl、mod和 all所有语句。ddl记录所有数据定义语句例如CREATE、ALTER和 DROP语句。mod记录所有ddl语句外加数据修改语句例如INSERT, UPDATE、DELETE、TRUNCATE, 和COPY FROM。 如果PREPARE、EXECUTE和 EXPLAIN ANALYZE包含合适类型的命令它们也会被记录。对于使用扩展查询协议的客户端当收到一个执行消息时会产生日志并且会包括绑定参数的值任何内嵌的单引号会被双写。
默认值是none。只有超级用户可以改变这个设置。 注意 即使使用log_statement all设置包含简单语法错误的语句也不会被记录。这是因为只有在完成基本语法解析并确定了语句类型之后才会发出日志消息。在扩展查询协议的情况下在执行阶段之前即在解析分析或规划期间出错的语句也不会被记录。将log_min_error_statement设置为ERROR或更低来记录这种语句。 log_replication_commands (boolean)
导致每一个复制命令都被记录在服务器日志中。默认值是off。只有 超级用户可以更改这个设置。
log_temp_files (integer)
控制记录临时文件名和尺寸。临时文件可以被创建用来排序、哈希和存储临时查询结果。当每一个临时文件被删除时都会制作一个日志项。一个零值记录所有临时文件信息而正值只记录尺寸大于或等于指定千字节数的文件。默认设置为 -1它禁用这种记录。只有超级用户可以更改这个设置。
log_timezone (string)
设置在服务器日志中写入的时间戳的时区。和TimeZone不同这个值是集簇范围的因此所有会话将报告一致的时间戳。内建默认值是GMT但是通常会被在postgresql.conf中覆盖。initdb将安装一个对应于其系统环境的设置。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
8.4. 使用 CSV 格式的日志输出
在log_destination列表中包括csvlog提供了一种便捷方式将日志文件导入到一个数据库表。这个选项发出逗号分隔值CSV格式的日志行包括这些列 带毫秒的时间戳、 用户名、 数据库名、 进程 ID、 客户端主机:端口号、 会话 ID、 每个会话的行号、 命令标签、 会话开始时间、 虚拟事务 ID、 普通事务 ID、 错误严重性、 SQLSTATE 代码、 错误消息、 错误消息详情、 提示、 导致错误的内部查询如果有、 错误位置所在的字符计数、 错误上下文、 导致错误的用户查询如果有且被log_min_error_statement启用、 错误位置所在的字符计数、 在 PostgreSQL 源代码中错误的位置如果log_error_verbosity被设置为verbose以及应用名。 下面是一个定义用来存储 CSV 格式日志输出的样表
CREATE TABLE postgres_log
(log_time timestamp(3) with time zone,user_name text,database_name text,process_id integer,connection_from text,session_id text,session_line_num bigint,command_tag text,session_start_time timestamp with time zone,virtual_transaction_id text,transaction_id bigint,error_severity text,sql_state_code text,message text,detail text,hint text,internal_query text,internal_query_pos integer,context text,query text,query_pos integer,location text,application_name text,PRIMARY KEY (session_id, session_line_num)
);
使用COPY FROM命令将一个日志文件导入到这个表中
COPY postgres_log FROM /full/path/to/logfile.csv WITH csv;你可以做一些事情来简化导入 CSV 日志文件 设置log_filename和log_rotation_age为你的日志文件提供一种一致的、可预测的命名空间。这让你预测文件名会是怎样以及知道什么时候一个个体日志文件完成并且因此准备好被导入。 将log_rotation_size设置为 0 来禁用基于尺寸的日志轮转因为它使得日志文件名难以预测。 将log_truncate_on_rotation设置为on这样在同一个文件中旧日志数据不会与新数据混杂。 上述表定义包括一个主键声明。这有助于避免意外地两次导入相同的信息。COPY命令一次提交所有它导入的数据因此任何错误将导致整个导入失败。如果你导入一个部分完成的日志文件并且稍后当它完全完成后再次导入主键违背将导致导入失败。请等到日志完成且被关闭之后再导入。这个过程也可以避免意外地导入部分完成的行这种行也将导致COPY失败。
8.5. 进程标题
这些设置控制服务器进程的进程标题如何被修改。进程标题通常可以用ps或者 Windows 上的进程浏览器等程序来查看。
cluster_name (string)
为这个集簇中所有的服务器进程设置出现在进程标题中的集簇名称。这个名称可以是任何长度不超过NAMEDATALEN个字符在标准编译中是 64字符的任何字符串。只有可打印的 ASCII 字符能被用在cluster_name值中。其他字符将被替换为问号?。如果这个参数被设置为空字符串也是默认值将不会显示名称。这个参数只能在服务器启动时设置。
update_process_title (boolean)
启用进程标题更新每次服务器接收到一个新的 SQL 命令时都更新进程标题。在大部分平台上这个设置默认为on但是由于 Windows 上更新进程标题的开销更大所以在 Windows 这个设置默认为off。只有超级用户能更改这个设置。
九、运行时统计数据
9.1. 查询和索引统计收集器
这些参数控制服务器范围的统计数据收集特性。当统计收集被启用时被产生的数据可以通过pg_stat和pg_statio系统视图族访问。
track_activities (boolean)
启用对每个会话的当前执行命令的信息收集还有命令开始执行的时间。这个参数默认为打开。注意即使被启用这些信息也不是对所有用户可见只有超级用户和拥有报告信息的会话的用户可见因此它不会表现为一个安全风险。只有超级用户可以更改这个设置。
track_activity_query_size (integer)
指定跟踪每个活动会话当前执行命令所保留的字节数它们被用于pg_stat_activity.query域。默认值是 1024。这个参数只能在服务器启动时被设置。
track_counts (boolean)
启用在数据库活动上的统计收集。这个参数默认为打开因为自动清理守护进程需要被收集的信息。只有超级用户可以更改这个设置。
track_io_timing (boolean)
启用对系统 I/O 调用的计时。这个参数默认为关闭因为它将重复地向操作系统查询当前时间这会在某些平台上导致显著的负荷。你可以使用pg_test_timing工具来度量你的系统中计时的开销。I/O 计时信息被显示在pg_stat_database中、当BUFFERS选项被使用时的EXPLAIN输出中以及pg_stat_statements中。只有超级用户可以更改这个设置。
track_functions (enum)
启用跟踪函数调用计数和用时。指定pl只跟踪过程语言函数指定all还会跟踪 SQL 和 C 语言函数。默认值是none它禁用函数统计跟踪。只有超级用户可以更改这个设置。 注意 简单到足以被“内联”到调用查询中的 SQL 语言函数不会被跟踪 而不管这个设置。 stats_temp_directory (string)
设置存储临时统计数据的目录。这可以是一个相对于数据目录的路径或一个绝对路径。默认值是pg_stat_tmp。在一个基于 RAM 的文件系统上指明这个参数将降低物理 I/O 需求并且提高性能。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
9.2. 统计监控
log_statement_stats (boolean)log_parser_stats (boolean)log_planner_stats (boolean)log_executor_stats (boolean)
对每个查询向服务器日志里输出相应模块的性能统计。这是一种粗糙的分析工具。类似于 Unix 的getrusage()系统功能。log_statement_stats报告总的语句统计而其它的报告针每个模块的统计。log_statement_stats不能和 其它任何针对每个模块统计的选项一起启用。所有这些选项都是默认禁用的。只有超级用户可以更改这个设置。
十、自动清理
这些设置控制autovacuum特性的行为。注意很多这些设置可以被针对每个表 的设置所覆盖请见存储参数。
autovacuum (boolean)
控制服务器是否运行自动清理启动器后台进程。默认为开启 不过要自动清理正常工作还需要启用track_counts。 该参数只能在postgresql.conf文件或服务器命令行中设置 不过通过更改表存储参数可以为表禁用自动清理。
注意即使该参数被禁用系统也会在需要防止事务ID回卷时发起清理进程。
log_autovacuum_min_duration (integer)
如果自动清理运行至少该值所指定的毫秒数被自动清理执行的每一个动作都会被日志记录。 将该参数设置为0会记录所有的自动清理动作。-1默认值将禁用对自动清理动作的记录。 例如如果你将它设置为250ms则所有运行250ms或更长时间的 自动清理和分析将被记录。此外当该参数被设置为除-1外的任何值时 如果一个自动清理动作由于一个锁冲突或者被并发删除的关系而被跳过将会为此记录一个消息。 开启这个参数对于追踪自动清理活动非常有用。这个参数只能在 postgresql.conf文件或者服务器命令行中设置。但是可以通过更改表的存储 参数为个别表覆盖这个设置。
autovacuum_max_workers (integer)
指定能同时运行的自动清理进程除了自动清理启动器之外的最大数量。默认值为3。该参数只能在服务器启动时设置。
autovacuum_naptime (integer)
指定自动清理在任意给定数据库上运行的最小延迟。在每一轮中后台进程检查数据库并根据需要为数据库中的表发出VACUUM和ANALYZE命令。延迟以秒计且默认值为1分钟1min。该参数只能在postgresql.conf文件或在服务器命令行上设置。
autovacuum_vacuum_threshold (integer)
指定能在一个表上触发VACUUM的被更新或被删除元组的最小数量。默认值为50个元组。该参数只能在postgresql.conf文件或在服务器命令中设置。但是对个别表可以通过修改表存储参数来覆盖该设置。
autovacuum_analyze_threshold (integer)
指定能在一个表上触发ANALYZE的被插入、被更新或被删除元组的最小数量。默认值为50个元组。该参数只能在postgresql.conf文件或在服务器命令中设置。但是对个别表可以通过修改表存储参数来覆盖该设置。
autovacuum_vacuum_scale_factor (floating point)
指定一个表尺寸的分数在决定是否触发VACUUM时将它加到autovacuum_vacuum_threshold上。默认值为0.2表尺寸的20%。该参数只能在postgresql.conf文件或在服务器命令中设置。但是对个别表可以通过修改表存储参数来覆盖该设置。
autovacuum_analyze_scale_factor (floating point)
指定一个表尺寸的分数在决定是否触发ANALYZE时将它加到autovacuum_analyze_threshold上。默认值为0.1表尺寸的10%。该参数只能在postgresql.conf文件或在服务器命令中设置。但是对个别表可以通过修改表存储参数来覆盖该设置。
autovacuum_freeze_max_age (integer)
指定在一个VACUUM操作被强制执行来防止表中事务ID回卷之前一个表的pg_class.relfrozenxid域能保持的最大年龄事务的。注意即便自动清理被禁用系统也将发起自动清理进程来阻止回卷。
清理也允许从pg_xact子目录中移除旧文件这也是为什么默认值被设置为较低的2亿事务。该参数只能在服务器启动时设置但是对于个别表可以通过修改表存储参数来降低该设置。
autovacuum_multixact_freeze_max_age (integer)
指定在一个VACUUM操作被强制执行来防止表中多事务ID回卷之前一个表的pg_class.relminmxid域能保持的最大年龄多事务的。注意即便自动清理被禁用系统也将发起自动清理进程来阻止回卷。
清理多事务也允许从pg_multixact/members和pg_multixact/offsets子目录中移除旧文件这也是为什么默认值被设置为较低的4亿事务。该参数只能在服务器启动时设置但是对于个别表可以通过修改表存储参数来降低该设置。
autovacuum_vacuum_cost_delay (integer)
指定用于自动VACUUM操作中的代价延迟值。如果指定-1则使用vacuum_cost_delay值。默认值为20毫秒。该参数只能在postgresql.conf文件或在服务器命令中设置。但是对个别表可以通过修改表存储参数来覆盖该设置。
autovacuum_vacuum_cost_limit (integer)
指定用于自动VACUUM操作中的代价限制值。如果指定-1默认值则使用vacuum_cost_limit值。注意该值被按比例地分配到运行中的自动清理工作者上如果有多个因此每一个工作者的限制值之和不会超过这个变量中的值。该参数只能在postgresql.conf文件或在服务器命令中设置。但是对个别表可以通过修改表存储参数来覆盖该设置。
十一、客户端连接默认值
11.1. 语句行为
client_min_messages (enum)
控制被发送给客户端的消息级别。有效值是DEBUG5、 DEBUG4、DEBUG3、DEBUG2、 DEBUG1、LOG、NOTICE、 WARNING、ERROR。 每个级别都包括其后的所有级别。级别越靠后被发送的消息越少。默认值是NOTICE。 注意LOG在这里有与log_min_messages中不同的排名。
INFO 级别的消息总是被发送到客户端。
search_path (string)
这个变量指定当一个对象表、数据类型、函数等被用一个无模式限定的简单名称引用时用于进行搜索该对象的模式顺序。当在不同模式中有同名对象时将使用第一个在搜索路径中被找到的对象。一个不属于搜索路径中任何一个模式的对象只能通过用限定名带点号指定包含它的模式来引用。
search_path的值必需是一个逗号分隔的模式名列表。任何不是一个已有模式的名称或者是一个用户不具有USAGE权限的模式将被安静地忽略。
如果列表项之一是特殊名$user则具有SESSION_USER返回的名字的模式将取代它如果有这样一个模式并且该用户有该模式的USAGE权限如果没有$user会被忽略。
系统目录模式pg_catalog总是被搜索不管它是否在搜索路径中被提及。如果它在路径中被提及那么它将被按照路径指定的顺序搜索。如果pg_catalog不在路径中则它将在任何路径项之前被搜索。
同样当前会话的临时表模式pg_temp_nnn也总是被搜索如果存在。它可以在路径中通过使用别名pg_temp显式列出。如果在路径中没有列出那么会首先对它进行搜索甚至是在pg_catalog之前。然而临时模式只被用来搜索关系表、视图、序列等和数据类型名。它从不用于搜索函数或操作符名。
当对象创建时没有指定一个特定目标模式它们将被放置在search_path中第一个合法模式中。如果搜索路径为空将报告一个错误。
这个参数的缺省值是$user, public。这种设置支持一个数据库其中没有用户拥有私有模式并且所有人共享使用public、每个用户私有模式及其组合的共享使用。其它效果可以通过全局或者针对每个用户修改默认搜索路径设置获得。
特别地只有当数据库只有一个用户或者有少数的相互信任的用户时默认配置是合适的。
搜索路径的当前有效值可以通过SQL函数current_schemas检查。它和检查search_path的值不太一样因为current_schemas显示出现在search_path中的项如何被解析。
row_security (boolean)
这个变量控制是否以抛出一个错误来代替应用一条行安全性策略。在设置为on时策略正常应用。在设置为off时只要有至少一条策略被应用则查询就会失败。默认为on。受限的行可见性会导致不正确的结果时可将其改成off。例如pg_dump默认会做这种更改。这个变量对能绕过每一条行安全性策略的角色即超级用户和具有BYPASSRLS属性的角色没有效果。
更多关于行安全性策略的信息请见CREATE POLICY。
default_tablespace (string)
这个变量指定当一个CREATE命令没有显式指定一个表空间时创建对象表和索引的默认表空间。
该值要么是一个表空间的名字要么是一个指定使用当前数据库默认表空间的空字符串。如果该值和任何现有表空间的名字都不匹配PostgreSQL将自动使用当前数据库的默认表空间。如果指定了一个非默认的表空间用户必须对它有CREATE权限否则创建企图将失败。
这个变量不被用于临时表对临时表会使用temp_tablespaces。
当创建数据库时也会使用这个变量。默认情况下一个新数据库会从它的模板数据库继承其表空间设置。
temp_tablespaces (string)
这个变量指定当一个CREATE命令没有显式指定一个表空间时创建临时对象临时表和临时表上的索引的默认表空间。用于排序大型数据集的临时文件也被创建在这些表空间中。
该值是一个表空间名字的列表。当列表中有多于一个名称时每次一个临时对象被创建时PostgreSQL随机选择列表中的一个成员。例外是在一个事务中连续创建的临时对象被放置在里表中的连续表空间中。如果列表被选中元素是一个空字符串PostgreSQL将自动使用当前数据库的默认表空间。
当temp_tablespaces被交互式地设置时指定一个不存在的表空间是一种错误类似于为用户指定一个不具有CREATE权限的表空间。不过当使用一个之前设置的值时不存在的表空间会被忽略就像用户缺少CREATE权限的表空间一样。特殊地使用一个在postgresql.conf中设置的值时这条规则起效。
默认值是一个空字符串它使得所有临时对象被创建在当前数据库的默认表空间中。
参阅default_tablespace。
check_function_bodies (boolean)
这个参数通常为打开 。当设置为off时它禁用CREATE FUNCTION期间对函数体字符串的验证。禁用验证避免了验证处理的副作用并且避免了如向前引用导致的伪肯定。在代表其他用户载入函数之前设置这个参数为offpg_dump会自动这样做。
default_transaction_isolation (enum)
每个 SQL 事务都有一个隔离级别可以是“读未提交”、“读已提交”、“可重复读”或者“可序列化”。这个参数控制每个新事务的默认隔离级别。默认是“读已提交”。
default_transaction_read_only (boolean)
一个只读的 SQL 事务不能修改非临时表。这个参数控制每个新事务的默认只读状态 。默认是off读/写。
更多信息请参考 SET TRANSACTION。
default_transaction_deferrable (boolean)
当运行在可序列化隔离级别时一个可延迟只读 SQL 事务可以在它被允许继续之前延迟一段时间。但是一旦它开始执行就不会产生任何用来保证可序列化性的负荷因此序列化代码将没有任何理由因为并发更新而强制它中断使得这个选项适合于长时间运行的只读事务。
这个参数控制每个新事务的默认可延迟状态。目前它对读写事务或者那些操作在低于可序列化隔离级别上的事务无效。默认值是off。
详情请参阅SET TRANSACTION。
session_replication_role (enum)
为当前会话控制复制相关的触发器和规则的触发。需要超级用户权限才能设置这个变量并且会导致丢弃任何之前缓存下来的查询计划。可能的值有origin默认、replica和local。
这个设置的预期用途是由逻辑复制系统在应用所复制的更改时将它设置为replica。其效果将是触发器和规则没有对其默认配置做修改在复制机上将不会被触发。更多信息请参考ALTER TABLE的子句ENABLE TRIGGER以及ENABLE RULE。
PostgreSQL在内部会把设置origin和local同样对待。第三方复制系统可能会把这两个值用于其内部目的例如把local用来标出一个不应复制其更改的会话。
因为外键被实现为触发器将这个参数设置为replica还会禁用所有的外键检查如果使用不当可能会让数据处于一种不一致的状态。
statement_timeout (integer)
中止任何使用了超过指定毫秒数的语句从命令到达服务器开始计时。如果log_min_error_statement被设置为ERROR或更低语句如果超时也会被记录。一个零值默认将关闭这个参数。
我们不推荐在postgresql.conf中设置statement_timeout因为它会影响所有会话。
lock_timeout (integer)
如果任何语句在试图获取表、索引、行或其他数据库对象上的锁时等到超过指定的毫秒数该语句将被中止。该时间限制独立地应用于每一次锁获取尝试。该限制会应用到显式锁定请求如LOCK TABLE或不带NOWAIT的SELECT FOR UPDATE和隐式获得的锁。如果log_min_error_statement被设置为ERROR或更低超时的语句会被记录。一个零值默认将关闭这个参数。
与statement_timeout不同这个超时只在等待锁时发生。注意如果statement_timeout为非零设置lock_timeout为相同或更大的值没有意义因为事务超时将总是第一个被触发。
我们不推荐在postgresql.conf中设置lock_timeout因为它会影响所有会话。
idle_in_transaction_session_timeout (integer)
终止任何已经闲置超过这个参数所指定的时间以毫秒计的打开事务的会话。这使得该会话所持有的任何锁被释放并且其所持有的连接槽可以被重用它也允许只对这个事务可见的元组被清理。
默认值 0 会禁用这个特性。
vacuum_freeze_table_age (integer)
当表的pg_class.relfrozenxid域达到该设置指定的年龄时VACUUM会执行一次激进的扫描。激进的扫描与常规VACUUM的不同在于它会访问每一个可能包含未冻结 XID 或者 MXID 的页面而不只是那些可能包含死亡元组的页面。默认值是 1.5 亿个事务。尽管用户可以把这个值设置为从 0 到 20 亿VACUUM会悄悄地将有效值设置为autovacuum_freeze_max_age值的95%因此在表上启动一次反回卷自动清理之前有机会进行一次定期手动VACUUM。
vacuum_freeze_min_age (integer)
指定VACUUM在扫描表时用来决定是否冻结行版本的切断年龄以事务计。默认值是 5 千万个事务。尽管用户可以将这个值设置为从 0 到 10 亿VACUUM会悄悄地将有效值设置为autovacuum_freeze_max_age值的一半这样在强制执行的自动清理之间不会有过短的时间间隔。
vacuum_multixact_freeze_table_age (integer)
如果表的pg_class.relminmxid域超过了这个设置指定的年龄VACUUM会执行一次激进的扫描。激进的扫描与常规VACUUM的区别在于它会访问每一个可能包含未冻结 XID 或者 MXID 的页面而不是只扫描那些可能包含死亡元组的页面。默认值是 1.5 亿个组合事务。尽管用户可以把这个值设置为从 0 到 20 亿VACUUM会悄悄地将有效值设置为autovacuum_multixact_freeze_max_age值的95%因此在表上启动一次反回卷自动清理之前有机会进行一次定期手动VACUUM。
vacuum_multixact_freeze_min_age (integer)
指定VACUUM在扫描表时用来决定是否把组合事务 ID 替换为一个更新的事务 ID 或组合事务 ID 的切断年龄以组合事务计。默认值是 5 千万个组合事务。尽管用户可以将这个值设置为从 0 到 10 亿VACUUM会悄悄地将有效值设置为autovacuum_multixact_freeze_max_age值的一半这样在强制执行的自动清理之间不会有过短的时间间隔。
vacuum_cleanup_index_scale_factor (floating point)
指定在以前的统计信息收集过程中计数到的堆元组总数的一个分数插入不超过这一数量所代表的元组不会导致VACUUM清理阶段的索引扫描。这个设置当前仅适用于B-树索引。
如果没有元组从堆中删除则当至少满足下列条件之一时在VACUUM清理阶段仍会扫描B-树索引索引统计信息过时或者索引中包含在清理时可回收的已删除页。如果新近插入的元组数占上次统计信息收集时检测到的堆元组总数的比例超过vacuum_cleanup_index_scale_factor则认为索引信息已经过时。堆元组的总数被存放在索引的元页中。注意直到VACUUM找不到死亡元组之前元页中都不包括这个数据。因此只有在第二次以及之后的VACUUM周期检测不到死亡元组时清理阶段的B-树索引扫描才能被跳过。
该值的取值范围可以是从0到10000000000。当vacuum_cleanup_index_scale_factor被设置为0时在VACUUM清理期间不会跳过索引扫描。默认值是0.1。
bytea_output (enum)
设置bytea类型值的输出格式。有效值是hex默认和 escape传统的 PostgreSQL 格式。不管这个设置的值如何bytea类型总是接受这两种格式的输入。
xmlbinary (enum)
设置二进制值如何被编码为 XML。例如这适用于通过xmlelement函数或xmlforest函数将bytea值转换到 XML 值。可能的值有base64和hex它们都是用 XML 模式标准定义的。默认值是base64。
这里的实际选择都是根据爱好做出的只受客户端应用中可能存在的限制的约束。两种方法都支持所有可能的值尽管十六进制编码将比 base64 编码更大。
xmloption (enum)
当在XML和字符串值之间进行转换时无论设置DOCUMENT或 CONTENT都是隐式的。可参阅Section 8.13。 有效值是DOCUMENT和CONTENT。 缺省值是CONTENT。当在 XML 和字符串值之间进行转换时设置DOCUMENT或CONTENT都是隐式的。有效值是DOCUMENT和CONTENT。默认值是CONTENT。
根据 SQL 标准设置这个选项的命令是
SET XML OPTION { DOCUMENT | CONTENT };
这种语法在 PostgreSQL 也可用。
gin_pending_list_limit (integer)
设置fastupdate被启用时可以使用的 GIN 待处理列表的最大尺寸。如果该列表增长到超过这个最大尺寸会通过批量将其中的项移入主 GIN 数据结构来清理列表。默认值是四兆字节4MB。可以通过更改索引的存储参数来为个别 GIN 索引覆盖这个设置。
11.2. 区域和格式化
DateStyle (string)
设置日期和时间值的显示格式以及解释有歧义的日期输入值的规则。由于历史原因 这个变量包含两个独立的部分输出格式声明ISO、Postgres、SQL或German、 输入/输出的年/月/日顺序DMY、MDY或YMD。这些可以被独立设置或者一起设置。关键字Euro和European是DMY的同义词关键字US、NonEuro和NonEuropean是MDY的同义词。内建默认值是ISO, MDY但是initdb将用对应于选中的lc_time区域行为的设置初始化配置文件。
IntervalStyle (enum)
设置间隔值的显示格式。值sql_standard将产生匹配 SQL 标准间隔文本的输出。当DateStyle参数被设置为ISO时值postgres默认将产生匹配PostgreSQL发行 8.4 之前的输出。当DateStyle参数被设置为非ISO输出时值postgres_verbose会产生匹配PostgreSQL发行 8.4 之前的输出。值iso_8601会产生匹配在 ISO 8601 的 4.4.3.2 节中定义的“带标志符格式”的时间间隔的输出。
IntervalStyle参数也可以影响对有歧义的间隔输入的解释。
TimeZone (string)
设置用于显示和解释时间戳的时区。内建默认值是GMT但是它通常会在postgresql.conf中被覆盖initdb将安装一个对应于其系统环境的设置。
timezone_abbreviations (string)
设置服务器接受的日期时间输入中使用的时区缩写集合。默认值为Default 这个集合在全世界大多数地方都能工作。也还有Australia和India以及可能为一种特定安装定义的其他集合。
extra_float_digits (integer)
这个参数为浮点值调整显示的位数包括float4、float8以及几何数据类型。参数值被加在标准的位数FLT_DIG或DBL_DIG视情况而定上。该值最高可以被设置为 3 来包括部分有效位这特别有助于转储需要被准确恢复的否点数据。或者它可以被设置为负值来消除不需要的位。
client_encoding (string)
设置客户端编码字符集。默认使用数据库编码。
lc_messages (string)
设置消息显示的语言。可接受的值是系统相关的如果这个变量被设置为空字符串默认那么该值将以一种系统相关的方式从服务器的执行环境中继承。
在一些系统上这个区域分类并不存在。仍然可以设置这个变量只是不会有任何效果。同样所期望语言的翻译消息也可能不存在。在这种情况下你将仍然继续看到英文消息。
只有超级用户可以改变这个设置。因为它同时影响发送到服务器日志和客户端的消息。一个不正确的值可能会降低服务器日志的可读性。
lc_monetary (string)
设置用于格式化货币量的区域例如用to_char函数族。可接受的值是系统相关的如果这个变量被设置为空字符串默认那么该值将以一种系统相关的方式从服务器的执行环境中继承。
lc_numeric (string)
设置用于格式化数字的区域例如用to_char函数族。可接受的值是系统相关的。如果这个变量被设置为空字符串默认那么该值将以一种系统相关的方式从服务器的执行环境中继承。
lc_time (string)
设置用于格式化日期和时间的区域例如用to_char函数族。可接受的值是系统相关的如果这个变量被设置为空字符串默认那么该值将以一种系统相关的方式从服务器的执行环境中继承。
default_text_search_config (string)
选择被那些没有显式参数指定配置的文本搜索函数变体使用的文本搜索配置。内建默认值是pg_catalog.simple但是如果能够标识一个匹配区域的配置initdb将用对应于选中的lc_ctype区域的设置初始化配置文件。
11.3. 共享库预载入
为了载入附加的功能或者达到提高性能的目的可用多个设置来预先载入共享库到服务器中。 例如$libdir/mylib设置可能会导致mylib.so或者某些平台上的mylib.sl从安装的标准库目录被预装载。这些设置之间的区别在于生效的时间以及改变它们所需的特权。
可以用这个方法预装载PostgreSQL的过程语言库通常是使用$libdir/plXXX语法其中的XXX是pgsql、perl、tcl或python。
只有特别为与PostgreSQL一起使用设计的共享库才能以这种方式载入。每一个PostgreSQL支持 的库都有一个“魔法块”它会被检查以保证兼容性。由于这个原因非PostgreSQL无法 以这种方式被载入。你可能可以使用操作系统的工具如LD_PRELOAD载入它。
总之请参考特定模块的文档来用推荐的方法载入它。
local_preload_libraries (string)
这个变量指定一个或者多个要在连接开始时预载入的共享库。它包含一个由逗号分隔的库名列表其中每个名称都会按LOAD命令的方式解析。项之间的空格会被忽略如果需要在库名中包含空格或者逗号请把库名放在双引号内。这个参数 值只在连接开始时生效。后续的更改不会有任何效果。如果一个指定的 库没有找到连接尝试将会失败。
任何用户都能设置这个选项。正因为如此能被这样载入的库被严格限制为出现于安装的标准库 目录中plugins子目录下的共享库保证只有“安全的”库被安装到 这里是数据库管理员的责任。local_preload_libraries中的项可以显式 指定这个目录例如$libdir/plugins/mylib或者只是指定库的 名称 — mylib 和 $libdir/plugins/mylib的效果是相同的。
这个特性的目的是允许非特权用户在特定的会话中载入正在调试的或者性能度量库 而无需一个显式的LOAD命令。为了这个目的通常通过使用客 户端的PGOPTIONS环境变量或者 ALTER ROLE SET来设置这个参数。
不过除非一个模块被特别设计成由非超级用户以这种方式使用通常不推荐使用这个设置。应该看看 session_preload_libraries。
session_preload_libraries (string)
这个变量指定一个或者多个要在连接开始时预载入的共享库。只有超级用户更够更改这个设置。它包含一个由逗号分隔的库名列表其中每个名称都会按LOAD命令的方式解析。项之间的空格会被忽略如果需要在库名中包含空格或者逗号请把库名放在双引号内。这个参数只在连接开始时起效。后续的改变没有效果。如果指定的库没有找到连接尝试将会失败。只有超级用户能够更改这个设置。
这个特性的意图是允许在特定会话中载入调试用的或者测量性能的库而不需要显式的给出一个 LOAD命令。例如通过用ALTER ROLE SET设置这个参数可以 为一个给定用户名下的所有会话启用auto_expain。还有无需重启 服务器就能更改这个参数但是只有新会话启动时才会生效这样可以以这种方式更容易地增 加新模块即便它们会应用到所有会话。
和shared_preload_libraries不同相对于在库被第一次使用 时载入它在会话开始时载入库并没有什么性能优势。不过当使用连接池时这样做还是有一些 优势。
shared_preload_libraries (string)
这个变量指定一个或者多个要在服务器启动时预载入的共享库。它包含一个由逗号分隔的库名列表其中每个名称都会按LOAD命令的方式解析。项之间的空格会被忽略如果需要在库名中包含空格或者逗号请把库名放在双引号内。这个参数只能在服务器启动时设置。如果指定的库没有找到服务器将无法启动。
有些库需要执行只能在postmaster启动时发生的特定操作例如分配共享内存、保留轻量级锁 或者启动后台工作者。这些库必须通过这个参数在服务器启动时载入。每个库的详情请见文档。
其他库也能被预载入。通过预载入一个共享库当该库被第一次使用时就可以避免库的启动时间。 不过启动每个新服务器进程的时间可能会略有增加即使该进程从不使用该库。因此推荐只 把这个参数用于那些要在大多数会话中使用的库上。还有改变这个参数要求重启服务器因此 对于短期的调试任务来说这不是好的选择应该转用 shared_preload_libraries。 注意 在 Windows 主机上在服务器启动时预载入一个库并不会减少启动每个新服务器进程所需的 时间每一个服务器进程将会重新载入预载入的库。不过对于那些要在postmaster启动时 执行操作的库来说Windows 主机上的 shared_preload_libraries任然有用。 jit_provider (string)
这个变量是要被使用的JIT提供者库的名称。默认是llvmjit。这个参数只能在服务器启动时设置。
如果这个变量被设置为一个不存在的库JIT将不可用但是也不会发生错误。这种特性允许在主PostgreSQL包之外单独安装JIT支持。
11.4. 其他默认值
dynamic_library_path (string)
如果需要打开一个可以动态装载的模块并且在CREATE FUNCTION或LOAD命令中指定的文件名没有目录部分即名字中不包含斜线那么系统将搜索这个路径以查找所需的文件。
dynamic_library_path的值必须是一个冒号分隔或者在 Windows 上以分号分隔的绝对目录路径的列表。如果一个列表元素以特殊字符串开始$libdir会被替换为PostgreSQL包中已编译好的库目录。这里是PostgreSQL发布提供的模块被安装的位置使用pg_config --pkglibdir来找到这个目录的名字。例如
dynamic_library_path /usr/local/lib/postgresql:/home/my_project/lib:$libdir或者在 Windows 环境中
dynamic_library_path C:\tools\postgresql;H:\my_project\lib;$libdir这个参数的默认值是$libdir。如果该值被设置为一个空字符串则关闭自动路径搜索。
这个参数可以在运行时由超级用户修改但是这样修改的设置只能保持到这个客户端连接的结尾因此这个方法应该保留给开发目的。 我们建议在postgresql.conf配置文件中设置这个参数。
gin_fuzzy_search_limit (integer)
GIN 索引返回的集合尺寸的软上限。
十二、锁管理
deadlock_timeout (integer)
这是进行死锁检测之前在一个锁上等待的总时间以毫秒计。死锁检测相对昂贵因此服务器不会在每次等待锁时都运行这个它。我们乐观地假设在生产应用中死锁是不常出现的并且只在开始检测死锁之前等待一会儿。增加这个值就减少了浪费在无用的死锁检测上的时间但是减慢了报告真正死锁错误的速度。默认是 1 秒1s这可能是实际中你想要的最小值。在一个高负载的服务器上你可能需要增大它。这个值的理想设置应该超过你通常的事务时间这样就可以减少在锁释放之前就开始死锁检查的机会。只有超级用户可以更改这个设置。
当log_lock_waits被设置时这个参数还可以决定发出关于锁等待的日志之前等待的时长。如果你想调查锁延迟你可能希望设置一个比正常的deadlock_timeout小的值。
max_locks_per_transaction (integer)
共享锁表跟踪在max_locks_per_transaction * (max_connections max_prepared_transactions) 个对象如表上的锁。因此在任何一个时刻只有不超过这么多个可区分对象能够被锁住。这个参数控制为每个事务分配的对象锁的平均数量。个体事务可以锁住更多对象数量可以和锁表中能容纳的所有事务的锁一样多。这不是能被锁住的行数那个值是没有限制的。默认值 64 已经被历史证明是足够的但是如果你有需要在一个事务中使用很多不同表的查询例如查询一个有很多子表的父表你可能需要提高这个值。这个参数只能在服务器启动时设置。
当运行一个后备服务器时你必须设置这个参数为大于等于主服务器上的值。否则后备服务器上将不允许查询。
max_pred_locks_per_transaction (integer)
共享谓词锁表跟踪在max_pred_locks_per_transaction * (max_connections max_prepared_transactions) 个对象如表上的锁。因此在任何一个时刻只有不超过这么多个可区分对象能够被锁住。这个参数控制为每个事务分配的对象锁的平均数量。个体事务可以锁住更多对象数量可以和锁表中能容纳的所有事务的锁一样多。这不是能被锁住的行数那个值是没有限制的。默认值 64 已经在测试中被证明通常是足够的但是如果你有需要在一个可序列化事务中使用很多不同表的查询例如查询一个有很多子表的父表你可能需要提高这个值。这个参数只能在服务器启动时设置。
max_pred_locks_per_relation (integer)
这个参数控制在谓词锁被提升为覆盖整个关系之前该谓词锁能够在单个关系上锁住多少页面或元组。大于等于零的值表示一种绝对限制而负值表示用max_pred_locks_per_transaction除以这个设置的绝对值。默认值为-2它将保持以往版本的PostgreSQL中的行为。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
max_pred_locks_per_page (integer)
这个参数控制在谓词锁被提升为覆盖整个页面之前该谓词锁能在单一页面上锁住多少行。默认值是2。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
十三、版本和平台兼容性
13.1. 以前的 PostgreSQL 版本
array_nulls (boolean)
这个参数控制数组输入解析器是否把未用引号的NULL识别为一个空数组元素。默认为on允许输入包含空值的数组值。但是PostgreSQL 8.2 之前的版本不支持数组中的空值并且因此将把NULL当作指定一个值为字符串“NULL”的正常数组元素。对于那些要求旧行为的应用的向后兼容性这个变量可以被设置为off。
注意即使这个变量为off也能够创建包含空值的数组值。
backslash_quote (enum)
这个参数控制字符串文本中的单引号是否能够用\来表示。首选的 SQL 标准的方法是将其双写但是PostgreSQL在历史上也接受\。不过使用\容易导致安全风险因为在某些客户端字符集编码中有多字节字符的最后一个字节在数值上等价于 ASCII 的\。如果客户端代码没有做到正确转义那么将会导致 SQL 注入攻击。如果服务器拒绝看起来带有被反斜线转义的单引号的查询那么就可以避免这种风险。backslash_quote的可用值是on总是允许\、off总是拒绝以及safe_encoding只有客户端编码不允许在多字节字符中存在 ASCII \时允许。safe_encoding是默认设置。
注意在符合标准的字符串文本中\就表示\。这个参数只影响不符合标准的文本的处理包括转义字符串语法E...。
default_with_oids (boolean)
这个参数控制CREATE TABLE和CREATE TABLE AS在既没有指定WITH OIDS也没有指定WITHOUT OIDS的情况下是否在新创建的表中包含 OID 列。它还决定被SELECT INTO创建的表里面是否包含 OID 。这个参数在默认情况下为off。在PostgreSQL 8.0 及更早的版本中它默认为on。
我们反对在用户表中使用 OID 因此大多数安装应该禁用这个变量。需要为一个特殊表使用 OID 的应用应该在创建表的时候指定WITH OIDS。为了兼容不遵循这一行为的老旧应用这个变量可以被启用。
escape_string_warning (boolean)
打开时如果在普通字符串文本中...语法出现了 一个反斜线\并且standard_conforming_strings为关闭那么就会发出一个警告。默认值是on。
希望使用反斜线作为转义符的应用应该被修改来使用转义字符串语法E...因为在 SQL 标准中普通字符串的默认行为是将反斜线视作一个普通字符。这个变量可以被启用来帮助定位需要被更改的代码。
lo_compat_privileges (boolean)
在PostgreSQL 9.0 之前大对象不具有访问特权并且因此总是所有用户可读可写的。为了和以前的版本兼容把这个变量设置为on可以禁用这种新的特权检查。默认是off。只有超级用户可以更改这个设置。
设置这个参数不会禁用所有与大对象相关的安全检查 — 除了那些在PostgreSQL 9.0中已经修改了的默认行为。
operator_precedence_warning (boolean)
当开启时对于任何从PostgreSQL 9.4 以来由于操作符优先级 变化而导致含义改变的结构解析器将发出一个警告。这有助于审计应用已检查是否 优先级变化破坏了什么东西。但是它的本意并不是希望在生产环境中保持打开因为它 会对某些完全合法、兼容标准的 SQL 代码发出警告。默认为off。
quote_all_identifiers (boolean)
当数据库产生 SQL 时强制所有标识符被引号包围即使它们当前不是关键字。这将影响EXPLAIN的输出以及pg_get_viewdef等函数的结果。另请参阅pg_dump和pg_dumpall的--quote-all-identifiers选项。
standard_conforming_strings (boolean)
控制普通字符串文本...是否按照 SQL 标准把反斜线当普通文本。从PostgreSQL 9.1 开始默认值为on之前的发行中默认值为off。应用可以检查这个参数来判断字符串文本如何被处理。这个参数的存在也可以被当做转义字符串语法E...被支持的标志。如果一个应用希望反斜线被当做转义字符应该使用转义字符串语法。
synchronize_seqscans (boolean)
它允许对大型表的顺序扫描与其他扫描同步因此并发扫描可以在几乎相同的时刻读取相同的块这样可以分担 I/O 负载。当启用这个参数时一个扫描可能会从表的中间开始并且之后“绕回”到开头以覆盖所有的行这样可以与已在进行中的扫描活动同步。对于没有ORDER BY子句的查询来这样的扫描会在返回行的顺序中造成不可预料的改变。将这个参数设置为off以保证 8.3 之前的行为顺序扫描总是从表的起始处开始。默认值是on。
13.2. 平台和客户端兼容性
transform_null_equals (boolean)
当打开时形为expr NULL或NULL expr的表达式将被当做expr IS NULL 也就是说如果expr得出空值值则返回真否则返回假。正确的 SQL 标准兼容的expr NULL行为总是返回空未知。因此这个参数默认为off。
不过在Microsoft Access里的过滤表单生成的查询似乎使用expr NULL来测试空值因此如果你使用这个接口访问数据库你可能想把这个选项打开。因为expr NULL形式的表达式总是返回空值使用 SQL 标准解释。它们不是非常有用并且在普通应用中也不常见在应用中也不常见因此这个选项实际上没有什么危害。但是新用户常常对涉及 空值的表达式的语义上感到困惑因此这个选项默认为关闭。
请注意这个选项只影响 NULL形式而不影响其它比较操作符或者其它与一些涉及等值操作符的表达式在计算上等效的其他表达式例如IN。因此这个选项不是劣质程序的一般修复。
十四、错误处理
exit_on_error (boolean)
如果为真任何错误将中止当前会话。默认情况下这个值被设置为假这样只有 FATAL 错误致命将中止会话。
restart_after_crash (boolean)
当被设置为真默认值时PostgreSQL将在一次后端崩溃后自动重新初始化。让这个值设置为真通常是将数据库可用性最大化的最佳方法。但是在某些环境中例如PostgreSQL被集群软件调用时禁用重启可能很有用这样集群软件可以得到控制并且采取它认为适当的行动。
data_sync_retry (boolean)
如果设置为false默认值PostgreSQL在将修改的数据文件刷新到文件系统失败时将引发PANIC级错误。这样会导致数据库服务器崩溃。
在某些操作系统上回写失败后内核页面缓存中的数据状态未知。 在某些情况下它可能已被完全遗忘因此重试不安全第二次尝试可能报告为成功而事实上数据已丢失。在此类情形下避免数据丢失的唯一方法是在报告任何故障后从WAL中恢复最好是在调查了故障的根本原因并更换了任何有故障的硬件之后。
如果设置为truePostgreSQL将报告错误但会继续运行以便可以在以后的检查点中重试数据刷新操作。仅在调查操作系统假如回写失败时对缓冲数据的处理方式的情况下才将其设置为true。
十五、预置选项
下列“参数”是只读的它们是在编译或安装PostgreSQL时决定的。同样它们被排除在postgresql.conf文件例子之外。这些选项报告特定应用可能感兴趣的多种PostgreSQL行为特别是管理前端相关的行为。
block_size (integer)
报告一个磁盘块的大小。它由编译服务器时BLCKSZ的值确定。默认值是 8192 字节。有些配置变量的含义例如shared_buffers会被block_size影响。
data_checksums (boolean)
报告对这个集簇是否启用了数据校验码。详见data checksums。
data_directory_mode (integer)
在Unix系统上这个参数报告启动时data_directory所定义的数据目录的权限在Microsoft Windows上这个参数将总是显示0700。更多信息请参考group access。
debug_assertions (boolean)
报告编译PostgreSQL时是否启用了断言。 如果PostgreSQL被编译时定义了宏 USE_ASSERT_CHECKING is defined when PostgreSQL例如通过 configure选项 --enable-cassert定义那么会报告已启用。默认情况下 PostgreSQL编译时没有用断言。
integer_datetimes (boolean)
报告PostgreSQL是否在编译时打开了 64 位整数日期和时间。从PostgreSQL 10起这个值总是on。
lc_collate (string)
报告文本数据排序使用的区域。该值是在数据库被创建时确定的。
lc_ctype (string)
报告决定字符分类的区域。该值是在数据库被创建时决定的。通常它和lc_collate一样但是可以为特殊应用设置成不同的值。
max_function_args (integer)
报告函数参数的最大数量。它由编译服务器时的FUNC_MAX_ARGS值决定的。默认值是 100 个参数。
max_identifier_length (integer)
报告标识符的最大长度。它由编译服务器时的NAMEDATALEN值减一决定。NAMEDATALEN的默认值是 64 因此max_identifier_length的默认值是 63但是在使用多字节编码时可以少于 63 个字符。
max_index_keys (integer)
报告索引键的最大数目。它由编译服务器时的INDEX_MAX_KEYS值决定。默认值是 32 个键。
segment_size (integer)
报告一个文件段中可以存储的块页的数量。由编译服务器时的RELSEG_SIZE值决定。一个段文件的最大尺寸以字节计等于segment_size乘以block_size默认是 1GB。
server_encoding (string)
报告数据库的编码字符集。这是在数据库被创建时决定的。通常客户端只需要关心client_encoding的值。
server_version (string)
报告服务器版本数值。它是由编译服务器时的PG_VERSION值决定的。
server_version_num (integer)
报告服务器版本数值的整数值。它是由编译服务器时的PG_VERSION_NUM值决定的。
wal_block_size (integer)
报告一个 WAL 磁盘块的尺寸。由编译服务器时的XLOG_BLCKSZ值决定。默认是 8192 字节。
wal_segment_size (integer)
报告 WAL 段文件的大小。默认是 16MB。
十六、自定义选项
这个特性被设计用来由附加模块向PostgreSQL添加通常不为系统知道的参数例如过程语言。这允许使用标准方法配制扩展模块。
自定义选项有两部分名称一个扩展名然后是一个句点再然后是正确的参数名就像 SQL 中的合格名称。一个例子是plpgsql.variable_conflict。
因为自定义选项可能需要在没有载入相关扩展模块的进程中设置PostgreSQL将接收任意两部分参数名的设置。这种变量被认为是占位符并且在定义它们的模块被载入之前不会有实际功能。当一个扩展模块被载入它将加入它的变量定义、根据那些定义转换任何占位符值并且对以其扩展名开始的任意未识别占位符发出警告。
十七、开发者选项
下面的参数目的是用在PostgreSQL源代码上 并且在某些情况下可以帮助恢复严重损坏了的数据库。在一个生产数据库中没有理由使用它们。同样它们被从例子postgresql.conf文件中排除。请注意许多这些参数要求特殊的源代码编译标志才能工作。
allow_system_table_mods (boolean)
允许对系统表结构的修改。它可以被initdb使用。这个参数只能在服务器启动时设置。
ignore_system_indexes (boolean)
读取系统表时忽略系统索引但是修改系统表时依然同时更新索引。这在从被破坏的系统索引中恢复数据的时有用。这个参数在会话开始之后不能被更改。
post_auth_delay (integer)
如果为非零那么在一个新的服务器进程派生出来之后并且在它开始认证过程之前就会发生这么多秒的延迟。这是为了给开发者们一个机会在一个服务器进程上附加一个调试器。这个参数在会话开始之后不能被更改。
pre_auth_delay (integer)
如果为非零那么在一个新的服务器进程派生出来之后并且在它开始认证过程之前就会发生这么多秒的延迟。这是为了给开发者们一个机会在一个服务器进程上附加一个调试器来跟踪认证过程中的不当行为。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
trace_notify (boolean)
为LISTEN和NOTIFY命令生成大量调试输出。client_min_messages和log_min_messages必须是DEBUG1或者更低才能把这种输出分别发送到客户端或者服务器日志。
trace_recovery_messages (enum)
启用记录与恢复有关的调试输出否则无法记录。这个参数允许用户覆盖log_min_messages的正常设置但只用于指定的消息。这个参数的目的是用来调试热后备。有效值包括DEBUG5、DEBUG4、DEBUG3、DEBUG2、DEBUG1和LOG。默认值LOG完全不会影响日志决定。其他值会记录相关级别或更高级别的与恢复相关的调试消息就好像它们具有LOG优先级一样对于log_min_messages的通用设置这会无条件的将消息发送给服务器日志。这个参数只能在postgresql.conf文件中或在服务器命令行上设置。
trace_sort (boolean)
如果打开发出在排序操作中的资源使用的相关信息。只有在编译PostgreSQL时定义了TRACE_SORT宏 这个参数才可用不过当前在默认情况下就定义了TRACE_SORT。
trace_locks (boolean)
如果开启发出锁使用情况的信息。被转储信息中包括锁操作的类型、锁的类型和 被锁或被解锁对象的唯一标识符。同样包括的还有已经授予这个对象的锁类型的位掩码和 等待这个对象的锁类型的位掩码。对每一种锁类型已授权锁和等待锁的计数也会被一起转储。一个日志文件输出的例子如下
LOG: LockAcquire: new: lock(0xb7acd844) id(24688,24696,0,0,0,1)grantMask(0) req(0,0,0,0,0,0,0)0 grant(0,0,0,0,0,0,0)0wait(0) type(AccessShareLock)
LOG: GrantLock: lock(0xb7acd844) id(24688,24696,0,0,0,1)grantMask(2) req(1,0,0,0,0,0,0)1 grant(1,0,0,0,0,0,0)1wait(0) type(AccessShareLock)
LOG: UnGrantLock: updated: lock(0xb7acd844) id(24688,24696,0,0,0,1)grantMask(0) req(0,0,0,0,0,0,0)0 grant(0,0,0,0,0,0,0)0wait(0) type(AccessShareLock)
LOG: CleanUpLock: deleting: lock(0xb7acd844) id(24688,24696,0,0,0,1)grantMask(0) req(0,0,0,0,0,0,0)0 grant(0,0,0,0,0,0,0)0wait(0) type(INVALID)被转储结构的详细信息可以在src/include/storage/lock.h中找到。
只有在编译PostgreSQL时定义了LOCK_DEBUG宏 这个参数才可用。
trace_lwlocks (boolean)
如果开启发出轻量级锁的使用信息。轻量级锁主要是为了提供对共享内存数据结构的互斥访问。
只有在编译PostgreSQL时定义了LOCK_DEBUG宏 这个参数才可用。
trace_userlocks (boolean)
如果开启发出关于用户锁使用的信息。与trace_locks的输出一样但只用于咨询锁。
只有在编译PostgreSQL时定义了LOCK_DEBUG宏 这个参数才可用。
trace_lock_oidmin (integer)
如果设置不会跟踪小于这个 OID 的锁用于避免在系统表上的输出。
只有在编译PostgreSQL时定义了LOCK_DEBUG宏 这个参数才可用。
trace_lock_table (integer)
无条件地跟踪此表OID上的锁。
只有在编译PostgreSQL时定义了LOCK_DEBUG宏 这个参数才可用。
debug_deadlocks (boolean)
如果设置当死锁超时发生时转储所有当前锁的信息。
只有在编译PostgreSQL时定义了LOCK_DEBUG宏 这个参数才可用。
log_btree_build_stats (boolean)
如果设置会记录 B 树操作上的系统资源使用情况统计内存和 CPU。
只有在编译PostgreSQL时定义了BTREE_BUILD_STATS宏 这个参数才可用。
wal_consistency_checking (string)
这个参数被设计用来检查WAL重做例程中的缺陷。当这个参数被启用时被修改的任何缓冲区的全页映像及其WAL记录都被加入到记录中。如果该记录后来被重放系统将首先应用每个记录然后测试该记录修改的缓冲区是否符合存储的映像。在某些情况下例如提示位小的变动是可以接受的并且会被忽略。任何预期之外的差别都将导致致命错误最后中止恢复。
这个设置的默认值是空字符串它将禁用这一特性。它可以被设置为all以检查所有记录或者被设置为一个逗号分隔的资源管理器列表用以检查那些资源管理器产生的记录。当前支持的资源管理器是heap、heap2、btree、hash、gin、gist、sequence、spgist、brin以及generic。只有超级用户可以更改这一设置。
wal_debug (boolean)
如果被打开WAL 相关的调试输出将被发出。只有在编译PostgreSQL时定义了WAL_DEBUG宏的情况下这个参数才可用。
ignore_checksum_failure (boolean)
只有当data checksums被启用时才有效。
在读取过程中检测到一次校验码失败通常会导致PostgreSQL报告一个错误。设置ignore_checksum_failure为打开会导致系统忽略失败但是仍然报告一个警告并且继续执行。这种行为可能导致崩溃、传播或隐藏损坏或者其他严重的问题。但是它允许你绕过错误并且在块头部仍然健全的情况下从表中检索未损坏的元组。如果头部被损坏即便这个选项被启用系统也将报告一个错误。默认设置是off并且只能被超级用户改变。
zero_damaged_pages (boolean)
检测到一个损坏的页面头部通常会导致PostgreSQL报告一个错误并且中止当前事务。把zero_damaged_pages设置为打开会让系统报告一个警告、把损坏的页面填充零然后继续处理。这种行为会毁掉数据即被损坏页面上的所有行。但是它允许你绕开错误并且从可能存在表中的任何未损坏页面中检索行。如果由于一次硬件或软件错误而发生毁坏这种方法可用于恢复数据。通常你不应该把它设置为打开除非你已经彻底放弃从表的损坏页面中恢复数据。被填充零的页面不会被强制到磁盘上因此我们推荐在再次关闭这个参数之前先重建表或索引。默认的设置是off并且只有超级用户可以改变它。
jit_debugging_support (boolean)
如果LLVM有所需要的功能用GDB注册所生成的函数。这会让调试更加容易。默认设置是off。这个参数只能在服务器启动时设置。
jit_dump_bitcode (boolean)
把生成的LLVM IR写出到文件系统写到data_directory中。只有在做JIT内部实现工作时这个参数才能派上用场。默认设置是off。这个参数只能由超级用户修改。
jit_expressions (boolean)
当JIT编译被激活时确定表达式是否用JIT编译。默认值是on。
jit_profiling_support (boolean)
如果LLVM有所需的功能发出需要的数据以允许perf对JIT生成的函数画像。这会写出文件到$HOME/.debug/jit/中如果需要由用户负责对其执行清除。默认设置是off。这个参数只能在服务器启动时设置。
jit_tuple_deforming (boolean)
当JIT编译被激活时确定元组拆解是否被JIT编译。默认值是on。
十八、短选项
为了方便起见系统中还为一些参数提供了单字母的命令行选项开关。它们在表18.1中描述。其中一些选项是由于历史原因而存在并且它们作为一个单字母选项存在并不表示它们会被大量使用。
表 18.1. 短选项键
短选项等效于-B xshared_buffers x-d xlog_min_messages DEBUGx-edatestyle euro-fb, -fh, -fi, -fm, -fn, -fo, -fs, -ftenable_bitmapscan off, enable_hashjoin off, enable_indexscan off, enable_mergejoin off, enable_nestloop off, enable_indexonlyscan off, enable_seqscan off, enable_tidscan off-Ffsync off-h xlisten_addresses x-ilisten_addresses *-k xunix_socket_directories x-lssl on-N xmax_connections x-Oallow_system_table_mods on-p xport x-Pignore_system_indexes on-slog_statement_stats on-S xwork_mem x-tpa, -tpl, -telog_parser_stats on, log_planner_stats on, log_executor_stats on-W xpost_auth_delay x
