Menghapus dokumen dalam indeks pencarian

1. Gunakan Dokumen - Indeks REST API dengan penghapusan @search.action untuk menghapusnya dari indeks pencarian.

2. Menyusun panggilan POST yang menentukan nama indeks dan titik akhir docs/index.

3. Pastikan isi permintaan menyertakan kunci dokumen yang ingin Anda hapus.

   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. Kirim permintaan.

   Tabel berikut menjelaskan berbagai kode status per dokumen yang dapat dikembalikan dalam respons. Beberapa kode status menunjukkan masalah dengan permintaan itu sendiri, sementara yang lain menunjukkan kondisi kesalahan sementara. Pilihan terakhir yang harus Anda coba lagi setelah jeda.

   Kode status	Meaning	Dapat Dicoba Lagi	Catatan
   200	Dokumen berhasil dihapus.	n/a	Operasi penghapusan adalah idempoten. Artinya, bahkan jika kunci dokumen tidak ada dalam indeks, mencoba operasi penghapusan dengan kunci tersebut menghasilkan kode status 200.
   400	Terjadi kesalahan dalam dokumen yang mencegahnya dihapus.	Tidak.	Pesan kesalahan dalam respons memberikan detail.
   422	Indeks sementara tidak tersedia karena diperbarui dengan bendera 'allowIndexDowntime' diatur ke 'true'.	Yes	Tunggu hingga indeks tersedia.
   503	Layanan pencarian Anda untuk sementara tidak tersedia, mungkin karena beban berat.	Yes	Dalam kasus ini, kode Anda harus menunggu sebelum mencoba lagi atau Anda berisiko memperpanjang tidak tersedianya layanan.

   Nota

   Jika kode klien Anda sering menerima respons 207, salah satu alasan yang mungkin adalah sistem sedang mengalami beban. Anda dapat mengonfirmasi ini dengan memeriksa statusCode properti untuk 503. Jika demikian, sebaiknya batasi permintaan pengindeksan. Jika tidak, jika lalu lintas pengindeksan tidak mereda, sistem dapat mulai menolak semua permintaan dengan kesalahan 503.

5. Anda dapat mengirim ulang kueri Pencarian untuk mengonfirmasi penghapusan. Anda harus mendapatkan pesan kesalahan 404: Dokumen tidak ditemukan.

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

Referensi:Dokumen - Indeks

Permintaan penghapusan yang berhasil mengembalikan HTTP 200 (OK). Isi respons berisi status untuk setiap dokumen:

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

Contoh berikut menghapus dokumen dari indeks:

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

Referensi:SearchClient, delete_documents

Contoh berikut menghapus dokumen dari indeks:

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

Referensi:SearchClient, IndexDocumentsAsync, IndexDocumentsBatch

Azure SDK untuk JavaScript/TypeScript menyediakan API berikut untuk penghapusan dokumen:

• IndexDocumentsBatch
• Pengirim Indeks Pencarian Berbasis Buffer

Referensi:SearchClient, IndexDocumentsBatch

Azure SDK untuk Java menyediakan API berikut untuk penghapusan dokumen:

• IndexActionType
• Pengirim Indeks Pencarian Berbasis Buffer

Sampel kode: IndexContentManagementExample.java

Referensi:SearchClient, IndexActionType

1. Gunakan Dokumen - Indeks REST API dengan penghapusan @search.action untuk menghapusnya dari indeks pencarian. Menyusun panggilan POST yang menentukan nama indeks dan titik akhir docs/index.

2. Pastikan isi permintaan menyertakan kunci semua dokumen yang ingin Anda hapus.

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

• Batas batch: Disarankan untuk membatasi batch hingga 1.000 dokumen atau sekitar 16 MB per permintaan untuk memastikan performa optimal.

• Idempotency: Penghapusan bersifat idempotensi; jika Anda mencoba menghapus ID dokumen yang tidak ada, API tetap akan mengembalikan status 200 OK.

• Latensi: Dokumen tidak selalu dihapus secara instan dari penyimpanan. Proses latar belakang melakukan penghapusan fisik setiap beberapa menit.

• Penyimpanan vektor: Menghapus dokumen tidak segera membebaskan kuota penyimpanan vektor. Penghapusan fisik memerlukan beberapa menit. Untuk pengembalian segera ruang vektor, Anda mungkin perlu menghapus dan membangun kembali indeks.

Referensi:Dokumen - Indeks

Contoh berikut menghapus beberapa dokumen secara massal:

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

Referensi:SearchClient, delete_documents

Contoh berikut menghapus beberapa dokumen secara massal:

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

Referensi:SearchClient, IndexDocumentsAsync, IndexDocumentsBatch

Azure SDK untuk JavaScript/TypeScript menyediakan API berikut untuk penghapusan dokumen massal:

• IndexDocumentsBatch
• Pengirim Indeks Pencarian Berbasis Buffer

Referensi:SearchClient, IndexDocumentsBatch

Azure SDK untuk Java menyediakan API berikut untuk penghapusan dokumen massal:

• IndexActionType
• Pengirim Indeks Pencarian Berbasis Buffer

Sampel kode: IndexContentManagementExample.java

Referensi:SearchClient, IndexActionType

1. Di portal Microsoft Azure, buka halaman Gambaran Umum layanan pencarian.
2. Pilih manajemen pencarian>Indeks.
3. Periksa kolom Jumlah dokumen untuk indeks Anda.
4. Tunggu beberapa menit dan refresh jika jumlah belum berubah (penghapusan asinkron).

Gunakan Get Document API untuk mengonfirmasi dokumen tidak ada lagi:

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

Respons yang diharapkan: HTTP 404 Tidak Ditemukan jika dokumen berhasil dihapus.

Anda juga dapat memeriksa statistik indeks:

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