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

削除 (V2)

この操作は、ID またはブール式を使用してエンティティを削除します。

POST/v2/vectordb/entities/delete
接続エンドポイント

https://${CLUSTER_ENDPOINT}

📘ノート
  • ${CLUSTER_ENDPOINT} を、あなたのZilliz Cloudクラスターのエンドポイントに置き換える必要があります。
  • エンドポイントを取得するには、Describe Cluster V2 APIを使用してレスポンスから値を抽出してください。
shell
export CLUSTER_ENDPOINT=""
パラメータ
Authorizationstringheader必要

認証トークンは、適切な権限を持つ API key または username:password のようにコロンで連結した username と password の組である必要があります。project endpoint を使用している場合は、十分な権限を持つ有効な API key のみが使用できます。

値の例： Bearer {{TOKEN}}
リクエスト・ボディapplication/json
dbNamestring

データベースの名前。

collectionNamestring必要

エンティティを削除する collection の名前。

filterstring必要

一致するエンティティを絞り込むためのスカラー filtering 条件です。スカラー filtering をスキップするには、このパラメータを空文字列に設定できます。スカラー filtering 条件の構築方法については、Reference on Scalar Filters を参照してください。

partitionNamestring

現在の collection 内の partition の名前。 指定した場合、データは指定された partition から削除されます。

idstring

削除するエンティティの primary key です。filter の代わりにこのパラメータを使用して、ID により単一のエンティティを削除できます。

exprParamsobject

パラメータ化された filter 式の式テンプレートパラメータ値。

bash
export TOKEN="db_admin:xxxxxxxxxxxxx"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/entities/delete" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "collectionName": "medium_articles",
    "filter": "id == 4321034832910"
}'
bash
export TOKEN="db_admin:xxxxxxxxxxxxx"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/entities/delete" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "collectionName": "medium_articles",
    "filter": "reading_time > 15"
}'
bash
export TOKEN="db_admin:xxxxxxxxxxxxx"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/entities/delete" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "collectionName": "medium_articles",
    "id": "4321034832910"
}'
レスポンス200 OK - application/json

空のオブジェクトを返します。

削除リクエストの成功時に返される結果の形式の 1 つ。

codeinteger

レスポンスコード。

costinteger

この操作のコスト。free cluster および serverless cluster にのみ適用され、現在のリクエストの vCU 使用量を示します。

dataobject

削除されたエンティティの数を含むレスポンスペイロード。

deleteCountinteger

リクエストによって削除されたエンティティの数。

エラーメッセージを返します。

codeinteger

レスポンスコード。

messagestring

エラーメッセージ。

Successjson
{
    "code": 0,
    "cost": 0,
    "data": {
        "deleteCount": 1
    }
}
Ctrl I