html_strip = {0|1}此选项决定是否应从传入的全文数据中去除 HTML 标记。默认值为 0，表示禁用去除。要启用去除，请将值设置为 1。
HTML 标签和实体被视为标记并将被处理。
HTML 标签会被移除，而它们之间的内容（例如 <p> 和 </p> 之间的所有内容）则保持不变。您可以选择保留并索引标签属性（例如 A 标签中的 HREF 属性或 IMG 标签中的 ALT 属性）。一些知名的内联标签，如 A、B、I、S、U、BASEFONT、BIG、EM、FONT、IMG、LABEL、SMALL、SPAN、STRIKE、STRONG、SUB、SUP 和 TT，会被完全移除。所有其他标签被视为块级标签，并被替换为空白。例如，文本 te<b>st</b> 会被索引为单个关键词 'test'，而 te<p>st</p> 会被索引为两个关键词 'te' 和 'st'。
HTML 实体会被解码并替换为对应的 UTF-8 字符。去除器支持数字形式的实体（例如 ï）和文本形式的实体（例如 ó 或 ），并支持 HTML4 标准指定的所有实体。
该去除器设计用于处理格式正确的 HTML 和 XHTML，但在处理格式错误的输入（如带有多余的 < 或未闭合的 > 的 HTML）时可能产生意外结果。
请注意，只有标签本身以及 HTML 注释会被去除。要去除标签内容，包括嵌入的脚本，请参见 html_remove_elements 选项。标签名称没有限制，意味着所有看起来像有效标签开始、结束或注释的内容都会被去除。
- SQL
- JSON
- PHP
- Python
- Python-asyncio
- javascript
- Java
- C#
- Rust
- CONFIG
CREATE TABLE products(title text, price float) html_strip = '1'POST /cli -d "
CREATE TABLE products(title text, price float) html_strip = '1'"$index = new \Manticoresearch\Index($client);
$index->setName('products');
$index->create([
'title'=>['type'=>'text'],
'price'=>['type'=>'float']
],[
'html_strip' => '1'
]);utilsApi.sql('CREATE TABLE products(title text, price float) html_strip = \'1\'')await utilsApi.sql('CREATE TABLE products(title text, price float) html_strip = \'1\'')res = await utilsApi.sql('CREATE TABLE products(title text, price float) html_strip = \'1\'');utilsApi.sql("CREATE TABLE products(title text, price float) html_strip = '1'");utilsApi.Sql("CREATE TABLE products(title text, price float) html_strip = '1'");utils_api.sql("CREATE TABLE products(title text, price float) html_strip = '1'", Some(true)).await;table products {
html_strip = 1
type = rt
path = tbl
rt_field = title
rt_attr_uint = price
}html_index_attrs = img=alt,title; a=title;html_index_attrs 选项允许您指定即使其他 HTML 标记被去除，也应被索引的 HTML 标记属性。默认值为空，表示不索引任何属性。 该选项的格式是按标签列举可索引属性，如上例所示。指定属性的内容将被保留并索引，提供了一种从全文数据中提取额外信息的方法。
- SQL
- JSON
- PHP
- Python
- Python-asyncio
- javascript
- Java
- C#
- Rust
- CONFIG
CREATE TABLE products(title text, price float) html_index_attrs = 'img=alt,title; a=title;' html_strip = '1'POST /cli -d "
CREATE TABLE products(title text, price float) html_index_attrs = 'img=alt,title; a=title;' html_strip = '1'"$index = new \Manticoresearch\Index($client);
$index->setName('products');
$index->create([
'title'=>['type'=>'text'],
'price'=>['type'=>'float']
],[
'html_index_attrs' => 'img=alt,title; a=title;',
'html_strip' => '1'
]);utilsApi.sql('CREATE TABLE products(title text, price float) html_index_attrs = \'img=alt,title; a=title;\' html_strip = \'1\'')await utilsApi.sql('CREATE TABLE products(title text, price float) html_index_attrs = \'img=alt,title; a=title;\' html_strip = \'1\'')res = await utilsApi.sql('CREATE TABLE products(title text, price float) html_index_attrs = \'img=alt,title; a=title;\' html_strip = \'1\'');utilsApi.sql("CREATE TABLE products(title text, price float) html_index_attrs = \'img=alt,title; a=title;\' html_strip = '1'");utilsApi.Sql("CREATE TABLE products(title text, price float) html_index_attrs = \'img=alt,title; a=title;\' html_strip = '1'");utils_api.sql("CREATE TABLE products(title text, price float) html_index_attrs = \'img=alt,title; a=title;\' html_strip = '1'", Some(true)).await;table products {
html_index_attrs = img=alt,title; a=title;
html_strip = 1
type = rt
path = tbl
rt_field = title
rt_attr_uint = price
}html_remove_elements = element1[, element2, ...]一个 HTML 元素列表，其内容及元素本身将被去除。可选，默认值为空字符串（不去除任何元素内容）。
此选项允许您去除元素的内容，即开闭标签之间的所有内容。它对于去除嵌入的脚本、CSS 等非常有用。空元素的短标签形式（例如
）被正确支持，且该标签之后的文本不会被去除。
该值是以逗号分隔的元素（标签）名称列表，指定应去除其内容。标签名称不区分大小写。
- SQL
- JSON
- PHP
- Python
- Python-asyncio
- javascript
- Java
- C#
- Rust
- CONFIG
CREATE TABLE products(title text, price float) html_remove_elements = 'style, script' html_strip = '1'POST /cli -d "
CREATE TABLE products(title text, price float) html_remove_elements = 'style, script' html_strip = '1'"$index = new \Manticoresearch\Index($client);
$index->setName('products');
$index->create([
'title'=>['type'=>'text'],
'price'=>['type'=>'float']
],[
'html_remove_elements' => 'style, script',
'html_strip' => '1'
]);utilsApi.sql('CREATE TABLE products(title text, price float) html_remove_elements = \'style, script\' html_strip = \'1\'')await utilsApi.sql('CREATE TABLE products(title text, price float) html_remove_elements = \'style, script\' html_strip = \'1\'')res = await utilsApi.sql('CREATE TABLE products(title text, price float) html_remove_elements = \'style, script\' html_strip = \'1\'');utilsApi.sql("CREATE TABLE products(title text, price float) html_remove_elements = \'style, script\' html_strip = '1'");utilsApi.Sql("CREATE TABLE products(title text, price float) html_remove_elements = \'style, script\' html_strip = '1'");utils_api.sql("CREATE TABLE products(title text, price float) html_remove_elements = \'style, script\' html_strip = '1'", Some(true)).await;table products {
html_remove_elements = style, script
html_strip = 1
type = rt
path = tbl
rt_field = title
rt_attr_uint = price
}index_sp = {0|1}控制句子和段落边界的检测和索引。可选，默认值为 0（不检测也不索引）。
此指令启用句子和段落边界的检测和索引，使得 SENTENCE 和 PARAGRAPH 操作符能够工作。句子边界检测基于纯文本分析，只需设置 index_sp = 1 即可启用。段落检测则依赖于 HTML 标记，并在 HTML 去除过程 中进行。因此，要索引段落边界，必须同时将 index_sp 指令和 html_strip 指令设置为 1。
以下规则用于确定句子边界：
- 问号 (?) 和感叹号 (!) 总是表示句子边界。
- 句末点号 (.) 表示句子边界，除以下情况外：
- 当后面跟着一个字母时。这被视为缩写的一部分（例如 "S.T.A.L.K.E.R." 或 "Goldman Sachs S.p.A."）。
- 当后面跟着一个逗号时。这被视为缩写后跟逗号（例如 "Telecom Italia S.p.A., founded in 1994"）。
- 当后面跟着一个空格和一个小写字母时。这被视为句子中的缩写（例如 "News Corp. announced in February"）。
- 当前面跟着一个空格和一个大写字母，且后面跟着一个空格时。这被视为中间名的首字母（例如 "John D. Doe"）。
段落边界在每个块级 HTML 标签处检测，包括：ADDRESS、BLOCKQUOTE、CAPTION、CENTER、DD、DIV、DL、DT、H1、H2、H3、H4、H5、LI、MENU、OL、P、PRE、TABLE、TBODY、TD、TFOOT、TH、THEAD、TR 和 UL。
句子和段落都会使关键字位置计数器增加 1。
- SQL
- JSON
- PHP
- Python
- Python-asyncio
- javascript
- Java
- C#
- Rust
- CONFIG
CREATE TABLE products(title text, price float) index_sp = '1' html_strip = '1'POST /cli -d "
CREATE TABLE products(title text, price float) index_sp = '1' html_strip = '1'"$index = new \Manticoresearch\Index($client);
$index->setName('products');
$index->create([
'title'=>['type'=>'text'],
'price'=>['type'=>'float']
],[
'index_sp' => '1',
'html_strip' => '1'
]);utilsApi.sql('CREATE TABLE products(title text, price float) index_sp = \'1\' html_strip = \'1\'')await utilsApi.sql('CREATE TABLE products(title text, price float) index_sp = \'1\' html_strip = \'1\'')res = await utilsApi.sql('CREATE TABLE products(title text, price float) index_sp = \'1\' html_strip = \'1\'');utilsApi.sql("CREATE TABLE products(title text, price float) index_sp = \'1\' html_strip = '1'", true);utilsApi.Sql("CREATE TABLE products(title text, price float) index_sp = \'1\' html_strip = '1'", true);utils_api.sql("CREATE TABLE products(title text, price float) index_sp = \'1\' html_strip = '1'", Some(true)).await;table products {
index_sp = 1
html_strip = 1
type = rt
path = tbl
rt_field = title
rt_attr_uint = price
}index_zones = h*, th, title字段内要索引的 HTML/XML 区域列表。默认值为空字符串（不索引任何区域）。
“区域”定义为开标签和匹配的闭标签之间的所有内容，所有共享相同标签名称的跨度都称为一个“区域”。例如，文档字段中 <H1> 和 </H1> 之间的所有内容属于 H1 区域。
index_zones 指令启用区域索引，但必须同时启用 HTML 剥离器（通过设置 html_strip = 1）。index_zones 的值应为以逗号分隔的标签名称和通配符（以星号结尾）的列表，用于作为区域索引。
区域可以嵌套和重叠，只要每个开标签都有匹配的闭标签。区域也可以用于使用 ZONE 操作符进行匹配，如 extended_query_syntax 中所述。
- SQL
- JSON
- PHP
- Python
- Python-asyncio
- javascript
- Java
- C#
- Rust
- CONFIG
CREATE TABLE products(title text, price float) index_zones = 'h, th, title' html_strip = '1'POST /cli -d "
CREATE TABLE products(title text, price float) index_zones = 'h, th, title' html_strip = '1'"$index = new \Manticoresearch\Index($client);
$index->setName('products');
$index->create([
'title'=>['type'=>'text'],
'price'=>['type'=>'float']
],[
'index_zones' => 'h*,th,title',
'html_strip' => '1'
]);utilsApi.sql('CREATE TABLE products(title text, price float) index_zones = \'h, th, title\' html_strip = \'1\'')await utilsApi.sql('CREATE TABLE products(title text, price float) index_zones = \'h, th, title\' html_strip = \'1\'')res = await utilsApi.sql('CREATE TABLE products(title text, price float) index_zones = \'h, th, title\' html_strip = \'1\'');utilsApi.sql("CREATE TABLE products(title text, price float) index_zones = 'h, th, title' html_strip = '1'", true);utilsApi.Sql("CREATE TABLE products(title text, price float) index_zones = 'h, th, title' html_strip = '1'", true);utils_api.sql("CREATE TABLE products(title text, price float) index_zones = 'h, th, title' html_strip = '1'", Some(true)).await;table products {
index_zones = h*, th, title
html_strip = 1
type = rt
path = tbl
rt_field = title
rt_attr_uint = price
}Manticore 允许创建分布式表，它们的行为类似于普通的普通表或实时表，但实际上是用于搜索的子表集合。当查询发送到分布式表时，查询会分发到集合中的所有表。服务器随后收集并处理响应，必要时对聚合值进行排序和重新计算。
从客户端的角度来看，查询就像是在查询单个表。
分布式表可以由任何组合的表组成，包括：
- 本地存储表（普通表 和 实时表）
- 远程表
- 本地和远程表的组合
- Percolate 表（本地、远程或组合）
- 单个本地表和多个远程表，或任何其他组合
不建议将 percolate 和模板表与普通表和实时表混合使用。
分布式表在配置文件中定义为类型 'distributed'，或通过 SQL 子句 CREATE TABLE 定义。
table foo {
type = distributed
local = bar
local = bar1, bar2
agent = 127.0.0.1:9312:baz
agent = host1|host2:tbl
agent = host1:9301:tbl1|host2:tbl2 [ha_strategy=random retry_count=10]
...
}CREATE TABLE distributed_index type='distributed' local='local_index' agent='127.0.0.1:9312:remote_table'分布式表的本质在于其指向的子表列表。分布式表中有两种类型的子表：
Manticore Search 中的分布式表充当“主节点”，将请求的查询代理到其他表，并提供从收到的响应中合并的结果。该表本身不保存任何数据。它可以连接到本地表和位于其他服务器上的表。以下是一个简单分布式表的示例：
- Configuration file
- RT mode
- PHP
- Python
- Python-asyncio
- javascript
- Java
- C#
- Rust
table index_dist {
type = distributed
local = index1
local = index2
...
}CREATE TABLE local_dist type='distributed' local='index1' local='index2';$params = [
'body' => [
'settings' => [
'type' => 'distributed',
'local' => [
'index1',
'index2'
]
]
],
'table' => 'products'
];
$index = new \Manticoresearch\Index($client);
$index->create($params);utilsApi.sql('CREATE TABLE local_dist type=\'distributed\' local=\'index1\' local=\'index2\'')await utilsApi.sql('CREATE TABLE local_dist type=\'distributed\' local=\'index1\' local=\'index2\'')res = await utilsApi.sql('CREATE TABLE local_dist type=\'distributed\' local=\'index1\' local=\'index2\'');utilsApi.sql("CREATE TABLE local_dist type='distributed' local='index1' local='index2'");utilsApi.Sql("CREATE TABLE local_dist type='distributed' local='index1' local='index2'");utils_api.sql("CREATE TABLE local_dist type='distributed' local='index1' local='index2'", Some(true)).await;Manticore Search 中的远程表由分布式表定义中的 agent 前缀表示。分布式表可以包含本地表和远程表的组合。如果没有提供本地表，分布式表将纯粹是远程的，仅作为代理。例如，您可能有一个监听多个端口并服务不同协议的 Manticore 实例，然后将查询重定向到仅通过 Manticore 内部二进制协议接受连接的后端服务器，使用持久连接以减少建立连接的开销。 即使纯远程分布式表本身不提供本地表，它仍然会消耗机器资源，因为它仍需要执行最终计算，例如合并结果和计算最终聚合值。
agent = address1 [ | address2 [...] ][:table-list]
agent = address1[:table-list [ | address2[:table-list [...] ] ] ]agent 指令声明每次搜索包含的分布式表时要搜索的远程代理。这些代理本质上是指向网络表的指针。指定的值包括地址，也可以包括多个备选项（代理镜像），用于仅地址或地址和表列表。
地址规范必须是以下之一：
address = hostname[:port] # eg. server2:9312
address = /absolute/unix/socket/path # eg. /var/run/manticore2.sockhostname 是远程主机名，port 是远程 TCP 端口号，table-list 是以逗号分隔的表名列表，方括号 [] 表示可选子句。
如果省略表名，则假定为定义此行的同一表。换句话说，在为 'mycoolindex' 分布式表定义代理时，您可以仅指向地址，系统将假定您正在查询代理端点上的 mycoolindex 表。
如果省略端口号，则假定为 9312。如果定义了但无效（例如 70000），则该代理将被跳过。
您可以将每个代理指向一个或多个位于一个或多个网络服务器上的远程表，没有限制。这支持多种使用模式：
- 在多个代理服务器上分片并创建任意集群拓扑
- 在多个代理服务器上分片，镜像以实现高可用性和负载均衡
- 在本地主机内分片以利用多个核心（不过，使用多个本地表更简单）
所有代理并行搜索。索引列表原样传递给远程代理。该列表在代理内的具体搜索方式（即顺序或并行）完全取决于代理的配置（参见 threads 设置）。主服务器无法远程控制此行为。
需要注意的是，LIMIT 选项在代理查询中被忽略。这是因为每个代理可能包含不同的表，因此客户端负责对最终结果集应用限制。这就是为什么查询物理表与查询分布式表在查询日志中显示不同的原因。查询不能简单复制原始查询，因为这样不会产生正确结果。
例如，如果客户端发出查询 SELECT ... LIMIT 10, 10，且有两个代理，第二个代理只有 10 个文档，广播原始 LIMIT 10, 10 查询将导致从第二个代理收到 0 个文档。然而，LIMIT 10,10 应该返回结果集中的第 10 到 20 个文档。为解决此问题，必须向代理发送更宽松的限制查询，例如默认的 max_matches 值 1000。
例如，如果有一个分布式表 dist 指向远程表 user，客户端查询 SELECT * FROM dist LIMIT 10,10 会被转换为 SELECT * FROM user LIMIT 0,1000 并发送到远程表 user。一旦分布式表收到结果，它将应用 LIMIT 10,10 并返回请求的 10 个文档。
SELECT * FROM dist LIMIT 10,10;查询将被转换为：
SELECT * FROM user LIMIT 0,1000此外，值可以为每个单独代理指定选项，例如：
- ha_strategy -
random，roundrobin，nodeads，noerrors（覆盖特定代理的全局ha_strategy设置） conn-pconn，持久连接（等同于在表级设置agent_persistent）blackhole0，1（与代理的 agent_blackhole 设置相同）retry_count整数值（对应 agent_retry_count，但提供的值不会乘以镜像数量）
agent = address1:table-list[[ha_strategy=value, conn=value, blackhole=value]]示例：
# config on box1
# sharding a table over 3 servers
agent = box2:9312:shard1
agent = box3:9312:shard2
# config on box2
# sharding a table over 3 servers
agent = box1:9312:shard2
agent = box3:9312:shard3
# config on box3
# sharding a table over 3 servers
agent = box1:9312:shard1
agent = box2:9312:shard3
# per agent options
agent = box1:9312:shard1[ha_strategy=nodeads]
agent = box2:9312:shard2[conn=pconn]
agent = box2:9312:shard2[conn=pconn,ha_strategy=nodeads]
agent = test:9312:any[blackhole=1]
agent = test:9312|box2:9312|box3:9312:any2[retry_count=2]
agent = test:9312|box2:9312:any2[retry_count=2,conn=pconn,ha_strategy=noerrors]为获得最佳性能，建议将位于同一服务器上的远程表放在同一条记录中。例如，不要这样写：
agent = remote:9312:idx1
agent = remote:9312:idx2而应优先这样写：
agent = remote:9312:idx1,idx2agent_persistent = remotebox:9312:index2agent_persistent 选项允许您与代理保持持久连接，即查询执行后连接不会断开。该指令的语法与 agent 指令相同。但不是为每个查询打开新连接然后关闭，主服务器会保持连接打开并重用它进行后续查询。每个代理主机的最大持久连接数由 searchd 部分的 persistent_connections_limit 选项定义。
需要注意的是，必须将 persistent_connections_limit 设置为大于 0 的值才能使用持久代理连接。如果未定义，则默认为 0，agent_persistent 指令将与 agent 指令行为相同。
使用持久的主-代理连接可以减少 TCP 端口压力并节省连接握手时间，从而提高效率。
agent_blackhole = testbox:9312:testindex1,testindex2agent_blackhole 指令允许您将查询转发到远程代理，而无需等待或处理它们的响应。这对于调试或测试生产集群非常有用，因为您可以设置一个单独的调试/测试实例，并从生产主（聚合器）实例将请求转发到该实例，而不会干扰生产工作。主 searchd 将尝试连接到黑洞代理并正常发送查询，但不会等待或处理任何响应，且所有黑洞代理上的网络错误将被忽略。该值的格式与常规的 agent 指令相同。
agent_connect_timeout = 300agent_connect_timeout 指令定义连接到远程代理的超时时间。默认情况下，值被假定为毫秒，但可以有其他后缀)。默认值为 1000（1 秒）。
连接到远程代理时，searchd 最多等待此时间以成功完成连接。如果达到超时但连接尚未建立，并且启用了 retries，则会启动重试。
agent_query_timeout = 10000 # our query can be long, allow up to 10 secagent_query_timeout 设置 searchd 等待远程代理完成查询的时间。默认值为 3000 毫秒（3 秒），但可以通过后缀表示不同的时间单位。
建立连接后，searchd 将最多等待 agent_query_timeout 时间以完成远程查询。请注意，此超时与 agent_connection_timeout 是分开的，远程代理可能导致的总延迟是两者之和。如果达到 agent_query_timeout，查询将不会重试，而是会产生警告。
请注意，行为还受 reset_network_timeout_on_packet 的影响。
agent_retry_count 是一个整数，指定 Manticore 在报告致命查询错误之前，在分布式表中尝试连接和查询远程代理的次数。它的工作方式类似于配置文件中 "searchd" 部分定义的 agent_retry_count，但专门应用于表。
mirror_retry_count 的作用与 agent_retry_count 相同。如果同时提供了两个值，mirror_retry_count 将优先，并会发出警告。
以下选项管理远程代理的整体行为，并在配置文件的 searchd 部分中指定。它们为整个 Manticore 实例设置默认值。
agent_connect_timeout-agent_connect_timeout参数的默认值。agent_query_timeout-agent_query_timeout参数的默认值。此值也可以在分布式（网络）表中使用相同的设置名称按查询覆盖。agent_retry_count是一个整数，指定 Manticore 在报告致命查询错误之前，在分布式表中尝试连接和查询远程代理的次数。默认值为 0（即不重试）。此值也可以通过 'OPTION retry_count=XXX' 子句按查询指定。如果提供了按查询选项，它将优先于配置文件中指定的值。
注意，如果您在分布式表的定义中使用了代理镜像，服务器将在每次连接尝试之前根据指定的 ha_strategy 选择不同的镜像。在这种情况下，agent_retry_count 将针对集合中的所有镜像进行汇总。
例如，如果您有 10 个镜像并设置 agent_retry_count=5，服务器将尝试最多 50 次重试（假设每 10 个镜像平均尝试 5 次）。如果选项为 ha_strategy = roundrobin，则每个镜像实际上正好尝试 5 次。
同时，agent 定义中提供的 retry_count 选项作为绝对限制。换句话说，代理定义中的 [retry_count=2] 选项意味着最多尝试 2 次，无论线路中有 1 个还是 10 个镜像。
agent_retry_delay 是一个整数值，表示 Manticore Search 在失败后重试查询远程代理之前等待的时间，单位为毫秒。此值可以在 searchd 配置中全局指定，也可以通过 OPTION retry_delay=XXX 子句按查询指定。如果同时提供了两个选项，按查询选项优先于全局选项。默认值为 500 毫秒（0.5 秒）。此选项仅在 agent_retry_count 或按查询的 OPTION retry_count 非零时相关。
client_timeout 选项设置使用持久连接时请求之间的最大等待时间。该值以秒或带时间后缀的形式表示。默认值为 5 分钟。
示例：
client_timeout = 1hhostname_lookup 选项定义更新主机名的策略。默认情况下，代理主机名的 IP 地址在服务器启动时缓存，以避免过度访问 DNS。然而，在某些情况下，IP 可能动态变化（例如云托管），可能希望不缓存 IP。将此选项设置为 request 会禁用缓存，并在每次查询时查询 DNS。IP 地址也可以使用 FLUSH HOSTNAMES 命令手动更新。
listen_tfo 选项允许对所有监听器使用 TCP_FASTOPEN 标志。默认情况下，它由系统管理，但可以通过将其设置为 '0' 明确关闭。
有关 TCP Fast Open 扩展的更多信息，请参阅 Wikipedia。简而言之，它允许在建立连接时消除一次 TCP 往返。
在实践中，使用 TFO 可以优化客户端代理的网络效率，类似于使用 agent_persistent 时的效果，但无需保持活动连接且不受最大连接数的限制。
大多数现代操作系统都支持 TFO。Linux（作为最先进的系统之一）自 2011 年起支持它，内核版本从 3.7 开始支持（针对服务器端）。Windows 自某些 Windows 10 版本开始支持它。其他系统，如 FreeBSD 和 MacOS，也支持该功能。
对于 Linux 系统，服务器会检查变量 /proc/sys/net/ipv4/tcp_fastopen 并据此行为。第 0 位管理客户端，第 1 位管理监听器。默认情况下，系统将此参数设置为 1，即启用客户端，禁用监听器。
persistent_connections_limit = 29 # assume that each host of agents has max_connections = 30 (or 29).persistent_connections_limit 选项定义了与远程持久代理的最大同时持久连接数。这是一个实例范围的设置，必须在 searchd 配置部分定义。每次连接到 agent_persistent 下定义的代理时，我们尝试重用现有连接（如果存在）或创建新连接并保存以供将来使用。然而，在某些情况下，可能需要限制持久连接的数量。该指令定义了限制，并影响所有分布式表中每个代理主机的连接数。
建议将此值设置为代理配置中 max_connections 选项的相等或更小值。
分布式表的一个特殊情况是单个本地表和多个远程表，这种情况专门用于 分布式片段创建，当片段来源于文件时。在这种情况下，本地表可以作为“模板”表，提供构建片段时的分词设置。
snippets_file_prefix = /mnt/common/server1/snippets_file_prefix 是一个可选前缀，可以在生成片段时添加到本地文件名。默认值是当前工作文件夹。
要了解有关分布式片段创建的更多信息，请参阅 CALL SNIPPETS。
您可以从多个 percolate 表创建分布式表。构建此类表的语法与其他分布式表相同，可以包含多个 local 表以及 agents。
对于 DPQ，列出存储查询和通过它们搜索（使用 CALL PQ）的操作是透明的，表现得就像所有表都是一个单一的本地表。然而，数据操作语句如 insert、replace、truncate 不可用。
如果在代理列表中包含非预查询表，行为将不确定。如果错误的代理具有与 PQ 表外层模式（id、query、tags、filters）相同的模式，列出存储的 PQ 规则时不会触发错误，可能会用其自身的非 PQ 字符串污染 PQ 表中实际存储的 PQ 规则列表。因此，请谨慎并意识到这可能引起的混淆。对这样的错误代理执行 CALL PQ 会触发错误。
有关对分布式预查询表进行查询的更多信息，请参阅 对分布式预查询表进行查询。