跳到主要内容

delete()

Near Deprecation

此操作使用布尔表达式从 Partition 中删除 Entity。

Notes

在 Collection 对象的 delete() 方法中使用 partition_name 参数,等同于使用 Partition 对象的 delete() 方法。

请求语法​

python
delete(
expr: str,
timeout: float | None
)

参数:

  • expr (string) -

    [必需]

    用于筛选待删除 Entity 的布尔表达式。

  • timeout (float | None)

    此操作的超时时长。将其设置为 None 表示当收到任意响应或发生任意错误时,此操作即超时。

返回类型:

MutationResult

返回:

包含以下字段的 MutationResult 对象:

  • insert_count (int)

    已插入 Entity 的数量。

  • delete_count (int)

    已删除 Entity 的数量。

  • upsert_count (int)

    已 upsert 的 Entity 数量。

  • succ_count (int)

    此操作中成功执行的次数。

  • succ_index (list)

    从 0 开始的索引号列表,每个索引号表示一次成功的操作。

  • err_count (int)

    此操作中失败执行的次数。

  • err_index (list)

    从 0 开始的索引号列表,每个索引号表示一次失败的操作。

  • primary_keys (list)

    已插入 Entity 的主键列表。

  • timestamp (int)

    此操作完成时的时间戳。

异常:

  • MilvusException

    此操作期间发生任何错误时会引发此异常。

示例​

python
from pymilvus import Collection, Partition, 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
)

partition = Partition(
collection=collection,
name="partition_a",
)

# Insert a list of columns
partition.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 = partition.delete("id in [ 0, 1 ]")

以下操作与 delete() 相关:

最低 SDK 版本Inherit