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.* 文件（包括二进制日志数据、元数据和锁文件等）。

空值会禁用二进制日志记录，这会提高性能但会使 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

您也可以选择使用 Linux amd64 平台上的特殊 manticore-executor-dev 版本，例如：https://github.com/manticoresoftware/executor/releases/tag/v1.0.13

如果您选择此方法，请记住将 manticore executor 的开发版本链接到 /usr/bin/php。

要禁用 Manticore Buddy，请将值设置为空，如示例所示。

此设置确定在使用持久连接时等待请求之间的最大时间（以秒或 special_suffixes 为单位）。它是可选的，默认值为五分钟。

服务器 libc 本地化设置。可选，默认为 C。

指定 libc 本地化设置，影响基于 libc 的排序规则。有关详细信息，请参阅 排序规则 部分。

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

指定用于传入请求的默认排序规则。可以在每个查询的基础上覆盖排序规则。有关可用排序规则和其他详细信息的列表，请参阅 排序规则 部分。

当指定此设置时，它会启用 实时模式，这是一种管理数据模式的强制方法。值应为存储所有表、二进制日志以及此模式下 Manticore Search 正常运行所需所有其他内容的目录路径。 当指定 data_dir 时，不允许对 普通表 进行索引。有关 RT 模式和普通模式之间差异的更多信息，请参阅 此部分。

此设置控制在 INSERT 和 REPLACE 操作期间字符串到数字类型转换的严格验证模式。可选，默认为 0（非严格模式，向后兼容）。

当设置为 1（严格模式）时，无效的字符串到数字转换（例如，将空字符串 '' 或非数字字符串 'a' 转换为 bigint 属性）将返回错误，而不是静默转换为 0。这有助于在数据插入期间尽早发现数据质量问题。

当设置为 0（非严格模式，默认）时，无效的转换将静默转换为 0，保持与旧版本的向后兼容性。

严格模式验证以下情况：

• 空字符串或无法转换的字符串
• 以非数字字符结尾的字符串（例如，'123abc'）
• 超出类型范围的数值（溢出/下溢）

防止在表中没有搜索时自动刷新 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。

在短语类操作符中使用 |（OR）操作符时，根据指定的替代项数量，扩展组合的总数可能会呈指数级增长。此设置通过限制查询处理过程中考虑的排列数来防止过度的查询扩展。

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

• 默认情况下以错误失败
• 如果启用了 expansion_phrase_warning，则返回部分结果并附带警告

此设置控制当 expansion_phrase_limit 定义的查询扩展限制被超过时的行为。

默认情况下，查询将以错误消息失败。当 expansion_phrase_warning 设置为 1 时，搜索将继续使用短语的部分转换（最多达到配置的限制），并返回警告消息给用户，同时附带结果集。这允许过于复杂无法完全扩展的查询仍能返回部分结果，而不会完全失败。

此设置指定代理镜像统计窗口大小，以秒为单位（或 special_suffixes）。它是可选的，默认值为 60 秒。

对于包含代理镜像的分布式表（更多信息请参见 agent），主节点会跟踪每个镜像的多个不同计数器。这些计数器随后用于故障转移和平衡（主节点根据计数器选择最佳镜像使用）。计数器以 ha_period_karma 秒为块进行累积。

在开始新的块后，主节点仍可能使用前一个块的累积值，直到新块填充一半。因此，任何之前的记录最多在 1.5 倍 ha_period_karma 秒后将不再影响镜像选择。

尽管最多使用两个块进行镜像选择，但最多存储 15 个最近的块用于仪器目的。这些块可以通过 SHOW AGENT STATUS 语句进行检查。

此设置配置代理镜像 ping 间隔，以毫秒为单位（或 special_suffixes）。它是可选的，默认值为 1000 毫秒。

对于包含代理镜像的分布式表（更多信息请参见 agent），主节点在空闲期间会向所有镜像发送 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。

使 searchd 在使用 多查询 时对单个批次提交的查询数量执行合理性检查。将其设置为 0 以跳过检查。

最大同时客户端连接数。默认情况下是无限的。通常只有在使用任何类型的持久连接时才会注意到这一点，例如 cli mysql 会话或远程分布式表的持久远程连接。当超过限制时，您仍然可以使用 VIP 连接 连接到服务器。VIP 连接不会计入限制。

实例范围内单个操作可以使用的线程数。默认情况下，适当的操作可以占用所有 CPU 核心，从而没有其他操作的余地。例如，对一个相当大的 percolate 表执行 call pq 可能会利用所有线程数十秒。将 max_threads_per_query 设置为例如 threads 的一半，可以确保您能够并行运行几个这样的 call pq 操作。

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

此外，您可以使用 threads OPTION 在每个查询的基础上控制行为。

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

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

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

还有一个“硬限制”，该限制无法通过选项超过。此限制由系统定义，可以在 Linux 上的文件 /etc/security/limits.conf 中更改。其他操作系统可能有不同的方法，因此请参阅相关手册以获取更多信息。

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

最大允许的网络数据包大小。此设置限制了客户端的查询数据包和分布式环境中远程代理的响应数据包。仅用于内部合理性检查，不会直接影响 RAM 使用或性能。可选，默认值为 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 协议连接的客户端报告不同的版本号。（默认情况下，它会报告自己的版本。）

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

还要注意 reset_network_timeout_on_packet 参数。此参数会改变 network_timeout 的行为，使其从应用于整个 query 或 result 改为应用于单个数据包。通常，一个查询/结果会包含在一个或两个数据包中。然而，在需要大量数据的情况下，此参数在保持操作活跃性方面可能非常有价值。

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

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

此设置确定是否允许仅使用 negation 全文操作符的查询。可选，默认为0（仅使用NOT操作符的查询将失败）。

设置默认的表压缩阈值。更多信息请参见 - Number of optimized disk chunks。此设置可以通过每个查询选项 cutoff 覆盖。也可以通过 SET GLOBAL 动态更改。

此设置确定到远程 persistent agents 的最大同时持久连接数。每次连接在 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中指定的线程数。

请注意，如果您的工作线程已经很忙，因为您有：

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

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

默认启用。

此配置设置分配给缓存结果集的最大RAM量（以字节为单位）。默认值为16777216，相当于16兆字节。如果将值设置为0，则禁用查询缓存。有关查询缓存的更多信息，请参阅查询缓存。

查询日志格式。可选，允许的值为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 指令控制每个关键字的文档列表读取缓冲区大小。对于每个搜索查询中的每个关键字出现，都有两个相关的读取缓冲区：一个用于文档列表，一个用于命中列表。此设置允许您控制文档列表缓冲区大小。

更大的缓冲区大小可能会增加每个查询的 RAM 使用量，但可能会减少 I/O 时间。对于慢速存储，设置较大的值是有意义的，但对于能够处理高 IOPS 的存储，应在较低值范围内进行实验。

默认值为 256K，最小值为 8K。您还可以在每个表的基础上设置 read_buffer_docs，这将覆盖服务器配置级别的任何设置。

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

此设置也可以通过 read_buffer_hits 中的 read_buffer_hits 选项在每个表的基础上指定，这将覆盖服务器级别的设置。

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

在查询时，某些读取操作可以提前知道需要读取的数据量，但有些目前还不能。最明显的是命中列表的大小目前无法提前知道。此设置允许您控制在这些情况下读取多少数据。它会影响命中列表的 I/O 时间，对于大于未提示读取大小的列表会减少 I/O 时间，但对于较小的列表会增加 I/O 时间。它不会影响 RAM 使用，因为读取缓冲区已经分配。因此，它不应大于 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 块刷新检查周期，以秒为单位（或 特殊后缀）。可选，默认为 10 小时。

即使主动更新的 RT 表完全适合 RAM 块，仍可能导致 binlog 不断增长，影响磁盘使用和崩溃恢复时间。通过此指令，搜索服务器会定期执行刷新检查，符合条件的 RAM 块可以被保存，从而实现后续的 binlog 清理。有关详细信息，请参阅 二进制日志。

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

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

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

此指令允许您限制由 OPTIMIZE 语句引起的 I/O 影响。超过此限制的 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 文件会被完全预缓存（它们分别包含属性数据、二进制属性数据、关键字表和已删除行映射）。如果没有启用无缝旋转，旋转表会尝试使用尽可能少的 RAM，并按以下步骤工作：

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 会禁用缓存。

secondary_index_block_cache = 16M

This option enables/disables the use of secondary indexes for search queries. It is optional, and the default is 1 (enabled). Note that you don't need to enable it for indexing as it is always enabled as long as the Manticore Columnar Library is installed. The latter is also required for using the indexes when searching. There are three modes available:

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

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

searchd --stopwait 等待时间，以秒为单位（或 special_suffixes）。可选，默认为60秒。

当你运行 searchd --stopwait 时，服务器需要在停止前执行一些操作，例如完成查询、刷新RT RAM块、刷新属性和更新binlog。这些任务需要一些时间。searchd --stopwait 将等待最多 shutdown_time 秒，直到服务器完成其任务。合适的时间取决于你的表大小和负载。

此设置指定解压跳过列表的内存缓存最大大小。可选，默认为64M。

跳过列表用于加快大型文档列表的查找速度。缓存它们可以避免在查询中重复解压相同的跳过列表数据。将此选项设置为0以禁用缓存。

生成片段时添加到本地文件名前的前缀。可选，默认为当前工作目录。

此前缀可以与 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接口时，等待请求之间的最大时间（以秒为单位，或 special_suffixes）。可选，默认为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还会维护一个独立的轻量级进程，监控主服务器进程，并在发生异常终止时自动重新启动它。看门狗默认是启用的。