搜索设置

OpenSearch 支持以下搜索设置

• search.max_buckets (动态，整数)：单个响应中允许的最大聚合桶数。默认值为 65535。

• search.phase_took_enabled (动态，布尔值)：启用在搜索响应中返回阶段级别的 took 时间值。默认值为 false。

• search.allow_expensive_queries (动态，布尔值)：允许或禁止昂贵的查询。更多信息，请参阅昂贵的查询。

• search.default_allow_partial_results (动态，布尔值)：一个集群级别设置，允许在请求超时或分片失败时返回部分搜索结果。如果搜索请求包含 allow_partial_search_results 参数，则该参数优先于此设置。默认值为 true。

• search.cancel_after_time_interval (动态，时间单位)：一个集群级别设置，用于在协调节点级别设置所有搜索请求的默认超时。达到指定时间后，请求将停止，所有相关任务将被取消。默认值为 -1（无超时）。

• search.default_search_timeout (动态，时间单位)：一个集群级别设置，指定搜索请求在分片级别被取消之前可以运行的最长时间。如果在搜索请求中指定了 timeout 间隔，则该间隔优先于此配置设置。默认值为 -1。

• search.default_keep_alive (动态，时间单位)：指定滚动和时间点 (PIT) 搜索的默认保持活动值。由于一个请求可能会多次到达一个分片（例如，在查询和获取阶段），OpenSearch 会打开一个贯穿请求整个持续时间的 请求上下文，以确保每个单独的分片请求的分片状态一致性。在标准搜索中，一旦获取阶段完成，请求上下文就会关闭。对于滚动或 PIT 搜索，OpenSearch 会保持请求上下文打开，直到明确关闭（或直到达到保持活动时间）。一个后台线程会定期检查所有打开的滚动和 PIT 上下文，并删除那些已超出其保持活动超时的上下文。search.keep_alive_interval 设置指定检查上下文过期频率。search.default_keep_alive 设置是默认的过期截止时间。滚动或 PIT 请求可以明确指定保持活动时间，该时间优先于此设置。默认值为 5m。

• search.keep_alive_interval (静态，时间单位)：确定 OpenSearch 检查超出其保持活动限制的请求上下文的间隔。默认值为 1m。

• search.max_keep_alive (动态，时间单位)：指定最大保持活动值。max_keep_alive 设置用作对其他 keep_alive 设置（例如 default_keep_alive）以及请求级别保持活动设置（用于滚动和 PIT 上下文）的安全检查。如果请求在任何一种情况下超出 max_keep_alive 值，操作将失败。默认值为 24h。

• search.low_level_cancellation (动态，布尔值)：启用低级别请求取消。Lucene 的经典超时机制只在收集搜索结果时检查时间。然而，一个昂贵的查询，例如通配符或前缀查询，可能在开始收集结果之前需要很长时间来扩展。在这种情况下，查询运行的时间可能会超过超时值。低级别取消机制通过不仅在收集搜索结果时，而且在查询扩展阶段或执行任何 Lucene 操作之前进行超时，解决了这种情况。默认值为 true。

• search.max_open_scroll_context (动态，整数)：一个节点级别设置，指定节点上打开的滚动上下文的最大数量。默认值为 500。

• search.request_stats_enabled (动态，布尔值)：从协调节点的角度开启节点级别阶段时间统计的收集。请求级别统计会跟踪搜索请求在不同搜索阶段中总共花费的时间。您可以使用 节点统计 API 检索这些计数器。默认值为 false。

• search.highlight.term_vector_multi_value (静态，布尔值)：指定在高亮显示多值字段的片段时，跨多个值进行高亮。默认值为 true。

• search.max_aggregation_rewrite_filters (动态，整数)：确定聚合期间允许的最大重写过滤器数量。将此值设置为 0 以禁用聚合的过滤器重写优化。这是一个实验性功能，未来版本可能会更改或移除。

• search.dynamic_pruning.cardinality_aggregation.max_allowed_cardinality (动态，整数)：确定在基数聚合中应用动态剪枝的阈值。如果字段的基数超过此阈值，聚合将恢复到默认方法。这是一个实验性功能，未来版本可能会更改或移除。

• search.keyword_index_or_doc_values_enabled (动态，布尔值)：确定在对 keyword 字段运行 multi_term 查询时是使用索引还是文档值。默认值为 false。

时间点设置

有关 PIT 设置的信息，请参阅PIT 设置。

要了解有关静态和动态设置的更多信息，请参阅配置 OpenSearch。