Odstranění dokumentů v indexu vyhledávání

1. Použijte Documents - Index REST API s příkazem delete @search.action, abyste jej odstranili z indexu vyhledávání.

2. Formulujte volání POST určující název indexu docs/index a koncový bod.

3. Ujistěte se, že text požadavku obsahuje klíč dokumentu, který chcete odstranit.

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

4. Odešlete požadavek.

   Následující tabulka vysvětluje různé stavové kódy jednotlivých dokumentů, které lze vrátit v odpovědi. Některé stavové kódy označují problémy se samotným požadavkem, zatímco jiné označují dočasné chybové stavy. Druhý pokus byste měli opakovat po zpoždění.

   Stavový kód	Meaning	Opakovatelné	Poznámky
   200	Dokument byl úspěšně odstraněn.	není k dispozici	Operace odstranění jsou idempotentní. To znamená, že i když klíč dokumentu v indexu neexistuje, při pokusu o operaci odstranění s tímto klíčem vznikne stavový kód 200.
   400	V dokumentu došlo k chybě, která znemožňovala odstranění dokumentu.	Ne	Chybová zpráva v odpovědi obsahuje podrobnosti.
   422	Index je dočasně nedostupný, protože se v něm aktualizoval příznak allowIndexDowntime nastavený na hodnotu true.	Ano	Počkejte, až bude index k dispozici.
   503	Vaše vyhledávací služba je dočasně nedostupná, pravděpodobně kvůli vysokému zatížení.	Ano	V takovém případě by váš kód měl před opakováním počkat, jinak riskujete prodloužení nedostupnosti služby.

   Poznámka:

   Pokud váš klientský kód často narazí na odpověď 207, je jedním z možných důvodů, proč je systém zatížený. Můžete to potvrdit tak, že zkontrolujete statusCode vlastnost 503. Pokud ano, doporučujeme omezit požadavky na indexování. Jestliže indexovací provoz neklesne, může systém začít odmítat všechny požadavky se stavovou chybou 503.

5. Odstranění můžete potvrdit opětovným odesláním vyhledávacího dotazu . Měla by se zobrazit zpráva o tom, že dokument 404 nebyl nalezen.

   GET https://[service name].search.windows.net/indexes/hotel-sample-index/docs/18?api-version=2026-04-01
   

Reference:Documents – index

Úspěšný požadavek na odstranění vrátí http 200 (OK). Text odpovědi obsahuje stav pro každý dokument:

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

Následující příklad odstraní dokument z indexu:

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)")

Reference:SearchClient, delete_documents

Následující příklad odstraní dokument z indexu:

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

Sada Azure SDK pro JavaScript/TypeScript poskytuje následující rozhraní API pro odstranění dokumentu:

• IndexDocumentsBatch
• SearchIndexingBufferedSender

Reference:SearchClient, IndexDocumentsBatch

Sada Azure SDK pro Javu poskytuje následující rozhraní API pro odstranění dokumentu:

• IndexActionType
• SearchIndexingBufferedSender

Ukázka kódu: IndexContentManagementExample.java

Reference:SearchClient, IndexActionType

1. Použijte Documents - Index REST API s příkazem delete @search.action, abyste jej odstranili z indexu vyhledávání. Formulujte volání POST určující název indexu docs/index a koncový bod.

2. Ujistěte se, že text požadavku obsahuje klíče všech dokumentů, které chcete odstranit.

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

• Limity skupin: Doporučujeme omezit skupiny na 1 000 dokumentů nebo přibližně 16 MB na požadavek, aby se zajistil optimální výkon.

• Idempotency: Odstranění je idempotentní; Pokud se pokusíte odstranit ID dokumentu, které neexistuje, rozhraní API stále vrátí stav 200 OK.

• Latence: Dokumenty se neodeberou vždy okamžitě z úložiště. Proces na pozadí provede fyzické odstranění každých několik minut.

• Vektorové úložiště: Odstranění dokumentů okamžitě nevyvolá kvóty vektorového úložiště. Fyzické odstranění trvá několik minut. K okamžitému relamaci vektorového prostoru možná budete muset index vypustit a znovu sestavit.

Reference:Documents – index

Následující příklad odstraní více dokumentů hromadně:

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)")

Reference:SearchClient, delete_documents

Následující příklad odstraní více dokumentů hromadně:

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

Sada Azure SDK pro JavaScript/TypeScript poskytuje následující rozhraní API pro hromadné odstranění dokumentu:

• IndexDocumentsBatch
• SearchIndexingBufferedSender

Reference:SearchClient, IndexDocumentsBatch

Sada Azure SDK pro Javu poskytuje následující rozhraní API pro hromadné odstranění dokumentu:

• IndexActionType
• SearchIndexingBufferedSender

Ukázka kódu: IndexContentManagementExample.java

Reference:SearchClient, IndexActionType

1. Na webu Azure Portal otevřete stránku Přehled vyhledávací služby.
2. Vyberte Správu vyhledávání>Indexy.
3. Zkontrolujte sloupec Počet dokumentů pro váš index.
4. Počkejte několik minut a aktualizujte, pokud se počet nezměnil (odstranění je asynchronní).

Pomocí rozhraní Get Document API ověřte, že dokument již neexistuje:

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

Očekávaná odpověď: HTTP 404 Nenalezena, pokud byl dokument úspěšně odstraněn.

Můžete také zkontrolovat statistiky indexu:

GET https://[service-name].search.windows.net/indexes/hotels-sample/stats?api-version=2026-04-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)");
}