Arama dizinindeki belgeleri silme

1. Belgeler - Dizin REST API'sini bir silme @search.action işlemiyle kullanarak arama dizininden kaldırın.

2. Dizin adını ve uç noktayı belirten bir POST çağrısı formüle edin docs/index .

3. İsteğin gövdesinde silmek istediğiniz belgenin anahtarının bulunduğundan emin olun.

   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. İsteği gönderin.

   Aşağıdaki tabloda, yanıtta döndürülebilecek çeşitli belge başına durum kodları açıklanmaktadır. Bazı durum kodları isteğin kendisiyle ilgili sorunları, diğerleri ise geçici hata koşullarını belirtir. İkincisi, bir gecikmeden sonra yeniden denemeniz gerekir.

   Durum kodu	Meaning	Yeniden denenebilir	Notes
   200	Belge başarıyla silindi.	Yok	Silme işlemleri idemopotenttir. Başka bir ifadeyle, dizinde bir belge anahtarı olmasa bile, bu anahtarla silme işlemi denenmesi 200 durum koduyla sonuçlanır.
   400	Belgede silinmesini engelleyen bir hata oluştu.	Hayı	Yanıttaki hata iletisi ayrıntıları sağlar.
   422	Dizin, 'allowIndexDowntime' seçeneği 'true' olarak ayarlanarak güncellendiği için geçici olarak kullanılamıyor.	Yes	Indeksin kullanılabilir olmasını bekleyin.
   503	Arama hizmetiniz, büyük olasılıkla ağır yük nedeniyle geçici olarak kullanılamıyor.	Yes	Kodunuzun yeniden denemeden önce beklemesi gerekir, yoksa hizmetin kullanım dışı durumunun uzaması riskiyle karşılaşırsınız.

   Uyarı

   İstemci kodunuz sık sık bir 207 yanıtıyla karşılaşırsa, olası nedenlerden biri sistemin yük altında olmasıdır. 503 özelliğini kontrol ederek statusCode ifadesini onaylayabilirsiniz. Bu durumda dizin oluşturma isteklerini azaltmanızı öneririz. Aksi takdirde, indeksleme trafiği azalmazsa, sistem 503 hatası vererek tüm istekleri reddetmeye başlayabilir.

5. Silme işlemini onaylamak için Arama sorgusunu yeniden gönderebilirsiniz. 404 belgesi bulunamadı iletisini almanız gerekir.

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

Başvuru:Belgeler - Dizin

Başarılı bir silme isteği HTTP 200 (Tamam) döndürür. Yanıt gövdesi her belgenin durumunu içerir:

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

Aşağıdaki örnek bir belgeyi dizinden siler:

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

Referans:SearchClient, delete_documents

Aşağıdaki örnek bir belgeyi dizinden siler:

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

Başvuru:SearchClient, IndexDocumentsAsync, IndexDocumentsBatch

JavaScript/TypeScript için Azure SDK,belge silme için aşağıdaki API'leri sağlar:

• IndexDocumentsBatch
• SearchIndexingBufferedSender

Referans:SearchClient, IndexDocumentsBatch

Java için Azure SDK,belge silme için aşağıdaki API'leri sağlar:

• IndexActionType
• SearchIndexingBufferedSender

Kod örneği: IndexContentManagementExample.java

Reference:SearchClient, IndexActionType

1. Belgeler - Dizin REST API'sini bir silme @search.action işlemiyle kullanarak arama dizininden kaldırın. Dizin adını ve uç noktayı belirten bir POST çağrısı formüle edin docs/index .

2. İsteğin gövdesinde silmek istediğiniz tüm belgelerin anahtarlarının bulunduğundan emin olun.

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

• Toplu iş sınırları: En iyi performansı sağlamak için toplu işlemlerin istek başına 1.000 belgeyle veya kabaca 16 MB ile sınırlandırılması önerilir.

• Idempotency: Silme işlemi idempotenttir; Var olmayan bir belge kimliğini silmeye çalışırsanız, API yine de 200 OK durumu döndürür.

• Gecikme süresi: Belgeler her zaman depolama alanından hemen kaldırılmaz. Arka plan işlemi, fiziksel silme işlemini birkaç dakikada bir gerçekleştirir.

• Vektör depolama: Belgelerin silinmesi vektör depolama kotalarını hemen boşaltmaz. Fiziksel silme işlemi birkaç dakika sürer. Vektör alanının hemen geri kazanılmasını sağlamak için dizini bırakmanız ve yeniden oluşturmanız gerekebilir.

Başvuru:Belgeler - Dizin

Aşağıdaki örnek birden çok belgeyi toplu olarak siler:

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

Referans:SearchClient, delete_documents

Aşağıdaki örnek birden çok belgeyi toplu olarak siler:

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

Başvuru:SearchClient, IndexDocumentsAsync, IndexDocumentsBatch

JavaScript/TypeScript için Azure SDK,toplu belge silme için aşağıdaki API'leri sağlar:

• IndexDocumentsBatch
• SearchIndexingBufferedSender

Referans:SearchClient, IndexDocumentsBatch

Java için Azure SDK,toplu belge silme için aşağıdaki API'leri sağlar:

• IndexActionType
• SearchIndexingBufferedSender

Kod örneği: IndexContentManagementExample.java

Reference:SearchClient, IndexActionType

1. Azure portalında arama hizmetine Genel Bakış sayfasını açın.
2. Arama yönetimi>Dizinlerini seçin.
3. Dizininizin Belge sayısı sütununu denetleyin.
4. Sayı değişmediyse birkaç dakika bekleyin ve yenileyin (silme işlemi zaman uyumsuzdur).

Belgenin artık var olmadığını onaylamak için Belge Al API'sini kullanın:

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

Beklenen yanıt: Belge başarıyla silindiyse HTTP 404 Bulunamadı.

Dizin istatistiklerini de de kontrol edebilirsiniz:

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