删除搜索索引中的文档

1. 使用 文档 - 索引 REST API 进行删除 @search.action ，以将其从搜索索引中删除。

2. 创建一个指定索引名称和docs/index终结点的POST调用。

3. 请确保请求正文包含要删除的文档的密钥。

   POST https://[service name].search.azure.cn/indexes/hotels-sample-index/docs/index?api-version=2025-09-01
   Content-Type: application/json   
   api-key: [admin key]
   
   {  
     "value": [  
       {  
         "@search.action": "delete",  
         "id": "18"  
       }  
     ]  
   }
   

4. 发送请求。

   下表说明了可在响应中返回的各种每文档 状态代码 。 某些状态代码会指示请求本身的问题，而另一些代码会指示临时错误条件。 对于后者，应在延迟后重试。

   状态代码	Meaning	可重试	注释
   200	已成功删除文档。	n/a	删除操作是幂等的。 也就是说，即使索引中不存在某个文档键，使用该键尝试执行删除操作也会生成 200 状态代码。
   400	文档中有一个错误，阻止删除它。	否	响应中的错误消息提供了详细信息。
   422	索引暂时不可用，因为在将“allowIndexDowntime”标志设置为“true”的情况下更新了它。	是的	等待索引可用。
   503	搜索服务暂时不可用，可能是因为负荷较重。	是的	在此情况下，代码应在重试前等待，否则面临延长服务不可用性状态的风险。

   注释

   如果客户端代码经常遇到 207 响应，则一个可能的原因是系统过载。 可以通过检查 statusCode 503 的属性来确认这一点。 如果是这样，我们建议限制索引请求。 否则，如果索引流量不下降，系统可能开始使用 503 错误拒绝所有请求。

5. 可以重新发送 查找查询 以确认删除。 你应该收到一个 404 未找到文档的提示。

   GET https://[service name].search.azure.cn/indexes/hotel-sample-index/docs/18?api-version=2025-09-01
   

参考：文档 - 索引

成功的删除请求返回 HTTP 200（确定）。 响应正文包含每个文档的状态：

{
    "value": [
        { "key": "18", "status": true, "statusCode": 200 }
    ]
}

以下示例从索引中删除文档：

from azure.core.credentials import AzureKeyCredential
from azure.search.documents import SearchClient

# Set up the client
service_name = "<your-search-service-name>"
index_name = "hotels-sample-index"
api_key = "<your-admin-api-key>"

endpoint = f"https://{service_name}.search.azure.cn"
credential = AzureKeyCredential(api_key)
client = SearchClient(endpoint=endpoint, index_name=index_name, credential=credential)

# Delete a document by key
result = client.delete_documents(documents=[{"HotelId": "18"}])
print(f"Deleted {len(result)} document(s)")

Reference：SearchClient，delete_documents

以下示例从索引中删除文档：

using Azure;
using Azure.Search.Documents;
using Azure.Search.Documents.Models;

// Set up the client
string serviceName = "<your-search-service-name>";
string indexName = "hotels-sample-index";
string apiKey = "<your-admin-api-key>";

Uri endpoint = new Uri($"https://{serviceName}.search.azure.cn");
AzureKeyCredential credential = new AzureKeyCredential(apiKey);
SearchClient searchClient = new SearchClient(endpoint, indexName, credential);

// Delete a document by key
var batch = IndexDocumentsBatch.Delete("HotelId", new[] { "18" });
IndexDocumentsResult result = await searchClient.IndexDocumentsAsync(batch);

Console.WriteLine($"Deleted {result.Results.Count} document(s)");

Reference：SearchClient、 IndexDocumentsAsync、 IndexDocumentsBatch

用于 JavaScript/TypeScript 的 Azure SDK 提供以下用于文档删除的 API：

• IndexDocumentsBatch
• SearchIndexingBufferedSender

Reference：SearchClient、 IndexDocumentsBatch

用于 Java 的 Azure SDK 提供以下用于文档删除的 API：

• 索引操作类型
• SearchIndexingBufferedSender

代码示例： IndexContentManagementExample.java

Reference：SearchClient、 IndexActionType

1. 使用 文档 - 索引 REST API 进行删除 @search.action ，以将其从搜索索引中删除。 创建一个指定索引名称和docs/index终结点的POST调用。

2. 请确保请求正文包含您要删除的所有文档的键值。

   POST https://[service name].search.azure.cn/indexes/hotels-sample-index/docs/index?api-version=2025-09-01
   Content-Type: application/json   
   api-key: [admin key]
   
   {
     "value": [
       {
         "@search.action": "delete",
         "id": "doc1"
       },
       {
         "@search.action": "delete",
         "id": "doc2"
       }
     ]
   }
   

• 批处理限制：建议将批限制为 1,000 个文档，或每个请求大约 16 MB，以确保最佳性能。

• 幂等性：删除操作是幂等的；如果尝试删除不存在的文档ID，API仍将返回200 OK状态。

• 延迟：文档并不总是从存储中立即删除。 后台进程每隔几分钟执行物理删除。

• 矢量存储：删除文档不会立即释放矢量存储配额。 物理删除需要几分钟时间。 如果想要立即回收矢量空间，可能需要删除并重建索引。

参考：文档 - 索引

以下示例批量删除多个文档：

from azure.core.credentials import AzureKeyCredential
from azure.search.documents import SearchClient

# Set up the client
service_name = "<your-search-service-name>"
index_name = "hotels-sample-index"
api_key = "<your-admin-api-key>"

endpoint = f"https://{service_name}.search.azure.cn"
credential = AzureKeyCredential(api_key)
client = SearchClient(endpoint=endpoint, index_name=index_name, credential=credential)

# Delete multiple documents by key
documents_to_delete = [
    {"HotelId": "doc1"},
    {"HotelId": "doc2"},
    {"HotelId": "doc3"}
]
result = client.delete_documents(documents=documents_to_delete)
print(f"Deleted {len(result)} document(s)")

Reference：SearchClient，delete_documents

以下示例批量删除多个文档：

using Azure;
using Azure.Search.Documents;
using Azure.Search.Documents.Models;

// Set up the client
string serviceName = "<your-search-service-name>";
string indexName = "hotels-sample-index";
string apiKey = "<your-admin-api-key>";

Uri endpoint = new Uri($"https://{serviceName}.search.azure.cn");
AzureKeyCredential credential = new AzureKeyCredential(apiKey);
SearchClient searchClient = new SearchClient(endpoint, indexName, credential);

// Delete multiple documents by key
var batch = IndexDocumentsBatch.Delete("HotelId", new[] { "doc1", "doc2", "doc3" });
IndexDocumentsResult result = await searchClient.IndexDocumentsAsync(batch);

Console.WriteLine($"Deleted {result.Results.Count} document(s)");

Reference：SearchClient、 IndexDocumentsAsync、 IndexDocumentsBatch

用于 JavaScript/TypeScript 的 Azure SDK 提供以下用于批量文档删除的 API：

• IndexDocumentsBatch
• SearchIndexingBufferedSender

Reference：SearchClient、 IndexDocumentsBatch

用于 Java 的 Azure SDK 提供以下用于批量文档删除的 API：

• 索引操作类型
• SearchIndexingBufferedSender

代码示例： IndexContentManagementExample.java

Reference：SearchClient、 IndexActionType

1. 在 Azure 门户中，打开搜索服务 “概述 ”页。
2. 选择搜索管理>索引。
3. 检查索引的文档计数列。
4. 等待几分钟后刷新页面，如果计数未更改（因为删除是异步进行的）。

使用 “获取文档 API”确认文档不再存在：

GET https://[service-name].search.azure.cn/indexes/hotels-sample-index/docs/18?api-version=2025-09-01
api-key: [admin-key]

预期响应：如果文档已成功删除，则返回 HTTP 404 Not Found。

还可以检查索引统计信息：

GET https://[service-name].search.azure.cn/indexes/hotels-sample-index/stats?api-version=2025-09-01
api-key: [admin-key]

# Python - verify document was deleted
try:
    document = client.get_document(key="18")
    print("Document still exists")
except Exception as e:
    print(f"Document not found (expected): {e}")

// C# - verify document was deleted
try
{
    var document = await searchClient.GetDocumentAsync<Hotel>("18");
    Console.WriteLine("Document still exists");
}
catch (RequestFailedException ex) when (ex.Status == 404)
{
    Console.WriteLine("Document not found (expected)");
}