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

コレクションを変更する

コレクションの名前を変更したり、設定を変更したりできます。このページでは、コレクションを変更する方法について説明します。

コレクションの名前を変更する​

コレクションの名前は次のように変更できます。

python
from pymilvus import MilvusClient

client = MilvusClient(
    uri="YOUR_CLUSTER_ENDPOINT",
    token="YOUR_CLUSTER_TOKEN"
)

client.rename_collection(
    old_name="my_collection",
    new_name="my_new_collection"
)

client.rename_collection(
    old_name="my_new_collection",
    new_name="my_collection"
)

コレクションのプロパティを設定する​

コレクションの作成後、コレクションレベルのプロパティを変更できます。

📘Notes

このセクションに記載されているプロパティはすべて、マネージドコレクションにのみ適用されます。

サポートされるプロパティ​

プロパティ

説明

collection.ttl.seconds

コレクションのデータを特定の期間後に削除する必要がある場合は、Time-To-Live（TTL）を秒単位で設定することを検討してください。TTL がタイムアウトすると、Zilliz Cloud はコレクションからすべてのエンティティを削除します。

削除は非同期で行われるため、削除が完了する前でも検索やクエリを実行できます。

詳細は、コレクション単位の TTL を設定するを参照してください。

ttl_field

各エンティティの絶対有効期限タイムスタンプ（エンティティ単位の TTL）を格納する TIMESTAMPTZ フィールドの名前です。各エンティティは、実時間がこのフィールドに格納された値に達した時点で正確に期限切れになります。フィールドの値が NULL の場合は、エンティティが期限切れになることはありません。collection.ttl.seconds とは相互に排他的です。

詳細は、エンティティ単位の TTL を設定するを参照してください。

mmap.enabled

メモリマッピング（Mmap）を使用すると、ディスク上の大きなファイルに直接メモリでアクセスできるため、Zilliz Cloud はインデックスとデータをメモリとハードドライブの両方に保存できます。この方法は、アクセス頻度に基づいてデータ配置ポリシーを最適化し、検索パフォーマンスに影響を与えずにコレクションのストレージ容量を拡張するのに役立ちます。

Zilliz Cloud は、クラスターに対してグローバルな mmap 設定を実装しています。設定は、特定のフィールドまたはそのインデックスで変更できます。

詳細は、mmap を使用するを参照してください。

partitionkey.isolation

Partition Key Isolation を有効にすると、Zilliz Cloud は Partition Key の値に基づいてエンティティをグループ化し、各グループに個別のインデックスを作成します。検索リクエストを受信すると、Zilliz Cloud はフィルタリング条件で指定された Partition Key の値に基づいてインデックスを特定し、検索範囲をそのインデックスに含まれるエンティティ内に制限します。これにより、検索時に無関係なエンティティのスキャンを回避し、検索パフォーマンスを大幅に向上させます。

詳細は、Partition Key Isolation を使用するを参照してください。

dynamicfield.enabled

動的フィールドを有効にせずに作成されたコレクションに対して、動的フィールドを有効にします。有効にすると、元のスキーマで定義されていないフィールドを持つエンティティを挿入できます。詳細は、動的フィールドを参照してください。

allow_insert_auto_id

Whether to allow a コレクション to accept user-provided primary key values when AutoID has been enabled for the コレクション.

  • When set to "true": Inserts, upserts, and bulk imports use the user-provided primary key if present; otherwise, primary key values are auto-generated.

  • When set to "false": User-provided primary key values are rejected or ignored and primary key values are always auto-generated. The default is "false".

timezone

時刻に依存する操作、特に TIMESTAMPTZ フィールドを処理する際の、このコレクションのデフォルトタイムゾーンを指定します。タイムスタンプは内部的に UTC で保存され、Zilliz Cloud はこの設定に従って、表示および比較のために値を変換します。設定した場合、コレクションのタイムゾーンはデータベースのデフォルトタイムゾーンを上書きします。クエリの timezone パラメーターは、その両方を一時的に上書きできます。値は有効な IANA タイムゾーン識別子（例: Asia/Shanghai、America/Chicago、UTC）である必要があります。TIMESTAMPTZ フィールドの使用方法については、TIMESTAMPTZ フィールドを参照してください。

例 1: コレクション単位の TTL を設定する​

次のコードスニペットは、コレクション TTL を設定する方法を示しています。

python
from pymilvus import MilvusClient

client.alter_collection_properties(
    collection_name="my_collection",
    properties={"collection.ttl.seconds": 60}
)

例 2: エンティティ単位の TTL を設定する​

Public Preview

次のコードスニペットは、既存の TIMESTAMPTZ フィールド（expire_at）をエンティティ単位の TTL 用の TTL フィールドとして指定します。コレクションには、その名前の TIMESTAMPTZ フィールドがすでに含まれている必要があり、collection.ttl.seconds を設定してはいけません。2 つの TTL モードは相互に排他的です。

エンティティ単位の TTL のワークフロー全体（スキーマの設定、挿入、クエリ、リフレッシュ、削除）については、エンティティ単位の TTL を設定するを参照してください。

python
from pymilvus import MilvusClient

client.alter_collection_properties(
    collection_name="my_collection",
    properties={"ttl_field": "expire_at"}
)

例 3: mmap を有効にする​

次のコードスニペットは、mmap を有効にする方法を示しています。

python
from pymilvus import MilvusClient

client.alter_collection_properties(
    collection_name="my_collection",
    properties={"mmap.enabled": True}
)

例 4: パーティションキーを有効にする​

次のコードスニペットは、パーティションキーを有効にする方法を示しています。

python
from pymilvus import MilvusClient

client.alter_collection_properties(
    collection_name="my_collection",
    properties={"partitionkey.isolation": True}
)

例 5: 動的フィールドを有効にする​

次のコードスニペットは、動的フィールドを有効にする方法を示しています。

python
from pymilvus import MilvusClient

client.alter_collection_properties(
    collection_name="my_collection",
    properties={"dynamicfield.enabled": True}
)

例 6: allow_insert_auto_id を有効にする​

allow_insert_auto_id プロパティを使用すると、AutoID が有効なコレクションが、挿入、アップサート、一括インポート時にユーザー指定の主キー値を受け入れられるようになります。"true" に設定すると、Zilliz Cloud はユーザー指定の主キー値があればそれを使用し、ない場合は自動生成します。デフォルトは "false" です。

次の例は、allow_insert_auto_id を有効にする方法を示しています。

python
client.alter_collection_properties(
    collection_name="my_collection",
    properties={"allow_insert_auto_id": "true"}
)
# After enabling, inserts with a PK column will use that PK; otherwise Zilliz Cloud auto-generates.

例 7: コレクションのタイムゾーンを設定する​

timezone プロパティを使用すると、コレクションのデフォルトタイムゾーンを設定できます。これは、データの挿入、クエリ、結果の表示など、コレクション内のすべての操作で時間関連データを解釈および表示する方法を決定します。

timezone の値は、Asia/Shanghai、America/Chicago、UTC など、有効な IANA タイムゾーン識別子 である必要があります。無効または非標準の値を使用すると、コレクションプロパティの変更時にエラーが発生します。

次の例は、コレクションのタイムゾーンを Asia/Shanghai: に設定する方法を示しています。

python
client.alter_collection_properties(
    collection_name="my_collection",
    properties={"timezone": "Asia/Shanghai"}
)

コレクションプロパティを削除する​

次のようにプロパティを削除することで、コレクションのプロパティをリセットすることもできます。

python
client.drop_collection_properties(
    collection_name="my_collection",
    property_keys=[
        "collection.ttl.seconds"
    ]
)
このページは役に立ちましたか？
Ctrl I