delete()
この操作は、ブール式を使用してエンティティを削除します。
リクエスト構文
delete(
expr: str,
partition_name: str | None,
timeout: float | None
)
パラメータ:
-
expr (string) -
[必須]
削除するエンティティをフィルタリングするためのブール式。
-
partition_name (string) -
一致したエンティティを削除する partition の名前。
partition が指定されている場合、その partition 内のエンティティのみがフィルタリング対象になります。それ以外の場合、collection 内のすべてのエンティティが対象になります。
-
timeout (float | None)
この操作のタイムアウト時間。これを None に設定すると、応答が返されるか、またはエラーが発生した時点でこの操作はタイムアウトします。
戻り値の型:
MutationResult
戻り値:
以下のフィールドを含む MutationResult オブジェクト:
-
insert_count (int)
挿入されたエンティティ数。
-
delete_count (int)
削除されたエンティティ数。
-
upsert_count (int)
upsert されたエンティティ数。
-
succ_count (int)
この操作中に正常に実行された回数。
-
succ_index (list)
0 から始まるインデックス番号のリストで、それぞれが成功した操作を示します。
-
err_count (int)
この操作中に失敗した実行回数。
-
err_index (list)
0 から始まるインデックス番号のリストで、それぞれが失敗した操作を示します。
-
primary_keys (list)
挿入されたエンティティの主キーのリスト。
-
timestamp (int)
この操作が完了した時点のタイムスタンプ。
例外:
-
MilvusException
この操作中に何らかのエラーが発生した場合、この例外が発生します。
例
from pymilvus import Collection, CollectionSchema, FieldSchema, DataType
schema = CollectionSchema([
FieldSchema("id", DataType.INT64, is_primary=True),
FieldSchema("vector", DataType.FLOAT_VECTOR, dim=5)
])
# Create a collection
collection = Collection(
name="test_collection",
schema=schema
)
# Insert a list of columns
collection.insert(
data=[
[0,1,2,3,4], # id
[ # vector
[0.1,0.2,-0.3,-0.4,0.5],
[0.3,-0.1,-0.2,-0.6,0.7],
[-0.6,-0.3,0.2,0.8,0.7],
[0.6,0.2,-0.3,-0.8,0.5],
[0.3,0.1,-0.2,-0.6,-0.7],
],
]
)
# Delete two entities
res = collection.delete("id in [ 0, 1 ]")
関連操作
以下の操作は delete() に関連しています: