Azure Blob Depolama verilerini dizine alın

Uyarı

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.

Important

Bu özellikler ve işlevler, diğer Microsoft hizmetleri ve üçüncü taraf hizmetlerle bağlantıları destekler. Bu hizmetlerin kullanımı ilgili koşullara tabidir ve Azure uyumluluk sınırının dışında veri işleme veya depolamanın yanı sıra Azure uyumluluk sınırına akan verilere neden olabilir.

Verilerinizin kuruluşunuzun uyumluluk ve coğrafi sınırları dışında akıp akmayacağını ve ilgili etkileri ve uygun izinlerin, sınırların ve onayların sağlanıp sağlanmayacağını yönetmek sizin sorumluluğunuzdadır.

Özel kullanım örnekleriniz bağlamında oluşturduğunuz uygulamaları dikkatle gözden geçirmek ve test etmek ve tüm uygun kararları ve özelleştirmeleri yapmak sizin sorumluluğunuzdadır. Bu, metapromptlar, içerik filtreleri veya diğer güvenlik sistemleri gibi sorumlu yapay zeka risk azaltmalarınızı uygulamayı ve uygulamalarınızın uygun kalite, güvenilirlik, güvenlik ve güvenilirlik standartlarını karşılamasını sağlamayı içerir. Daha fazla bilgi için bkz. Azure Yapay Zeka Arama Saydamlık Notu.

Bu makalede, Azure Blob Depolama'dan içerik içeri aktaran ve Azure Yapay Zeka Arama'te aranabilir hale getiren bir dizin oluşturucu yapılandırmayı öğreneceksiniz. Dizin oluşturucu blobları tek bir kapsayıcıda giriş olarak alır. Çıktı, aranabilir içeriği ve meta verileri tek tek alanlarda depolayan bir arama dizinidir.

Bu makalede, dizin oluşturucuyu yapılandırmayı ve çalıştırmayı göstermek için Arama Hizmeti REST API'leri kullanılır. Ancak şunları da kullanabilirsiniz:

Uyarı

Azure Yapay Zeka Arama, dizin oluşturma sırasında rol tabanlı erişim denetimi (RBAC) kapsamını alabilir ve bu izinleri bir arama dizinindeki dizine alınmış içeriğe aktarabilir. Daha fazla bilgi için bkz. RBAC kapsamları meta verilerini almak için blob dizin oluşturucu veya bilgi kaynağı kullanma.

Önkoşullar

  • Azure Blob Depolama, Standart performans (genel amaçlı v2).

  • Erişim katmanları arasında sık erişimli, seyrek erişimli, soğuk ve arşiv bulunur. Dizin oluşturucular sık erişimli, seyrek erişimli ve soğuk erişim katmanlarında blobları alabilir.

  • Metin içeriği ve meta veriler sağlayan bloblar. Bloblar ikili içerik veya yapılandırılmamış metin içeriyorsa, görüntü ve doğal dil işleme için yapay zeka zenginleştirmesi eklemeyi göz önünde bulundurun. Blob içeriği, fiyatlandırma katmanınızın dizin oluşturucu sınırlarını aşamaz.

  • Desteklenen bir ağ yapılandırması ve veri erişimi. En azından Azure Depolama'da okuma izinlerine ihtiyacınız vardır. Erişim anahtarı içeren bir depolama bağlantı dizesi, depolama içeriğine okuma erişimi sağlar. Bunun yerine Microsoft Entra oturum açma bilgilerini ve rollerini kullanıyorsanız, arama hizmetinin yönetilen kimliğinin Depolama Blob Veri Okuyucusu izinlerine sahip olduğundan emin olun.

    Varsayılan olarak, hem arama hem de depolama genel IP adreslerinden gelen istekleri kabul eder. Ağ güvenliği acil bir sorun değilse yalnızca bağlantı dizesi ve okuma izinlerini kullanarak blob verilerini dizine alabilirsiniz. Veri erişimi hakkında yönergeler almak için ağ korumalarını eklemeye hazır olduğunuzda, bkz. Azure ağ güvenliği özellikleri ile korunan içeriğe dizin oluşturucunun erişimi.

  • REST çağrılarını bu makalede gösterilene benzer şekilde formüle etmek için REST istemcisini kullanın.

Desteklenen görevler

Bu dizin oluşturucuyu aşağıdaki görevler için kullanabilirsiniz:

  • Veri dizini oluşturma ve artımlı dizin oluşturma: Dizin oluşturucu blob kapsayıcılarından ve klasörlerinden dosyaları ve ilişkili meta verileri dizine alabilir. Yerleşik değişiklik algılama aracılığıyla yeni ve güncelleştirilmiş dosyaları ve meta verileri algılar. Veri yenilemeyi bir zamanlamaya göre veya isteğe bağlı olarak yapılandırabilirsiniz.

  • Silme algılama: Dizin oluşturucu yerel geçici silme veya özel meta veriler aracılığıyla silmeleri algılayabilir.

  • Beceri kümeleri aracılığıyla yapay zeka uygulandı: Dizin oluşturucu beceri kümelerini tam olarak destekler. Bu destek, veri öbekleme ve ekleme ekleyen tümleşik vektörleştirme gibi temel özellikleri içerir.

  • Ayrıştırma modları: JSON dizilerini veya satırlarını tek tek arama belgelerine ayrıştırmak istiyorsanız dizin oluşturucu JSON ayrıştırma modlarını destekler. Ayrıca Markdown ayrıştırma modunu da destekler.

  • Diğer özelliklerle uyumluluk: Dizin oluşturucu hata ayıklama oturumları, artımlı zenginleştirmeler için dizin oluşturucu önbelleği ve bilgi deposu gibi diğer dizin oluşturucu özellikleriyle sorunsuz çalışır.

Desteklenen belge biçimleri

Blob dizin oluşturucu aşağıdaki belge biçimlerinden metin ayıklayabilir:

  • CSV (bkz. CSV bloblarının dizinini oluşturma)
  • EML
  • EPUB
  • GZ
  • HTML
  • JSON (bkz. JSON bloblarını dizinleme)
  • KML (coğrafi gösterimler için XML)
  • Markdown
  • Microsoft Office biçimleri: DOCX/DOC/DOCM, XLSX/XLS/XLSM, PPTX/PPT/PPTM, MSG (Outlook e-postaları), XML (hem 2003 hem de 2006 WORD XML)
  • Belge biçimlerini açma: ODT, ODS, ODP
  • PDF
  • Düz metin dosyaları (ayrıca bkz. Düz metin dizini oluşturma)
  • RTF
  • XML
  • Zip

Dizine eklemek istediğiniz blobları belirleme

Dizin oluşturmayı ayarlamadan önce kaynak verilerinizi gözden geçirerek herhangi bir değişiklik yapmanız gerekip gerekmediğini belirleyin. Dizin oluşturucu bir kerede bir kapsayıcıdaki içeriği dizine alabilir. Dizin oluşturucu varsayılan olarak kapsayıcıdaki tüm blobları işler. Daha seçmeli işleme için çeşitli seçenekleriniz vardır:

  • Blobları bir sanal klasöre yerleştirin. Dizin oluşturucu veri kaynağı tanımı , sanal klasör alabilen bir query parametre içerir. Bir sanal klasör belirtirseniz, dizin oluşturucu yalnızca klasördeki blobları dizine alır.

  • Blobları dosya türüne göre dahil edin veya hariç tutun. Desteklenen belge biçimleri listesi , dışlamanız gereken blobları belirlemenize yardımcı olabilir. Örneğin, aranabilir metin sağlamayan görüntü veya ses dosyalarını dışlamak isteyebilirsiniz. Bu özelliği dizin oluşturucudaki yapılandırma ayarları aracılığıyla denetleyebilirsiniz.

  • Rastgele blobları dahil edin veya hariç tutun. Belirli bir blobu atlamak için Azure Blob Depolama'daki bloblara aşağıdaki meta veri özelliklerini ve değerlerini ekleyin. Dizin oluşturucu bu özellik ile karşılaştığında, dizin oluşturma çalıştırmasında blobu veya içeriğini atlar.

    Özellik adı Özellik değeri Explanation
    AzureSearch_Skip true Blob dizinleyicisinin blobu tamamen atlamasını yönlendirir. Dizin oluşturucu meta verileri veya içeriği ayıklamaya çalışmaz. Bu özellik, belirli bir blob tekrar tekrar başarısız olduğunda ve dizin oluşturma işlemini kestiğinde kullanışlıdır.
    AzureSearch_SkipContent true Dizin oluşturucu içeriği atlar ve yalnızca meta verileri ayıklar. Bu özellik"dataToExtract": "allMetadata" açıklanan ayara eşdeğerdir, ancak kapsamı belirli bir blob olarak belirlenmiştir.

Ekleme veya dışlama ölçütlerini ayarlamazsanız, dizin oluşturucu uygun olmayan bir blobu hata olarak bildirir ve devam eder. Yeterli hata oluşursa işlem durdurulabilir. Dizin oluşturucu yapılandırma ayarlarında hataya dayanıklılık belirtebilirsiniz.

Dizin oluşturucu genellikle blob başına bir arama belgesi oluşturur ve burada metin içeriği ve meta veriler bir dizinde aranabilir alanlar olarak yakalanır. Bloblar tam dosyaysa, bunları birden çok arama belgesine ayrıştırabilirsiniz. Örneğin, bir CSV dosyasındaki satırları ayrıştırarak satır başına bir arama belgesi oluşturabilirsiniz.

Bileşik veya eklenmiş belge (ZIP arşivi, ekleri içeren eklenmiş Outlook e-postası içeren bir Word belgesi veya gibi). Ekleri olan MSG dosyası) da tek bir belge olarak dizine alınır. Örneğin, bir .MSG dosyasının eklerinden ayıklanan tüm görüntüler normalized_images alanında döndürülür. Resimleriniz varsa bu içerikten daha fazla arama yardımcı programı elde etmek için yapay zeka zenginleştirmesi eklemeyi göz önünde bulundurun.

Dizin oluşturucu, bir belgenin metin içeriğini adlı contentbir dize alanına ayıklar. Standart ve kullanıcı tanımlı meta verileri de ayıklayabilirsiniz.

Blob meta verilerini dizinleme

blob meta verilerini içerikle birlikte dizine alabilirsiniz. Dizin oluşturucu, meta veri özelliklerini ayıklar ve bunları dizin alanlarında depolar. Bu, filtreler ve sorgular oluşturmak için kullanışlıdır.

Yakalamak istediğiniz meta veri özellikleri için arama dizininizdeki alanları tanımlayın. Kullanılabilir her standart veya özel meta veri özelliğini tanımlamanız gerekmez. Uygulamanız için ihtiyacınız olan özellikleri yakalamanız yeterlidir.

Şu anda bu dizin oluşturucu blob dizin etiketlerini dizine alma işlemini desteklemez.

Important

Dizin oluşturucu yalnızca arama dizininizde zaten tanımlanmış meta veri alanlarını doldurur. Bu gereksinim hem standart blob meta verileri hem de özel meta veriler için geçerlidir. Bir alan tanımlanmamışsa, meta veri değeri dizin oluşturma sırasında ayıklanır ancak arama sonuçlarında görünmemesi için sessizce atılır. Bu, arama sonuçlarında null meta veri alanlarının en yaygın kaynağıdır. Daha fazla bilgi için bkz. Arama sonuçlarında meta veri alanları null.

Standart blob meta veri özellikleri

Standart blob meta verileri için, dizininizdeki alanları aynı alt çizgili adları kullanarak tanımlayın. Adım adım alan tanımı örnekleri için bkz. Dizine arama alanları ekleme.

Ayıklanması gereken meta verileri denetleyen ayar da dahil olmak üzere dataToExtract dizin oluşturucu yapılandırması için bkz. Blob dizin oluşturucusunu yapılandırma ve çalıştırma.

Dizininizde karşılık gelen alanları tanımlarsanız dizin oluşturucu bu standart meta veri özelliklerini tanır ve eşleyebilir:

  • metadata_storage_name (Edm.String), blobun dosya adıdır. Örneğin, bir blob'nuz /my-container/my-folder/subfolder/resume.pdfvarsa, bu alanın değeri olur resume.pdf.

  • metadata_storage_path (Edm.String), depolama hesabı da dahil olmak üzere blobun tam URI'sidir. Örneğin, https://myaccount.blob.core.windows.net/my-container/my-folder/subfolder/resume.pdf. Gezinti veya kaynak ilişkilendirmesi için arama sonuçlarına blob URL'lerini eklemek için bu özelliği kullanın.

  • metadata_storage_content_type (Edm.String), blobu karşıya yüklemek için kullandığınız kod tarafından belirtilen içerik türüdür. Örneğin, application/octet-stream.

  • metadata_storage_last_modified (Edm.DateTimeOffset), blob için son değiştirilen zaman damgasıdır. Azure Yapay Zeka Arama değiştirilen blobları tanımlamak ve ilk dizin oluşturma işleminden sonra her şeyin yeniden dizine alınmasını önlemek için bu zaman damgasını kullanır.

  • metadata_storage_size (Edm.Int64), bayt cinsinden blob boyutudur.

  • metadata_storage_content_md5 (Edm.String), varsa blob içeriğinin MD5 karmasıdır.

  • metadata_storage_sas_token (Edm.String), özel becerilerin bloba erişmek için kullanabileceği geçici bir SAS belirtecidir. Süresi dolabileceği için bu belirteci daha sonra kullanmak üzere depolamayın.

Özel ve içeriğe özgü meta veriler

Özel veya kullanıcı tanımlı blob meta verileri için, blob'un meta veri anahtarıyla tam olarak aynı ada sahip bir alan tanımlayın. Örneğin, bloblarınızda değeri Sensitivityolan bir meta veri anahtarı High varsa dizininizde türünde Sensitivity adlı Edm.String bir alan tanımlayın.

Ayrıca, dizine eklediğiniz blobların belge biçimine özgü meta veri özelliklerini de temsil edebilirsiniz. Daha fazla bilgi için bkz. İçerik meta veri özellikleri.

Veri kaynağını tanımlama

Veri kaynağı tanımı, verilerdeki değişiklikleri tanımlamak için dizine eklenecek verileri, kimlik bilgilerini ve ilkeleri belirtir. Veri kaynağı, birden çok dizin oluşturucu tarafından kullanılabilmesi için bağımsız bir kaynak olarak tanımlanır.

  1. Tanımını ayarlamak için bir veri kaynağı oluşturun veya güncelleştirin:

    {
    "name" : "my-blob-datasource",
    "type" : "azureblob",
    "credentials" : { "connectionString" : "DefaultEndpointsProtocol=https;AccountName=<account name>;AccountKey=<account key>;" },
    "container" : { "name" : "my-container", "query" : "<optional-virtual-directory-name>" }
}

  2. type öğesini azureblob olarak ayarlayın (gerekli).

  3. credentials bir Azure Depolama bağlantı dizesi olarak ayarlayın. Sonraki bölümde desteklenen biçimler açıklanmaktadır.

  4. container öğesini blob kapsayıcısına ayarlayın ve alt klasörleri belirtmek için query'i kullanın.

Ayrıca, kaynak belge silinmek üzere işaretlendiğinde dizin oluşturucunun bir arama belgesini silmesini istiyorsanız, veri kaynağı tanımına geçici silme ilkeleri de ekleyebilirsiniz.

Desteklenen kimlik bilgileri ve bağlantı dizesi

Dizin oluşturucular aşağıdaki bağlantıları kullanarak bir blob kapsayıcısına bağlanabilir.

Tam erişimli depolama hesabı bağlantı dizesi
{ "connectionString" : "DefaultEndpointsProtocol=https;AccountName=<your storage account>;AccountKey=<your account key>;" }
Bağlantı dizesini, sol bölmedeki Erişim anahtarları'nı seçerek Azure portalındaki Depolama hesabı sayfasından alabilirsiniz. Yalnızca bir anahtar değil tam bir bağlantı dizesi seçtiğinizden emin olun.
Yönetilen kimlik bağlantı dizesi
{ "connectionString" : "ResourceId=/subscriptions/<your subscription ID>/resourceGroups/<your resource group name>/providers/Microsoft.Storage/storageAccounts/<your storage account name>/;" }
Bu bağlantı dizesi hesap anahtarı gerektirmez, ancak daha önce yönetilen kimlik kullanarak bağlanmak için bir arama hizmeti yapılandırmış olmanız gerekir.
Depolama hesabı paylaşılan erişim imzası (SAS) bağlantı dizesi
{ "connectionString" : "BlobEndpoint=https://<your account>.blob.core.windows.net/;SharedAccessSignature=?sv=2016-05-31&sig=<the signature>&spr=https&se=<the validity end time>&srt=co&ss=b&sp=rl;" }
SAS, kapsayıcılar ve nesneler (bu örnekte bloblar) üzerinde liste ve okuma izinlerine sahip olmalıdır.
Kapsayıcı paylaşılan erişim imzası
{ "connectionString" : "ContainerSharedAccessUri=https://<your storage account>.blob.core.windows.net/<container name>?sv=2016-05-31&sr=c&sig=<the signature>&se=<the validity end time>&sp=rl;" }
SAS,kapsayıcı üzerinde liste ve okuma izinlerine sahip olmalıdır. Daha fazla bilgi için bkz . Paylaşılan erişim imzalarını (SAS) kullanarak Azure Depolama kaynaklarına sınırlı erişim verme.

Uyarı

SAS kimlik bilgilerini kullanıyorsanız, sürelerinin dolmasını önlemek için veri kaynağı kimlik bilgilerini düzenli aralıklarla yenilenen imzalarla güncelleştirmeniz gerekir. SAS kimlik bilgilerinin süresi dolarsa, dizin oluşturucu "Bağlantı dizesinde sağlanan kimlik bilgileri geçersiz veya süresi dolmuş" gibi bir hata iletisiyle başarısız olur.

Dizine arama alanları ekleme

Arama dizininde, Azure bloblarınızın içeriğini ve meta verilerini kabul etmek için alanlar ekleyin.

  1. Blob içeriğini ve meta verilerini depolayan arama alanlarını tanımlamak için dizin oluşturun veya güncelleştirin:

    POST https://[service name].search.windows.net/indexes?api-version=2026-04-01
{
    "name" : "my-search-index",
    "fields": [
        { "name": "ID", "type": "Edm.String", "key": true, "searchable": false },
        { "name": "content", "type": "Edm.String", "searchable": true, "filterable": false },
        { "name": "metadata_storage_name", "type": "Edm.String", "searchable": false, "filterable": true, "sortable": true  },
        { "name": "metadata_storage_size", "type": "Edm.Int64", "searchable": false, "filterable": true, "sortable": true  },
        { "name": "metadata_storage_content_type", "type": "Edm.String", "searchable": false, "filterable": true, "sortable": true },        
    ]
}

  2. Belge anahtarı alanı ("key": true) oluşturun. Blob içeriği için en iyi adaylar meta veri özellikleridir.

    • metadata_storage_path (varsayılan), nesnenin veya dosyanın tam yoludur. Anahtar alanı (ID bu örnekte) varsayılan olduğundan metadata_storage_path değerleriyle doldurulur.

    • metadata_storage_name yalnızca adlar benzersizse kullanılabilir. Bu alanın anahtar olarak olmasını istiyorsanız, bu alan tanımına gidin "key": true .

    • Bloblara eklediğiniz özel meta veri özelliği. Bu seçenek, blob karşıya yükleme işleminizin bu meta veri özelliğini tüm bloblara eklemesini gerektirir. Anahtar gerekli bir özellik olduğundan, değeri eksik olan tüm bloblar dizine alınamaz. Anahtar olarak özel meta veri özelliği kullanıyorsanız, bu özellikte değişiklik yapmaktan kaçının. Anahtar özelliği değişirse dizin oluşturucular aynı blob için yinelenen belgeler ekler.

    Meta veri özellikleri genellikle belge anahtarları için geçersiz olan / ve - gibi karakterleri içerir. Ancak dizin oluşturucu, yapılandırma veya alan eşlemesi gerektirmeden anahtar meta veri özelliğini otomatik olarak kodlar.

  3. Blob'un content özelliği aracılığıyla her dosyadan ayıklanan metni depolamak için bir content alan ekleyin. Bu adı kullanmanız gerekmez, ancak bu adı kullanarak örtük alan eşlemelerinden yararlanabilirsiniz.

  4. Standart meta veri özellikleri için alanlar ekleyin. Dizin oluşturucu özel meta veri özelliklerini, standart meta veri özelliklerini ve içeriğe özgü meta veri özelliklerini okuyabilir.

Blob dizin oluşturucusunu yapılandırma ve çalıştırma

Dizini ve veri kaynağını oluşturduktan sonra dizin oluşturucuyu oluşturun. Dizin oluşturucu yapılandırması, çalışma zamanı davranışlarını denetleen girişleri, parametreleri ve özellikleri belirtir. Bir blobun hangi bölümlerinin dizine ekleneceğini de belirtebilirsiniz.

  1. Dizin oluşturucuya bir ad verip veri kaynağına ve hedef dizine başvurarak dizin oluşturucu oluşturun veya güncelleştirin:

    POST https://[service name].search.windows.net/indexers?api-version=2026-04-01
{
  "name" : "my-blob-indexer",
  "dataSourceName" : "my-blob-datasource",
  "targetIndexName" : "my-search-index",
  "parameters": {
      "batchSize": null,
      "maxFailedItems": null,
      "maxFailedItemsPerBatch": null,
      "configuration": {
          "indexedFileNameExtensions" : ".pdf,.docx",
          "excludedFileNameExtensions" : ".png,.jpeg",
          "dataToExtract": "contentAndMetadata",
          "parsingMode": "default"
      }
  },
  "schedule" : { },
  "fieldMappings" : [ ]
}

  2. Varsayılan (10 belge) kullanılabilir kaynakları az kullandığında veya bunaltılmasına neden olduğunda batchSize değerini ayarlayın. Varsayılan toplu iş boyutları veri kaynağına özeldir. Blob dizin oluşturma, daha büyük ortalama belge boyutunu dikkate alarak toplu iş boyutunu 10 belge olarak ayarlar.

  3. altında configuration, hangi blobların dosya türüne göre dizinlendiğini kontrol edin veya tüm blobları almak için belirtilmemiş bırakın.

    için indexedFileNameExtensions, dosya uzantılarının virgülle ayrılmış bir listesini sağlayın (baştaki noktayla). Dizin oluşturucunun atladığı uzantıları belirtmek için excludedFileNameExtensions de aynısını yapın. Aynı uzantı her iki listede de yer alırsa, dizin oluşturucu bunu dizin oluşturmanın dışında tutar.

  4. configuration altında, blobların hangi bölümlerinin dizine ekleneceğini denetlemek için dataToExtract ayarlayın.

  5. configuration öğesinin altında, parsingMode değerini ayarlayın. Varsayılan ayrıştırma modu blob başına bir arama belgesidir. Bloblar düz metinse, düz metin ayrıştırmaya geçerek daha iyi performans elde edebilirsiniz. Blobları birden çok arama belgesine eşleyen daha ayrıntılı ayrıştırmaya ihtiyacınız varsa farklı bir mod belirtin. Aşağıdakilerden oluşan bloblar için bire çok ayrıştırma desteklenir:

  6. Alan adında veya türünde farklılıklar varsa veya arama dizininde bir kaynak alanın birden çok sürümüne ihtiyacınız varsa alan eşlemelerini belirtin.

    Blob dizinlemede, dizinleyicinin content ve meta veri özelliklerini dizindeki benzer isim ve türdeki alanlara eşlemek için yerleşik desteği bulunduğundan, alan eşlemelerini çoğu zaman atlayabilirsiniz. Meta veri özellikleri için dizin oluşturucu, kısa çizgileri - otomatik olarak arama dizinindeki alt çizgilerle değiştirir.

  7. Diğer özellikler hakkında daha fazla bilgi için Dizin Oluşturucu Oluştur'a bakın. Parametre açıklamalarının tam listesi için bkz . REST API.

Dizin oluşturucu oluşturulduğunda otomatik olarak çalışır. True olarak ayarlayarak disabled bu eylemi engelleyebilirsiniz. Dizin oluşturucu yürütmesini denetlemek için isteğe bağlı olarak bir dizin oluşturucu çalıştırın veya zamanlamaya yerleştirin.

Birden çok Azure Blob kapsayıcısından tek bir dizine veri dizini oluşturma

Dizin oluşturucuların yalnızca tek bir kapsayıcıdan veri dizini oluşturabildiğini unutmayın. Birden çok kapsayıcıdaki verileri dizine almanız ve tek bir AI Search dizininde birleştirmeniz gerekiyorsa, tümü aynı dizine işaret eden birden çok dizin oluşturucu yapılandırın. SKU başına kullanılabilir dizin oluşturucu sayısı üst sınırına dikkat edin.

Örneğin, my-blob-datasource1 ve my-blob-datasource2 adlı iki ayrı veri kaynağından veri çekmek için iki dizin oluşturucu kullanabilirsiniz. Her veri kaynağı ayrı bir Azure Blob kapsayıcısını gösterir, ancak her ikisi de adlı my-search-indexaynı dizine yönlendirir.

İlk dizin oluşturucu tanımı örneği:

POST https://[service name].search.windows.net/indexers?api-version=2026-04-01
{
  "name" : "my-blob-indexer1",
  "dataSourceName" : "my-blob-datasource1",
  "targetIndexName" : "my-search-index",
  "parameters": {
      "batchSize": null,
      "maxFailedItems": null,
      "maxFailedItemsPerBatch": null,
      "configuration": {
          "indexedFileNameExtensions" : ".pdf,.docx",
          "excludedFileNameExtensions" : ".png,.jpeg",
          "dataToExtract": "contentAndMetadata",
          "parsingMode": "default"
      }
  },
  "schedule" : { },
  "fieldMappings" : [ ]
}

Paralel örnekte çalışan ikinci dizin oluşturucu tanımı:

POST https://[service name].search.windows.net/indexers?api-version=2026-04-01
{
  "name" : "my-blob-indexer2",
  "dataSourceName" : "my-blob-datasource2",
  "targetIndexName" : "my-search-index",
  "parameters": {
      "batchSize": null,
      "maxFailedItems": null,
      "maxFailedItemsPerBatch": null,
      "configuration": {
          "indexedFileNameExtensions" : ".pdf,.docx",
          "excludedFileNameExtensions" : ".png,.jpeg",
          "dataToExtract": "contentAndMetadata",
          "parsingMode": "default"
      }
  },
  "schedule" : { },
  "fieldMappings" : [ ]
}

Dizin oluşturucu durumunu denetle

Dizin oluşturucu durumunu ve yürütme geçmişini izlemek için Dizin Oluşturucu Durumunu Al isteği gönderin.

GET https://myservice.search.windows.net/indexers/myindexer/status?api-version=2026-04-01
  Content-Type: application/json  
  api-key: [admin key]

Yanıt, durumu ve işlenen öğe sayısını içerir. Aşağıdaki örneğe benzer görünmelidir:

    {
        "status":"running",
        "lastResult": {
            "status":"success",
            "errorMessage":null,
            "startTime":"2022-02-21T00:23:24.957Z",
            "endTime":"2022-02-21T00:36:47.752Z",
            "errors":[],
            "itemsProcessed":1599501,
            "itemsFailed":0,
            "initialTrackingState":null,
            "finalTrackingState":null
        },
        "executionHistory":
        [
            {
                "status":"success",
                "errorMessage":null,
                "startTime":"2022-02-21T00:23:24.957Z",
                "endTime":"2022-02-21T00:36:47.752Z",
                "errors":[],
                "itemsProcessed":1599501,
                "itemsFailed":0,
                "initialTrackingState":null,
                "finalTrackingState":null
            },
            ... earlier history items
        ]
    }

Yürütme geçmişi, en son tamamlanan yürütmelerin en fazla 50'sini içerir. Kayıtlar ters kronolojik sırayla sıralandığından en son işlem önce gelir.

Sorun giderme

Eksik meta veri değerlerini ve yaygın blob dizin oluşturma hatalarını tanılamak için bu bölümü kullanın.

Arama sonuçlarında meta veri alanları null

Arama sonuçlarınızda meta veri alanları için null veya boş değerler görüyorsanız şu denetim listesini kullanın:

  1. Alanın dizin şemanızda mevcut olduğunu doğrulayın: Yakalamak istediğiniz her meta veri özelliği için bir alan tanımladığınızdan denetleyin. Alanın mevcut olduğunu onaylamak için dizininizde bir GET isteği çalıştırın.

  2. Doğru alan adını kullanın: Standart blob özellikleri için, metadata_storage_path yerine metadata-storage-path gibi alt çizgili adı kullanın. Özel meta veriler için alan adının blob'un meta veri anahtarıyla tam olarak eşleşmesi gerekir.

  3. Dizin oluşturucunun doğru ayarlandığını dataToExtract onaylayın:

    • contentAndMetadata (varsayılan) hem içeriği hem de standart/özel meta verileri ayıklar.
    • storageMetadata yalnızca standart blob özelliklerini ve özel meta verileri ayıklar.
    • allMetadata standart özelliklerin yanı sıra içeriğe özgü meta verileri ayıklar.

    Ayarın amacınızla eşleştiğinden emin olmak için dizin oluşturucu yapılandırmanızı denetleyin.

  4. Şema güncelleştirmelerinin ardından dizin oluşturucuyu yeniden çalıştırın: Dizininize yeni bir alan eklediyseniz, belgelerin güncelleştirilmiş şemaya göre işlenmesi için dizin oluşturucuyu yeniden çalıştırın. Yeni alan doldurulmadan önce mevcut belgelerin yeniden işlenmesi gerekebilir.

  5. Dizin oluşturucu yürütme geçmişini denetleyin: Azure portalında dizin oluşturucunuza gidin veya yürütme ayrıntılarını ve hata iletilerini görüntülemek için Dizin Oluşturucu Durumunu Al 'ı (REST API) kullanın.

Dizin oluşturucu hataları ve desteklenmeyen içerik türleri

Varsayılan olarak, blob dizin oluşturucu, ses dosyası gibi desteklenmeyen içerik türüne sahip bir blobla karşılaştığında durur. Parametresini excludedFileNameExtensions kullanarak belirli içerik türlerini atlayabilirsiniz.

Bazı belgeler başarısız olduğunda dizin oluşturma işleminin devam etmesi istiyorsanız, aşağıdaki parametreleri ayarlayın ve daha sonra tek tek belgeleri araştırın. Daha fazla bilgi için bkz . Dizin oluşturucu sorun giderme kılavuzu ve Dizin oluşturucu hataları ve uyarıları.

Hatalar oluştuğunda, dizin oluşturucunun yanıtını beş dizin oluşturucu parametresi denetler:

PUT /indexers/[indexer name]?api-version=2026-04-01
{
  "parameters" : { 
    "maxFailedItems" : 10, 
    "maxFailedItemsPerBatch" : 10,
    "configuration" : { 
        "failOnUnsupportedContentType" : false, 
        "failOnUnprocessableDocument" : false,
        "indexStorageMetadataOnlyForOversizedDocuments": false
      }
    }
}
Parametre Geçerli değerler Description
maxFailedItems -1, null veya 0, pozitif tamsayı Blobları ayrıştırırken veya dizine belge eklerken herhangi bir işlem noktasında hata oluşursa dizine eklemeye devam edin. Bu özelliği kabul edilebilir hata sayısına ayarlayın. değeri -1 , kaç hata olursa olsun işlemeye izin verir. Aksi takdirde, değer pozitif bir tamsayıdır.
maxFailedItemsPerBatch -1, null veya 0, pozitif tamsayı Yukarıdakiyle aynıdır, ancak toplu dizin oluşturma için kullanılır.
failOnUnsupportedContentType doğru veya yanlış Dizin oluşturucu içerik türünü belirleyemezse, işe devam etmek mi yoksa başarısız mı olmak istediğinizi belirtin.
failOnUnprocessableDocument doğru veya yanlış Dizin oluşturucu, başka bir şekilde desteklenen içerik türündeki bir belgeyi işleyemiyorsa, işe devam edilip edilmeyeceğini veya başarısız olup olmayacağını belirtin.
indexStorageMetadataOnlyForOversizedDocuments doğru veya yanlış Aşırı büyük bloblar varsayılan olarak hata olarak değerlendirilir. Bu parametreyi true olarak ayarlarsanız, dizin oluşturucu içerik dizine alınamıyor olsa bile meta verilerini dizine almaya çalışır. Blob boyutuyla ilgili sınırlar için bkz. Hizmet sınırları.

İlgili içerik

  • Last updated on