18.18. 开发者选项

下面的参数目的是用在开发测试上, 并且永远不能用于生产数据库。 但是,它们中的一些能够用于帮助恢复严重损坏的数据库。 同样,它们被从例子lightdb.conf文件中排除。 请注意许多这些参数要求特殊的源代码编译标志才能工作。

allow_in_place_tablespaces (boolean)

当向CREATE TABLESPACE命令提供空位置字符串时,允许将表空间创建为lt_tblspc内的目录。这是为了允许测试主服务器和备用服务器在同一台计算机上运行的复制场景。这样的目录可能会混淆备份工具,因为备份工具希望在该位置只找到符号链接。只有超级用户才能更改此设置。

allow_system_table_mods (boolean)

允许对系统表结构的修改,以及对系统表的某些其他危险操作。这是不允许的,即使是对超级用户。 不理智地使用此设置可能导致无法恢复的数据丢失或严重损坏数据库系统。只有超级用户才能更改此设置

backtrace_functions (string)

这个参数包含一个以逗号分隔的C函数名称列表。 如果出现错误,并且发生错误的内部C函数的名称与列表中的值相匹配,那么将向服务器日志中写入一个回溯跟踪信息和错误消息。 这可以用来调试源代码的特定区域。

回溯支持并非在所有平台上都可以使用,并且回溯的质量取决于编译选项。

该参数只能由超级用户设置。

ignore_system_indexes (boolean)

读取系统表时忽略系统索引(但是修改系统表时依然同时更新索引)。这在从被破坏的系统索引中恢复数据的时有用。这个参数在会话开始之后不能被更改。

post_auth_delay (integer)

执行身份验证过程后启动新服务器进程时延迟的时间量。这是为了给开发者们一个机会在一个服务器进程上附加一个调试器。 如果指定值时没有单位,则以秒为单位。0值(默认值)禁用延迟。这个参数在会话开始之后不能被更改。

pre_auth_delay (integer)

在新服务器进程分叉后,在进行身份验证过程之前,延迟的时间量。这是为了给开发者们一个机会在一个服务器进程上附加一个调试器来跟踪认证过程中的不当行为。 如果指定值时没有单位,则以秒为单位。0值(默认值)禁用延迟。这个参数只能在lightdb.conf文件中或在服务器命令行上设置。

trace_notify (boolean)

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

trace_recovery_messages (enum)

启用记录与恢复有关的调试输出,否则无法记录。这个参数允许用户覆盖log_min_messages的正常设置,但只用于指定的消息。这个参数的目的是用来调试热后备。有效值包括DEBUG5DEBUG4DEBUG3DEBUG2DEBUG1LOG。默认值LOG完全不会影响日志决定。其他值会记录相关级别或更高级别的与恢复相关的调试消息,就好像它们具有LOG优先级一样;对于log_min_messages的通用设置,这会无条件的将消息发送给服务器日志。这个参数只能在lightdb.conf文件中或在服务器命令行上设置。

trace_sort (boolean)

如果打开,发出在排序操作中的资源使用的相关信息。只有在编译LightDB时定义了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中找到。

只有在编译LightDB时定义了LOCK_DEBUG宏, 这个参数才可用。

trace_lwlocks (boolean)

如果开启,发出轻量级锁的使用信息。轻量级锁主要是为了提供对共享内存数据结构的互斥访问。

只有在编译LightDB时定义了LOCK_DEBUG宏, 这个参数才可用。

trace_userlocks (boolean)

如果开启,发出关于用户锁使用的信息。与trace_locks的输出一样,但只用于咨询锁。

只有在编译LightDB时定义了LOCK_DEBUG宏, 这个参数才可用。

trace_lock_oidmin (integer)

如果设置,不会跟踪小于这个 OID 的锁(用于避免在系统表上的输出)。

只有在编译LightDB时定义了LOCK_DEBUG宏, 这个参数才可用。

trace_lock_table (integer)

无条件地跟踪此表(OID)上的锁。

只有在编译LightDB时定义了LOCK_DEBUG宏, 这个参数才可用。

debug_deadlocks (boolean)

如果设置,当死锁超时发生时,转储所有当前锁的信息。

只有在编译LightDB时定义了LOCK_DEBUG宏, 这个参数才可用。

log_btree_build_stats (boolean)

如果设置,会记录 B 树操作上的系统资源使用情况统计(内存和 CPU)。

只有在编译LightDB时定义了BTREE_BUILD_STATS宏, 这个参数才可用。

wal_consistency_checking (string)

这个参数被设计用来检查WAL重做例程中的缺陷。当这个参数被启用时,被修改的任何缓冲区的全页映像及其WAL记录都被加入到记录中。如果该记录后来被重放,系统将首先应用每个记录然后测试该记录修改的缓冲区是否符合存储的映像。在某些情况下(例如提示位),小的变动是可以接受的,并且会被忽略。任何预期之外的差别都将导致致命错误,最后中止恢复。

这个设置的默认值是空字符串,它将禁用这一特性。它可以被设置为all以检查所有记录,或者被设置为一个逗号分隔的资源管理器列表用以检查那些资源管理器产生的记录。当前,支持的资源管理器是heapheap2btreehashginsequence以及generic。只有超级用户可以更改这一设置。

wal_debug (boolean)

如果被打开,WAL 相关的调试输出将被发出。只有在编译LightDB时定义了WAL_DEBUG宏的情况下,这个参数才可用。

ignore_checksum_failure (boolean)

只有当data checksums被启用时才有效。

在读取过程中检测到一次校验码失败通常会导致LightDB报告一个错误。设置ignore_checksum_failure为打开会导致系统忽略失败(但是仍然报告一个警告),并且继续执行。这种行为可能导致崩溃、传播或隐藏损坏或者其他严重的问题。但是,它允许你绕过错误并且在块头部仍然健全的情况下从表中检索未损坏的元组。如果头部被损坏,即便这个选项被启用系统也将报告一个错误。默认设置是off,并且只能被超级用户改变。

zero_damaged_pages (boolean)

检测到一个损坏的页面头部通常会导致LightDB报告一个错误,并且中止当前事务。把zero_damaged_pages设置为打开会让系统报告一个警告、把损坏的页面填充零,然后继续处理。这种行为会毁掉数据,即被损坏页面上的所有行。但是它允许你绕开错误并且从可能存在表中的任何未损坏页面中检索行。如果由于一次硬件或软件错误而发生毁坏,这种方法可用于恢复数据。通常你不应该把它设置为打开,除非你已经彻底放弃从表的损坏页面中恢复数据。被填充零的页面不会被强制到磁盘上,因此我们推荐在再次关闭这个参数之前先重建表或索引。默认的设置是off,并且只有超级用户可以改变它。

ignore_invalid_pages (boolean)

如果设置为 off(默认值),则在恢复期间检测到引用无效页面的 WAL 记录会导致 LightDB 引发 PANIC 级别错误,中止恢复。 将ignore_invalid_pages设置为on会导致系统忽略 WAL 记录中的无效页面引用(但仍报告警告),并继续恢复。 此行为可能会导致崩溃、数据丢失、传播或隐藏腐败,或其他严重问题。 但是,它可能允许你通过 PANIC 级错误,完成恢复,并启动服务器。 参数只能在服务器启动时设置。它仅在恢复期间或待机模式下生效。