Aracılığıyla paylaş

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

Azure AI Search'te dizin oluşturucu çalıştırmanın birkaç yolu vardır:

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. İndeksleyici yürütmesini, 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 açıkça dışa dönük çağrılar yapan az sayıdaki 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ği ve hedef Azure kaynağında rol ataması kullanılarak yapılır. Dizin oluşturucu sanal ağdaki bir Azure kaynağına bağlanıyorsa, bu bağlantı için paylaşılan bir özel bağlantı oluşturmanız gerekir.

Dizinleyici çalıştırma

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ı Genel Bakış sayfasının Azure portalının Temel bölümünden de kontrol edebilirsiniz. Eşzamanlı işlemeye ihtiyacınız varsa, arama birimlerinizin yeterli kopya içerdiğinden emin olun. Dizin oluşturucular arka planda çalışmadığı için, hizmet baskı altındaysa her zamankinden daha fazla sorgu sınırlandırması 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.

Genel bakış sayfasının arama birimlerini gösteren temel bilgiler bölümünün ekran görüntüsü.

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 tarafından ek ücret ödemeden yönetilen ve güvenliği sağlanan içerik işlemcileri vardır. Bu ortam, yoğun işlem kullanan işlemleri boşaltmak ve rutin işlemler için hizmete özgü kaynakları kullanılabilir durumda bırakmak için kullanılır. Mümkün olduğunda, çoğu beceri kümesi çok kiracılı ortamda yürütülür. Bu varsayılan seçenektir.

    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. Beceri gerektirmeyen işleme, çok kiracılı içerik işlemcilerinde buluşsal yöntemler ve sistem bilgileri ile belirlenir ve müşteri denetimi altında değildir.

Yalnızca arama kümelerinize özel bir dizinleyici ve beceri kümesi işleme sabitleyerek Standard2 veya üzeri hizmetlerde çok kiracılı ortamın kullanımını tamamen ö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:

Workload Maksimum süre En fazla iş sayısı Yürütme ortamı
Özel infaz 24 saat Arama birimi başına bir dizin oluşturucu işi. Dizin oluşturma arka planda çalışmaz. Bunun yerine, arama hizmeti tüm dizin oluşturma işlerini devam eden sorgulara ve nesne yönetimi eylemlerine (dizin oluşturma veya güncelleştirme gibi) karşı dengeler. Dizin oluşturucuları çalıştırırken, dizin oluşturma birimleri büyükse biraz sorgu gecikmesi görmeyi beklemeniz gerekir.
Multitenant 2 saat 2 Belirsiz 3 İçerik işleme kümesi çok kiracılı olduğundan, talebi karşılamak için içerik işlemcileri eklenir. İsteğe bağlı veya zamanlanmış yürütmede gecikme yaşıyorsanız, bunun nedeni büyük olasılıkla sistemin işlemci eklemesi veya kullanılabilir olmasını beklemesidir.

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

2 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 .

3 "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şturucuyu Ç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, veri kaynağındaki yeni ve güncellenmiş belgeler üzerinde dizinleyicinin çalışmasının başlangıç noktası haline gelen son güncellenmiş arama belgesini bulmak için iç kontrol noktasını saptayarak başlar.

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.

  • Dizin oluşturucunun yeni ve güncelleştirilmiş satırları okuyabilmesi için önce Azure SQL veya Azure Cosmos DB gibi diğer veri kaynaklarının değişiklik algılama için yapılandırılması gerekir.

Eğer temel alınan içerik değişmediyse, bir çalıştırma işleminin hiçbir etkisi olmaz. Bu durumda, dizin oluşturucu yürütme geçmişi 0\0 adet işlenen belgeyi gösterir.

Tam olarak yeniden işlemek için dizin oluşturucuyu bir sonraki bölümde açıklandığı gibi sıfırlamanız gerekir.

Dizin oluşturucuları sıfırlama

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

Bir dizinin tamamını veya bir bölümünü yeniden oluşturmanız gerekiyorsa nesne hiyerarşisindeki azalan düzeylerde kullanılabilir API'leri sıfırla seçeneğini kullanın:

Sıfırlamadan sonra, yeni ve mevcut belgelerin yeniden işlenmesi için Çalıştır komutunu kullanarak devam edin. Veri kaynağında karşılığı olmayan yalnız bırakılmış arama belgeleri sıfırlama/çalıştırma yoluyla kaldırılamaz. Belirli belgeleri silmeniz gerekiyorsa bkz. Arama dizinindeki belgeleri silme veya Bunun yerine Belgeler - Dizin .

Note

Tablolar boş olamaz. Satırları temizlemek için TRUNCATE TABLE kullanırsanız, dizin oluşturucunun sıfırlanması ve yeniden çalıştırılması ilgili arama belgelerini kaldırmaz. Sahipsiz arama belgelerini kaldırmak için, silme eylemiyle dizine almanız gerekir.

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

Sıfırlama, zirve noktayı temizler. Arama dizinindeki tüm belgeler, satır içi güncellemeler yapılmadan veya mevcut içerikle birleştirilmeden tamamen üzerine yazılmak üzere işaretlenir. Beceri kümesi ve zenginleştirme önbelleğine sahip 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 bir çalıştırma isteği göndermelisiniz.

Sıfırlama/çalıştırma işlemleri bir arama dizinine veya bilgi deposuna, belirli belgeler ya da projeksiyonlara ve eğer bir sıfırlama açıkça veya zımni olarak beceriler içeriyorsa önbellekteki zenginleştirmelere uygulanabilir.

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.

Dizin oluşturucuyu sıfırladıktan sonra eylemi geri alamazsınız.

  1. Azure portalında oturum açın ve arama hizmeti sayfasını açın.

  2. Genel Bakış sayfasında Dizin Oluşturucular sekmesini seçin.

  3. Bir dizin oluşturucu seçin.

  4. Sıfırla komutunu seçin ve ardından eylemi onaylamak için Evet'i seçin.

  5. Durumu göstermek için sayfayı yenileyin. Ayrıntılarını görüntülemek için öğeyi seçebilirsiniz.

  6. Dizin oluşturucu işlemesini başlatmak için Çalıştır'ı seçin veya bir sonraki zamanlanmış yürütmeyi bekleyin.

    Sıfırla komutunun vurgulandığı dizin oluşturucu yürütme portalı sayfasının ekran görüntüsü.

Beceriler nasıl sıfırlanır (önizleme)

"Becerileri Sıfırla isteği, bir veya daha fazla beceriyi, sonraki dizinleyici işlemi sırasında seçici olarak işler." Beceri kümelerine sahip dizin oluşturucular için, yalnızca belirli bir beceriyi ve onun çıkışına bağlı ardıl becerileri yeniden işlemeye zorlamak amacıyla bu bireysel becerileri sıfırlayabilirsiniz. Etkinleştirdiyseniz zenginleştirme önbelleği de yenilenir.

Önbelleğe alma özelliği etkinleştirilmiş dizin oluşturucular için, dizin oluşturucunun algılayamayacağı beceri güncelleştirmeleri için açıkça işlem isteğinde bulunabilirsiniz. Örneğin, özel beceri düzeltmeleri gibi dış değişiklikler yaparsanız, bu API'yi kullanarak beceriyi yeniden çalıştırabilirsiniz. Bilgi deposu veya arama dizini gibi çıkışlar, önbellekten yeniden kullanılabilir veriler ve güncelleştirilmiş beceriye göre yeni içerik kullanılarak yenilenir.

En son önizleme API'sini öneririz.

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

Yukarıdaki ö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 listelenmemiş beceriler çalıştırılır. Bunun doğru olması için, 2 ile #4 arası beceriler için önbelleğe alınmış zenginleştirmelerin #1'e bağımlılığı olmamalıdır (sıfırlama için listelenmiştir).

Hiçbir beceri belirtilmezse, beceri kümesinin tamamı yürütülür ve önbelleğe alma etkinleştirilirse önbellek de yenilenir.

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), belirli belgeleri yenileyebilmeniz için belge anahtarlarının listesini kabul eder. Belirtilirse, sıfırlama parametreleri, temel alınan verilerdeki diğer değişikliklerden bağımsız olarak işlenenlerin tek belirleyicisi olur. Ö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, yalnızca bu belge işlenir.

Belge başına temelinde, arama belgesindeki tüm alanlar veri kaynağındaki değerlerle ve meta verilerle yenilenir. 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 bu izinler de arama dizinine yeniden alınır. Daha fazla bilgi için bkz. ADLS 2. Nesil dizin oluşturucuları ile ACL ve RBAC kapsamını yeniden dizinleme.

Belge bir beceri kümesi aracılığıyla zenginleştirilmişse ve önbelleğe alınmış veriler varsa, beceri kümesi yalnızca belirtilen belgeler için çağrılır ve yeniden işlenen belgeler için önbellek güncelleştirilir.

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 öneririz.

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

  2. Çağır Dizin Oluşturucu - Belgelerin hangilerinin işleneceğini belirtmek için önizleme API sürümü ile Belgeleri Sıfırla.

    POST https://[service name].search.windows.net/indexers/[indexer name]/resetdocs?api-version=2025-11-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 çağrılırsa, dizin oluşturucu meta verilerine sıfırlanacak belge anahtarları veya veri kaynağı belge tanımlayıcıları eklenir. 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ğlanan 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 .

    • Birden çok arama belgesine ayrıştırılan bloblar için (parsingMode jsonLines veya jsonArrays olarak ayarlandığında, ya da delimitedText), belge anahtarı dizin oluşturucu tarafından oluşturulur ve sizin bilginiz dışında olabilir. Bu senaryoda, belge anahtarına yapılan sorgu, doğru değeri döndürür.

    • Dizin oluşturucunun sıfırlama belgelerini işlemeye çalışmayı durdurmasını istiyorsanız, "documentKeys" veya "datasourceDocumentIds" öğesini boş bir "[]" listesine ayarlayabilirsiniz. Bu, dizin oluşturucunun yüksek su işaretine göre düzenli dizinlemeye devam etmesine olanak 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. Yalnızca belirli belgeler dizine eklenir.

  4. Son yüksek su işaretinden işlemek için Run Indexer'ı ikinci kez çağı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ğırmak, yeni anahtarları belge anahtarları sıfırlama listesine ekler. API'yi overwrite parametresi true olarak ayarlanmış şekilde çağırmak, geçerli listenin üzerine yenisiyle yazar:

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

Dizin oluşturucuları nasıl yeniden senkronize edilir (önizleme)

Dizin Oluşturucuları Yeniden Eşitle , tüm belgelerin kısmi yeniden dizinlemesini 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 indeksleyici başarılı bir ilk çalıştırmadan sonra senkronize olmayı başarır. Bir belge veri kaynağından silinirse, dizin oluşturucu bu tanıma göre eşitlenmiş olarak kalır. Ancak, dizin oluşturucu çalıştırıldığında, silme izleme etkin durumdaysa hedef dizindeki ilgili belge kaldırılır.

Veri kaynağında bir belge değiştirilirse, dizin oluşturucu senkronize olmaktan çıkar. Değişiklik izleme mekanizmaları genellikle bir sonraki çalıştırma sırasında diziciyi yeniden senkronize eder. Örneğin, Azure Depolama'da bir blobu değiştirmek, son değiştirilme zamanını günceller ve bu güncellenen zaman, önceki çalıştırma tarafından belirlenen yüksek su işaretini geçtiği için sonraki dizinleyici çalıştırmasında yeniden dizine alınmasına olanak tanır.

Buna karşılık, ADLS Gen2 gibi belirli veri kaynakları için, bir blobun Erişim Denetim Listeleri (ACL'ler) değiştirildiğinde son değiştirilme zamanını etkilemez, bu da ACL'lerin işlenmek üzere alınması durumunda değişiklik izlemeyi etkisiz hale getirir. Sonuç olarak, yalnızca en yüksek su işaretinden sonra değiştirilen belgeler işlendiğinden, değiştirilen blob bir sonraki çalıştırmada yeniden dizine alınmaz.

"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ştirme için hedeflenen blobun belge anahtarının tanımlanması gerekir.

Resync Indexers verimli ve kullanışlı bir alternatif sunar. Kullanıcılar dizin oluşturucuyu yeniden eşitleme moduna alır ve resync indexers API'sini çağırarak yeniden eşitlemek için içeriği belirtir. Bir sonraki çalıştırmada, dizin oluşturucu kaynaktaki verilerin yalnızca ilgili bölümünü inceleyecek ve belirtilen veriyle ilgisiz gereksiz işlemelerden kaçınacaktır. 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 eşitleme ve çalıştırma

  1. Çağır Dizin oluşturucuları - Yeniden Eşitle ve hangi içeriğin yeniden eşitleneceğini belirtmek için bir önizleme API sürümü kullanın.

    POST https://[service name].search.windows.net/indexers/[indexer name]/resync?api-version=2025-11-01-preview
{
    "options" : [
        "permissions"
    ]
}
    • 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 işaretinden işlemek için Run Indexer'ı ikinci kez çağı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ınıldığını görmek için aşağıdaki adımları izleyin.

  1. Önizleme API'siyle Dizin Oluşturucu Durumunu Al çağır.

    Ö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ırlama için "mod" indexingAllDocs olarak ayarlanmalıdır (yapay zeka zenginleştirmesi aracılığıyla doldurulan alanlar açısından, potansiyel olarak tüm belgeler etkilenebilir).

    Dizin Oluşturucuları Yeniden Eşitleme için "modu" indexingResync olarak ayarlanmalıdır. 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 "mod" indexingResetDocs olarak ayarlanmalıdır. Dizin oluşturucu, belge sıfırlama çağrısında sağlanan tüm belge anahtarları işlenene kadar bu durumu korur ve bu süre boyunca işlem devam ederken başka dizin oluşturucu işleri yürütülmeyecektir. Belge anahtarları listesindeki tüm belgeleri bulmak, her belgeyi açarak içindeki anahtarı bulup eşleştirmek anlamına gelir ve 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 diğer tüm bloblar önce denetlenene kadar eşleşen blobları bulamaz.

  3. Belgeler yeniden işlendikten sonra Dizin Durumunu Al komutunu yeniden çalıştırın. Dizinleyici, bir sonraki çalıştırmada yeni veya güncelleştirilmiş belgeleri işlemek için indexingAllDocs moduna döner.

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

Standart 3 Yüksek Yoğunluklu (S3 HD) fiyatlandırma katmanındaki arama hizmetleri için geçerlidir.

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ı izleme

Bir arama hizmetinin toplu dizin oluşturucu çalışma zamanı kullanımını izleyin ve geçerli 24 saatlik zaman aralığı içinde ne kadar çalışma zamanı kotası kaldığını belirleyin.

Arama hizmeti kaynak sağlayıcısı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=2025-11-01-preview 
  Content-Type: application/json
  Authorization: Bearer {{accessToken}}

Yanıtlar, başlangıç ve bitiş saatlerini, kullanılan saniyeleri, kalan saniyeleri ve son 24 saat içindeki kümülatif çalışma zamanını 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=2025-11-01-preview 
  Content-Type: application/json
  Authorization: Bearer {{accessToken}}

Yanıtlar, başlangıç ve bitiş saatlerini, kullanılan saniyeleri ve kalan saniyeleri gösteren özellikleri runtime içerir.

Sonraki Adımlar

Sıfırlama API'leri, sonraki dizinleyici çalışmasının kapsamını belirlemek için kullanılır. Gerçek işleme için isteğe bağlı dizin oluşturucu işlemi çağırmanız veya zamanlanmış bir görevin işi tamamlaması için 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.

  • Last updated on