delete()

此操作通过 Entity ID 或布尔表达式删除 Entity。

Notes

外部 Collection 不支持此操作。

请求语法

python
delete(
    collection_name: str,
    ids: Optional[Union[list, str, int]] = None,
    timeout: Optional[float] = None,
    filter: Optional[str] = "",
    partition_name: Optional[str] = "",
    **kwargs,
) -> dict

参数：

collection_name (str) -

[必需]

现有 Collection 的名称。
ids (list | str | int) -

[必需]

指定的 Entity ID 或 Entity ID 列表。

该值默认为 None，表示应用标量过滤条件。同时设置 ids 和 filter 会导致抛出 ParamError 异常。
timeout (float | None) -

此操作的超时时长。

将其设置为 None 表示当收到任何响应或发生任何错误时，此操作即超时。
filter (str) -

用于筛选匹配 Entity 的标量过滤条件。

该值默认为空字符串，表示不应用任何条件。同时设置 ids 和 filter 会导致抛出 ParamError 异常。

您可以将此参数设置为空字符串以跳过标量过滤。要构建标量过滤条件，请参见布尔表达式规则。

Notes
使用过滤表达式删除 Entity 时，请确保该 Collection 已加载。否则，Zilliz Cloud 将返回错误。
partition_name (str | "") -

要从中删除 Entity 的 Partition 名称。

该值默认为空字符串。若指定，则会从指定的 Partition 中删除 Entity。

返回类型：

dict

返回：

一个包含已删除 Entity 数量的字典。

python
{
    "delete_cnt": int
}

异常：

MilvusException

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

当同时指定 ids 和 filter 时，将引发此异常。
DataTypeNotMatchException

当参数值与要求的数据类型不匹配时，将引发此异常。

示例

python
from pymilvus import MilvusClient

# 1. Set up a milvus client
client = MilvusClient(
    uri="https://inxx-xxxxxxxxxxxx.api.gcp-us-west1.zillizcloud.com:19530",
    token="user:password"
)

# 2. Create a collection
client.create_collection(
    collection_name="test_collection",
    dimension=5
)

# 3. Insert data
client.insert(
    collection_name="test_collection",
    data=[
        {"id": 0, "vector": [0.5, 0.09, 0.2, 0.15, 0.05], "color": "green"},
        {"id": 1, "vector": [0.04, 0.09, 0.33, 0.03, 0.35], "color": "blue"},
        {"id": 2, "vector": [0.1, 0.21, 0.41, 0.36, 0.9], "color": "orange"},
        {"id": 3, "vector": [0.75, 0.24, 0.09, 0.81, 0.41], "color": "red"},
        {"id": 4, "vector": [0.13, 0.27, 0.3, 0.23, 0.17], "color": "yellow"},
        {"id": 5, "vector": [0.17, 0.3, 0.13, 0.9, 0.29], "color": "white"},
        {"id": 6, "vector": [0.33, 0.22, 0.39, 0.17, 0.18], "color": "black"},
        {"id": 7, "vector": [0.16, 0.13, 0.03, 0.13, 0.12], "color": "purple"},
        {"id": 8, "vector": [0.12, 0.16, 0.25, 0.2, 0.16], "color": "pink"},
        {"id": 9, "vector": [0.07, 0.38, 0.36, 0.03, 0.47], "color": "brown"}
    ]
)

# {'insert_count': 10}

# 4. Delete entities
client.delete(
    collection_name="test_collection",
    ids=[3, 6, 7]
)

# {'delete_count': 3}

client.delete(
    collection_name="test_collection",
    filter="id in [1, 8, 9] and color like 'b%'"
)

# {'delete_count': 2}

请求语法​

示例​

请求语法

示例