FT.INFO
返回索引的信息和统计信息
语法
FT.INFO index
引入版本：1.0.0
复杂度摘要：O(1)
返回有关给定索引的信息和统计信息。
必需参数
index
是给定索引的名称。您必须首先使用 FT.CREATE 创建索引。您还可以使用使用 FT.ALIASADD 或 FT.ALIASUPDATE 创建的 index 别名。
返回值
概述
| 返回字段名称 | 定义 |
|---|---|
index_name |
创建索引时定义的索引名称。 |
index_options |
FT.CREATE 期间选择的索引选项，如 FILTER {filter}、LANGUAGE {default_lang} 等。 |
index_definition |
包括key_type、hash或JSON； prefixes，如果有的话；和default_score。 |
attributes |
索引架构字段名称、类型和属性。 |
num_docs |
文件数量。 |
max_doc_id |
最大文档ID。 |
num_terms |
不同术语的数量。 |
num_records |
记录总数。 |
各种尺寸统计
| 统计 | 定义 |
|---|---|
inverted_sz_mb |
倒排索引使用的内存，倒排索引是RediSearch中用于搜索的核心数据结构。大小以兆字节为单位。 |
vector_index_sz_mb |
向量索引使用的内存，它存储与每个文档关联的任何向量。 |
total_inverted_index_blocks |
倒排索引中的块总数。 |
offset_vectors_sz_mb |
偏移向量使用的内存，存储文档中术语的位置信息。 |
doc_table_size_mb |
文档表使用的内存，包含索引中每个文档的元数据。 |
sortable_values_size_mb |
可排序值使用的内存，这些值是与文档关联并用于排序目的的值。 |
key_table_size_mb |
键表使用的内存，存储文档ID和Redis键之间的映射。 |
geoshapes_sz_mb |
GEO相关字段使用的内存。 |
records_per_doc_avg |
每个文档的平均记录数（包括删除）。 |
bytes_per_record_avg |
每条记录的平均大小（以字节为单位）。 |
offsets_per_term_avg |
每项的平均偏移数（位置信息）。 |
offset_bits_per_record_avg |
每个记录用于偏移的平均位数。 |
tag_overhead_sz_mb |
用于优化性能的TAG索引结构的大小。 |
text_overhead_sz_mb |
用于优化性能的TEXT索引结构的大小。 |
total_index_memory_sz_mb |
DB中所有索引消耗的总内存。 |
索引相关统计
| 统计 | 定义 |
|---|---|
hash_indexing_failures |
索引过程中遇到的失败次数。 |
total_indexing_time |
索引文档所花费的累积挂钟时间（以毫秒为单位）。 |
indexing |
指示当前是否正在生成索引。 |
percent_indexed |
已成功生成索引的百分比（1表示100%）。 |
number_of_uses |
索引被使用的次数。 |
cleaning |
索引删除标志。 1 值表示索引删除正在进行中。 |
垃圾收集统计
| 统计 | 定义 |
|---|---|
bytes_collected |
垃圾收集期间收集的字节数。 |
total_ms_run |
垃圾收集所花费的总时间（以毫秒为单位）。 |
total_cycles |
垃圾收集周期的总数。 |
average_cycle_time_ms |
每个垃圾收集周期的平均时间（以毫秒为单位）。值 nan 表示平均周期时间不可用。 |
last_run_time_ms |
上次垃圾收集运行所花费的时间（以毫秒为单位）。 |
接下来两个与GC相关的字段适用于父进程和子进程在同一内存区域同时发生更改，导致父进程丢弃这些更改的情况。
| 统计 | 定义 |
|---|---|
gc_numeric_trees_missed |
垃圾收集期间由于父进程分裂而丢弃更改的数值树节点的数量。 |
gc_blocks_denied |
由于在垃圾收集期间被父进程修改而被丢弃（跳过）的更改的块的数量。值得注意的是，由于倒排索引块是仅附加的，因此只能跳过倒排索引的最后一个块。 |
游标统计
| 统计 | 定义 |
|---|---|
global_idle |
系统中空闲光标的数量。 |
global_total |
系统中光标的总数。 |
index_capacity |
每个索引允许的最大游标数。 |
index_total |
索引上打开的游标总数。 |
其他统计
- 方言统计：使用每种方言搜索索引的次数，1 - 4。
- 索引错误统计，包括
indexing failures、last indexing error、last indexing error key。 - 字段统计信息，包括每个 schema 字段的
indexing failures、last indexing error和last indexing error key。
示例
Return statistics about an index
127.0.0.1:6379> ft.info idx:bicycle 1) index_name 2) idx:bicycle 3) index_options 4) (空数组) 5) index_definition 6) 1) key_type 2) JSON 3) 前缀 4) 1) 自行车: 5) default_score 6) "1" 7) 属性 8) 1) 1) 标识符 2) $.pickup_zone 3) 属性 4) pickup_zone 5) 类型 6) GEOSHAPE 7) coord_system 8) SPHERICAL 2) 1) 标识符 2) $.store_location 3) 属性 4) store_location 5) 类型 6) GEO 3) 1) 标识符 2) $.brand 3) 属性 4) 品牌 5) 类型 6) TEXT 7) WEIGHT 8) "1" 4) 1) 标识符 2) $.model 3) 属性 4) 型号 5) 类型 6) TEXT 7) WEIGHT 8) "1" 5) 1) 标识符 2) $.description 3) 属性 4) 描述 5) 类型 6) TEXT 7) WEIGHT 8) "1" 6) 1) 标识符 2) $.price 3) 属性 4) 价格 5) 类型6) 数字 7) 1) 标识符 2) $.条件 3) 属性 4) 条件 5) 类型 6) 标签 7) 分隔符 8) , 9) num_docs 10) "10" 11) max_doc_id 12) "10" 13) num_terms 14) "546" 15) num_records 16) "692" 17）inverted_sz_mb 18）“0.003993034362792969”19）vector_index_sz_mb 20）“0”21）total_inverted_index_blocks 22）“551”23）offset_vectors_sz_mb 24） “7.047653198242188e-4”25）doc_table_size_mb 26）“7.152557373046875e-4”27）sortable_values_size_mb 28）“0”29）key_table_size_mb 30）“3.0422210693359375e-4” 31）geoshapes_sz_mb 32）“0.00426483154296875”33）records_per_doc_avg 34）“69.19999694824219”35）bytes_per_record_avg 36）“6.0505781173706055”37） offsets_per_term_avg 38）“1.0679190158843994”39）offset_bits_per_record_avg 40）“8”41）hash_indexing_failures 42）“0”43）total_indexing_time 44）“4.539999961853027”45）索引46） “0”47）percent_indexed 48）“1”49）number_of_uses 50）（整数）1 51）清洁52）（整数）0 53）gc_stats 54）1）bytes_collected 2）“0”3）total_ms_run 4）“0”5）total_cycles 6）“0”7）average_cycle_time_ms 8)“nan”9)last_run_time_ms 10)“0”11)gc_numeric_trees_missed 12)“0”13)gc_blocks_denied 14)“0”55)cursor_stats 56)1)global_idle 2)(整数)0 3)global_total 4)(整数)0 5)index_capacity 6) (整数) 128 7) index_total 8) (整数) 0 57) dialect_stats 58) 1) dialect_1 2) (整数) 0 3) dialect_2 4) (整数) 0 5) dialect_3 6) (整数) 0 7) dialect_4 8) (整数) 0 59) 索引错误60) 1) 索引失败 2) (整数) 0 3) 上次索引错误 4) N/A 5) 上次索引错误键 6) "N/A" 61) 字段统计 62) 1) 1) 标识符 2) $.pickup_zone 3) 属性 4) pickup_zone 5) 索引错误 6) 1) 索引失败 2) (整数) 0 3) 上次索引错误4) N/A 5) 最后索引错误键 6) "N/A" 2) 1) 标识符 2) $.store_location 3) 属性 4) store_location 5) 索引错误 6) 1) 索引失败 2) （整数）0 3) 最后索引错误 4) N/A 5) 最后索引错误键 6) "N/A" 3) 1) 标识符 2) $.brand 3) 属性4) 品牌 5) 索引错误 6) 1) 索引失败 2) (整数) 0 3) 上次索引错误 4) N/A 5) 上次索引错误键 6) "N/A" 4) 1) 标识符 2) $.model 3) 属性 4) 型号 5) 索引错误 6) 1) 索引失败 2) (整数) 0 3) 上次索引错误 4) N/A 5) 最后索引错误键 6) "N/A" 5) 1) 标识符 2) $.description 3) 属性 4) 描述 5) 索引错误 6) 1) 索引失败 2) （整数）0 3) 最后索引错误 4) N/A 5) 最后索引错误键 6) "N/A" 6) 1) 标识符 2) $.price 3) 属性 4) 价格 5) 索引错误 6) 1) 索引失败 2) （整数）0 3) 最后一个索引错误 4) N/A 5) 最后一个索引错误键 6) “N/A” 7) 1) 标识符 2) $.condition 3) 属性 4) 条件 5) 索引错误 6) 1) 索引失败 2) （整数）0 3) 最后一个索引错误 4) N/A 5) 最后一个索引错误键6) “不适用”
Redis Software 与 Redis Cloud 兼容性
| Redis 软件 |
Redis软件 Flex |
Redis Cloud 灵活且每年 |
Redis Cloud 免费和固定 |
说明 |
|---|---|---|---|---|
| ✅ 支持 | ⚠️ 有限 | ✅ 支持 | ✅ 支持 | 对 Flex 数据库 的支持有限。 |
返回值
RESP2
以下之一： * 包含索引信息和统计信息的键值对的 数组。 * 简单错误回复 在这些情况下：没有这样的索引。
RESP3
以下之一： * 地图 包含索引信息和统计信息作为键值对。 * 简单错误回复 在这些情况下：没有这样的索引。
参见
FT.CREATE | FT.SEARCH | FT.ALIASADD | FT.ALIASUPDATE
相关主题
资料来源：Redis 官方 FT.INFO 文档；中文内容参考 Redis 文档许可。