FT.CREATE - Amazon ElastiCache

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

FT.CREATE

FT.CREATE コマンドは空のインデックスを作成し、バックフィルプロセスを開始します。各インデックスは、多数のフィールド定義で構成されます。各フィールド定義では、フィールド名、フィールドタイプ、および宣言されたタイプの値を見つけるための各インデックスキー内のパスを指定します。一部のフィールドタイプ定義には、追加のサブタイプ指定子が含まれます。

HASH キーのインデックスの場合、パスはハッシュメンバー名と同じです。オプションの AS 句を使用すると、必要に応じてフィールド名を変更できます。フィールド名の変更は、メンバー名に特殊文字が含まれている場合に特に便利です。

JSON キーのインデックスの場合、パスは宣言されたタイプのデータへの JSON パスになります。JSON パスには常に特殊文字が含まれているため、AS 句は必須です。

[Syntax] (構文)

FT.CREATE <index-name>
ON HASH | JSON
[PREFIX <count> <prefix1> [<prefix2>...]]
SCHEMA 
(<field-identifier> [AS <alias>] 
| VECTOR [HNSW|FLAT] <attr_count> [<attribute_name> <attribute_value>])
| TAG [SEPARATOR <sep>] [CASESENSITIVE] 
| NUMERIC 
)+

<index-name> (必須): インデックスに付ける名前です。同じ名前のインデックスが既に存在する場合、エラーが返されます。

ON HASH | JSON (オプション): 指定されたタイプに一致するキーのみがこのインデックスに含まれます。省略すると、HASH が想定されます。

PREFIX <prefix-count> <prefix> (オプション): この句を指定すると、指定されたプレフィックスの 1 つ以上と同じバイトで始まるキーのみがこのインデックスに含まれます。この句を省略すると、正しいタイプのすべてのキーが含まれます。長さが 0 のプレフィックスは、正しいタイプのすべてのキーとも一致します。

フィールドタイプ:

  • TAG: タグフィールドは、1 つ以上のタグ値を含む文字列です。

    • SEPARATOR <sep> (オプション): 個々のタグを区切るために使用される文字 (,.<>{}[]"':;!@#$%^&*()-+=~) の 1 つ。省略した場合、デフォルトは「,」です。

    • CASESENSITIVE (オプション): 存在する場合、タグの比較では大文字と小文字が区別されます。デフォルトでは、タグの比較では大文字と小文字は区別されません。

  • NUMERIC: 数値フィールドには数値が含まれます。

  • VECTOR: ベクトルフィールドにはベクトルが含まれます。現在、HNSW (Hierarchical Navigable Small World) と FLAT (ブルートフォース) という 2 つのベクトルインデックス作成アルゴリズムがサポートされています。それぞれのアルゴリズムには追加の属性のセットがあり、その中には必須の属性とオプションの属性があります。

    • FLAT: Flat アルゴリズムは正確な回答を提供しますが、インデックス付きベクトルの数に比例したランタイムがあるため、大規模なデータセットには適さない場合があります。

      • DIM <number> (必須): ベクトル内のディメンションの数を指定します。

      • TYPE FLOAT32 (必須): データ型。現在 FLOAT32 のみがサポートされています。

      • DISTANCE_METRIC [L2 | IP | COSINE] (必須): 距離アルゴリズムを指定します。

      • INITIAL_CAP <size> (オプション): 初期インデックスサイズ。

    • HNSW: HNSW アルゴリズムは近似解を提供しますが、動作速度は FLAT を大きく上回ります。

      • DIM <number> (必須): ベクトル内のディメンションの数を指定します。

      • TYPE FLOAT32 (必須): データ型。現在 FLOAT32 のみがサポートされています。

      • DISTANCE_METRIC [L2 | IP | COSINE] (必須): 距離アルゴリズムを指定します。

      • INITIAL_CAP <size> (オプション): 初期インデックスサイズ。

      • M <number> (オプション): 各レイヤーのグラフ内の各ノードに許可された最大出力エッジの数。レイヤー 0 では、出力エッジの最大数は 2*M になります。デフォルトは 16、最大値は 512 です。

      • EF_CONSTRUCTION <number> (オプション): インデックスの構築中に検査されるベクトルの数を制御します。このパラメータの値を大きくすると、インデックスの作成時間が長くなりますが、再現率が向上します。デフォルト値は 200 です。最大値は 4096 です。

      • EF_RUNTIME <number> (オプション): クエリオペレーション中に検査されるベクトルの数を制御します。デフォルト値は 10 で、最大値は 4096 です。このパラメータ値は、実行するクエリごとに設定できます。値を大きくするとクエリ時間が長くなりますが、クエリの再現率は向上します。

RESPONSE: OK またはエラー。