19.17. 开发者选项

下面的参数目的是用在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)

LISTENNOTIFY命令生成大量调试输出。client_min_messageslog_min_messages必须是DEBUG1或者更低才能把这种输出分别发送到客户端或者服务器日志。

trace_recovery_messages (enum)

启用记录与恢复有关的调试输出,否则无法记录。这个参数允许用户覆盖log_min_messages的正常设置,但只用于指定的消息。这个参数的目的是用来调试热后备。有效值包括DEBUG5DEBUG4DEBUG3DEBUG2DEBUG1LOG。默认值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)=0
      wait(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)=1
      wait(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)=0
      wait(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)=0
      wait(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以检查所有记录,或者资源管理器的逗号分隔列表, 以仅检查源自这些资源管理器的记录。目前,支持的资源管理器是 heapheap2btreehashgingistsequencespgistbringeneric。 只有超级用户可以更改此设置。

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,并且只有超级用户可以改变它。