Удаление документов в индексе поиска

1. Используйте REST API Документы - Индекс с помощью удаления @search.action, чтобы удалить его из индекса поиска.

2. Сформулируйте вызов POST, указывающий имя индекса и конечную точку docs/index .

3. Убедитесь, что текст запроса содержит ключ документа, который требуется удалить.

   POST https://[service name].search.windows.net/indexes/hotels-sample/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.windows.net/indexes/hotel-sample-index/docs/18?api-version=2025-09-01
   

Reference:Documents — Index

Успешный запрос на удаление возвращает 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"
api_key = "<your-admin-api-key>"

endpoint = f"https://{service_name}.search.windows.net"
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)")

Справочник: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";
string apiKey = "<your-admin-api-key>";

Uri endpoint = new Uri($"https://{serviceName}.search.windows.net");
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

Пакет SDK Azure для JavaScript/TypeScript предоставляет следующие API для удаления документов:

• IndexDocumentsBatch
• SearchIndexingBufferedSender

Reference:SearchClient, IndexDocumentsBatch

Пакет SDK Azure для Java предоставляет следующие API для удаления документов:

• IndexActionType
• SearchIndexingBufferedSender

Пример кода: IndexContentManagementExample.java

Reference:SearchClient, IndexActionType

1. Используйте REST API Документы - Индекс с помощью удаления @search.action, чтобы удалить его из индекса поиска. Сформулируйте вызов POST, указывающий имя индекса и конечную точку docs/index .

2. Убедитесь, что текст запроса содержит ключи всех документов, которые вы хотите удалить.

   POST https://[service name].search.windows.net/indexes/hotels-sample/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"
       }
     ]
   }
   

• Ограничения пакетов: Рекомендуется ограничивать пакеты до 1000 документов или примерно 16 МБ на запрос, чтобы обеспечить оптимальную производительность.

• Идемпотентность: удаление является идемпотентным; Если вы пытаетесь удалить идентификатор документа, который не существует, API по-прежнему возвращает состояние 200 OK.

• Задержка. Документы не всегда удаляются мгновенно из хранилища. Фоновый процесс выполняет физическое удаление каждые несколько минут.

• Хранилище векторов: удаление документов не сразу освобождает квоты хранилища векторов. Для физического удаления требуется несколько минут. Для немедленного восстановления пространства векторов может потребоваться удалить и перестроить индекс.

Reference:Documents — Index

В следующем примере выполняется массовое удаление нескольких документов:

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"
api_key = "<your-admin-api-key>"

endpoint = f"https://{service_name}.search.windows.net"
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)")

Справочник: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";
string apiKey = "<your-admin-api-key>";

Uri endpoint = new Uri($"https://{serviceName}.search.windows.net");
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

Пакет SDK Azure для JavaScript/TypeScript предоставляет следующие API для массового удаления документов:

• IndexDocumentsBatch
• SearchIndexingBufferedSender

Reference:SearchClient, IndexDocumentsBatch

Пакет SDK Azure для Java предоставляет следующие API для массового удаления документов:

• IndexActionType
• SearchIndexingBufferedSender

Пример кода: IndexContentManagementExample.java

Reference:SearchClient, IndexActionType

1. На портале Azure откройте страницу обзора службы поиска.
2. Выберите управление поиском>индексы.
3. Проверьте столбец количество документов для вашего индекса.
4. Подождите несколько минут и обновите, если число не изменилось (удаление асинхронно).

Используйте API получения документов , чтобы подтвердить, что документ больше не существует:

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

Ожидаемый ответ: HTTP 404 Не найден, если документ был успешно удален.

Вы также можете проверить статистику индекса:

GET https://[service-name].search.windows.net/indexes/hotels-sample/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)");
}