delete()
This operation deletes entities by their IDs or with a boolean expression.
public DeleteResp delete(DeleteReq request)
Request Syntax
delete(DeleteReq.builder()
.databaseName(String databaseName)
.collectionName(String collectionName)
.partitionName(String partitionName)
.filter(String filter)
.ids(List<Object> ids)
.consistencyLevel(ConsistencyLevel consistencyLevel)
.filterTemplateValues(Map<String, Object> filterTemplateValues)
.build()
);
BUILDER METHODS:
databaseName(String databaseName)-The name of the database. Defaults to the current database if not specified.
collectionName(String collectionName)-The name of the target collection.
partitionName(String partitionName)-The name of the target partition.
filter(String filter)-A boolean expression to filter results.
ids(List<Object> ids)-A list of primary key values to identify specific entities.
consistencyLevel(ConsistencyLevel consistencyLevel)-The consistency level for the operation. Available in v2.6.25 or later. See ConsistencyLevel.
filterTemplateValues(Map<String, Object> filterTemplateValues)-A map of template variable values for parameterized filters.
RETURN TYPE:
DeleteResp
RETURNS:
A DeleteResp object contains the number of deleted entities and the operation cost.
getDeleteCnt()(long) -The number of deleted entities.
getCost()(Long) -The cost of the operation in milliseconds. Available in v2.6.25 or later.
EXCEPTIONS:
-
This exception will be raised when any error occurs during this operation.
Example
import io.milvus.v2.client.ConnectConfig;
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.common.DataType;
import io.milvus.v2.common.IndexParam;
import io.milvus.v2.service.collection.request.AddFieldReq;
import io.milvus.v2.service.collection.request.CreateCollectionReq;
import io.milvus.v2.service.collection.request.LoadCollectionReq;
import io.milvus.v2.service.vector.request.DeleteReq;
import io.milvus.v2.service.vector.request.InsertReq;
import io.milvus.v2.service.vector.response.DeleteResp;
import com.google.gson.Gson;
import com.google.gson.JsonObject;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
// 1. Set up a client
ConnectConfig connectConfig = ConnectConfig.builder()
.uri("http://localhost:19530")
.token("root:Milvus")
.build();
MilvusClientV2 client = new MilvusClientV2(connectConfig);
// 2. Create a collection with an "id" field and a "vector" field with dimension 2
CreateCollectionReq.CollectionSchema collectionSchema = MilvusClientV2.CreateSchema();
collectionSchema.addField(AddFieldReq.builder().fieldName("id").dataType(DataType.Int64).isPrimaryKey(Boolean.TRUE).autoID(Boolean.FALSE).build());
collectionSchema.addField(AddFieldReq.builder().fieldName("vector").dataType(DataType.FloatVector).dimension(2).build());
IndexParam indexParam = IndexParam.builder()
.fieldName("vector")
.metricType(IndexParam.MetricType.COSINE)
.build();
client.createCollection(CreateCollectionReq.builder()
.collectionName("test")
.collectionSchema(collectionSchema)
.indexParams(Collections.singletonList(indexParam))
.build());
// 3. Insert rows and load the collection
List<JsonObject> rows = new ArrayList<>();
for (long id = 0; id < 20; id++) {
JsonObject row = new JsonObject();
row.addProperty("id", id);
row.add("vector", new Gson().toJsonTree(new float[]{id * 0.1f, id * 0.2f}));
rows.add(row);
}
client.insert(InsertReq.builder()
.collectionName("test")
.data(rows)
.build());
client.loadCollection(LoadCollectionReq.builder().collectionName("test").build());
// 4. Delete entities with filter "id > 10"
DeleteReq deleteReq = DeleteReq.builder()
.collectionName("test")
.filter("id > 10")
.build();
DeleteResp deleteResp = client.delete(deleteReq);