メインコンテンツまでスキップ

INVERTED

データに対して頻繁にフィルタクエリを実行する必要がある場合、INVERTED インデックスによってクエリパフォーマンスを大幅に向上できます。すべてのドキュメントをスキャンする代わりに、Zilliz Cloud は転置インデックスを使用して、フィルタ条件に一致する正確なレコードをすばやく特定します。

INVERTED インデックスを使用するタイミング​

次のような場合に INVERTED インデックスを使用します。

  • 特定の値でフィルタリングする: フィールドが特定の値に等しいすべてのレコードを見つける（例: category == "electronics"）

  • テキストコンテンツをフィルタリングする: VARCHAR フィールドに対して効率的な検索を実行する

  • JSON フィールド値をクエリする: JSON 構造内の特定のキーでフィルタリングする

パフォーマンス上の利点: INVERTED インデックスは、コレクション全体のスキャンの必要をなくすことで、大規模データセットにおけるクエリ時間を数秒から数ミリ秒に短縮できます。

INVERTED インデックスの仕組み​

Zilliz Cloud の INVERTED インデックス は、それぞれの一意なフィールド値（用語（term））を、その値が出現するドキュメント ID の集合にマッピングします。この構造により、値が繰り返されるフィールドやカテゴリ値を持つフィールドに対して高速なルックアップが可能になります。

図に示すように、このプロセスは 2 つのステップで機能します。

  1. 順方向マッピング（ID → Term）: 各ドキュメント ID は、それが含むフィールド値を指します。

  2. 逆方向マッピング（Term → IDs）: Zilliz Cloud は一意な用語を収集し、各用語からそれを含むすべての ID への逆マッピングを構築します。

たとえば、値 "electronics" は ID 1 と 3 にマッピングされ、"books" は ID 2 と 5 にマッピングされます。

A19NwPlGIh1YrGbSBZKcNKz0nhd

特定の値（例: category == "electronics"）でフィルタリングする場合、Zilliz Cloud は単にインデックス内でその用語を参照し、一致する ID を直接取得します。これによりデータセット全体をスキャンする必要がなくなり、特にカテゴリ値や繰り返し値に対して高速なフィルタリングが可能になります。

INVERTED インデックスは、BOOL、INT8、INT16、INT32、INT64、FLOAT、DOUBLE、VARCHAR、JSON、ARRAY など、すべてのスカラーフィールド型をサポートします。ただし、JSON フィールドをインデックス化するためのインデックスパラメータは、通常のスカラーフィールドとは少し異なります。

JSON 以外のフィールドにインデックスを作成する​

JSON 以外のフィールドにインデックスを作成するには、次の手順に従います。

  1. インデックスパラメータを準備します。

    python
    from pymilvus import MilvusClient

    client = MilvusClient(uri="YOUR_CLUSTER_ENDPOINT") # Replace with your server address

    # Create an empty index parameter object
    index_params = client.prepare_index_params()

  2. INVERTED インデックスを追加します。

    python
    index_params.add_index(
        field_name="category",           # Name of the field to index
        index_type="INVERTED",          # Specify INVERTED index type
        index_name="category_index"     # Give your index a name
    )

  3. インデックスを作成します。

    python
    client.create_index(
        collection_name="my_collection", # Replace with your collection name
        index_params=index_params
    )

JSON フィールドにインデックスを作成する​

JSON フィールド内の特定のパスに対して INVERTED インデックスを作成することもできます。これには、JSON パスとデータ型を指定する追加パラメータが必要です。

python
# Build index params
index_params.add_index(
    field_name="metadata",                    # JSON field name
    index_type="INVERTED",
    index_name="metadata_category_index",
    params={
        "json_path": "metadata[\"category\"]",    # Path to the JSON key
        "json_cast_type": "varchar"              # Data type to cast to during indexing
    }
)

# Create index
client.create_index(
    collection_name="my_collection", # Replace with your collection name
    index_params=index_params
)

サポートされているパス、データ型、制限事項を含む JSON フィールドのインデックス化に関する詳細は、JSON Indexing を参照してください。

インデックスを削除する​

drop_index() メソッドを使用して、コレクションから既存のインデックスを削除します。

📘注意

Milvus v2.6.x と互換性のあるクラスターでは、不要になったスカラーインデックスを直接削除できます。事前にコレクションをリリースする必要はありません。

python
client.drop_index(
    collection_name="my_collection",   # Name of the collection
    index_name="category_index" # Name of the index to drop
)

ベストプラクティス​

  • データのロード後にインデックスを作成する: パフォーマンス向上のため、すでにデータが含まれているコレクションにインデックスを構築します

  • わかりやすいインデックス名を使用する: フィールドと用途が明確にわかる名前を選びます

  • インデックスのパフォーマンスを監視する: インデックス作成の前後でクエリパフォーマンスを確認します

  • クエリパターンを考慮する: 頻繁にフィルタリングするフィールドにインデックスを作成します

次のステップ​

  • AUTOINDEX について学びます。

  • 高度な JSON インデックス化のシナリオについては、JSON Indexing を参照してください。

Ctrl I