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)
为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) 如果开启,发出锁使用情况的信息。被转储信息中包括锁操作的类型、锁的类型和被锁或被解锁对象的唯一标识符。同样包括的还有已经授予这个对象的锁类型的位掩码和等待这个对象的锁类型的位掩码。对每一种锁类型,已授权锁和等待锁的计数也会被一起转储。一个日志文件输出的例子如下:
代码语言:javascript复制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以检查所有记录,或者被设置为一个逗号分隔的资源管理器列表用以检查那些资源管理器产生的记录。当前,支持的资源管理器是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编译被激活时(见Section 32.2),确定表达式是否用JIT编译。默认值是on。
jit_profiling_support (boolean) 如果LLVM有所需的功能,发出需要的数据以允许perf对JIT生成的函数画像。这会写出文件到$HOME/.debug/jit/中,如果需要,由用户负责对其执行清除。默认设置是off。这个参数只能在服务器启动时设置。
jit_tuple_deforming (boolean) 当JIT编译被激活时(见Section 32.2),确定元组拆解是否被JIT编译。默认值是on。