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

您也可以指示 searchd 定期将这些更改写回磁盘以防止数据丢失。刷新间隔由 attr_flush_period 决定，单位为秒（或 special_suffixes）。

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

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

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

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

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

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

请注意，切换 auto_optimize 开关不会阻止您手动运行 OPTIMIZE TABLE。

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

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

注意：自动 schema 功能 需要 Manticore Buddy。如果功能无法使用，请确保 Buddy 已安装。

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

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

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

对于熟悉 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、对其进行修改或实现新插件，则可能需要修改。后者情况下，您可以从 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执行器的开发版本链接到 /usr/bin/php。

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

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

服务器 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。

当在类似短语的操作符内使用 |（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 为监听器设置只读模式，限制其仅接受读取查询。

log 设置指定日志文件名，所有 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 选项 按查询控制行为。

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

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

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

还有一个“硬限制”，该限制不能被此选项超越。此限制由系统定义，可在 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 协议连接的客户端报告不同的版本。（默认情况下，它报告自己的版本。）

网络客户端请求读写超时，单位为秒（或 special_suffixes）。可选，默认值为 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指定的线程数。

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

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

那么启用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块刷新检查周期，单位为秒（或special_suffixes）。可选，默认值为10小时。

完全适合RAM块的主动更新RT表仍可能导致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操作，这些操作将作为独立I/O计入rt_merge_iops限制。因此，保证所有优化活动每秒产生的磁盘I/O不超过 (rt_merge_iops * rt_merge_maxiosize) 字节。

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

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

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

但如果属性或字典数据量大，预加载步骤可能耗时显著——预加载1-5GB以上文件时可能需要几分钟。

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

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

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

此选项指定二级索引使用的块缓存大小。可选，默认8MB。当二级索引处理包含大量值的过滤器（例如IN()过滤器）时，会读取并处理这些值的元数据块。 在连接查询中，这一过程会对左表的每个批次重复执行，每个批次可能在单个连接查询内重复读取相同元数据。这会严重影响性能。元数据块缓存将这些块保存在内存中，以便后续批次重用。 缓存仅在连接查询中使用，对非连接查询无影响。注意，缓存大小限制是针对每个属性和每个二级索引的。每个磁盘块中的每个属性都在此限制内运行。最坏情况下，总内存使用量可估算为限制乘以磁盘块数和连接查询中使用的属性数。

设置 secondary_index_block_cache = 0 可禁用缓存。

secondary_index_block_cache = 16M

• 1: Enable the use of secondary indexes on search. They can be disabled for individual queries using analyzer hints

• force: Same as enable, but any errors during the loading of secondary indexes will be reported, and the whole index will not be loaded into the daemon.

  Example:

  secondary_indexes = 1

server_id = 1

shutdown_timeout = 3m # wait for up to 3 minutes

Note that this is a prefix and not a path! This means that if a prefix is set to "server1" and the request refers to "file23", searchd will attempt to open "server1file23" (all of that without quotes). So, if you need it to be a path, you have to include the trailing slash.

After constructing the final file path, the server unwinds all relative dirs and compares the final result with the value of snippet_file_prefix. If the result does not begin with the prefix, such a file will be rejected with an error message.

For example, if you set it to /mnt/data and someone calls snippet generation with the file ../../../etc/passwd as the source, they will get the error message:

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

instead of the content of the file.

Also, with a non-set parameter and reading /etc/passwd, it will actually read /daemon/working/folder/etc/passwd since the default for the parameter is the server's working folder.

Note also that this is a local option; it does not affect the agents in any way. So you can safely set a prefix on a master server. The requests routed to the agents will not be affected by the master's setting. They will, however, be affected by the agent's own settings.

This might be useful, for instance, when the document storage locations (whether local storage or NAS mountpoints) are inconsistent across the servers.

snippets_file_prefix = /mnt/common/server1/

sphinxql_state cannot be used to execute arbitrary commands, such as CREATE TABLE.

sphinxql_state = uservars.sql

sphinxql_timeout = 15m

ssl_ca = keys/ca-cert.pem

ssl_cert = keys/server-cert.pem

ssl_key = keys/server-key.pem

subtree_docs_cache = 8M

subtree_hits_cache = 16M