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

コレクションの変更

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

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

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

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"
)

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

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

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

プロパティ

説明

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

コレクションで AutoID が有効になっている場合に、ユーザー指定の主キー値をコレクションが受け入れるかどうかを指定します。

  • "true" に設定した場合: 挿入、アップサート、および一括インポートでは、ユーザー指定の主キーがある場合はその値が使用され、ない場合は主キー値が自動生成されます。

  • "false" に設定した場合: ユーザー指定の主キー値は拒否または無視され、主キー値は常に自動生成されます。デフォルトは "false" です。

timezone

時間に敏感な操作、特に TIMESTAMPTZ フィールドを処理する際に、このコレクションのデフォルトタイムゾーンを指定します。タイムスタンプは内部的に UTC で保存され、Milvus はこの設定に従って表示および比較用の値を変換します。設定すると、コレクションのタイムゾーンがデータベースのデフォルトタイムゾーンを上書きします。クエリの 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}
)

例 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
from pymilvus import MilvusClient

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
from pymilvus import MilvusClient

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

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

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

python
from pymilvus import MilvusClient

client.drop_collection_properties(
collection_name="my_collection",
property_keys=[
"collection.ttl.seconds"
]
)