Zenginleştirme önbelleği yapılandırma (önizleme)

Not

Azure Yapay Zeka Arama Azure portalı, REST API'leri ve Azure SDK’ları aracılığıyla kullanılabilir. Ayrıca kuruluş içeriğini Microsoft Foundry portalındaki aracılar için yeniden kullanılabilir, izin kullanan bilgi bankalarına dönüştüren yönetilen bilgi katmanı Foundry IQ'yu temel alır.

Önemli

(önizleme) olarak işaretlenen özellikler, özellikler veya özellikler hizmet düzeyi sözleşmesi kapsamında değildir, üretim iş yükleri için önerilmez ve genel kullanıma sunulmadan önce değişebilir veya kısıtlanabilir. Azure Yapay Zeka Arama önizleme terimleri, tek başına veya genel kullanıma sunulan bir özelliğin parçası olsun, tüm önizleme işlevleri için geçerlidir.

Bu makalede, her seferinde tam bir yeniden derleme olmadan aşağı akış zenginleştirme adımlarını değiştirebilmeniz için beceri kümesi işlem hattına önbelleğe alma ekleme işlemi açıklanmaktadır. Zenginleştirme önbelleği (önizleme), önizleme REST API'sini gerektirir. Varsayılan olarak, bir beceri kümesi durumsuzdur ve herhangi bir kısmını değiştirmek için dizin oluşturucunun tamamen tekrar çalıştırılması gerekir. Zenginleştirme önbelleğiyle, dizin oluşturucu beceri kümesi veya dizin oluşturucu tanım değişikliklerine göre belge ağacının hangi bölümlerinin yenilenmesi gerektiğini belirler. Dizin oluşturucu, mümkün olduğunda mevcut işlenmiş çıktıyı korur ve yeniden kullanır.

Sağladığınız bağlantı dizesini kullanarak önbelleğe alınmış içeriği Azure Depolama'a yerleştirirsiniz. Dizin oluşturucu çalıştırıldığında bu nesneleri oluşturur. Zenginleştirme önbelleğini, arama hizmetiniz tarafından yönetilen ve değiştirmemesi gereken bir iç bileşen olarak düşünün.

Önemli

Zenginleştirme önbelleği beceri kümesi çıktılarının, dizin oluşturucu durumunun veya dizine alınan belgelerin yedeği değildir. Hangi belgelerin işlenmesini tamamladığını izlemez. Büyük veri kaynakları için önbelleğe almayı etkinleştirmeden önce Sınırlamalar bölümünü gözden geçirin.

adlı bir kapsayıcı ms-az-search-indexercache-<alpha-numeric-string>
Tablolar MsAzSearchIndexerCacheIndex<alpha-numeric-string> ismiyle adlandırılmış

Önkoşullar

önbelleğe alınmış zenginleştirmeleri depolamak için Azure Depolama. Depolama hesabı genel amaçlı v2 olmalıdır.
Yalnızca blob dizin oluşturma için, bloblar veri kaynağınızdan silindiğinde hem önbellekten hem de dizinden eşitlenmiş belge kaldırmaya ihtiyacınız varsa, dizin oluşturucuda silme ilkesini etkinleştirin. Bu ilke olmadan, önbellekten belge silme desteklenmez.

Dizin oluşturucuları ve beceri kümelerini ayarlama konusunda bilgi sahibi olmanız gerekir. Dizin oluşturucuya genel bakış ile başlayın ve zenginleştirme işlem hatları hakkında bilgi edinmek için beceri kümelerine geçin.

Sınırlama

Dikkat

SharePoint dizin oluşturucu (önizleme) kullanıyorsanız artımlı zenginleştirmeden kaçının. Belirli durumlarda önbellek geçersiz hale gelir. Yeniden yüklemek için dizin oluşturucuyu sıfırlayıp tam yeniden oluşturma gerçekleştirin.

Büyük veri kaynaklarının ek bir önbellek sınırlaması vardır.

Dikkat

Büyük veri kaynakları için zenginleştirme önbelleği, uzun süre çalışan beceriler, yinelenen kesintiler veya sık beceri hataları oluştuğunda toplam yeniden işlemeyi artırabilir. Dizin oluşturucu, yeniden işlemeyi en aza indirmek yerine doğruluğun önceliğini belirler, böylece yinelenen kesintilerden kaynaklanan önbellek kapsamı yeniden deneme davranışını artırır. Bu davranış bir hata değil beklenen bir davranıştır.

Büyüyen bir önbellek kapsamından kurtarmak için veri kaynağını daha küçük kapsayıcılara veya sanal klasörlere bölün. Ardından aynı dizine işaret eden paralel dizin oluşturucuları kullanın. Önbelleğin ilişkilendirmesini kaldırmak için, dizin oluşturucuda cache özelliğini null olarak ayarlayın. Bölümleme düzeniyle ilgili yönergeler için bkz. Büyük veri kümelerini dizinleme.

İzinler

Azure Yapay Zeka Arama kimliğinin Azure Depolama yazma erişimi olması gerekir:

Depolama Blob Verileri Katkı Sağlayıcısı
Depolama Tablosu Veri Katılımcısı

bağlantı dizesi söz dizimi, sistem tarafından atanan veya kullanıcı tarafından atanan bir kimliğin kullanılıp kullanılmayacağını belirler. Daha fazla bilgi için bkz. Azure Depolama'a yönetilen kimlik kullanarak bağlanma.

Cache özelliğini ayarlama

Hem yeni hem de mevcut dizin oluşturucular için bu yordamı kullanın.

Dizin oluşturucu tanımında, cache öğesini belirtin ve şu şekilde ayarlayın:

(Gerekli) storageConnectionString bir Azure Depolama bağlantı dizesi olarak ayarlayın.
(İsteğe bağlı) enableReprocessing (true varsayılan olarak). false artımlı zenginleştirmeyi geçici olarak askıya almak için ayarlayın ve daha sonra true durumuna geri dönün.

Azure portalı
REST

Sol tarafta Dizinleyiciler'i seçin.
Yeni bir dizin oluşturucu oluşturmak için Dizin oluşturucu ekle'yi seçin veya mevcut dizin oluşturucuları JSON düzenleme modunda açın.
Artımlı zenginleştirmeyi etkinleştirin, zenginleştirme önbelleği depolama hesabını ayarlayın ve dizin oluşturucuyu kaydedin.
Mevcutsa dizin oluşturucuyu sıfırlayın.
Dizin oluşturucuyu çalıştırın. Bu tek seferlik tam yeniden derleme önbelleğin tohumlarını oluşturur. Yüklendikten sonra sonraki çalıştırmalarda artımlı yeniden kullanım uygulanır.

Mevcut bir dizin oluşturucuyu düzenliyorsanız, geçerli yapılandırmayı almak için GET Indexer'ı kullanın.

Dizin Oluşturucu Oluştur veya Güncelleştir için en son önizleme API'sini kullanın.

PUT https://[YOUR-SEARCH-SERVICE].search.windows.net/indexers/[YOUR-INDEXER-NAME]?api-version=2026-08-01-preview
    Content-Type: application/json
    api-key: [YOUR-ADMIN-KEY]
    {
        "name": "<YOUR-INDEXER-NAME>",
        "targetIndexName": "<YOUR-INDEX-NAME>",
        "dataSourceName": "<YOUR-DATASOURCE-NAME>",
        "skillsetName": "<YOUR-SKILLSET-NAME>",
        "cache": {
            "storageConnectionString": "<YOUR-STORAGE-ACCOUNT-CONNECTION-STRING>",
            "enableReprocessing": true
        },
        "fieldMappings": [],
        "outputFieldMappings": [],
        "parameters": []
    }

Zaten varsa dizin oluşturucuyu sıfırlayın.
Dizin oluşturucuyu çalıştırın. Bu tek seferlik tam yeniden derleme önbelleğin tohumlarını oluşturur. Yüklendikten sonra sonraki çalıştırmalarda artımlı yeniden kullanım uygulanır.
```
POST https://[YOUR-SEARCH-SERVICE].search.windows.net/indexers/[YOUR-INDEXER-NAME]/run?api-version=2026-08-01-preview
    Content-Type: application/json
    api-key: [YOUR-ADMIN-KEY]
```

Dizin oluşturucuda başka bir GET isteği yayınlarsanız, hizmetten gelen yanıt önbellek nesnesinde bir ID özellik içerir. Dize, bu dizin oluşturucu tarafından işlenen her belgenin önbelleğe alınmış tüm sonuçlarını ve ara durumunu içeren kapsayıcının adına eklenir. Kimlik, Blob depolamada önbelleği benzersiz olarak adlandırmak için kullanılır.

    "cache": {
        "ID": "<ALPHA-NUMERIC STRING>",
        "enableReprocessing": true,
        "storageConnectionString": "DefaultEndpointsProtocol=https;AccountName=<YOUR-STORAGE-ACCOUNT>;AccountKey=<YOUR-STORAGE-KEY>;EndpointSuffix=core.windows.net"
    }

Önbelleğe alınmış çıktıyı kontrol et

Azure portalında oturum açın ve Azure Depolama hesabınızı bulun.
Kapsayıcıları ve tabloları gözden geçirmek için Storage Browser'ı kullanın.
- Kapsayıcı adı şeklindedir ms-az-search-indexercache-<some-alphanumeric-string>.
- Tablo adları şeklindedir MsAzSearchIndexerCacheIndex<alpha-numeric-string>.

Dizin oluşturucu bir önbellek oluşturur ve kullanır. İçeriği okunabilir değil.

Önbelleğin çalışır durumda olup olmadığını doğrulamak için bir beceri kümesini değiştirin ve dizin oluşturucuyu çalıştırın, ardından yürütme süresi ve belge sayısı için öncesi ve sonrası ölçümlerini karşılaştırın.

Taranan belgelerin görüntü analizi ve Optik Karakter Tanıma (OCR) içeren beceri kümeleri iyi test çalışmaları yapar. Aşağı akış metin becerisini veya görüntüyle ilgili olmayan herhangi bir beceriyi değiştirirseniz, dizin oluşturucu önceden işlenen görüntüyü ve OCR içeriğini önbellekten alabilir ve düzenlemelerinizden yalnızca metinle ilgili değişiklikleri işleyebilir. Dizin oluşturucu yürütme sayılarında daha az belge, daha kısa yürütme süreleri ve daha düşük maliyetler bekleyebilirsiniz.

cog-search-demo öğreticilerinde kullanılan dosya kümesi, JPG, PNG, HTML, DOCX, PPTX ve diğer türlerde 14 dosya içerdiği için yararlı bir test çalışmasıdır. en'yi es'e veya başka bir dile dönüştürün, metin çeviri becerisini artımlı zenginleştirmenin kavram kanıtı testi için.

Yaygın hatalar

İstekte bir önizleme API sürümü belirtmeyi unutursanız aşağıdaki hata oluşur:

"The request is invalid. Details: indexer : A resource without a type name was found, but no expected type was specified. To allow entries without type information, the expected type must also be specified when the model is specified."

Dizin oluşturucu gereksiniminiz eksikse 400 Hatalı İstek hatası da oluşur. Hata iletisi eksik bağımlılıkları belirtir.

Sonraki adım

Beceri kümeleri içeren dizin oluşturucularda artımlı zenginleştirmeyi kullanabilir, böylece hem dizinler hem de bilgi depoları için içeriği yeniden kullanabilirsiniz. Önbellek yönetimi hakkında daha fazla bilgi edinmek için aşağıdaki makaleye bakın:

Zenginleştirme önbelleğini yönetme

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Son güncelleştirme: 2026-09-17