Menjalankan atau mengatur ulang pengindeks, keterampilan, atau dokumen

Dalam Pencarian Azure AI, Anda dapat menjalankan pengindeks dengan beberapa cara:

• Jalankan segera setelah pembuatan pengindeks. Opsi ini adalah default kecuali Anda membuat pengindeks dalam status dinonaktifkan.
• Jalankan sesuai jadwal untuk memanggil eksekusi secara berkala. Jika pengindeks terjadwal berhenti memicu, lihat Tanya Jawab Umum perilaku penjadwalan untuk langkah-langkah pemulihan.
• Jalankan sesuai permintaan, dengan atau tanpa reset.

Artikel ini menjelaskan cara menjalankan pengindeks sesuai permintaan, dengan dan tanpa reset. Ini juga menjelaskan eksekusi, durasi, dan konkurensi pengindeks.

Cara pengindeks terhubung ke sumber daya Azure

Pengindeks adalah salah satu dari sedikit subsistem yang secara langsung melakukan panggilan keluar ke sumber daya Azure lainnya. Bergantung pada sumber data eksternal, Anda dapat menggunakan kunci atau peran untuk mengautentikasi koneksi.

Dalam hal peran Azure, pengindeks tidak memiliki identitas terpisah: koneksi dari mesin pencari ke sumber daya Azure lain menggunakan sistem atau identitas terkelola yang ditetapkan pengguna dari layanan pencarian, ditambah penetapan peran pada sumber daya Azure target. Jika pengindeks tersambung ke sumber daya Azure di jaringan virtual, Anda harus membuat tautan privat shared untuk koneksi tersebut.

Pelaksanaan pengindeksan

Layanan pencarian menjalankan satu pekerjaan pengindeks per unit pencarian. Setiap layanan pencarian dimulai dengan satu unit pencarian, tetapi setiap partisi atau replika baru meningkatkan unit pencarian layanan Anda. Anda dapat memeriksa jumlah unit pencarian di bagian Esensial portal Azure dari halaman Overview. Jika Anda memerlukan pemrosesan bersamaan, pastikan unit pencarian Anda menyertakan jumlah replika yang cukup. Pengindeks tidak berjalan di latar belakang, sehingga Anda mungkin mengalami lebih banyak pengurangan kecepatan kueri daripada biasanya jika layanan berada di bawah tekanan.

Cuplikan layar berikut menunjukkan jumlah unit pencarian, yang menentukan berapa banyak pengindeks yang dapat berjalan sekaligus.

Setelah eksekusi pengindeks dimulai, Anda tidak dapat menjeda atau menghentikannya. Eksekusi pengindeks berhenti ketika tidak ada lagi dokumen untuk dimuat atau di-refresh, atau ketika batas waktu berjalan maksimum tercapai.

Anda dapat menjalankan beberapa pengindeks pada satu waktu dengan asumsi kapasitas yang memadai, tetapi setiap pengindeks itu sendiri adalah instans tunggal. Memulai instans baru saat pengindeks sudah dalam eksekusi menghasilkan kesalahan ini: "Failed to run indexer "<indexer name>" error: "Another indexer invocation is currently in progress; concurrent invocations are not allowed."

Lingkungan eksekusi pengindeks

Pekerjaan pengindeks berjalan di lingkungan eksekusi terkelola. Saat ini, ada dua lingkungan:

• Lingkungan eksekusi privat berjalan pada kluster pencarian yang khusus untuk layanan pencarian Anda.

• Lingkungan multitenansi memiliki pemroses konten yang dikelola dan diamankan oleh Microsoft tanpa biaya tambahan. Lingkungan ini mengalihkan pemrosesan yang sangat intensif secara komputasi, sehingga sumber daya khusus layanan tetap tersedia untuk operasi rutin. Jika memungkinkan, sebagian besar set keterampilan dijalankan di lingkungan multipenyewa. Lingkungan ini adalah default.

  Pemrosesan intensif komputasi mengacu pada set keterampilan yang berjalan pada prosesor konten dan pekerjaan pengindeks yang memproses volume dokumen yang tinggi, atau dokumen dengan ukuran besar. Heuristik dan informasi sistem menentukan pemrosesan yang tidak terkait dengan skillset pada prosesor konten multitenan dan tidak berada dalam kendali pelanggan.

Anda dapat mencegah penggunaan lingkungan multipenyewa pada layanan Standard2 atau yang lebih tinggi dengan menyematkan pengindeks dan pemrosesan kumpulan kemampuan secara eksklusif pada kluster pencarian Anda. Atur executionEnvironment parameter dalam definisi pengindeks untuk selalu menjalankan pengindeks di lingkungan eksekusi privat.

Firewall IP memblokir lingkungan multipenyewa, jadi jika Anda memiliki firewall, buat aturan yang memungkinkan koneksi prosesor multipenyewa.

Batas pengindeks bervariasi untuk setiap lingkungan:

¹ Unit pencarian dapat berupa kombinasi partisi dan replika yang fleksibel , tetapi pekerjaan pengindeks tidak terkait dengan satu atau yang lain. Dengan kata lain, jika Anda memiliki 12 unit, Anda dapat memiliki 12 pekerjaan pengindeksan yang berjalan bersamaan di eksekusi pribadi, tanpa memedulikan bagaimana unit pencarian tersebut disebarkan.

² Jika lebih dari dua jam diperlukan untuk memproses semua data, aktifkan deteksi perubahan dan jadwalkan pengindeks untuk berjalan pada interval 5 menit untuk melanjutkan pengindeksan dengan cepat jika berhenti karena waktu habis. Lihat Mengindeks himpunan data besar untuk strategi lainnya.

³ "Tidak ditentukan" berarti bahwa batas tidak diukur oleh jumlah pekerjaan. Beberapa beban kerja, seperti pemrosesan set keterampilan, dapat berjalan secara paralel, yang dapat mengakibatkan banyak pekerjaan meskipun hanya satu pengindeks yang terlibat. Meskipun lingkungan tidak memberlakukan batasan, batas pengindeks untuk layanan pencarian Anda masih berlaku.

Jalankan tanpa reset

Operasi Jalankan Pengindeks mendeteksi dan memproses hanya apa yang diperlukan untuk menyinkronkan indeks pencarian dengan perubahan di sumber data yang mendasarinya. Pengindeksan inkremental dimulai dengan menemukan penanda batas tertinggi internal untuk mencari dokumen pencarian yang terakhir diperbarui. Dokumen ini menjadi titik awal untuk eksekusi pengindeks melalui dokumen baru dan yang diperbarui di sumber data.

Deteksi perubahan sangat penting untuk menentukan apa yang baru atau diperbarui di sumber data. Pengindeks menggunakan kemampuan deteksi perubahan sumber data yang mendasar untuk menentukan apa yang baru atau diperbarui di sumber data.

• Azure Storage memiliki deteksi perubahan bawaan melalui properti LastModified-nya.

• Sumber data lain, seperti Azure SQL atau Azure Cosmos DB, memerlukan konfigurasi untuk deteksi perubahan sebelum pengindeks dapat membaca baris baru dan yang diperbarui.

Jika konten yang mendasarinya tidak berubah, operasi eksekusi tidak berpengaruh. Dalam hal ini, riwayat eksekusi pengindeks menunjukkan dokumen yang diproses 0\0 .

Untuk memproses ulang semua dokumen, Anda perlu mengatur ulang pengindeks.

Atur ulang pengindeks

Setelah eksekusi awal, pengindeks melacak dokumen pencarian mana yang diindeks melalui tanda batas tertinggi internal. Penanda tidak diekspos, tetapi secara internal pengindeks tahu di mana terakhir kali berhenti.

Untuk membangun kembali semua atau sebagian indeks, gunakan Reset API yang tersedia pada tingkat penurunan dalam hierarki objek:

• Atur Ulang Pengindeks menghapus penanda batas tertinggi dan melakukan pengindeksan ulang penuh untuk semua dokumen.
• Resync Indexers (pratinjau) melakukan pengindeksan ulang parsial yang efisien dari semua dokumen.
• Reset Dokumen (pratinjau) mengindeks ulang dokumen atau daftar dokumen tertentu.
• Reset Skills (pratinjau) memicu pemrosesan skill untuk skill tertentu.

Setelah reset, ikuti perintah Jalankan untuk memproses ulang dokumen baru dan yang sudah ada. Anda tidak dapat menghapus dokumen pencarian yatim yang tidak memiliki padanan di sumber data melalui reset and run. Untuk menghapus dokumen tertentu, lihat Menghapus dokumen dalam indeks pencarian atau Dokumen - Indeks.

Cara mengatur ulang dan menjalankan pengindeks

Reset menghapus batas tertinggi. Semua dokumen dalam indeks pencarian ditandai untuk penimpaan penuh, tanpa pembaruan sebaris atau penggabungan ke dalam konten yang ada. Untuk indexer yang memiliki skillset dan cache pengayaan (pratinjau), mengatur ulang indeks juga secara implisit mengatur ulang skillset tersebut.

Proses kerja sebenarnya dimulai setelah Anda melakukan reset dengan perintah Jalankan.

• Semua dokumen baru yang menemukan sumber yang mendasar ditambahkan ke indeks pencarian.
• Semua dokumen yang ada di sumber data dan indeks pencarian ditimpa dalam indeks pencarian.
• Setiap konten yang diperkaya yang dihasilkan dari kumpulan keterampilan dibangun ulang. Cache pengayaan, jika diaktifkan, akan diperbarui.

Seperti yang disebutkan sebelumnya, reset adalah operasi pasif: Anda harus mengikuti permintaan Jalankan untuk membangun kembali indeks.

Operasi reset atau menjalankan diterapkan pada indeks pencarian atau penyimpanan pengetahuan, pada dokumen atau proyeksi tertentu, serta pengayaan yang di-cache jika reset secara eksplisit atau implisit mencakup keterampilan.

Reset juga berlaku untuk operasi pembuatan dan pembaruan. Ini tidak memicu penghapusan atau pembersihan dokumen yatim di indeks pencarian. Untuk informasi selengkapnya tentang menghapus dokumen, lihat Dokumen - Indeks.

Anda tidak dapat membatalkan operasi reset.

POST /indexers/[indexer name]/reset?api-version=[api-version]

POST /indexers/[indexer name]/run?api-version=[api-version]

GET /indexers/[indexer name]/status?api-version=[api-version]

// Reset the indexer if it already exists
try
{
    await indexerClient.GetIndexerAsync(blobIndexer.Name);
    //Rest the indexer if it exsits.
    await indexerClient.ResetIndexerAsync(blobIndexer.Name);
}
catch (RequestFailedException ex) when (ex.Status == 404) { }

await indexerClient.CreateOrUpdateIndexerAsync(blobIndexer);

// Run indexer
Console.WriteLine("Running Blob Storage indexer...\n");

try
{
    await indexerClient.RunIndexerAsync(blobIndexer.Name);
}
catch (RequestFailedException ex) when (ex.Status == 429)
{
    Console.WriteLine("Failed to run indexer: {0}", ex.Message);
}

Cara mereset keterampilan (pratinjau)

Permintaan Reset Keterampilan secara selektif memproses satu atau beberapa keterampilan pada eksekusi pengindeks berikutnya. Untuk pengindeks yang memiliki keterampilan, Anda dapat mengatur ulang keterampilan individu untuk memaksa pemrosesan ulang hanya keterampilan itu dan keterampilan hilir apa pun yang bergantung pada outputnya. Jika Anda mengaktifkan cache pengayaan, permintaan juga akan merefreshnya.

Untuk pengindeks dengan cache yang diaktifkan, Anda dapat secara eksplisit meminta agar pembaruan skill yang tidak dapat dideteksi oleh pengindeks diproses. Misalnya, jika Anda membuat perubahan eksternal, seperti revisi ke keterampilan kustom, gunakan API ini untuk menjalankan kembali keterampilan. Proses ini me-refresh output, seperti penyimpanan pengetahuan atau indeks pencarian, dengan menggunakan data yang dapat digunakan kembali dari cache dan konten baru sesuai keterampilan yang diperbarui.

Gunakan API pratinjau terbaru.

POST /skillsets/[skillset name]/resetskills?api-version=2026-08-01-preview
{
    "skillNames" : [
        "#1",
        "#5",
        "#6"
    ]
}

Anda dapat menentukan keterampilan individual, seperti yang ditunjukkan dalam contoh sebelumnya, tetapi jika salah satu keterampilan tersebut memerlukan output dari keterampilan yang tidak terdaftar (#2 hingga #4), proses menjalankan keterampilan yang tidak terdaftar kecuali cache dapat memberikan informasi yang diperlukan. Agar kondisi ini benar, pengayaan cache untuk keterampilan #2 hingga #4 tidak boleh bergantung pada #1 (tercantum untuk reset).

Jika Anda tidak menentukan keterampilan apa pun, proses akan menjalankan seluruh kumpulan keterampilan dan, jika penembolokan diaktifkan, juga menyegarkan cache.

Ingatlah untuk menindaklanjuti dengan Jalankan Pengindeks untuk memanggil pemrosesan aktual.

Cara mengatur ulang dokumen (pratinjau)

API Pengindeks - Reset Dokumen (pratinjau) menerima daftar kunci dokumen sehingga Anda dapat me-refresh dokumen tertentu. Jika Anda menentukan parameter reset, mereka hanya menentukan apa yang akan diproses, terlepas dari perubahan lain dalam data yang mendasar. Misalnya, jika 20 blob ditambahkan atau diperbarui sejak pengindeks terakhir berjalan, tetapi Anda hanya mengatur ulang satu dokumen, pengindeks hanya memproses dokumen tersebut.

Berdasarkan per dokumen, pengindeks me-refresh semua bidang dalam dokumen pencarian dengan nilai dan metadata dari sumber data. Anda tidak dapat memilih dan memilih bidang mana yang akan di-refresh.

Jika sumber datanya adalah Azure Data Lake Storage (ADLS) Gen2, dan blob terkait dengan metadata izin, pengindeks akan memasukkan ulang izin tersebut ke dalam indeks pencarian jika izin berubah pada data yang mendasarinya. Untuk informasi selengkapnya, lihat Mengindeks ulang cakupan ACL dan RBAC dengan pengindeks ADLS Gen2.

Jika Anda memperkaya dokumen melalui set keterampilan dan memiliki data cache, pengindeks memanggil set keterampilan hanya untuk dokumen yang ditentukan, dan memperbarui cache untuk dokumen yang diolah ulang.

Saat Anda menguji API ini untuk pertama kalinya, API berikut dapat membantu Anda memvalidasi dan menguji perilaku. Gunakan API pratinjau terbaru.

1. Panggil Indexers - Get Status dengan versi pratinjau API untuk memeriksa status reset dan status eksekusi. Anda dapat menemukan informasi tentang permintaan reset di akhir respons status.

2. Panggil Pengindeks - Reset Dokumen dengan versi API pratinjau untuk menentukan dokumen mana yang akan diproses.

   POST https://[service name].search.windows.net/indexers/[indexer name]/resetdocs?api-version=2026-08-01-preview
   {
       "documentKeys" : [
           "1001",
           "4452"
       ]
   }
   

   • API menerima dua jenis pengidentifikasi dokumen sebagai input: Kunci dokumen yang secara unik mengidentifikasi dokumen dalam indeks pencarian, dan pengidentifikasi dokumen sumber data yang secara unik mengidentifikasi dokumen di sumber data. Isi harus berisi daftar kunci dokumen atau daftar pengidentifikasi dokumen sumber data yang dicari pengindeks di sumber data. Memanggil API menambahkan kunci dokumen atau pengidentifikasi dokumen sumber data untuk direset ke metadata pengindeks. Pada eksekusi pengindeks terjadwal atau sesuai permintaan berikutnya, pengindeks hanya memproses dokumen reset.

   • Jika Anda menggunakan kunci dokumen untuk mengatur ulang dokumen dan kunci dokumen Anda direferensikan dalam pemetaan bidang pengindeks, pengindeks menggunakan pemetaan bidang untuk menemukan bidang yang sesuai di sumber data yang mendasar.

   • Kunci dokumen yang Anda berikan dalam permintaan adalah nilai dari indeks pencarian, yang bisa berbeda dari bidang terkait di sumber data. Jika Anda tidak yakin dengan nilai kunci, kirim kueri untuk mengembalikan nilai. Anda dapat menggunakan select untuk mengembalikan bidang kunci dokumen saja.

   • Untuk blob yang diurai oleh pengindeks menjadi beberapa dokumen pencarian (di mana parsingMode diatur ke jsonLines atau jsonArrays, atau delimitedText), pengindeks menghasilkan kunci dokumen, dan Anda mungkin tidak mengetahuinya. Dalam skenario ini, kueri untuk kunci dokumen mengembalikan nilai yang benar.

   • Jika Anda ingin pengindeks berhenti mencoba memproses reset dokumen, atur "documentKeys" atau "datasourceDocumentIds" ke daftar []kosong . Tindakan ini menyebabkan pengindeks kembali melanjutkan pengindeksan reguler berdasarkan high water mark. Kunci dokumen yang tidak valid atau tidak ada diabaikan.

3. Panggil Run Indexer (versi API apa pun) untuk memproses dokumen yang Anda tentukan. Pengindeks hanya mengindeks dokumen tertentu tersebut.

4. Panggil Run Indexer untuk kedua kalinya untuk memproses dari titik batas terakhir.

5. Panggil Cari Dokumen untuk memeriksa nilai yang diperbarui, dan juga untuk mengembalikan kunci dokumen jika Anda tidak yakin dengan nilainya. Gunakan "select": "<field names>" jika Anda ingin membatasi bidang mana yang muncul dalam respons.

Timpa ulang daftar kunci dokumen

Jika Anda memanggil RESET Documents API beberapa kali dengan kunci yang berbeda, kunci baru ditambahkan ke daftar kunci dokumen yang direset. Jika Anda memanggil API dengan parameter yang overwrite diatur ke true, daftar saat ini diganti dengan yang baru:

POST https://[service name].search.windows.net/indexers/[indexer name]/resetdocs?api-version=2026-08-01-preview
{
    "documentKeys" : [
        "200",
        "630"
    ],
    "overwrite": true
}

Cara mengatur ulang pengindeks (pratinjau)

Resync Indexers adalah PRATINJAU REST API yang melakukan pengindeksan ulang parsial dari semua dokumen. Pengindeks dianggap disinkronkan dengan sumber datanya ketika bidang tertentu dari semua dokumen dalam indeks target konsisten dengan data di sumber data. Biasanya, pengindeks mencapai sinkronisasi setelah eksekusi awal berhasil. Jika Anda menghapus dokumen dari sumber data, pengindeks tetap disinkronkan sesuai dengan definisi ini. Namun, selama pengindeks berikutnya berjalan, dokumen yang sesuai dalam indeks target dihapus jika pelacakan penghapusan diaktifkan.

Jika Anda mengubah dokumen di sumber data, pengindeks menjadi tidak disinkronkan. Umumnya, mekanisme pelacakan perubahan menyinkronkan ulang pengindeks selama eksekusi berikutnya. Misalnya, di Azure Storage, memodifikasi blob akan memperbarui waktu terakhir modifikasinya, sehingga pengindeks dapat mengindeks ulang blob tersebut pada eksekusi pengindeks berikutnya karena waktu pembaruannya melampaui batas tertinggi yang ditetapkan oleh eksekusi sebelumnya.

Sebaliknya, untuk sumber data tertentu seperti ADLS Gen2, mengubah daftar kontrol akses (ACL) blob tidak mengubah waktu modifikasi terakhirnya, sehingga pelacakan perubahan tidak efektif jika ACL akan diserap. Akibatnya, blob yang dimodifikasi tidak diindeks ulang dalam proses berikutnya, karena hanya dokumen yang dimodifikasi setelah tanda batas tertinggi terakhir diproses.

Meskipun penggunaan "reset" atau "reset docs" dapat mengatasi masalah ini, "reset" dapat memakan waktu dan tidak efisien untuk dataset besar, dan "reset docs" mengharuskan Anda mengidentifikasi kunci dokumen dari blob yang ingin Anda perbarui.

Resync Indexers menawarkan alternatif yang efisien dan nyaman. Anda cukup menempatkan pengindeks dalam mode sinkronisasi ulang dan menentukan konten yang akan disinkronkan ulang dengan memanggil API pengindeks sinkronisasi ulang. Dalam eksekusi berikutnya, pengindeks hanya memeriksa bagian data yang relevan dalam sumber dan menghindari pemrosesan yang tidak perlu yang tidak terkait dengan data yang ditentukan. Ini juga mengkueri dokumen yang ada dalam indeks target dan hanya memperbarui dokumen yang menunjukkan perbedaan antara sumber data dan indeks target. Setelah eksekusi sinkronisasi ulang, pengindeks disinkronkan dan kembali ke mode eksekusi pengindeks reguler untuk eksekusi berikutnya.

Cara mengatur ulang dan menjalankan pengindeks

1. Panggil Pengindeks - Sinkronisasi Ulang dengan versi API pratinjau untuk menentukan konten yang akan disinkronkan ulang.

   POST https://[service name].search.windows.net/indexers/[indexer name]/resync?api-version=2026-08-01-preview
   {
       "options" : [
           "permissions"
       ]
   }
   

   • Bidang options diperlukan. Saat ini, satu-satunya opsi yang didukung adalah permissions. Artinya, hanya bidang filter izin dalam indeks target yang diperbarui.

2. Panggil Run Indexer (versi API apa pun) untuk menyinkronkan ulang pengindeks.

3. Panggil Run Indexer untuk kedua kalinya untuk memproses dari titik batas terakhir.

Periksa status reset "currentState"

Untuk memeriksa status reset dan melihat kunci dokumen mana yang diantrekan untuk diproses, ikuti langkah-langkah berikut:

1. Panggil Dapatkan Status Pengindeks dengan menggunakan API pratinjau.

   API pratinjau mengembalikan bagian currentState , yang ditemukan di akhir respons.

   "currentState": {
       "mode": "indexingResetDocs",
       "allDocsInitialTrackingState": "{\"LastFullEnumerationStartTime\":\"2021-02-06T19:02:07.0323764+00:00\",\"LastAttemptedEnumerationStartTime\":\"2021-02-06T19:02:07.0323764+00:00\",\"NameHighWaterMark\":null}",
       "allDocsFinalTrackingState": "{\"LastFullEnumerationStartTime\":\"2021-02-06T19:02:07.0323764+00:00\",\"LastAttemptedEnumerationStartTime\":\"2021-02-06T19:02:07.0323764+00:00\",\"NameHighWaterMark\":null}",
       "resetDocsInitialTrackingState": null,
       "resetDocsFinalTrackingState": null,
       "resyncInitialTrackingState": null,
       "resyncFinalTrackingState": null,
       "resetDocumentKeys": [
           "200",
           "630"
       ]
   }
   

2. Periksa "mode":

   Untuk reset keterampilan, atur "mode" ke indexingAllDocs karena semua dokumen berpotensi terdampak dalam hal bidang yang diisi oleh pengayaan AI.

   Untuk Resync Indexers, atur "mode" ke indexingResync. Pengindeks memeriksa semua dokumen dan berfokus pada data yang tertarik di sumber data dan bidang yang tertarik dalam indeks target.

   Untuk Atur Ulang Dokumen, atur "mode" ke indexingResetDocs. Pengindeks mempertahankan status ini sampai memproses semua kunci dokumen yang disediakan dalam panggilan reset dokumen. Selama waktu ini, tidak ada pekerjaan pengindeks lain yang dijalankan saat operasi sedang berlangsung. Menemukan semua dokumen dalam daftar kunci dokumen memerlukan pemecahan setiap dokumen untuk menemukan dan mencocokkan pada kunci. Proses ini dapat memakan waktu cukup lama jika himpunan data besar. Jika kontainer blob berisi ratusan blob, dan dokumen yang ingin Anda reset berada di akhir, pengindeks tidak menemukan blob yang cocok sampai memeriksa semua yang lain terlebih dahulu.

3. Setelah pengindeks memproses ulang dokumen, jalankan Get Indexer Status lagi. Pengindeks kembali ke indexingAllDocs mode dan memproses dokumen baru atau yang diperbarui pada eksekusi berikutnya.

Periksa kuota runtime pengindeks untuk layanan pencarian S3 HD dan Tanpa Server

Bagian ini berlaku untuk layanan pencarian Standard 3 High Density (S3 HD) dan Serverless. Untuk panduan tentang perilaku kuota agregat dan perencanaannya, lihat Eksekusi pengindeksan pada Serverless dan S3 HD (pratinjau).

Setiap eksekusi indexer memiliki durasi maksimum dua jam. Selain itu, semua pengindeks berbagi waktu proses kumulatif selama 24 jam untuk setiap layanan dalam setiap jangka waktu 24 jam UTC.

Untuk membantu Anda memantau waktu berjalan pengindeks relatif terhadap jendela 24 jam, Dapatkan Statistik Layanan dan Dapatkan Status Pengindeks sekarang mengembalikan informasi lebih lanjut dalam respons.

Melacak kuota waktu proses kumulatif

Lacak penggunaan runtime pengindeks kumulatif layanan pencarian dan tentukan berapa banyak kuota runtime yang tersisa dalam jendela 24 jam saat ini.

Kirim permintaan GET ke titik akhir layanan pencarian. Untuk bantuan dalam menyiapkan klien REST dan mendapatkan token akses, lihat Menyambungkan ke layanan pencarian.

GET {{search-endpoint}}/servicestats?api-version=2026-08-01-preview
  Content-Type: application/json
  Authorization: Bearer {{accessToken}}

Respons mencakup indexersRuntime properti yang menunjukkan waktu mulai dan berakhir jendela, detik kumulatif yang digunakan oleh semua pengindeks, dan detik yang tersisa untuk layanan.

Melacak kuota waktu eksekusi pengindeksan

Mengembalikan informasi yang sama untuk satu pengindeks.

GET {{search-endpoint}}/indexers/hotels-sample-indexer/search.status?api-version=2026-08-01-preview
  Content-Type: application/json
  Authorization: Bearer {{accessToken}}

Respons mencakup runtime properti yang menunjukkan waktu mulai dan berakhir jendela, detik yang digunakan oleh pengindeks, dan detik yang tersisa untuk semua pengindeks dalam layanan.

Langkah berikutnya

RESET API digunakan untuk menginformasikan cakupan eksekusi pengindeks berikutnya. Untuk pemrosesan sebenarnya, Anda perlu menjalankan pengindeks sesuai permintaan atau membiarkan tugas terjadwal menyelesaikan prosesnya. Setelah eksekusi selesai, pengindeks kembali ke pemrosesan normal, apakah itu sesuai jadwal atau pemrosesan sesuai permintaan.

Setelah mengatur ulang dan menjalankan ulang pekerjaan pengindeks, Anda dapat memantau status dari layanan pencarian, atau mendapatkan informasi terperinci melalui pengelogan sumber daya.

• Memantau status pengindeks pencarian
• Mengumpulkan dan menganalisis data log
• Menjadwalkan pengindeks