Dokumentumok törlése keresési indexben

1. A(z) Dokumentumok – Index REST API-t használja a @search.action törléshez, hogy eltávolítsa azt a keresési indexből.

2. Alakítson ki egy POST-hívást, amely megadja az index nevét és a végpontot docs/index .

3. Győződjön meg arról, hogy a kérés törzse tartalmazza a törölni kívánt dokumentum kulcsát.

   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. Küldje el a kérést.

   Az alábbi táblázat a válaszban visszaadható dokumentumonkénti állapotkódokat ismerteti. Egyes állapotkódok a kéréssel kapcsolatos problémákat, míg mások átmeneti hibafeltételeket jeleznek. Az utóbbit egy késleltetés után újra meg kell próbálkoznia.

   Állapotkód	Meaning	Újrapróbálható	Jegyzetek
   200	A dokumentumot sikeresen törölték.	nincs adat	A törlési műveletek idempotensek. Vagyis még ha egy dokumentumkulcs nem is létezik az indexben, a törlési művelet megkísérlése ezzel a kulccsal 200-as állapotkódot eredményez.
   400	Hiba történt a dokumentumban, amely megakadályozta a törlést.	Nem	A válaszban megjelenő hibaüzenet részleteket tartalmaz.
   422	Az index átmenetileg nem érhető el, mert „true” (igaz) értékű allowIndexDowntime jelölővel lett frissítve.	Igen	Várja meg, amíg az index elérhetővé válik.
   503	A keresési szolgáltatás átmenetileg nem érhető el, valószínűleg nagy terhelés miatt.	Igen	Ebben az esetben a kódnak várnia kell az újrapróbálkozás előtt, különben fennáll a veszélye, hogy a szolgáltatás továbbra sem lesz elérhető.

   Megjegyzés:

   Ha az ügyfélkód gyakran találkozik egy 207-ben megadott válaszsal, az egyik lehetséges ok az, hogy a rendszer terhelés alatt van. Az 503 statusCode tulajdonságának ellenőrzésével ezt megerősítheti. Ha igen, javasoljuk az indexelési kérelmek szabályozását. Ellenkező esetben, ha a forgalom indexelése nem csökken, a rendszer 503 hibával elkezdheti elutasítani az összes kérést.

5. A keresési lekérdezést újraküldheti a törlés megerősítéséhez. A "404 - dokumentum nem található" hibaüzenetet kell kapnia.

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

Referencia:Dokumentumok – Index

A sikeres törlési kérelem HTTP 200 (OK) értéket ad vissza. A válasz törzse az egyes dokumentumok állapotát tartalmazza:

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

Az alábbi példa egy dokumentumot töröl egy indexből:

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

Hivatkozás:SearchClient, delete_documents

Az alábbi példa egy dokumentumot töröl egy indexből:

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

Referencia:SearchClient, IndexDocumentsAsync, IndexDocumentsBatch

Az Azure SDK for JavaScript/TypeScript a következő API-kat biztosítja a dokumentumok törléséhez:

• IndexDocumentsBatch
• KeresésIndexelésPuffereltKüldő

Hivatkozás:SearchClient, IndexDocumentsBatch

Az Azure SDK for Java a következő API-kat biztosítja a dokumentumok törléséhez:

• IndexActionType
• KeresésIndexelésPuffereltKüldő

Kódminta: IndexContentManagementExample.java

Hivatkozás:SearchClient, IndexActionType

1. A(z) Dokumentumok – Index REST API-t használja a @search.action törléshez, hogy eltávolítsa azt a keresési indexből. Alakítson ki egy POST-hívást, amely megadja az index nevét és a végpontot docs/index .

2. Győződjön meg arról, hogy a kérés törzse tartalmazza a törölni kívánt összes dokumentum kulcsát.

   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"
       }
     ]
   }
   

• Kötegkorlátok: Az optimális teljesítmény biztosítása érdekében ajánlott a kötegeket 1000 dokumentumra vagy kérésenként körülbelül 16 MB-ra korlátozni.

• Idempotencia: A törlés idempotens; Ha olyan dokumentumazonosítót próbál törölni, amely nem létezik, az API továbbra is 200 OK állapotot ad vissza.

• Késés: A dokumentumok nem mindig lesznek azonnal eltávolítva a tárolóból. A háttérfolyamat néhány percenként végrehajtja a fizikai törlést.

• Vektoros tárolás: A dokumentumok törlése nem szabadít fel azonnal vektoros tárolási kvótákat. A fizikai törlés több percet vesz igénybe. A vektortér azonnali visszaállításához előfordulhat, hogy el kell távolítania és újra kell építenie az indexet.

Referencia:Dokumentumok – Index

Az alábbi példa több dokumentumot töröl tömegesen:

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

Hivatkozás:SearchClient, delete_documents

Az alábbi példa több dokumentumot töröl tömegesen:

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

Referencia:SearchClient, IndexDocumentsAsync, IndexDocumentsBatch

Az Azure SDK for JavaScript/TypeScript a következő API-kat biztosítja a dokumentumok tömeges törléséhez:

• IndexDocumentsBatch
• KeresésIndexelésPuffereltKüldő

Hivatkozás:SearchClient, IndexDocumentsBatch

Az Azure SDK for Java a következő API-kat biztosítja a dokumentumok tömeges törléséhez:

• IndexActionType
• KeresésIndexelésPuffereltKüldő

Kódminta: IndexContentManagementExample.java

Hivatkozás:SearchClient, IndexActionType

1. Az Azure Portalon nyissa meg a keresési szolgáltatás áttekintési oldalát.
2. Válassza Kereséskezelés>Indexeklehetőséget.
3. Ellenőrizze az index Dokumentumszám oszlopát.
4. Várjon néhány percet, és frissítsen, ha a szám nem változott (a törlés aszinkron).

A Dokumentum lekérése API használatával erősítse meg, hogy a dokumentum már nem létezik:

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

Várt válasz: HTTP 404 Nem található, ha a dokumentumot sikeresen törölték.

Az indexstatisztikákat is ellenőrizheti:

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