Dizin oluşturucuları, becerileri veya belgeleri çalıştırma veya sıfırlama

Azure Yapay Zeka Arama'da bir dizin oluşturucuyu çeşitli yollarla çalıştırabilirsiniz:

• Dizin oluşturucu oluşturuldukten hemen sonra çalıştırın. Dizin oluşturucuyu devre dışı durumda oluşturmadığınız sürece bu seçenek varsayılan seçenektir.
• Düzenli aralıklarla yürütmeyi çağırmak için bir zamanlamaya göre çalıştırın. Zamanlanmış bir dizin oluşturucu tetiklenmeyi durdurursa, kurtarma adımları için Zamanlama davranışı SSS bölümüne bakın.
• Sıfırlama ile veya sıfırlama olmadan isteğe bağlı olarak çalıştırın.

Bu makalede dizin oluşturucuları isteğe bağlı olarak sıfırlamayla ve sıfırlama olmadan çalıştırma işlemi açıklanmaktadır. Ayrıca dizin oluşturucunun yürütülmesini, süresini ve eşzamanlılığını açıklar.

Dizin oluşturucular Azure kaynaklarına nasıl bağlanır?

Dizin oluşturucular, diğer Azure kaynaklarına fazla giden çağrılar yapan birkaç alt sistemden biridir. Dış veri kaynağına bağlı olarak, bağlantının kimliğini doğrulamak için anahtarları veya rolleri kullanabilirsiniz.

Azure rolleri açısından dizin oluşturucuların ayrı kimlikleri yoktur: arama altyapısından başka bir Azure kaynağına bağlantı, arama hizmetinin sistem veya kullanıcı tarafından atanan yönetilen kimliğini ve hedef Azure kaynağında rol atamasını kullanır. Dizin oluşturucu sanal ağdaki bir Azure kaynağına bağlanıyorsa, bu bağlantı için shared private link oluşturmanız gerekir.

Dizin oluşturucu yürütme

Arama hizmeti, arama birimi başına bir dizin oluşturucu işi çalıştırır. Her arama hizmeti bir arama birimiyle başlar, ancak her yeni bölüm veya çoğaltma hizmetinizin arama birimlerini artırır. arama birimi sayısını Overview sayfasının Azure portalın Temel bölümünden de kontrol edebilirsiniz. Eşzamanlı işlemeye ihtiyacınız varsa, arama birimlerinizin yeterli yedek içerdiğinden emin olun ki. Dizin oluşturucular arka planda çalışmaz, bu yüzden hizmet baskı altındaysa alışılmadık derecede fazla sorgu kısıtlaması yaşayabilirsiniz.

Aşağıdaki ekran görüntüsünde, aynı anda kaç dizin oluşturucunun çalışabileceğini belirleyen arama birimi sayısı gösterilmektedir.

Dizin oluşturucu yürütmesi başlatıldıktan sonra duraklatamaz veya durduramazsınız. Yüklenecek veya yenilenecek belge kalmadığında veya maksimum çalışma süresi sınırına ulaşıldığında dizin oluşturucu yürütmesi durdurulur.

Yeterli kapasite olduğunu varsayarak aynı anda birden çok dizin oluşturucu çalıştırabilirsiniz, ancak her dizin oluşturucu tek örnektir. Dizin oluşturucu zaten yürütmedeyken yeni bir örnek başlatmak şu hatayı üretir: "Failed to run indexer "<indexer name>" error: "Another indexer invocation is currently in progress; concurrent invocations are not allowed."

Dizin oluşturucu yürütme ortamı

Dizin oluşturucu işi yönetilen yürütme ortamında çalışır. Şu anda iki ortam vardır:

• Özel yürütme ortamı, arama hizmetinize özgü arama kümelerinde çalışır.

• Çok kiracılı bir ortamda, Microsoft ek ücret ödemeden yönetip güvenliğini sağlayan içerik işlemcileri vardır. Bu ortam işlem açısından yoğun işleme yükünü boşalttığı için hizmete özgü kaynaklar rutin işlemler için kullanılabilir durumda kalır. Mümkün olduğunda, çoğu beceri kümesi çok kiracılı ortamda yürütülür. Bu ortam varsayılandır.

  Hesaplama açısından yoğun işleme , yüksek hacimli belgeleri veya büyük boyutlu belgeleri işleyen içerik işlemcileri ve dizin oluşturucu işleri üzerinde çalışan beceri kümelerini ifade eder. Buluşsal yöntemler ve sistem bilgileri, çok kiracılı içerik işlemcilerinde beceri kümesi dışındaki işlemeyi belirler ve bu işleme müşterinin denetiminde değildir.

Yalnızca arama kümelerinize özel olarak bir dizinleyici ve beceri kümesi işlemesini sabitleyerek Standard2 veya üzeri hizmetlerde çok kiracılı ortamın kullanımını önleyebilirsiniz. Özel yürütme ortamında her zaman bir dizin oluşturucu çalıştırmak için dizin oluşturucu tanımındaki parametresini ayarlayın.executionEnvironment

IP güvenlik duvarları çok kiracılı ortamı engeller, bu nedenle bir güvenlik duvarınız varsa, çok kiracılı işlemci bağlantılarına izin veren bir kural oluşturun .

Dizin oluşturucu sınırları her ortam için farklılık gösterir:

¹ Arama birimleri, bölümlerin ve çoğaltmaların esnek birleşimleri olabilir, ancak dizin oluşturucu işleri hiçbirine bağlı değildir. Başka bir deyişle, 12 biriminiz varsa, arama birimleri nasıl dağıtılırsa dağıtılsın, özel yürütmede eşzamanlı olarak çalışan 12 dizin oluşturucu işiniz olabilir.

² Tüm verileri işlemek için iki saatten fazla gerekiyorsa, değişiklik algılamayı etkinleştirin ve zaman aşımı nedeniyle durursa dizin oluşturmayı hızlı bir şekilde sürdürmek için dizin oluşturucuyu 5 dakikalık aralıklarla çalışacak şekilde zamanlayın. Daha fazla strateji için bkz. Büyük bir veri kümesini dizine ekleme .

³ "Belirsiz", sınırın iş sayısına göre ölçül olmadığı anlamına gelir. Beceri kümesi işleme gibi bazı iş yükleri paralel olarak çalıştırılabilir ve bu da yalnızca bir dizin oluşturucu dahil olsa bile birçok işe neden olabilir. Ortam kısıtlamalar getirmese de, arama hizmetiniz için dizin oluşturucu sınırları geçerli olmaya devam eder.

Sıfırlama olmadan çalıştırma

Dizin Oluşturucu Çalıştır işlemi yalnızca arama dizinini temel alınan veri kaynağındaki değişikliklerle eşitlemek için gerekenleri algılar ve işler. Artımlı dizinleme, en son güncellenen arama belgesini bulmak için dahili üst sınır işaretinin tespit edilmesiyle başlar. Bu belge, veri kaynağındaki yeni ve güncelleştirilmiş belgeler üzerinde dizin oluşturucu yürütme için başlangıç noktası haline gelir.

Değişiklik algılama , veri kaynağındaki yeni veya güncelleştirilmiş bilgileri belirlemek için gereklidir. Dizin oluşturucular, veri kaynağındaki yeni veya güncelleştirilmiş özellikleri belirlemek için temel alınan veri kaynağının değişiklik algılama özelliklerini kullanır.

• Azure Depolama, LastModified özelliği aracılığıyla yerleşik değişiklik algılama özelliğine sahiptir.

• Azure SQL veya Azure Cosmos DB gibi diğer veri kaynakları, dizin oluşturucunun yeni ve güncelleştirilmiş satırları okuyabilmesi için değişiklik algılama için yapılandırma gerektirir.

Temel alınan içerik değişmediyse, çalıştırma işleminin hiçbir etkisi olmaz. Bu durumda, yürütme geçmişi dizinleyicisinin 0\0 belgesini işlediğini gösterir.

Tüm belgeleri yeniden işlemek için dizin oluşturucuyu sıfırlamanız gerekir.

Dizin oluşturucuları sıfırlama

İlk çalıştırmadan sonra, dizin oluşturucu, hangi arama belgelerinin dizine alındığını iç bir yüksek su seviyesi aracılığıyla takip eder. İşaretçi gösterilmez, ancak dahili olarak dizin oluşturucu en son nerede durduğunu bilir.

Dizinin tamamını veya bir bölümünü yeniden oluşturmak için nesne hiyerarşisindeki azalan düzeylerde kullanılabilen API'leri sıfırla seçeneğini kullanın:

• Dizin Oluşturucuları Sıfırla, yüksek su işaretini sıfırlar ve tüm belgeleri tam olarak yeniden dizinler.
• Dizin Oluşturucuları Yeniden Eşitle (önizleme), tüm belgelerin verimli bir kısmi yeniden dizinlemesini gerçekleştirir.
• Belgeleri Sıfırla (önizleme), belirli bir belgeyi veya belge listesini yeniden dizine alır.
• Becerileri Sıfırla (önizleme), belirli bir beceri için beceri işlemeyi çağırır.

Sıfırlandıktan sonra, yeni ve mevcut belgeleri yeniden işlemek için bir Çalıştır komutuyla izleyin. Sıfırlayıp çalıştırarak, veri kaynağında karşılığı olmayan sahipsiz arama belgelerini kaldıramazsınız. Belirli belgeleri silmek için bkz. Arama dizinindeki belgeleri silme veya Belgeler - Dizin.

Dizin oluşturucuları sıfırlama ve çalıştırma

Sıfırlama, en yüksek seviye işaretini temizler. Arama dizinindeki tüm belgeler, satır içi güncellemeler yapılmadan veya mevcut içerikle birleştirilmeden, tamamen üzerine yazılacak şekilde işaretlenmiştir. Beceri kümesi ve zenginleştirme önbelleği (önizleme) olan dizin oluşturucular için dizini sıfırlamak, beceri kümesini de örtük olarak sıfırlar.

Gerçek çalışma, çalıştır komutuyla sıfırlamayı takip ettiğinizde gerçekleşir:

• Temel alınan kaynağı bulan tüm yeni belgeler arama dizinine eklenir.
• Hem veri kaynağında hem de arama dizininde bulunan tüm belgelerin üzerine arama dizininde yazılır.
• Beceri kümelerinden oluşturulan zenginleştirilmiş içerikler yeniden oluşturulur. Zenginleştirme önbelleği (etkinse) yenilenir.

Daha önce belirtildiği gibi, sıfırlama pasif bir işlemdir: Dizini yeniden oluşturmak için çalıştırma isteği yapmanız gerekir.

Sıfırlama/çalıştırma işlemleri bir arama dizinine veya bilgi deposuna, belirli belgelere veya projeksiyonlara ve bir sıfırlama açıkça veya örtük olarak beceriler içeriyorsa önbelleğe alınmış zenginleştirmeler için geçerlidir.

Sıfırlama, oluşturma ve güncelleştirme işlemleri için de geçerlidir. Arama dizinindeki yalnız bırakılmış belgelerin silinmesini veya temizlenmesini tetiklemez. Belgeleri silme hakkında daha fazla bilgi için bkz. Belgeler - Dizin.

Sıfırlama işlemini geri alamazsınız.

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

Becerileri sıfırlama (önizleme)

Becerileri Sıfırla isteği, sonraki dizin oluşturucu çalıştırması sırasında bir veya daha fazla beceriyi seçmeli olarak işler. Beceri kümelerine sahip dizin oluşturucular için, yalnızca bu beceriyi ve çıkışına bağlı aşağı akış becerilerini yeniden işlemeye zorlamak için bireysel becerileri sıfırlayabilirsiniz. Zenginleştirme önbelleğini etkinleştirdiyseniz, istek de önbelleği yeniler.

Önbelleğe alma özelliği etkin olan dizin oluşturucular için, dizin oluşturucunun algılayamadığı beceri güncelleştirmelerinin işlenmesini açıkça isteyebilirsiniz. Örneğin, özel beceri düzeltmeleri gibi dış değişiklikler yaparsanız, beceriyi yeniden çalıştırmak için bu API'yi kullanın. İşlem, önbellekten yeniden kullanılabilir verileri ve güncelleştirilmiş beceriye göre yeni içeriği kullanarak bilgi deposu veya arama dizini gibi çıkışları yeniler.

En son önizleme API'sini kullanın.

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

Önceki örnekte gösterildiği gibi tek tek beceriler belirtebilirsiniz, ancak bu becerilerin herhangi biri listelenmemiş becerilerin çıkışını gerektiriyorsa (#2 ile #4 arasında), önbellek gerekli bilgileri sağlayamadığı sürece işlem listelenmemiş beceriler çalıştırır. Bu koşulun doğru olması için, 2 ile #4 arası beceriler için önbelleğe alınmış zenginleştirmeler #1'e (sıfırlama için listelenmiştir) bağlı olmamalıdır.

Herhangi bir beceri belirtmezseniz, işlem beceri kümesinin tamamını yürütür ve önbelleğe alma etkinleştirildiyse önbelleği de yeniler.

Gerçek işlemeyi çağırmak için Run Indexer ile izlemeyi unutmayın.

Belgeleri sıfırlama (önizleme)

Dizin Oluşturucular - Belgeleri Sıfırla (önizleme) API'si, belirli belgeleri yenileyebilmeniz için belge anahtarlarının listesini kabul eder. Sıfırlama parametrelerini belirtirseniz, temel alınan verilerdeki diğer değişikliklerden bağımsız olarak yalnızca neyin işleneceğini belirlerler. Örneğin, son dizin oluşturucu çalıştırmasının ardından 20 blob eklendiyse veya güncelleştirildiyse, ancak yalnızca bir belgeyi sıfırlarsanız, dizin oluşturucu yalnızca bu belgeyi işler.

Dizin oluşturucu, belge başına temelinde, arama belgesindeki tüm alanları veri kaynağındaki değerler ve meta verilerle yeniler. Hangi alanların yenilendiğini seçip seçemezsiniz.

Veri kaynağı Azure Data Lake Storage (ADLS) 2. Nesil ise ve bloblar izin meta verileriyle ilişkiliyse, temel alınan verilerde izinler değişirse dizin oluşturucu bu izinleri arama dizininde yeniden alır. Daha fazla bilgi için bkz. ADLS 2. Nesil dizin oluşturucuları ile ACL ve RBAC kapsamını yeniden dizinleme.

Belgeyi bir beceri kümesi aracılığıyla zenginleştirirseniz ve veriler önbelleğe alınmışsa, dizin oluşturucu yalnızca belirtilen belgeler için beceri kümesini çağırır ve yeniden işlenmiş belgeler için önbelleği güncelleştirir.

Bu API'yi ilk kez test ederken, aşağıdaki API'ler davranışları doğrulamanıza ve test etmenize yardımcı olabilir. En son önizleme API'sini kullanın.

1. Çağır Dizin oluşturucuları - Durumu Al sıfırlama ve yürütme durumunu kontrol etmek için önizleme API sürümü ile. Sıfırlama isteği hakkındaki bilgileri durum yanıtının sonunda bulabilirsiniz.

2. Dizin Oluşturucuları - Belgeleri Sıfırla işlevini, hangi belgelerin işleneceğini belirtmek için bir önizleme API sürümüyle çağırın.

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

   • API giriş olarak iki tür belge tanımlayıcısı kabul eder: Arama dizinindeki belgeleri benzersiz olarak tanımlayan belge anahtarları ve veri kaynağındaki belgeleri benzersiz olarak tanımlayan veri kaynağı belge tanımlayıcıları. Gövde, belge anahtarlarının listesini veya dizin oluşturucunun veri kaynağında arayabilecekleri veri kaynağı belge tanımlayıcılarının listesini içermelidir. API'yi çağırmak, dizin oluşturucu meta verilerine sıfırlamak için belge anahtarlarını veya veri kaynağı belge tanımlayıcılarını ekler. Dizin oluşturucunun bir sonraki zamanlanmış veya isteğe bağlı çalıştırmalarında, dizin oluşturucu yalnızca sıfırlama belgelerini işler.

   • Belgeleri sıfırlamak için belge anahtarlarını kullanırsanız ve belge anahtarlarınız dizin oluşturucu alan eşlemesinde başvurulursa, dizin oluşturucu temel alınan veri kaynağında uygun alanı bulmak için alan eşlemesini kullanır.

   • İstekte sağladığınız belge anahtarları, arama dizinindeki değerlerdir ve bu değerler veri kaynağındaki ilgili alanlardan farklı olabilir. Anahtar değerinden emin değilseniz, değeri döndürmek için bir sorgu gönderin . Yalnızca belge anahtarı alanını döndürmek için kullanabilirsiniz select .

   • Dizin oluşturucunun birden çok arama belgesine ayrıştırdığı bloblar için (parsingMode değeri jsonLines veya jsonArrays ya da delimitedText olarak ayarlandığında), belge anahtarı dizin oluşturucu tarafından oluşturulur ve bu anahtar önceden sizin tarafınızdan bilinmeyebilir. Bu senaryoda, doğru değeri elde etmek için belge anahtarını sorgulayan bir sorgu.

   • Dizin oluşturucunun sıfırlama belgelerini işlemeyi denemeyi durdurmasını istiyorsanız, "documentKeys" veya "datasourceDocumentIds" değerini boş bir liste olarak [] ayarlayın. Bu işlem, dizin oluşturucunun yüksek su işaretine göre normal dizin oluşturmaya devam etmesini sağlar. Geçersiz belge anahtarları veya var olmayan belge anahtarları yoksayılır.

3. Belirttiğiniz belgeleri işlemek için Run Indexer'ı (herhangi bir API sürümü) çağırın. Dizin oluşturucu yalnızca bu belirli belgeleri dizinler.

4. Son yüksek su seviyesinden işlemek için Run Indexer komutunu ikinci kez çalıştırın.

5. Güncelleştirilmiş değerleri denetlemek ve ayrıca değerden emin değilseniz belge anahtarlarını döndürmek için Arama Belgeleri'ni çağırın. Yanıtta hangi alanların görüneceğini sınırlamak istiyorsanız kullanın "select": "<field names>" .

Belge anahtarı listesinin üzerine yazma

Belgeleri Sıfırla API'sini farklı anahtarlarla birden çok kez çağırırsanız, yeni anahtarlar belge anahtarları sıfırlama listesine eklenir. overwrite parametresi true olarak ayarlanmış şekilde API'yi çağırırsanız, mevcut liste yenisiyle değiştirilir:

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

Dizin oluşturucuları yeniden eşitleme (önizleme)

Dizinleyicileri Yeniden Eşitle, tüm belgelerin kısmi yeniden dizinlenmesini gerçekleştiren bir önizleme REST API'dir. Hedef dizindeki tüm belgelerin belirli alanları veri kaynağındaki verilerle tutarlı olduğunda, dizin oluşturucu veri kaynağıyla eşitlenmiş olarak kabul edilir. Genellikle, bir dizinleyici başarılı bir ilk çalıştırmadan sonra eşitlemeyi başarır. Veri kaynağından bir belgeyi silerseniz, dizin oluşturucu bu tanıma uygun olarak eşzamanlı kalır. Ancak, sonraki dizin oluşturucu çalıştırması sırasında, silme takibi etkinleştirildiyse hedef dizindeki ilgili belge kaldırılır.

Veri kaynağındaki bir belgeyi değiştirirseniz, dizin oluşturucu eşzamanlılığını kaybeder. Genel olarak, değişiklik izleme mekanizmaları bir sonraki çalıştırma sırasında dizin oluşturucuyu yeniden senkronize eder. Örneğin, Azure Depolama’ta bir blob değiştirildiğinde son değiştirilme zamanı güncellenir; böylece güncellenen zaman, önceki çalıştırmanın belirlediği yüksek su işaretini aştığı için dizin oluşturucu bunu sonraki çalıştırmasında yeniden dizinleyebilir.

Buna karşılık, ADLS 2. Nesil gibi belirli veri kaynakları için bir blobun erişim denetim listelerinin (ACL) değiştirilmesi son değiştirme zamanını değiştirmez, bu nedenle ACL'ler alınacaksa değişiklik izleme etkisizdir. Sonuç olarak, yalnızca son eşik seviyesinden sonra değiştirilen belgeler işlendiği için değiştirilen blob sonraki işletimde yeniden dizine alınmıyor.

"Reset" veya "reset docs" kullanmak bu sorunu giderebilirken, "sıfırlama" büyük veri kümeleri için zaman alabilir ve verimsiz olabilir ve "belgeleri sıfırlamak" için güncelleştirmek istediğiniz blobun belge anahtarının tanımlanması gerekir.

Resync Indexers verimli ve kullanışlı bir alternatif sunar. Dizin oluşturucuyu yeniden eşitleme moduna yerleştirmeniz ve resync indexers API'sini çağırarak yeniden eşitlemek için içeriği belirtmeniz yeterlidir. Sonraki çalıştırmada, dizin oluşturucu kaynaktaki verilerin yalnızca ilgili bölümünü inceler ve belirtilen verilerle ilgisi olmayan gereksiz işlemleri önler. Ayrıca hedef dizindeki mevcut belgeleri sorgular ve yalnızca veri kaynağı ile hedef dizin arasındaki tutarsızlıkları gösteren belgeleri güncelleştirir. Yeniden eşitleme çalıştırmasının ardından dizin oluşturucu eşitlenir ve sonraki çalıştırmalar için normal dizin oluşturucu çalıştırma moduna geri döner.

Dizin oluşturucuları yeniden senkronize etme ve çalıştırma

1. Indexers - Resync'i hangi içeriğin yeniden eşzamanlanacağını belirtmek için bir önizleme API sürümüyle çağırın.

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

   • Bu options alan gereklidir. Şu anda desteklenen tek seçenek şeklindedir permissions. Yani, yalnızca hedef dizindeki izin filtresi alanları güncelleştirilir.

2. Dizin oluşturucuyu yeniden eşitlemek için Run Indexer'ı (herhangi bir API sürümü) çağırın.

3. Son yüksek su seviyesinden işlemek için Run Indexer komutunu ikinci kez çalıştırın.

"currentState" sıfırlama durumunu kontrol et

Sıfırlama durumunu denetlemek ve hangi belge anahtarlarının işlenmek üzere kuyruğa alındiğini görmek için şu adımları izleyin:

1. Önizleme API’si kullanarak Dizin Oluşturucu Durumunu Al çağrısı yapın.

   Önizleme API'si yanıtın currentState sonunda bulunan bölümü döndürür.

   "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. "Modu" denetleyin:

   Becerileri Sıfırla için, AI zenginleştirmesinin doldurduğu alanlar açısından tüm belgeler etkilenebileceğinden "mode"u indexingAllDocs olarak ayarlayın.

   Yeniden Eşitleme Dizin Oluşturucuları için "mod" değerini indexingResync olarak ayarlayın. Dizin oluşturucu tüm belgeleri denetler ve hedef dizindeki veri kaynağı ve ilgili alanlarla ilgili verilere odaklanır.

   "Belgeleri Sıfırla" için "mode"u indexingResetDocs olarak ayarlayın. Dizin oluşturucu, belgeleri sıfırlama çağrısında sağlanan tüm belge anahtarlarını işleyene kadar bu durumu korur. Bu süre boyunca, işlem devam ederken başka hiçbir dizin oluşturucu işi yürütülemez. Belge anahtarları listesindeki tüm belgeleri bulmak, anahtarı bulup eşleştirmek için her belgeyi tek tek incelemeyi gerektirir. Veri kümesi büyükse bu işlem biraz zaman alabilir. Blob kapsayıcısı yüzlerce blob içeriyorsa ve sıfırlamak istediğiniz belgeler sonundaysa, dizin oluşturucu önce diğer tüm blobları denetleyene kadar eşleşen blobları bulamaz.

3. Dizin oluşturucu belgeleri yeniden işledikten sonra Dizin Oluşturucu Durumunu Al'ı yeniden çalıştırın. Dizin oluşturucu indexingAllDocs moduna geri döner ve bir sonraki çalıştırmada yeni veya güncelleştirilmiş belgeleri işler.

S3 HD ve Sunucusuz arama hizmetleri için dizin oluşturucu çalışma zamanı kotasını denetleme

Bu bölüm Standart 3 Yüksek Yoğunluklu (S3 HD) ve Sunucusuz arama hizmetleri için geçerlidir. Toplam kota davranışı ve planlama yönergeleri için bkz. Sunucusuz ve S3 HD üzerinde dizin oluşturucu yürütmesi (önizleme).

Her dizin oluşturucu çalıştırması azami iki saat sürer. Ayrıca, tüm dizin oluşturucular her 24 saatlik UTC penceresinde hizmet başına 24 saatlik toplu çalışma zamanını paylaşır.

Dizin oluşturucu çalışma sürelerini 24 saatlik pencereye göre izlemenize yardımcı olmak için Hizmet İstatistiklerini Al ve Dizin Oluşturucu Durumunu Al artık yanıtta daha fazla bilgi döndürmektedir.

Kümülatif çalışma zamanı kotasının takibi

Arama hizmetinin toplu dizin oluşturucu çalışma zamanı kullanımını izleyin ve geçerli 24 saatlik pencerede ne kadar çalışma zamanı kotası kaldığını belirleyin.

Arama hizmeti uç noktasına bir GET isteği gönderin. REST istemcisi ayarlama ve erişim belirteci alma konusunda yardım için bkz. Arama hizmetine bağlanma.

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

Yanıtlar, pencerenin başlangıç ve bitiş saatlerini, tüm dizin oluşturucular tarafından kullanılan birikmeli saniyeleri ve hizmet için kalan saniyeleri gösteren özellikleri içerir indexersRuntime .

Dizin oluşturucu çalışma zamanı kotası izleme

Tek bir dizin oluşturucu için aynı bilgileri döndürür.

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

Yanıtlar, pencere başlangıç ve bitiş saatlerini, dizin oluşturucu tarafından kullanılan saniyeleri ve hizmetteki tüm dizin oluşturucular için kalan saniyeleri gösteren özellikleri içerir runtime .

Sonraki adımlar

Sıfırla API'leri, bir sonraki dizin oluşturucu çalıştırmasının kapsamını belirlemek için kullanılır. İşlemenin gerçekten gerçekleşmesi için dizin oluşturucuyu isteğe bağlı olarak çalıştırmanız veya zamanlanmış bir görevin işlemi tamamlamasına izin vermeniz gerekir. Çalıştırma tamamlandıktan sonra, dizin oluşturucu ister zamanlamaya göre ister isteğe bağlı işleme olsun normal işlemeye döner.

Dizin oluşturucu işlerini sıfırlayıp yeniden çalıştırdıktan sonra, arama hizmetinden durumu izleyebilir veya kaynak günlüğü aracılığıyla ayrıntılı bilgi alabilirsiniz.

• Arama dizin oluşturucu durumunu izleme
• Günlük verilerini toplama ve analiz etme
• Bir dizin oluşturucu zamanla