参阅Section 30.4获取调节这些设置的额外信息。
wal_level
(enum
)
wal_level
决定多少信息写入到 WAL 中。默认值是replica
,它会写入足够的数据以支持WAL归档和复制,包括在后备服务器上运行只读查询。minimal
会去掉除从崩溃或者立即关机中进行恢复所需的信息之外的所有记录。最后,logical
会增加支持逻辑解码所需的信息。每个层次包括所有更低层次记录的信息。这个参数只能在服务器启动时设置。
在minimal
级别中,某些批量操作的 WAL 日志可以被安全地跳过,这可以使那些操作更快(见Section 14.4.7)。这种优化可以应用的操作包括:
CREATE TABLE AS |
CREATE INDEX |
CLUSTER |
COPY 到在同一个事务中被创建或截断的表中 |
但最少的 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
可以作为一个有效的代替手段。更多讨论见Section 30.3。
如果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 中的默认值。默认值不一定是最理想的;有可能需要修改这个设置或系统配置的其他方面来创建一个崩溃-安全的配置,或达到最佳性能。这些方面在Section 30.1中讨论。这个参数只能在postgresql.conf
文件中或在服务器命令行上设置。
full_page_writes
(boolean
)
当这个参数为打开时,PostgreSQL服务器在一个检查点之后的页面的第一次修改期间将每个页面的全部内容写到 WAL 中。这么做是因为在操作系统崩溃期间正在处理的一次页写入可能只有部分完成,从而导致在一个磁盘页面中混合有新旧数据。在崩溃后的恢复期间,通常存储在 WAL 中的行级改变数据不足以完全恢复这样一个页面。存储完整的页面映像可以保证页面被正确存储,但代价是增加了必须被写入 WAL 的数据量(因为 WAL 重放总是从一个检查点开始,所以在检查点后每个页面的第一次改变时这样做就够了。因此,一种减小全页面写开销的方法是增加检查点间隔参数值)。
把这个参数关闭会加快正常操作,但是在系统失败后可能导致不可恢复的数据损坏,或者静默的数据损坏。其风险类似于关闭fsync
, 但是风险较小。并且只有在可关闭fsync
的情况下才应该关闭它。
关闭这个选项并不影响用于时间点恢复(PITR)的 WAL 归档使用(见Section 25.3)。
这个参数只能在postgresql.conf
文件中或在服务器命令行上设置。默认值是on
。
wal_log_hints
(boolean
)
当这个参数为on
时,PostgreSQL服务器一个检查点之后页面被第一次修改期间把该磁盘页面的整个内容都写入 WAL,即使对所谓的提示位做非关键修改也会这样做。
如果启用了数据校验和,提示位更新总是会被 WAL 记录并且这个设置会被忽略。你可以使用这个 设置测试如果你的数据库启用了数据校验和,会有多少额外的 WAL 记录发生。
这个参数只能在服务器启动时设置。默认值是off
。
wal_compression
(boolean
)
当这个参数为on
时,如果full_page_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
延迟时,要求的并发活动事务的最小数目。大一些的值会导致在延迟间隔期间更可能有至少另外一个事务准备好提交。默认值是五个事务。
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
或者服务器命令行中设置。
archive_mode
(enum
)
当启用archive_mode
时,可以通过设置
archive_command命令将完成的 WAL 段发送到
归档存储。除用于禁用的off
之外,还有两种模式:
on
和always
。在普通操作期间,这两种模式之间
没有区别,但是当设置为always
时,WAL 归档器在归档恢复
或者后备模式下也会被启用。在always
模式下,所有从归档恢复
的或者用流复制传来的文件将被(再次)归档。详见
Section 26.2.9。
archive_mode
和archive_command
是独立的变量,这样可以在不影响归档模式的前提下修改archive_command
。这个参数只能在服务器启动时设置。当wal_level
被设置为minimal
时,archive_mode
不能被启用。
archive_command
(string
)
本地 shell 命令被执行来归档一个完成的 WAL 文件段。字符串中的任何%p
被替换成要被归档的文件的路径名, 而%f
只被文件名替换(路径名是相对于服务器的工作目录, 即集簇的数据目录)。如果要在命令里嵌入一个真正的%
字符,可以使用%%
。有一点很重要,该命令只在成功时返回一个零作为退出状态。更多信息请见Section 25.3.1。
这个参数只能在postgresql.conf
文件中或在服务器命令行上设置。除非服务器启动时启用了archive_mode
,否则它会被忽略。如果archive_mode
被启用时,archive_command
是一个空字符串(默认),WAL 归档会被临时禁用,但服务器仍会继续累计 WAL 段文件,期待着一个命令被提供。将archive_command
设置为一个只返回真但不做任何事的命令(例如/bin/true
或 Windows 上的REM
)实际上会禁用归档,也会打破归档恢复所需的 WAL 文件链,因此只有在极少数情况下才能用。
archive_timeout
(integer
)
archive_command仅在已完成的 WAL 段上调用。因此,如果你的服务器只产生很少的 WAL 流量(或产生流量的周期很长),那么在事务完成和它被安全地记录到归档存储之间将有一个很长的延迟。为了限制未归档数据存在的时间,你可以设置archive_timeout
来强制服务器来周期性地切换到一个新的 WAL 段文件。当这个参数被设置为大于零时,只要从上次段文件切换后过了参数所设置的那么多秒并且已经有过任何数据库活动(包括一个单一检查点),服务器将切换到一个新的段文件(如果没有数据库活动则会跳过检查点)。注意,由于强制切换而提早关闭的被归档文件仍然与完整的归档文件长度相同。因此,使用非常短的archive_timeout
是不明智的 — 它将占用巨大的归档存储。一分钟左右的archive_timeout
设置通常比较合理。如果你希望数据能被更快地从主服务器上复制下来,你应该考虑使用流复制而不是归档。这个参数只能在postgresql.conf
文件中或在服务器命令行上设置。