FT.INFO

このコマンドは、リクエストされたインデックスに関する情報を提供します。

構文

FT.INFO index
  • index(必須): 情報を取得するインデックスの名前。

コマンドの戻り値

FT.INFO コマンドによって返される配列には、次の表に示すキーと値が含まれます。

一般

インデックスの一般情報のキーと値は次のとおりです。

キー 値の型 説明
index_name 文字列 インデックス名
num_docs integer このノードにあるインデックス パーティション内のキーの合計数
num_records integer このノードにあるインデックス パーティション内のレコードの合計数
hash_indexing_failures integer インデックス登録の試行の失敗回数
indexing integer バイナリ値。バックグラウンド インデックス登録が実行されているかどうかを示します
percent_indexed integer バックグラウンド インデックス登録の進捗状況。割合は 0~1 の値で表されます。
index_definition 配列 このキーによって提供される配列を確認するには、インデックスの定義をご覧ください。

インデックス定義情報

インデックス定義のキーと値は次のとおりです。

キー 値の型 説明
key_type 文字列 HASH。使用できるのは、このキータイプのみです。
prefixes array of strings キーの接頭辞
default_score integer 変更不可。これは、ベクトル検索スコアリング関数のデフォルトのスコアリング値であり、並べ替えに使用されます。
attributes 配列 このキーによって提供される配列を確認するには、属性(フィールド)情報をご覧ください。

属性(フィールド)情報

属性(フィールド)のキーと値は次のとおりです。

キー 値の型 説明
identifier 文字列 attribute names
属性 文字列 インデックス フィールド。これは、特定のインデックス HASH フィールドに関連付けられています。
type 文字列 VECTOR、TAG、NUMERIC のいずれか
index 配列 このキーによって提供される配列を確認するには、インデックス情報をご覧ください。

ベクトル インデックス情報

インデックス キーと値は次のとおりです。

キー 値の型 説明
容量 integer インデックスに保存できるベクトルの合計数に対する現在の容量。
dimensions integer ディメンション数
distance_metric 文字列 有効な値は L2、IP、Cosine です。
data_type 文字列 FLOAT32。使用できるのは、このデータ型のみです。
アルゴリズム 配列 このキーによって提供される配列については、アルゴリズム キーをご覧ください。

ベクトル アルゴリズム キー

アルゴリズムのキーと値は次のとおりです。

キー 値の型 説明
name 文字列 HNSW または FLAT
m integer 各レイヤのグラフで、ノードごとに許容される送信エッジの最大数を表示します。レイヤ 0 の場合、送信エッジの最大数は 2M です。デフォルト値は 16 です。最大値は 512 です。
ef_construction integer インデックス内のベクトルの数を表示します。デフォルト値は 200、最大値は 4,096 です。値を大きくすると、インデックスの作成に必要な時間は長くなりますが、再現率は向上します。
ef_runtime integer クエリ オペレーションで検査するベクトルの数が表示されます。デフォルト値は 10、最大値は 4,096 です。

必須の引数

  • index - 詳細を取得するインデックスの名前。

入力:

> FT.CREATE my_index_name SCHEMA my_vector_field_key VECTOR HNSW 10 TYPE FLOAT32 DIM 20 DISTANCE_METRIC COSINE M 4 EF_CONSTRUCTION 100 my_tag_field_key TAG SEPARATOR '@' CASESENSITIVE my_numeric_field_key NUMERIC
> FT.INFO my_index_name

出力:

 1) index_name
 2) my_index_name
 3) index_options
 4) (empty array)
 5) index_definition
 6) 1) key_type
    2) HASH
    3) prefixes
    4) 1)
    5) default_score
    6) "1"
 7) attributes
 8) 1)  1) identifier
        2) my_tag_field_key
        3) attribute
        4) my_tag_field_key
        5) type
        6) TAG
        7) SEPARATOR
        8) @
        9) CASESENSITIVE
       10) size
       11) "0"
    2) 1) identifier
       2) my_vector_field_key
       3) attribute
       4) my_vector_field_key
       5) type
       6) VECTOR
       7) index
       8)  1) capacity
           2) (integer) 10240
           3) dimensions
           4) (integer) 20
           5) distance_metric
           6) COSINE
           7) size
           8) "0"
           9) data_type
          10) FLOAT32
          11) algorithm
          12) 1) name
              2) HNSW
              3) m
              4) (integer) 4
              5) ef_construction
              6) (integer) 100
              7) ef_runtime
              8) (integer) 10
    3) 1) identifier
       2) my_numeric_field_key
       3) attribute
       4) my_numeric_field_key
       5) type
       6) NUMERIC
       7) size
       8) "0"
 9) num_docs
10) "0"
11) num_terms
12) "0"
13) num_records
14) "0"
15) hash_indexing_failures
16) "0"
17) backfill_in_progress
18) "0"
19) backfill_complete_percent
20) "1.000000"
21) mutation_queue_size
22) "0"
23) recent_mutations_queue_delay
24) "0 sec"