SHOW TABLE SETTINGS 是一个 SQL 语句，用于以与配置文件兼容的格式显示每个表的设置。

语法为：

SHOW TABLE table_name[.N | CHUNK N] SETTINGS

输出类似于 indextool 工具的 --dumpconfig 选项。报告提供了所有表设置的详细分解，包括分词器和字典选项。

您还可以指定特定的块编号，以查看 RT 表中特定块的设置。编号从 0 开始。

当使用UPDATE实时修改文档属性时，更改首先写入属性的内存副本。这些更新发生在内存映射文件中，意味着由操作系统决定何时将更改写入磁盘。在searchd正常关闭（由SIGTERM信号触发）时，所有更改都会被强制写入磁盘。

您也可以指示searchd定期将这些更改写回磁盘以防止数据丢失。这些刷新操作之间的间隔由attr_flush_period决定，以秒为单位（或使用特殊后缀）。

默认值为0，表示禁用定期刷新。但是，在正常关闭时仍会发生刷新。

此设置控制表的自动OPTIMIZE压缩过程。

默认情况下，表压缩会自动进行。您可以通过auto_optimize设置修改此行为：

• 0 表示禁用自动表压缩（您仍可以手动调用OPTIMIZE）
• 1 表示显式启用
• 启用它，同时将优化阈值乘以2。

默认情况下，OPTIMIZE会一直运行，直到磁盘块数量小于或等于逻辑CPU核心数乘以2。

但是，如果表具有KNN索引属性，则此阈值不同。在这种情况下，为了提高KNN搜索性能，它被设置为物理CPU核心数除以2。

请注意，开启或关闭auto_optimize不会阻止您手动运行OPTIMIZE TABLE。

Manticore支持自动创建尚不存在但在INSERT语句中指定的表。此功能默认启用。要禁用它，请在配置中显式设置auto_schema = 0。要重新启用，请设置auto_schema = 1或从配置中移除auto_schema设置。

请注意，/bulk HTTP端点不支持自动表创建。

注意：自动模式功能需要Manticore Buddy。如果它不工作，请确保Buddy已安装。

此设置控制二进制日志事务刷新/同步模式。它是可选的，默认值为2（每次事务刷新，每秒同步一次）。

该指令决定二进制日志刷新到操作系统并同步到磁盘的频率。支持三种模式：

• 0，每秒刷新和同步一次。这提供了最佳性能，但在服务器崩溃或操作系统/硬件崩溃时，最多可能丢失一秒钟内已提交的事务。
• 1，每次事务都刷新和同步。此模式性能最差，但保证每个已提交事务的数据都被保存。
• 2，每次事务刷新，每秒同步一次。此模式提供良好的性能，并确保在服务器崩溃时每个已提交的事务都被保存。但是，在操作系统/硬件崩溃的情况下，最多可能丢失一秒钟内已提交的事务。

对于熟悉MySQL和InnoDB的用户，此指令类似于innodb_flush_log_at_trx_commit。在大多数情况下，默认的混合模式2在速度和安全性之间提供了良好的平衡，既能完全保护RT表数据免受服务器崩溃的影响，也能在一定程度上防范硬件崩溃。

此设置控制二进制日志文件的管理方式。它是可选的，默认值为0（每个表单独文件）。

您可以选择两种管理二进制日志文件的方式：

• 每个表单独文件（默认，0）：每个表将其更改保存在自己的日志文件中。如果您有许多在不同时间更新的表，这种设置很好。它允许表在更新时无需等待其他表。此外，如果一个表的日志文件出现问题，不会影响其他表。
• 所有表共享单个文件（1）：所有表使用同一个二进制日志文件。这种方法使文件管理更容易，因为文件数量更少。但是，如果一个表仍需要保存其更新，这可能会导致文件保留时间超过必要。如果许多表需要同时更新，此设置也可能减慢速度，因为所有更改都必须等待写入一个文件。

此设置控制二进制日志文件的最大大小。它是可选的，默认值为256 MB。

一旦当前二进制日志文件达到此大小限制，将强制打开一个新的二进制日志文件。这导致日志粒度更细，在某些边界工作负载下可以实现更高效的二进制日志磁盘使用。值为0表示不应基于大小重新打开二进制日志文件。

此设置确定二进制日志（也称为事务日志）文件的路径。它是可选的，默认值为构建时配置的数据目录（例如，Linux中为/var/lib/manticore/data/binlog.*）。

二进制日志用于RT表数据的崩溃恢复，以及属性更新的普通磁盘索引，否则这些数据只会存储在RAM中直到刷新。当启用日志记录时，每个提交到RT表的事务都会被写入日志文件。日志会在非正常关机后启动时自动重放，从而恢复已记录的更改。

binlog_path 指令指定二进制日志文件的位置。它只应包含路径；searchd将在该目录下根据需要创建和解除链接多个 binlog.* 文件（包括binlog数据、元数据以及锁文件等）。

设为空值会禁用二进制日志，这可以提升性能，但会使RT表数据处于风险中。

此设置控制 boolean_simplify 搜索选项的默认值。它是可选的，默认值为1（启用）。

当设置为1时，服务器会自动应用 布尔查询优化 来提升查询性能。当设置为0时，默认不进行优化执行查询。此默认值可以通过对应的搜索选项 boolean_simplify 按每个查询进行覆盖。

此设置决定 Manticore Buddy 可执行文件的路径。它是可选的，默认值为构建时配置的路径，在不同操作系统之间可能不同。通常情况下，无需修改此设置。但如果你希望以调试模式运行 Manticore Buddy、修改 Manticore Buddy 或实现新插件，此设置将很有用。对于后一种情形，你可以从 https://github.com/manticoresoftware/manticoresearch-buddy 克隆Buddy，向 ./plugins/ 目录添加新插件，并在切换至Buddy源代码目录后运行 composer install --prefer-source 便于开发。

为确保你可以运行 composer，你的机器必须安装PHP 8.2或更高，并包含以下扩展：

--enable-dom
--with-libxml
--enable-tokenizer
--enable-xml
--enable-xmlwriter
--enable-xmlreader
--enable-simplexml
--enable-phar
--enable-bcmath
--with-gmp
--enable-debug
--with-mysqli
--enable-mysqlnd

你也可以选择releases中的Linux amd64专用 manticore-executor-dev 版本，例如：https://github.com/manticoresoftware/executor/releases/tag/v1.0.13

如果采用此方法，请记住将manticore executor的dev版本链接至 /usr/bin/php。

要禁用 Manticore Buddy，只需如示例所示将值设为空即可。

此设置用于指定使用持久连接时两次请求之间的最大等待时间（以秒或特殊后缀为单位）。它是可选的，默认值为五分钟。

服务器libc区域设置。可选，默认是C。

指定libc区域设置，影响基于libc的排序规则。详情请参阅 collations 部分。

服务器默认排序规则。可选，默认是libc_ci。

指定用于传入请求的默认排序规则。排序规则可以在每个查询上单独覆盖。有关可用排序规则及其它详细信息，请参阅 collations 部分。

当指定此设置后，会启用实时模式，这是管理数据模式的一种命令式方式。该值应为你希望存储所有表、二进制日志及Manticore Search在此模式下正常运行所需所有内容的目录路径。 当指定 data_dir 时，不允许为普通表建立索引。关于RT模式与普通模式的区别，请参见本节。

用于防止在表内无搜索时自动刷新RAM块的超时时间。可选，默认30秒。

用于在自动刷新前检测表中有无搜索的时间。 只有在最近 diskchunk_flush_search_timeout 秒内表中至少有一次搜索，才会自动刷新。该设置与 diskchunk_flush_write_timeout 联合工作。对应的每表设置具有更高优先级，并将覆盖该实例级默认值，为你带来更细致的控制。

在没有写入的情况下等待多少秒后自动将RAM块刷新到磁盘。可选，默认值为1秒。

如果在 diskchunk_flush_write_timeout 秒内没有写入发生，该 RAM 块将被刷新到磁盘。此设置与 diskchunk_flush_search_timeout 配合使用。要禁用自动刷新，请在配置中显式设置 diskchunk_flush_write_timeout = -1。相应的每表设置优先级更高，会覆盖此实例范围的默认值，提供更细粒度的控制。

此设置指定了文档存储中保存在内存中的文档块的最大大小。此项为可选，默认值为 16m（16 兆字节）。

当使用 stored_fields 时，会从磁盘读取并解压文档块。由于每个块通常包含多个文档，因此在处理下一个文档时可以重用该块。为此，块被保存在服务器范围的缓存中。缓存中保存的是未压缩的块。

在 RT 模式创建表时使用的默认属性存储引擎。可以是 rowwise（默认）或者 columnar。

此设置决定单个通配符展开的最大关键字数。可选，默认值为 0（无限制）。

当对启用了 dict = keywords 的表执行子字符串搜索时，单个通配符可能会匹配成千上万甚至数百万个关键字（比如匹配整个牛津词典中的 a*）。该指令允许限制此类展开的影响。设置 expansion_limit = N 可限制每个通配符在查询中最多展开为 N 个出现频率最高的匹配关键字。

此设置决定允许合并所有此类关键字的扩展关键字中的最大文档数。可选，默认值为 32。

当对启用了 dict = keywords 的表执行子字符串搜索时，单个通配符可能会匹配成千上万甚至数百万个关键字。此指令允许你增加允许合并的关键字数目，以加快匹配速度，但会使用更多内存。

此设置决定允许合并所有此类关键字的扩展关键字中的最大命中数。可选，默认值为 256。

当对启用了 dict = keywords 的表执行子字符串搜索时，单个通配符可能会匹配成千上万甚至数百万个关键字。此指令允许你增加允许合并的关键字数目，以加快匹配速度，但会使用更多内存。

此设置控制由于 PHRASE、PROXIMITY 和 QUORUM 操作符内部的 OR 运算符所生成的最大替代短语变体数。可选，默认值为 1024。

当在类似短语的操作符中使用 |（或）运算符时，展开的总组合数可能会根据指定的替代项数量呈指数增长。该设置通过限制查询处理期间考虑的排列数，有助于防止过度的查询展开。

如果生成的变体数超过此限制，查询将：

• 失败并返回错误（默认行为）
• 如果启用 expansion_phrase_warning，则返回带有警告的部分结果

此设置控制当查询展开限制由 expansion_phrase_limit 超过时的行为。

默认情况下，查询将失败并返回错误信息。当 expansion_phrase_warning 设置为 1 时，搜索会继续使用短语的部分转换（直到配置限制），并且服务器会向用户返回带有警告信息的结果集。这样，过于复杂而无法完全展开的查询仍能返回部分结果而不会完全失败。

此设置指定代理镜像统计窗口大小，单位为秒（或特殊后缀）。此选项可选，默认值为60秒。

对于包含代理镜像的分布式表（详见代理），主节点跟踪多个不同每镜像计数器。这些计数器随后用于故障转移与平衡（主节点基于计数器选择最佳镜像使用）。计数器累积于ha_period_karma秒区块。

开始新区块后，主节点仍可使用前区块累积值直至新区块半满。因此，任何前历史最多于1.5倍ha_period_karma秒后停止影响镜像选择。

尽管最多两区块用于镜像选择，为诊断目的存储至15最近区块。这些区块可通过SHOW AGENT STATUS语句检查。

此设置配置代理镜像ping间隔，单位为毫秒（或特殊后缀）。此选项可选，默认值为1000毫秒。

对于包含代理镜像的分布式表（详见代理），主节点于空闲期间向所有镜像发送ping命令。此用于跟踪当前代理状态（存活或死亡，网络往返等）。此类ping间隔由此指令定义。为禁用ping，设置ha_ping_interval为0。

listen_backlog 设置决定了 TCP 监听传入连接的队列长度。这对于逐个处理请求的 Windows 版本尤为重要。当连接队列达到限制时，新进入的连接将被拒绝。 对于非 Windows 版本，默认值通常即可，通常无需调整此设置。

返回给 Kibana 或 OpenSearch Dashboards 的服务器版本字符串。可选——默认设置为 7.6.0。

某些版本的 Kibana 和 OpenSearch Dashboards 期望服务器报告特定的版本号，且根据版本号可能表现不同。为解决此类问题，可以使用此设置，让 Manticore 向 Kibana 或 OpenSearch Dashboards 报告自定义版本。

该设置允许您指定 Manticore 接受连接的 IP 地址及端口，或 Unix 域套接字路径。

listen 的通用语法是：

listen = ( address ":" port | port | path | address ":" port start - port end ) [ ":" protocol [ "_vip" ] [ "_readonly" ] ]

您可以指定：

• IP 地址（或主机名）和端口号
• 或仅端口号
• 或 Unix 套接字路径（Windows 不支持）
• 或 IP 地址和端口范围

如果您指定端口号但未指定地址，searchd 将监听所有网络接口。Unix 路径以斜杠开头标识。端口范围只能为复制协议设置。

您还可以指定用于该套接字连接的协议处理程序（监听器）。监听器包括：

• 未指定 - Manticore 将接受此端口上传入连接，来源于：
  • 其他 Manticore 代理（例如远程分布式表）
  • 通过 HTTP 和 HTTPS 的客户端
  • Manticore Buddy。确保您有此类监听器（或如下面提及的 http 监听器）以避免 Manticore 功能受限。
• mysql MySQL 协议，供 MySQL 客户端连接。注意：
  • 也支持压缩协议。
  • 如果启用了 SSL，可以进行加密连接。
• replication - 用于节点间通信的复制协议。更多细节见复制部分。您可以指定多个复制监听器，但它们必须监听相同的 IP，只能端口不同。若您定义带端口范围的复制监听器（如 listen = 192.168.0.1:9320-9328:replication），Manticore 不会立即监听这些端口，而是在开始使用复制时，从指定范围内随机选取空闲端口监听。为保证复制正常工作，端口范围内至少要有 2 个端口。
• http - 同 未指定。Manticore 将接受远程代理及通过 HTTP 和 HTTPS 的客户端连接。
• https - HTTPS 协议。Manticore 将 仅 在此端口接受 HTTPS 连接。更多细节见SSL章节。
• sphinx - 传统二进制协议。用于接受远程 SphinxSE 客户端连接。某些 Sphinx API 客户端实现（如 Java 客户端）需要显式声明监听器。

对客户端协议添加后缀 _vip（即除 replication 外的所有，例如 mysql_vip、http_vip 或仅 _vip）会强制为该连接创建专用线程，以绕过各种限制。在节点维护或严重过载时服务器可能挂起或无法通过普通端口连接时，此功能很有用。

后缀 _readonly 会为监听器设置只读模式，并限制仅接受读取查询。

日志设置指定所有searchd运行时事件将记录的日志文件名。如果没有指定，默认名称为'searchd.log'。

或者，您可以使用 'syslog' 作为文件名。在这种情况下，事件将被发送到 syslog 守护进程。要使用 syslog 选项，您需要在构建期间使用 -–with-syslog 选项配置 Manticore。

限制每批查询的数量。可选，默认值为 32。

当使用 multi-queries 时，使 searchd 对单个批处理中提交的查询数量进行合理性检查。设置为 0 可跳过检查。

最大同时客户端连接数。默认无限制。通常只有在使用任何类型的持久连接时才会显著影响，如 cli mysql 会话或来自远程分布式表的持久远程连接。超过限制后，您仍然可以使用 VIP connection 连接到服务器。VIP 连接不计入限制。

一个操作可使用的线程实例范围限制。默认情况下，适当的操作可以占用所有 CPU 核心，导致没有空间给其他操作。例如，对一个相当大的 percolate 表执行 call pq 可以使用所有线程持续几十秒。将 max_threads_per_query 设置为比如说 threads 的一半，将确保您可以并行运行几个这样的 call pq 操作。

您还可以在运行时作为会话或全局变量设置此配置。

此外，您还可以借助 threads OPTION 对单个查询进行控制。

单查询允许的最大过滤器数量。此设置仅用于内部合理性检查，不直接影响内存使用或性能。可选，默认值为 256。

单个过滤器允许的最大值数量。此设置仅用于内部合理性检查，不直接影响内存使用或性能。可选，默认值为 4096。

服务器允许打开的最大文件数称为“软限制”。请注意，服务大型碎片化实时表可能需要将此限制设置得较高，因为每个磁盘块可能占用十几个或更多文件。例如，一个有 1000 个块的实时表可能需要同时打开数千个文件。如果您在日志中遇到“Too many open files”错误，请尝试调整此选项，因为它可能有助于解决该问题。

还有一个“硬限制”是选项无法超越的限制。此限制由系统定义，可以在 Linux 的 /etc/security/limits.conf 文件中更改。其他操作系统可能有不同的方法，具体请查询相关手册。

除了直接的数字值，您还可以使用魔法字 'max' 将限制设置为当前可用的硬限制。

允许的最大网络包大小。本设置限制分布式环境中客户端的查询包和远程代理的响应包。仅用于内部合理性检查，不直接影响内存使用或性能。可选，默认值为 128M。

通过 MySQL 协议返回的服务器版本字符串。可选，默认为空（返回 Manticore 版本）。

某些挑剔的 MySQL 客户端库依赖 MySQL 使用的特定版本号格式，而且有时根据报告的版本号（而非指示的功能标志）选择不同的执行路径。例如，Python MySQLdb 1.2.2 当版本号不符合 X.Y.ZZ 格式时会抛出异常；MySQL .NET 连接器 6.3.x 对版本号为 1.x 并且带有某些组合标志时会内部失败，等等。为了解决这些问题，您可以使用 mysql_version_string 指令，让 searchd 向通过 MySQL 协议连接的客户端报告不同的版本号。（默认情况下，它报告自己的版本。）

网络客户端请求读/写超时，单位为秒（或特殊后缀）。可选，默认值为5秒。searchd 将强制关闭在此超时时间内未能发送查询或读取结果的客户端连接。

另请注意 reset_network_timeout_on_packet 参数。此参数将 network_timeout 的行为从应用于整个 query 或 result 更改为应用于单个数据包。通常，一个查询/结果适合在一个或两个数据包内。但是，在需要大量数据的情况下，此参数对于保持操作活动非常宝贵。

此设置允许您指定节点的网络地址。默认情况下，它设置为复制 listen 地址。在大多数情况下这是正确的；但是，在某些情况下您必须手动指定它：

• 节点位于防火墙后面
• 启用了网络地址转换（NAT）
• 容器部署，例如 Docker 或云部署
• 节点分布在多个区域的集群

此设置决定是否允许仅包含否定全文运算符的查询。可选，默认值为0（使仅包含NOT运算符的查询失败）。

设置默认的表压缩阈值。在此处阅读更多信息 - 优化磁盘块数。此设置可以通过每个查询选项 cutoff 覆盖。也可以通过 SET GLOBAL 动态更改。

此设置确定到远程持久代理的最大同时持久连接数。每次连接到 agent_persistent 下定义的代理时，我们尝试重用现有连接（如果有），或者连接并保存该连接以供将来使用。但是，在某些情况下，限制此类持久连接的数量是有意义的。此指令定义了该限制。它影响跨所有分布式表到每个代理主机的连接数。

将此值设置为等于或小于代理配置中的 max_connections 选项是合理的。

pid_file 是 Manticore 搜索中的一个必需配置选项，它指定存储 searchd 服务器进程ID的文件路径。

searchd 进程ID文件在启动时重新创建并锁定，并在服务器运行时包含主服务器进程ID。在服务器关闭时取消链接。 此文件的目的是使 Manticore 能够执行各种内部任务，例如检查是否已有正在运行的 searchd 实例、停止 searchd 以及通知它应该轮换表。该文件也可用于外部自动化脚本。

查询时间预测模型的成本，单位为纳秒。可选，默认值为 doc=64, hit=48, skip=2048, match=64。

基于执行时间（通过最大查询时间设置）在完成前终止查询是一个很好的安全网，但它有一个固有的缺点：非确定性（不稳定）的结果。也就是说，如果您多次重复执行相同的（复杂）搜索查询并设置时间限制，时间限制将在不同阶段被触发，并且您将得到不同的结果集。

preopen_tables配置指令指定是否在启动时强制预打开所有表。默认值为1，这意味着无论每个表的preopen设置如何，所有表都将被预打开。如果设置为0，则每个表的设置可以生效，并且它们将默认为0。

预打开表可以防止搜索查询和轮换之间的竞争，这种竞争偶尔会导致查询失败。然而，它也会使用更多的文件句柄。在大多数场景中，建议预打开表。

以下是一个配置示例：

pseudo_sharding配置选项启用对本地普通表和实时表的搜索查询并行化，无论它们是直接查询还是通过分布式表查询。此功能将自动并行化查询，最多使用searchd.threads中指定的线程数。

请注意，如果您的worker线程已经繁忙，因为您有以下情况：

• 高查询并发
• 任何类型的物理分片：
  • 由多个普通/实时表组成的分布式表
  • 包含过多磁盘块的实时表

那么启用pseudo_sharding可能不会带来任何好处，甚至可能导致吞吐量略有下降。如果您更看重高吞吐量而非低延迟，建议禁用此选项。

默认启用。

此配置设置用于缓存结果集的最大RAM量，单位为字节。默认值为16777216，相当于16兆字节。如果该值设置为0，则查询缓存被禁用。有关查询缓存的更多信息，请参阅query cache了解详情。

查询日志格式。可选，允许的值为plain和sphinxql，默认为sphinxql。

sphinxql 模式记录有效的 SQL 语句。plain 模式以纯文本格式记录查询（主要适用于纯全文本用例）。此指令允许您在搜索服务器启动时在这两种格式之间切换。日志格式也可以使用 SET GLOBAL query_log_format=sphinxql 语法动态更改。更多详细信息请参阅 查询日志。

查询日志文件名。可选，默认为空（不记录查询）。所有搜索查询（如 SELECT ...，但不包括 INSERT/REPLACE/UPDATE 查询）都会记录在该文件中。格式描述见 查询日志。在使用 'plain' 格式时，可以使用 'syslog' 作为日志文件路径。在这种情况下，所有搜索查询将以 LOG_INFO 优先级发送到 syslog 守护进程，前缀为 '[query]'，而不是时间戳。要使用 syslog 选项，Manticore 必须在构建时配置为 --with-syslog。

query_log_mode 指令允许您为 searchd 和查询日志文件设置不同的权限。默认情况下，这些日志文件创建时权限为 600，意味着只有运行服务器的用户和 root 用户可以读取日志文件。 如果您希望允许其他用户读取日志文件，比如在非 root 用户下运行的监控方案，这个指令非常有用。

read_buffer_docs 指令控制关键词文档列表的读取缓冲区大小。对于每个搜索查询中的每个关键词出现，都会有两个相关的读取缓冲区：一个用于文档列表，一个用于命中列表。此设置允许您控制文档列表的缓冲区大小。

更大的缓冲区大小可能增加每查询的内存使用，但可能减少 I/O 时间。对于慢速存储，设置较大值是合理的，但对于能够实现高 IOPS 的存储，应在较小值区域进行试验。

默认值为 256K，最小值为 8K。您也可以在每个表级别设置 read_buffer_docs，它会覆盖服务器配置中的设置。

read_buffer_hits 指令指定关键词命中列表的读取缓冲区大小。默认大小为 256K，最小值为 8K。对于搜索查询中的每个关键词出现，都会有两个相关的读取缓冲区，一个用于文档列表，一个用于命中列表。增加缓冲区大小可以增加每查询的内存使用，但能减少 I/O 时间。对于慢速存储，较大的缓冲区大小是合理的，而对于高 IOPS 存储，则应在较小值区域进行试验。

该设置也可以通过在每个表级别使用 read_buffer_hits 选项在 read_buffer_hits 中设置，从而覆盖服务器级别的设置。

无提示读取大小。可选，默认值为 32K，最小值为 1K

在查询时，一些读取操作预先知道有多少数据要读，但有些尚未知晓。最明显的是，当前并不知道命中列表的大小。此设置让您控制在这种情况下要读取多少数据。它影响命中列表的 I/O 时间，对于大于无提示读取大小的列表可以减少 I/O 时间，但对于较小的列表则会增加。这不影响内存使用，因为读取缓冲区已经分配好。因此，它不应大于 read_buffer。

细化网络超时行为（例如 network_timeout 和 agent_query_timeout）。

设置为 0 时，超时限制的是发送整个请求/查询的最大时间。 设置为 1（默认）时，超时限制的是网络活动之间的最大间隔时间。

在复制过程中，一个节点可能需要向另一个节点发送一个大文件（例如 100GB）。假设网络传输速度为 1GB/s，使用大小为 4-5MB 的一系列数据包。传输整个文件需要 100 秒。默认的 5 秒超时只允许传输 5GB 数据，之后连接会断开。增加超时可以作为一种解决办法，但这不具备可扩展性（例如，下一个文件可能是 150GB，同样会失败）。然而，默认 reset_network_timeout_on_packet 设置为 1 时，超时不是应用于整个传输，而是应用于单个数据包。只要传输在进行中（且在超时期间网络上有实际接收数据），连接就保持活跃。如果传输出现卡顿，在数据包之间发生超时，则连接会断开。

请注意，如果设置了分布式表，则每个节点——包括主节点和代理节点——都应进行调整。在主节点方面，agent_query_timeout 受到影响；在代理节点方面，相关的是 network_timeout。

RT 表的 RAM 块刷新检查周期，单位为秒（或 special_suffixes）。可选，默认值为 10 小时。

完全适合于 RAM 块的主动更新的 RT 表仍可能导致不断增长的二进制日志，影响磁盘使用和崩溃恢复时间。使用此指令，搜索服务器执行定期的刷新检查，符合条件的 RAM 块可以被保存，从而实现相应的二进制日志清理。更多详情请参见 Binary logging。

RT 块合并线程允许启动的最大 I/O 操作数（每秒）。可选，默认值为 0（无限制）。

此指令允许您限制由 OPTIMIZE 语句导致的 I/O 影响。保证所有 RT 优化活动产生的磁盘 IOPS（每秒 I/O 操作）不会超过配置的限制。限制 rt_merge_iops 可以减少合并操作引起的搜索性能下降。

RT 块合并线程允许启动的最大单次 I/O 操作大小。可选，默认值为 0（无限制）。

此指令允许您限制由 OPTIMIZE 语句导致的 I/O 影响。超过此大小的 I/O 操作将被拆分成两个或多个操作，随后按照 rt_merge_iops 限制计算为多个 I/O 操作。因此，保证所有优化活动产生的磁盘 I/O 不会超过 (rt_merge_iops * rt_merge_maxiosize) 字节每秒。

防止在旋转包含大量数据的表以进行预缓存时 searchd 停顿。可选，默认值为 1（启用无缝旋转）。在 Windows 系统上，默认禁用无缝旋转。

表可能包含需要预先缓存到 RAM 的数据。目前，.spa、.spb、.spi 和 .spm 文件被完全预缓存（它们分别包含属性数据、blob 属性数据、关键字表和已删除行映射）。如果不使用无缝旋转，旋转表会尽可能少用内存，流程如下：

1. 临时拒绝新查询（返回“重试”错误代码）；
2. searchd 等待所有正在运行的查询完成；
3. 旧表被释放，其文件被重命名；
4. 新表文件被重命名，并分配所需的 RAM；
5. 新表的属性和字典数据预加载到 RAM；
6. searchd 继续提供来自新表的查询服务。

但是，如果属性或字典数据很多，预加载步骤可能需要显著时间——在预加载 1-5+ GB 的文件时，可能长达数分钟。

启用无缝旋转后，旋转流程如下：

1. 分配新表的 RAM 存储；
2. 异步预加载新表的属性和字典数据至 RAM；
3. 预加载成功后，释放旧表，同时重命名两个表的文件；
4. 预加载失败时，释放新表；
5. 在任何时刻，查询要么从旧表，要么从新表副本提供服务。

无缝旋转代价是旋转期间更高的峰值内存使用（因为预加载新副本时，旧副本和新副本的 .spa/.spb/.spi/.spm 数据都必须保留在 RAM 中）。平均内存使用量保持不变。

此选项指定二级索引使用的块缓存大小。可选，默认值为 8 MB。当二级索引处理包含大量值的过滤器（例如 IN() 过滤器）时，它们会读取并处理这些值的元数据块。 在联接查询中，这个过程会对左表的每个行批重复执行，每个批次可能在单个联接查询内多次重读相同的元数据。这会严重影响性能。元数据块缓存会把这些块保存在内存中， 以便后续批次重用。

该缓存仅在联接查询中使用，对非联接查询无影响。请注意，缓存大小限制是针对每个属性和每个二级索引的。每个磁盘块中的每个属性都在这个限制范围内运行。在最坏情况下，总内存 使用量可以估算为缓存大小限制乘以磁盘块数量和联接查询中使用的属性数量。

设置 secondary_index_block_cache = 0 将禁用缓存。

此选项启用或禁用搜索查询时使用二级索引。可选，默认值为 1（启用）。请注意，建立索引时无需启用它，只要安装了 Manticore Columnar Library，它始终启用。使用该索引搜索时也需要此库。提供三种模式：

• 0: 禁用在搜索中使用二级索引。可以通过 analyzer hints 为单个查询启用
• 1: 启用在搜索中使用二级索引。可以通过 analyzer hints 为单个查询禁用
• force: 与启用相同，但加载二级索引时的任何错误都会被报告，且整个索引不会加载到守护进程中。

作为服务器标识符的整数，用于生成复制集群中节点唯一的短 UUID 种子。server_id 在集群的所有节点中必须唯一，且范围在 0 到 127 之间。如果未设置 server_id，则将其计算为 MAC 地址和 PID 文件路径的哈希，或使用随机数作为短 UUID 的种子。

searchd --stopwait 的等待时间，单位为秒（或特殊后缀）。可选，默认为 60 秒。

当你运行 searchd --stopwait 时，服务器需要执行一些操作后才能停止，例如完成查询、刷新 RT RAM 块、刷新属性和更新二进制日志。这些任务需要一定时间。searchd --stopwait 最多等待 shutdown_time 秒让服务器完成任务。合适的时间取决于你的表大小和负载。

生成摘录时，预先添加到本地文件名的前缀。可选，默认是当前工作文件夹。

此前缀可与 load_files 或 load_files_scattered 选项一起用于分布式摘录生成。

注意，这个是前缀，而不是路径！这意味着，如果设置前缀为“server1”，且请求引用“file23”，searchd 会尝试打开“server1file23”（不含引号）。因此，如果需要它是路径，必须包含结尾的斜杠。

构造最终文件路径后，服务器会展开所有相对目录，并将结果与 snippet_file_prefix 值进行比较。如果结果不以该前缀开头，则此文件会被拒绝并显示错误消息。

例如，如果将其设置为 /mnt/data，有人用 ../../../etc/passwd 作为源文件调用摘录生成时，将收到错误消息：

File '/mnt/data/../../../etc/passwd' escapes '/mnt/data/' scope

而不是文件内容。

此外，若参数未设置且读取 /etc/passwd，实际将读取 /daemon/working/folder/etc/passwd，因为参数的默认值是服务器的工作文件夹。

还要注意这是一个本地选项；不会以任何方式影响代理。所以你可以安全地在主服务器上设置前缀。路由到代理的请求不会受到主服务器设置的影响，但会受代理自身设置的影响。

这在文档存储位置（无论是本地存储还是 NAS 挂载点）在服务器间不一致时非常有用。

当前 SQL 状态序列化文件的路径。

服务器启动时，会重放此文件。在符合条件的状态更改（例如，SET GLOBAL）时，会自动重写此文件。这样可以防止难以诊断的问题：如果加载了 UDF 函数，但 Manticore 崩溃且自动重启时，UDF 和全局变量将不再可用。使用持久化状态有助于确保优雅恢复，无意外。

sphinxql_state 不能用于执行任意命令，如 CREATE TABLE。

使用 SQL 接口时，两个请求之间最大等待时间（单位为秒，或特殊后缀）。可选，默认为 15 分钟。

SSL 证书颁发机构 (CA) 证书文件（也称为根证书）的路径。可选，默认为空。不为空时，ssl_cert 中的证书应由此根证书签名。

服务器使用 CA 文件验证证书签名。文件必须是 PEM 格式。

服务器 SSL 证书的路径。可选，默认为空。

服务器使用此证书作为自签名公钥，来通过 SSL 加密 HTTP 流量。文件必须是 PEM 格式。

SSL 证书密钥的路径。可选，默认为空。

服务器使用此私钥通过SSL加密HTTP流量。文件必须为PEM格式。

每个查询的最大公共子树文档缓存大小。可选，缺省值为0（禁用）。

此设置限制公共子树优化器的RAM使用量（参见 多查询）。每个查询最多将使用此数量的RAM来缓存文档条目。将限制设为0会禁用优化器。

每个查询的最大公共子树命中缓存大小。可选，缺省值为0（禁用）。

此设置限制公共子树优化器的RAM使用量（参见 多查询）。每个查询最多将使用此数量的RAM来缓存关键字出现次数（命中）。将限制设为0会禁用优化器。

Manticore守护进程的工作线程数（或线程池大小）。Manticore在启动时创建此数量的操作系统线程，它们在守护进程中执行所有任务，例如执行查询、创建片段等。某些操作可能会被拆分为子任务并并行执行，例如：

• 在实时表中搜索
• 在由本地表组成的分布式表中搜索
• 激活查询调用
• 其他操作

默认情况下，它设置为服务器上的CPU核心数。Manticore在启动时创建线程，并在停止时保留它们。每个子任务在需要时可以使用其中一个线程。当子任务完成时，它会释放线程，以便其他子任务可以使用它。

在I/O密集型负载的情况下，将该值设置为高于CPU核心数可能有意义。

每个任务（协程，一个搜索查询可能引发多个任务/协程）的最大堆栈大小。可选，缺省值为128K。

每个任务都有自己的128K堆栈。当您运行查询时，会检查它需要多少堆栈。如果默认的128K足够，它将直接处理。如果需要更多，将安排另一个堆栈增加的任务，继续处理。这种高级堆栈的最大大小受此设置限制。

将值设置为合理高的数值有助于处理非常深的查询，而不会导致整体RAM消耗过高。例如，将其设置为1G并不意味着每个新任务都会占用1G的RAM，但如果我们看到它需要比如说100M堆栈，我们只需为该任务分配100M。同时，其他任务将使用默认的128K堆栈。同样，我们可以运行甚至更复杂的查询，这些查询需要500M。只有当我们内部看到任务需要超过1G的堆栈时，才会失败并报告thread_stack过低。

然而，实际上，即使一个查询需要16M的堆栈，通常对于解析来说也过于复杂，会消耗过多时间和资源。因此，守护进程会处理它，但通过thread_stack设置限制此类查询看起来非常合理。

确定在成功轮换时是否删除.old表副本。可选，缺省值为1（执行删除）。

线程式服务器看门狗。可选，缺省值为1（启用看门狗）。

当Manticore查询崩溃时，可能会导致整个服务器崩溃。启用看门狗功能后，searchd还会维护一个独立的轻量级进程，监控主服务器进程，并在发生异常终止时自动重新启动它。看门狗默认是启用的。