Browse Source

docs: clarify HTTP persistent connections and state handling

Sergey Nikolaev 1 month ago
parent
commit
74fe73edf1

File diff suppressed because it is too large
+ 0 - 0
.translation-cache/Connecting_to_the_server/HTTP.md.json


+ 47 - 48
manual/chinese/Connecting_to_the_server/HTTP.md

@@ -1,14 +1,14 @@
 # HTTP
 
-你可以通过HTTP/HTTPS连接到Manticore Search。
+您可以通过 HTTP/HTTPS 连接到 Manticore Search。
 
 ## 配置
 <!-- example HTTP -->
-默认情况下,Manticore会在端口9308和9312上监听HTTP、HTTPS和二进制请求。
+默认情况下,Manticore 在端口 9308 和 9312 上监听 HTTP、HTTPS 和二进制请求。
 
-在配置文件的“searchd”部分,你可以使用`listen`指令定义HTTP端口,如下所示:
+在配置文件的 "searchd" 部分,您可以使用 `listen` 指令定义 HTTP 端口,如下所示:
 
-两行都有同样的含义(除了端口号)。它们都定义了将为所有API/HTTP/HTTPS协议提供服务的监听器。没有特殊要求,任何HTTP客户端都可以用来连接到Manticore。
+这两行都是有效的,含义相同(除了端口号)。它们都定义了将为所有 API/HTTP/HTTPS 协议提供服务的监听器。没有特殊要求,任何 HTTP 客户端都可以用来连接到 Manticore。
 
 <!-- request HTTP -->
 ```ini
@@ -21,13 +21,13 @@ searchd {
 ```
 <!-- end -->
 
-所有HTTP端点返回`application/json`内容类型。大多数情况下,端点使用JSON负载进行请求。但是,有一些例外使用NDJSON或简单的URL编码负载。
+所有 HTTP 端点返回 `application/json` 内容类型。大多数端点使用 JSON 负载进行请求。然而,有一些例外情况使用 NDJSON 或简单的 URL 编码负载。
 
-目前没有用户认证。因此,请确保HTTP接口对网络外部的任何人都是不可访问的。由于Manticore像其他任何Web服务器一样工作,你可以使用Nginx等反向代理来实现HTTP认证或缓存。
+目前没有用户认证。因此,请确保 HTTP 接口在您的网络之外不可访问。由于 Manticore 的功能与其他 Web 服务器类似,您可以使用反向代理(如 Nginx)来实现 HTTP 认证或缓存。
 
 <!-- example HTTPS -->
-HTTP协议还支持[SSL加密](../Security/SSL.md):
-如果你指定`:https`而不是`:http`,**只有**经过加密的连接才会被接受。否则,如果客户端尝试通过https连接但没有有效的密钥/证书提供,连接将被中断。如果你对9443端口进行非HTTPS的HTTP请求,它将返回HTTP状态码400。
+HTTP 协议也支持 [SSL 加密](../Security/SSL.md):
+如果您指定 `:https` 而不是 `:http`,**仅**接受安全连接。否则,如果未提供有效的密钥/证书,但客户端尝试通过 HTTPS 连接,连接将被丢弃。如果您向 9443 发送非 HTTPS 的 HTTP 请求,它将返回 HTTP 状态码 400。
 
 <!-- request HTTPS -->
 ```ini
@@ -40,11 +40,11 @@ searchd {
 ```
 <!-- end -->
 
-### VIP连接
+### VIP 连接
 <!-- example VIP -->
-可以使用单独的HTTP接口进行'VIP'连接。在这种情况下,连接会绕过线程池并总是创建一个新的专用线程。在服务器严重过载期间,这很有用,当服务器可能停滞或不允许常规端口连接时。
+可以使用单独的 HTTP 接口进行“VIP”连接。在这种情况下,连接会绕过线程池,始终创建一个新的专用线程。这在服务器可能停滞或不允许常规端口连接的严重过载期间管理 Manticore Search 很有用
 
-有关`listen`指令的更多信息,请参见[此处](../Server_settings/Searchd.md#listen)。
+有关 `listen` 指令的更多信息,请参见[此部分](../Server_settings/Searchd.md#listen)。
 
 <!-- request VIP -->
 ```ini
@@ -57,37 +57,37 @@ searchd {
 ```
 <!-- end -->
 
-## SQL over HTTP
+## 通过 HTTP 的 SQL
 
-Manticore提供了`/sql`、`/cli`和`/cli_json`端点,用于通过HTTP运行SQL查询。每个端点都针对特定的使用场景设计
+Manticore 提供了 `/sql`、`/cli` 和 `/cli_json` 端点,用于通过 HTTP 运行 SQL 查询。每个端点都设计用于特定的使用场景
 
-* `/sql`:适合应用程序的程序化使用。
-  - `/sql`端点只接受SELECT语句,并以HTTP JSON格式返回响应。
-  - `/sql?mode=raw`端点接受任何SQL查询,并以原始格式返回响应,类似于通过mysql接收的响应。
-* `/cli`:仅用于手动使用(例如,通过curl或浏览器)。**不建议用于脚本。**
-* `/cli_json`:类似于`/cli`,但返回结果以JSON格式。**不建议用于脚本。**
+* `/sql`:适用于从应用程序进行编程使用。
+  - `/sql` 端点仅接受 SELECT 语句,并以 HTTP JSON 格式返回响应。
+  - `/sql?mode=raw` 端点接受任何 SQL 查询,并以类似于通过 mysql 接收的原始格式返回响应。
+* `/cli`:**仅适用于手动使用**(例如通过 curl 或浏览器)。**不推荐用于脚本。**
+* `/cli_json`:类似于 `/cli`,但以 JSON 格式返回结果。**不推荐用于脚本。**
 
 ### /sql
 
 <!-- example SQL_over_HTTP -->
 
-通用语法:
+一般语法:
 * `curl "localhost:6780/sql[?mode=raw]&query={URL_ENCODED_QUERY}"`
 * `curl localhost:6780/sql[?mode=raw] -d "[query={URL_ENCODED_QUERY}|{NOT_URL_ENCODED_QUERY}]"`
 
-`/sql`端点通过HTTP JSON接口接受SQL查询:
-* 不带`mode=raw`时- 只允许[SELECTs](../Searching/Full_text_matching/Basic_usage.md#SQL),返回JSON格式的响应。
-* 带有`mode=raw` - 允许任何SQL查询,返回原始格式的响应。
+`/sql` 端点通过 HTTP JSON 接口接受 SQL 查询:
+* 不带 `mode=raw` - 仅允许 [SELECTs](../Searching/Full_text_matching/Basic_usage.md#SQL),返回 JSON 格式的响应。
+* 带 [mode=raw](../Connecting_to_the_server/HTTP.md#mode=raw) - 允许任何 SQL 查询,返回原始格式的响应。
 
-该端点可以使用GET或POST方法处理HTTP请求。发送查询时,你可以:
-1. **使用GET**:将查询包含在URL的`query`参数中,如`/sql?query=your_encoded_query_here`。**重要的是要对这个参数进行URL编码**,以避免错误,特别是如果查询包含`=`符号,这可能会被解释为URL语法的一部分而不是查询的一部分。
-2. **使用POST**:你也可以将查询放在POST请求的主体中。使用此方法时:
-   - 如果你将查询作为名为`query`的参数发送,**确保对其进行URL编码**。
-   - 如果你直接将查询作为纯文本(原始POST主体)发送,**不要对其进行URL编码**。这在查询较长或复杂,或者查询存储在文件中且你想以原样发送时非常有用,可以通过指向HTTP客户端(例如`curl`)来实现
+该端点可以使用 GET 或 POST 方法处理 HTTP 请求。发送查询时,您可以:
+1. **使用 GET:** 在 URL 的 `query` 参数中包含查询,例如 `/sql?query=your_encoded_query_here`。**重要的是要对这个参数进行 URL 编码**,以避免错误,特别是如果查询包含 `=` 符号,这可能会被解释为 URL 语法的一部分而不是查询的一部分。
+2. **使用 POST:** 您也可以在 POST 请求的正文中发送查询。使用此方法时:
+   - 如果您以名为 `query` 的参数发送查询,**请确保对其进行 URL 编码**。
+   - 如果您直接以纯文本(原始 POST 正文)发送查询,**不要进行 URL 编码**。这在查询较长或较复杂,或者查询存储在文件中且您希望按原样发送时很有用,只需将 HTTP 客户端(例如 `curl`)指向它即可
 
-这种方法保持了GET和POST的使用方式不同,避免了在单个请求中混淆方法
+这种方法保持了 GET 和 POST 的使用方式不同,并避免了在单个请求中混合方法的混淆
 
-不带`mode=raw`的响应是一个包含命中信息和执行时间的JSON。响应格式与[json/search](../Searching/Full_text_matching/Basic_usage.md#HTTP-JSON)端点相同。注意,`/sql`端点只支持单个搜索请求。处理多查询,请参阅下面关于[原始模式](../Connecting_to_the_server/HTTP.md#mode=raw)的章节
+不带 `mode=raw` 时,响应是一个包含命中信息和执行时间的 JSON。响应格式与 [json/search](../Searching/Full_text_matching/Basic_usage.md#HTTP-JSON) 端点相同。请注意,`/sql` 端点仅支持单个搜索请求。要处理多个查询,请参见下面关于 [raw 模式](../Connecting_to_the_server/HTTP.md#mode=raw) 的部分
 
 <!-- request POST -->
 ```bash
@@ -201,7 +201,7 @@ GET /sql?query=select%20id%2Csubject%2Cauthor_id%20%20from%20forum%20where%20mat
 
 <!-- example mode=raw -->
 
-`/sql`端点还包括一个特殊的"raw"模式,允许你发送**任何有效的SQL查询,包括多查询**。通过使用`mode=raw`选项可以激活此模式。
+`/sql` 端点还包括一个特殊的 "raw" 模式,允许您发送 **任何有效的 SQL 查询,包括多查询**。响应是一个包含一个或多个结果集的 JSON 数组。您可以通过使用选项 `mode=raw` 启用此模式。
 
 <!-- request POST -->
 ```bash
@@ -488,11 +488,11 @@ curl localhost:9308/sql -d 'mode=raw&query=SHOW TABLES'
 
 <!-- example cli -->
 
-> 注意:`/cli`需要[Manticore Buddy](../Installation/Manticore_Buddy.md)。如果不起作用,请确保已安装Buddy。
+> 注意:`/cli` 需要 [Manticore Buddy](../Installation/Manticore_Buddy.md)。如果不起作用,请确保已安装 Buddy。
 
-> 注意:`/cli`端点是使用curl或浏览器等工具与Manticore进行手动交互设计的。它不适用于自动化脚本。请使用`/sql`端点。
+> 注意:`/cli` 端点旨在使用 curl 或浏览器等工具手动与 Manticore 交互。它不适用于自动化脚本。请改用 `/sql` 端点。
 
-While the `/sql` 端点对于从应用程序中以编程方式控制 Manticore 是有用的,还有一个 `/cli` 端点。这使得使用 curl 或浏览器 **手动维护 Manticore 实例** 更加容易。它接受 POST 和 GET HTTP 方法。在 `/cli?` 之后输入的所有内容都被 Manticore 理解,即使没有通过 curl 手动转义或浏览器自动编码。不需要 `query` 参数。重要的是,`+` 符号不会被转换为空格,消除了编码它的必要。对于 POST 方法,Manticore 接受一切内容,没有任何更改。响应格式为表格形式,类似于 MySQL 客户端中看到的 SQL 结果集。
+虽然 /sql 端点对于从您的应用程序以编程方式控制 Manticore 非常有用,但还有一个 /cli 端点。这使得通过 curl 或浏览器**手动维护 Manticore 实例**更加容易。它接受 POST 和 GET HTTP 方法。/cli? 之后输入的所有内容都被 Manticore 理解,即使没有通过 curl 手动转义或浏览器自动编码。不需要 `query` 参数。重要的是,`+` 符号不会被转换为空格,因此无需对其进行编码。对于 POST 方法,Manticore 会原样接受所有内容,不会做任何更改。响应以表格格式呈现,类似于您在 MySQL 客户端中可能看到的 SQL 结果集。
 
 <!-- request POST -->
 
@@ -535,7 +535,7 @@ GET /cli?desc%20test
 
 <!-- request Browser -->
 
-![使用 /cli 在浏览器中](cli_browser.png)
+![在浏览器中使用 /cli](cli_browser.png)
 
 <!-- request curl example -->
 
@@ -558,13 +558,13 @@ curl 0:9308/cli -d 'desc test'
 <!-- end -->
 
 ### /cli_json
-> 注意:`/cli_json` 端点旨在使用 curl 或浏览器等工具进行手动与 Manticore 交互。它不适用于自动化脚本。请使用 `/sql` 端点。
+> 注意:/cli_json 端点是为使用 curl 或浏览器等工具手动与 Manticore 交互而设计的。它不适用于自动化脚本。请改用 /sql 端点。
 
 <!-- example cli_json -->
-`/cli_json` 端点提供了与 `/cli` 相同的功能,但响应格式为 JSON。它包括:
-- `columns` 部分描述模式。
-- `data` 部分包含实际数据。
-- 总结部分包含 "total"、"error" 和 "warning"。
+/cli_json 端点提供的功能与 /cli 相同,但响应格式为 JSON。它包括:
+- `columns` 部分描述模式。
+- `data` 部分包含实际数据。
+- 包含 "total"、"error" 和 "warning" 的摘要部分
 
 <!-- request POST -->
 
@@ -697,27 +697,26 @@ curl 0:9308/cli_json -d 'desc test'
 
 ### 持久连接
 
-持久连接意味着客户端不仅发送一个查询然后断开连接,而是保持连接打开并发送多个查询。因此,如果有名称解析,它只发生一次;TCP 窗口大小也会被建立。此外,守护进程可能会提供连接范围内的状态,例如元信息和之前查询的配置文件。
+持久连接意味着客户端保持 TCP 连接打开,并通过该连接发送多个查询,而不是为每个查询打开新连接。这避免了重复的名称解析和连接设置,并允许守护进程保留每个连接的状态,例如元信息和查询配置文件。
 
-通过 HTTP 1.0 协议连接时,需要添加 `Connection: keep-alive` 头来保持持久连接。
+在 HTTP/1.0 中,添加 `Connection: keep-alive` 以请求持久连接。
 
-通过 HTTP 1.1 协议连接时,默认情况下连接是持久的。在这种情况下,建议在终止查询时添加 `Connection: close` 头以明确表示连接已结束并被断开
+在 HTTP/1.1 中,连接默认是持久的。在最后一个请求上发送 `Connection: close` 以明确结束会话
 
 ### HTTP 状态
 
-在已建立的连接上,守护进程会保留一些状态,这些状态可以为后续查询提供。该状态保留对于 `/sql`、`/sql?mode=raw` 和 `/cli_json` 端点有效,但不适用于 `/cli` 端点。此功能允许通过 HTTP JSON 接口进行有状态交互。例如,使用 `/cli_json` 端点,可以在 `SELECT` 查询之后执行 `SHOW META` 命令,其行为类似于通过 MySQL 客户端与 Manticore 交互
+在持久连接上,守护进程会保留一些状态,后续查询可以使用这些状态。此状态对于 /sql、/sql?mode=raw 和 /cli_json 端点是保留的,但不适用于 /cli。这使得可以通过 HTTP JSON 进行有状态的交互。例如,当您使用 [/cli_json](../Connecting_to_the_server/HTTP.md#/cli_json) 时,可以在同一连接上 `SELECT` 之后运行 `SHOW META`,类似于使用 MySQL 客户端
 
-要使用 `curl` 通过一个连接运行多个 sphinxql 查询,您需要使用 `--next` 关键字链接您的命令
+要通过一个连接使用 sphinxql 运行多个查询,您需要使用 curl 的 `--next` 键将命令链接起来
 curl -s localhost:9312/cli_json -d "CALL PQ ('pq', ('{"title":"angry", "gid":3 }'))" --next localhost:9312/cli_json -d 'show meta'
 
 ```
-然而,请注意,这将不起作用
+但是请注意,以下内容将**无法工作**
 ```
 
 curl -s localhost:9312/cli_json -d "CALL PQ ('pq', ('{"title":"angry", "gid":3 }')); show meta"
 ```
-这是因为 sphinxql 对批量查询有特殊处理,或 [multi-query](../Searching/Multi-queries.md),它有自己的优点和限制。
+这是因为 Manticore 将分号分隔的 SQL 批处理视为 [多查询](../Searching/Multi-queries.md),它有自己的行为和限制。
 ```
 
-This is because sphinxql uses a special case for batch queries, or  [multi-query](../Searching/Multi-queries.md), which has its own benefits and limitations.
-
+This is because Manticore treats a semicolon-separated SQL batch as a [multi-query](../Searching/Multi-queries.md), which has its own behavior and limitations.

+ 5 - 6
manual/english/Connecting_to_the_server/HTTP.md

@@ -697,15 +697,15 @@ curl 0:9308/cli_json -d 'desc test'
 
 ### Persistent connections
 
-A persistent connection implies that the client sends not only one query and then drops the connection, but keeps the connection established and sends multiple queries. As a result, name resolution (if any) occurs only once; the TCP window size is also established. Moreover, a daemon may provide connection-wide state, such as meta-info and profiles of previous queries.
+A persistent connection means the client keeps the TCP connection open and sends multiple queries over it, instead of opening a new connection for each query. This avoids repeated name resolution and connection setup, and it allows the daemon to keep per-connection state, such as meta information and query profiles.
 
-When connecting via HTTP 1.0 protocol, you need to add the `Connection: keep-alive` header to maintain the persistent connection.
+With HTTP/1.0, add `Connection: keep-alive` to request a persistent connection.
 
-When connecting via HTTP 1.1 protocol, the connection is persistent by default. In this case, it is recommended to add the `Connection: close` header in the terminating query to explicitly signal that the connection has been finished and then dropped.
+With HTTP/1.1, connections are persistent by default. Send `Connection: close` on the final request to explicitly end the session.
 
 ### HTTP state
 
-On an established connection, a daemon keeps some state that may be provided for later queries. The state is retained for the `/sql`, `/sql?mode=raw`, and `/cli_json` endpoints, but not for the `/cli` endpoint. This feature enables stateful interactions via the HTTP JSON interface. For example, using the [/cli_json](../Connecting_to_the_server/HTTP.md#/cli_json) endpoint, you can execute a `SHOW META` command after a `SELECT` query, and it will behave similarly to interacting with Manticore through a MySQL client.
+On a persistent connection, the daemon keeps some state that later queries can use. This state is preserved for the `/sql`, `/sql?mode=raw`, and `/cli_json` endpoints, but not for `/cli`. This enables stateful interactions over HTTP JSON. For example, when you use [/cli_json](../Connecting_to_the_server/HTTP.md#/cli_json), you can run `SHOW META` after a `SELECT` on the same connection, similar to using a MySQL client.
 
 To run multiple queries using sphinxql via one connection with `curl`, you need to chain your commands with the
 `--next` key:
@@ -719,5 +719,4 @@ Notice, however, that this will NOT work:
 curl -s localhost:9312/cli_json -d "CALL PQ ('pq', ('{"title":"angry", "gid":3 }')); show meta"
 ```
 
-This is because sphinxql uses a special case for batch queries, or  [multi-query](../Searching/Multi-queries.md), which has its own benefits and limitations.
-
+This is because Manticore treats a semicolon-separated SQL batch as a [multi-query](../Searching/Multi-queries.md), which has its own behavior and limitations.

+ 9 - 10
manual/russian/Connecting_to_the_server/HTTP.md

@@ -492,7 +492,7 @@ curl localhost:9308/sql -d 'mode=raw&query=SHOW TABLES'
 
 > ПРИМЕЧАНИЕ: Эндпоинт `/cli` предназначен для ручного взаимодействия с Manticore с использованием таких инструментов, как curl или браузер. Он не предназначен для использования в автоматизированных скриптах. Вместо этого используйте эндпоинт `/sql`.
 
-Хотя конечная точка `/sql` полезна для программного управления Manticore из вашего приложения, существует также конечная точка `/cli`. Это упрощает **ручное обслуживание экземпляра Manticore** с помощью curl или вашего браузера. Она принимает оба HTTP-метода POST и GET. Всё, что введено после `/cli?`, понимается Manticore, даже если оно не экранировано вручную с помощью curl или автоматически закодировано браузером. Параметр `query` не требуется. Важно, что знак `+` не преобразуется в пробел, что устраняет необходимость его кодирования. Для метода POST Manticore принимает всё точно так, как есть, без каких-либо изменений. Ответ предоставляется в табличном формате, аналогичном набору результатов SQL, который вы можете увидеть в клиенте MySQL.
+Хотя эндпоинт `/sql` полезен для программного управления Manticore из вашего приложения, существует также эндпоинт `/cli`. Это упрощает **ручное обслуживание экземпляра Manticore** с помощью curl или вашего браузера. Он принимает оба HTTP-метода POST и GET. Всё, что введено после `/cli?`, понимается Manticore, даже если оно не экранировано вручную с помощью curl или автоматически закодировано браузером. Параметр `query` не требуется. Важно, что знак `+` не заменяется на пробел, что устраняет необходимость его кодирования. Для метода POST Manticore принимает всё как есть, без каких-либо изменений. Ответ представлен в табличном формате, аналогичном результату SQL, который вы можете видеть в клиенте MySQL.
 
 <!-- request POST -->
 
@@ -535,7 +535,7 @@ GET /cli?desc%20test
 
 <!-- request Browser -->
 
-![использование /cli в браузере](cli_browser.png)
+![using /cli in browser](cli_browser.png)
 
 <!-- request curl example -->
 
@@ -558,10 +558,10 @@ curl 0:9308/cli -d 'desc test'
 <!-- end -->
 
 ### /cli_json
-> ПРИМЕЧАНИЕ: Конечная точка `/cli_json` предназначена для ручного взаимодействия с Manticore с помощью таких инструментов, как curl или браузер. Она не предназначена для использования в автоматизированных скриптах. Вместо этого используйте конечную точку `/sql`.
+> ПРИМЕЧАНИЕ: Эндпоинт `/cli_json` предназначен для ручного взаимодействия с Manticore с использованием таких инструментов, как curl или браузер. Он не предназначен для использования в автоматизированных скриптах. Вместо этого используйте эндпоинт `/sql`.
 
 <!-- example cli_json -->
-Конечная точка `/cli_json` предоставляет те же возможности, что и `/cli`, но формат ответа — JSON. Он включает:
+Эндпоинт `/cli_json` предоставляет те же функции, что и `/cli`, но формат ответа — JSON. Он включает:
 - раздел `columns`, описывающий схему.
 - раздел `data` с фактическими данными.
 - Сводный раздел с "total", "error" и "warning".
@@ -697,15 +697,15 @@ curl 0:9308/cli_json -d 'desc test'
 
 ### Постоянные соединения
 
-Постоянное соединение подразумевает, что клиент отправляет не один запрос и затем разрывает соединение, а поддерживает соединение установленным и отправляет несколько запросов. В результате разрешение имён (если оно есть) происходит только один раз; также устанавливается размер TCP-окна. Более того, демон может предоставлять состояние, общее для всего соединения, например, метаинформацию и профили предыдущих запросов.
+Постоянное соединение означает, что клиент держит TCP-соединение открытым и отправляет по нему несколько запросов, вместо того чтобы открывать новое соединение для каждого запроса. Это позволяет избежать повторного разрешения имён и установки соединения, а также позволяет демону сохранять состояние для каждого соединения, такое как метаинформация и профили запросов.
 
-При подключении по протоколу HTTP 1.0 необходимо добавить заголовок `Connection: keep-alive` для поддержания постоянного соединения.
+При использовании HTTP/1.0 добавьте `Connection: keep-alive` для запроса постоянного соединения.
 
-При подключении по протоколу HTTP 1.1 соединение по умолчанию является постоянным. В этом случае рекомендуется добавить заголовок `Connection: close` в завершающем запросе, чтобы явно сигнализировать о завершении и последующем разрыве соединения.
+При использовании HTTP/1.1 соединения по умолчанию являются постоянными. Отправьте `Connection: close` в последнем запросе, чтобы явно завершить сеанс.
 
 ### Состояние HTTP
 
-На установленном соединении демон сохраняет некоторое состояние, которое может быть предоставлено для последующих запросов. Состояние сохраняется для конечных точек `/sql`, `/sql?mode=raw` и `/cli_json`, но не для конечной точки `/cli`. Эта функция позволяет осуществлять взаимодействие с сохранением состояния через HTTP JSON интерфейс. Например, используя конечную точку [/cli_json](../Connecting_to_the_server/HTTP.md#/cli_json), вы можете выполнить команду `SHOW META` после запроса `SELECT`, и она будет вести себя аналогично взаимодействию с Manticore через клиент MySQL.
+На постоянном соединении демон сохраняет некоторое состояние, которое могут использовать последующие запросы. Это состояние сохраняется для эндпоинтов `/sql`, `/sql?mode=raw` и `/cli_json`, но не для `/cli`. Это позволяет осуществлять взаимодействия с сохранением состояния через HTTP JSON. Например, при использовании [/cli_json](../Connecting_to_the_server/HTTP.md#/cli_json) вы можете выполнить `SHOW META` после `SELECT` на том же соединении, аналогично использованию клиента MySQL.
 
 Чтобы выполнить несколько запросов с использованием sphinxql через одно соединение с помощью `curl`, вам нужно объединить ваши команды с помощью ключа
 `--next`:
@@ -719,5 +719,4 @@ curl -s localhost:9312/cli_json -d "CALL PQ ('pq', ('{"title":"angry", "gid":3 }
 curl -s localhost:9312/cli_json -d "CALL PQ ('pq', ('{"title":"angry", "gid":3 }')); show meta"
 ```
 
-Это связано с тем, что sphinxql использует особый случай для пакетных запросов или [мультизапросов](../Searching/Multi-queries.md), которые имеют свои преимущества и ограничения.
-
+Это связано с тем, что Manticore рассматривает пакет SQL, разделённый точкой с запятой, как [мультизапрос](../Searching/Multi-queries.md), который имеет своё собственное поведение и ограничения.

Some files were not shown because too many files changed in this diff