@@ -5,22 +5,23 @@ SHOW META [ LIKE pattern ]
55```
66
77<!-- example show meta -->
8- ` SHOW META ` 是一个 SQL 语句,用于显示有关处理查询的附加元信息,包括查询时间、关键字统计以及使用的二级索引信息 。语法如下:
8+ ` SHOW META ` 是一个 SQL 语句,用于显示有关处理查询的附加元信息,包括查询时间、关键词统计以及使用的辅助索引信息 。语法如下:
99
1010包含的项目有:
1111* ` total ` :实际检索并发送给客户端的匹配数。该值通常受 [ LIMIT/size] ( ../Searching/Pagination.md#Pagination-of-search-results ) 搜索选项的限制。
1212* ` total_found ` :
13- - 索引中查询的估计匹配总数。如果需要精确的匹配数,请使用 ` SELECT COUNT(*) ` ,而不是依赖此值。
14- - 对于带有 ` GROUP BY ` 的查询,` total_found ` 表示组的数量,而非单个匹配数。
15- - 对于 [ GROUP N BY] ( ../Searching/Grouping.md#Give-me-N-rows ) 查询,` total_found ` 仍表示组的数量,无论 ` N ` 的值是多少。
16- * ` total_relation ` :指示 ` total_found ` 值是精确的还是估计的。
17- - 如果 Manticore 无法确定精确的 ` total_found ` 值,此字段将显示 ` total_relation: gte ` ,表示实际匹配数** 大于或等于** 报告的 ` total_found ` 。
18- - 如果 ` total_found ` 值是精确的,则显示 ` total_relation: eq ` 。
19- * ` time ` :处理搜索查询所用的时间(秒)。
20- * ` keyword[N] ` :搜索查询中使用的第 n 个关键字。注意关键字可以是通配符形式,例如 ` abc* ` 。
21- * ` docs[N] ` :包含搜索查询中第 n 个关键字的文档(或记录)总数。如果关键字是通配符形式,此值表示所有展开子关键字的文档总和,可能超过实际匹配文档数。
22- * ` hits[N] ` :第 n 个关键字在所有文档中出现的总次数(命中数)。
23- * ` index ` :所使用索引的信息(例如二级索引)。
13+ - 索引中查询的匹配项估计总数。如果需要确切的匹配数量,请使用 ` SELECT COUNT(*) ` ,而不要依赖此值。
14+ - 对于带有 ` GROUP BY ` 的查询,` total_found ` 表示组的数量,而非单个匹配。
15+ - 当使用带有 ` GROUP BY ` 的 ` HAVING ` 时,` total_found ` 反映应用 ` HAVING ` 过滤后的组数。这支持带有 ` HAVING ` 子句的正确分页。
16+ - 对于 [ GROUP N BY] ( ../Searching/Grouping.md#Give-me-N-rows ) 查询,不论 ` N ` 的值,` total_found ` 仍然表示组的数量。
17+ * ` total_relation ` :指示 ` total_found ` 的值是准确的还是估计的。
18+ - 如果 Manticore 无法确定精确的 ` total_found ` 值,该字段将显示 ` total_relation: gte ` ,意味着实际匹配数量 ** 大于或等于** 报告的 ` total_found ` 。
19+ - 如果 ` total_found ` 是精确值,则显示 ` total_relation: eq ` 。
20+ * ` time ` :处理搜索查询所用的时间(以秒为单位)。
21+ * ` keyword[N] ` :搜索查询中第 n 个使用的关键词。关键词可以是通配符,例如 ` abc* ` 。
22+ * ` docs[N] ` :包含搜索查询中第 n 个关键词的文档(或记录)总数。如果关键词是通配符,则该值表示所有展开子关键词文档数的总和,可能超过实际匹配的文档数。
23+ * ` hits[N] ` :第 n 个关键词在所有文档中出现的总次数(或命中次数)。
24+ * ` index ` :所用索引的信息(例如辅助索引)。
2425
2526<!-- intro -->
2627##### SQL:
@@ -69,7 +70,7 @@ show meta;
6970<!-- end -->
7071
7172<!-- example show meta iostats cpustats -->
72- ` SHOW META ` 可以显示 I/O 和 CPU 计数器,但仅当 searchd 启动时带有 ` --iostats ` 和 ` --cpustats ` 参数时才可用 。
73+ ` SHOW META ` 可以显示 I/O 和 CPU 计数器,但只有在 searchd 启动时使用了 ` --iostats ` 和 ` --cpustats ` 开关时,这些信息才可用 。
7374
7475<!-- intro -->
7576##### SQL:
@@ -132,7 +133,7 @@ SHOW META;
132133<!-- end -->
133134
134135<!-- example show meta predicted_time -->
135- 额外的值,如 ` predicted_time ` 、` dist_predicted_time ` 、` local_fetched_docs ` 、` local_fetched_hits ` 、` local_fetched_skips ` 及其对应的 ` dist_fetched_* ` ,仅在 ` searchd ` 配置了[ 预测时间成本] ( ../Server_settings/Searchd.md#predicted_time_costs ) 且查询的 ` OPTION ` 子句中包含 ` predicted_time ` 时可用 。
136+ 额外的值如 ` predicted_time ` 、` dist_predicted_time ` 、` local_fetched_docs ` 、` local_fetched_hits ` 、` local_fetched_skips ` 以及其对应的 ` dist_fetched_* ` 等仅在 ` searchd ` 配置了 [ 预测时间成本] ( ../Server_settings/Searchd.md#predicted_time_costs ) , 且查询的 ` OPTION ` 子句中包含 ` predicted_time ` 时才可用 。
136137
137138<!-- intro -->
138139##### SQL:
@@ -187,7 +188,7 @@ mysql> show meta;
187188
188189<!-- example show meta single statement -->
189190
190- ` SHOW META ` 必须在 ** 同一** 会话中紧接查询之后执行 。由于某些 MySQL 连接器/库使用连接池,单独执行 ` SHOW META ` 可能导致意外结果,例如获取到其他查询的元数据。在这些情况下(且通常推荐),应执行包含查询和 ` SHOW META ` 的多语句。一些连接器/库支持在同一方法中执行多查询,而其他可能需要专用方法或在连接设置时配置特定选项 。
191+ ` SHOW META ` 必须紧接查询之后在 ** 同一** 会话中执行 。由于某些 MySQL 连接器/库使用连接池,单独执行 ` SHOW META ` 可能导致意外结果,如获取到其它查询的元数据。针对这种情况(且一般推荐),请使用包含查询和 ` SHOW META ` 的多语句查询。有些连接器/库支持在同一方法内多查询执行,另一些可能需要专用多查询方法或在连接设置时配置特殊选项 。
191192
192193<!-- intro -->
193194##### SQL:
@@ -235,7 +236,7 @@ SELECT id,story_author FROM hn_small WHERE MATCH('one|two|three') LIMIT 5; SHOW
235236
236237<!-- example SHOW META LIKE -->
237238
238- 你也可以使用可选的 LIKE 子句,只选择匹配特定模式的变量 。模式语法遵循标准 SQL 通配符,其中 ` % ` 表示任意数量的任意字符,` _ ` 表示单个字符。
239+ 也可以使用可选的 LIKE 子句,只选出匹配特定模式的变量 。模式语法遵循标准 SQL 通配符,` % ` 表示任意数量的任意字符,` _ ` 表示单个字符。
239240
240241<!-- intro -->
241242##### SQL:
@@ -260,11 +261,11 @@ SHOW META LIKE 'total%';
260261
261262<!-- end -->
262263
263- ## SHOW META 和 facets
264+ ## SHOW META 与 facets
264265
265266<!-- example show meta facets -->
266267
267- 使用[ 分面搜索] ( ../Searching/Faceted_search.md ) 时,可以查看 ` SHOW META ` 输出中的 ` multiplier ` 字段,以确定优化分组中执行了多少查询 。
268+ 使用 [ 分面搜索] ( ../Searching/Faceted_search.md ) 时,可在 ` SHOW META ` 输出中查看 ` multiplier ` 字段,了解执行了多少个优化分组的查询 。
268269
269270<!-- intro -->
270271##### SQL:
@@ -312,13 +313,13 @@ SHOW META LIKE 'multiplier';
312313
313314<!-- end -->
314315
315- ## SHOW META 和查询优化器
316+ ## SHOW META 与查询优化器
316317
317318<!-- example of show meta vs query optimizer -->
318319
319- 当[ 基于成本的查询优化器] ( ../Searching/Cost_based_optimizer.md ) 选择使用 ` DocidIndex ` 、` ColumnarScan ` 或 ` SecondaryIndex ` 而非简单过滤器时 ,` SHOW META ` 命令会反映这一点。
320+ 当 [ 基于成本的查询优化器] ( ../Searching/Cost_based_optimizer.md ) 选择用 ` DocidIndex ` 、` ColumnarScan ` 或 ` SecondaryIndex ` 代替普通过滤时 ,` SHOW META ` 命令会反映这一点。
320321
321- ` index ` 变量显示查询执行期间使用的二级索引的名称和类型。百分比表示使用二级索引的磁盘块数量( RT 表情况)或伪分片数量(普通表情况) 。
322+ ` index ` 变量显示执行查询时使用的辅助索引名称和类型。百分比表示在 RT 表中使用辅助索引的磁盘块数量或在普通表中使用的伪分片数量 。
322323
323324<!-- intro -->
324325##### SQL:
@@ -350,15 +351,15 @@ SHOW META;
350351
351352<!-- example show meta PQ -->
352353
353- ` SHOW META ` 可在执行[ CALL PQ] ( ../Searching/Percolate_query.md#Performing-a-percolate-query-with-CALL-PQ ) 语句后使用,此时输出不同 。
354+ ` SHOW META ` 可在执行 [ CALL PQ] ( ../Searching/Percolate_query.md#Performing-a-percolate-query-with-CALL-PQ ) 语句后使用,此时会提供不同的输出 。
354355
355- ` CALL PQ ` 语句后执行的 ` SHOW META ` 包含:
356+ ` CALL PQ ` 之后的 ` SHOW META ` 包含:
356357
357358* ` total ` - 匹配文档所花费的总时间
358- * ` queries_matched ` - 匹配文档的存储查询数量
359- * ` document_matches ` - 匹配表中存储查询的文档数量
360- * ` total_queries_stored ` - 表中存储的查询总数
361- * ` term_only_queries ` - 表中包含词项的查询数量 ;其余查询使用扩展查询语法。
359+ * ` queries_matched ` - 匹配文档的存储查询数
360+ * ` document_matches ` - 匹配表中存储查询的文档数
361+ * ` total_queries_stored ` - 表中存储查询的总数
362+ * ` term_only_queries ` - 表中含词项的查询数 ;其余查询使用扩展查询语法。
362363
363364<!-- intro -->
364365##### SQL:
@@ -404,7 +405,7 @@ CALL PQ ('pq', ('{"title":"angry", "gid":3 }')); SHOW META;
404405* ` Queries failed ` - 失败的查询数量
405406* ` Fast rejected queries ` - 未完全评估但通过过滤器或其他条件快速匹配并拒绝的查询数量
406407* ` Time per query ` - 每个查询的详细时间
407- * ` Time of matched queries ` - 匹配到任何文档的查询所花费的总时间
408+ * ` Time of matched queries ` - 与任何文档匹配的查询所花费的总时间
408409
409410
410411<!-- intro -->
0 commit comments