Azure Blob Depolama içeriğinde arama yapma

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.

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.

Azure Blob Depolama depolanan çeşitli içerik türlerini aramak zor bir sorun olabilir, ancak Azure Yapay Zeka Arama içerik katmanında derin tümleştirme sağlar, metin bilgilerini ayıklar ve çıkarır ve daha sonra arama dizininde sorgulanabilir.

Bu makalede, bloblardan içerik ve meta verileri ayıklamak ve Azure Yapay Zeka Arama'te bir arama dizinine göndermek için temel iş akışını gözden geçirin. Sonuçta elde edilen dizin, tam metin araması veya vektör araması kullanılarak sorgulanabilir. İsteğe bağlı olarak, arama dışı senaryolar için bir bilgi deposuna işlenmiş blob içeriği gönderebilirsiniz.

Not

İş akışı ve oluşturma hakkında bilgi sahibi misiniz? Sonraki adımınız blob dizin oluşturucu yapılandırmadır.

Blob verileri üzerinde arama eklemek ne anlama gelir?

Azure Yapay Zeka Arama, bulutta barındırılan özel aranabilir içeriğinizi içeren kullanıcı tanımlı dizinler üzerinden dizin oluşturmayı ve iş yüklerini sorgulamayı destekleyen tek başına bir arama hizmetidir. Arama yapılabilir içeriğinizi bulutta sorgu motoruyla eşzamanlı yerleştirmek, performans için gereklidir; bu, sonuçları kullanıcıların arama sorgularından beklediği hızda döndürmeye yardımcı olur.

Azure Yapay Zeka Arama, dizin oluşturma katmanındaki Azure Blob Depolama ile tümleştirilir ve blob içeriğinizi ters dizinlere ve serbest biçimli metin sorgularını, vektör sorgularını ve filtre ifadelerini destekleyen diğer sorgu yapılarına dizinlenmiş arama belgeleri olarak içeri aktarır. Blob içeriğiniz bir arama dizininde dizine alındığından, blob içeriğinizdeki bilgileri bulmak için Azure Yapay Zeka Arama'teki tüm sorgu özelliklerini kullanabilirsiniz.

Azure Blob Depolama'daki tek bir kapsayıcı içinde bulunan bloblar, sizin girişlerinizdir. Bloblar neredeyse her tür metin verisi olabilir. Bloblarınız görüntü içeriyorsa, AI zenginleştirmesi ekleyerek görüntülerden metin ve özellikler oluşturup ayıklayabilirsiniz.

Çıktı her zaman istemci uygulamalarında hızlı metin araması, alma ve araştırma için kullanılan bir Azure Yapay Zeka Arama dizinidir. arasında, dizin oluşturma işlem hattı mimarisinin kendisidir. İşlem hattı, bu makalede daha ayrıntılı olarak ele alınan dizin oluşturucu özelliğini temel alır.

Dizin oluşturulduktan ve doldurulduktan sonra blob kapsayıcınızdan bağımsız olarak bulunur, ancak değiştirilen belgelere göre dizininizi yenilemek için dizin oluşturma işlemlerini yeniden çalıştırabilirsiniz. Değişiklik algılama için tek tek bloblardaki zaman damgası bilgileri kullanılır. Yenileme mekanizması olarak zamanlanmış yürütmeyi veya isteğe bağlı dizin oluşturmayı tercih edebilirsiniz.

Blob arama çözümünde kullanılan kaynaklar

Azure Yapay Zeka Arama, Azure Blob Depolama ve bir istemci gerekir. Azure Yapay Zeka Arama genellikle uygulama kodunuzun sorgu API'sinin isteklerini verdiği ve yanıtı işlediği bir çözümdeki çeşitli bileşenlerden biridir. Dizin oluşturmayı yönetmek için uygulama kodu da yazabilirsiniz, ancak kavram kanıtı testi ve anlık görevler için Azure Portalı'nı arama istemcisi olarak kullanmak yaygındır.

Blob Depolama'da kaynak içerik sağlayan bir kapsayıcıya ihtiyacınız vardır. Dosya ekleme ve dışlama ölçütlerini ayarlayabilir ve Azure Yapay Zeka Arama'te bir blobun hangi bölümlerinin dizine ekleneceğini belirtebilirsiniz.

Doğrudan Depolama Hesabı portalı sayfanızdan başlayabilirsiniz.

  1. Sol gezinti sayfasında Veri yönetimi'nin altında Azure AI Arama'yı seçerek bir arama hizmeti seçin veya oluşturun.

  2. Bloblarınızdaki aranabilir içeriği ayıklamak ve isteğe bağlı olarak oluşturmak için içeri aktarma sihirbazını kullanın. İş akışı, Azure Yapay Zeka Arama hizmetinizde bir dizin oluşturucu, veri kaynağı, dizin ve isteğe bağlı beceri kümesi oluşturur.

    Azure Depolama portalı sayfasındaki Azure AI Arama sihirbazının ekran görüntüsü.

  3. İçeriğinizi sorgulamak için arama portalı sayfasındaki Arama gezginini kullanın.

Başlamak için en iyi yer sihirbazdır, ancak blob dizin oluşturucuyu kendiniz yapılandırırken daha esnek seçenekler keşfedeceksiniz. REST istemcisi kullanabilirsiniz. Öğretici: Yarı yapılandırılmış verileri (JSON blobları) dizine alma ve arama, REST API'yi çağırma adımlarında size yol gösterir.

Blobların dizini nasıl oluşturulur?

Varsayılan olarak çoğu blob, tek bir metin öbeği olarak dizine alınan JSON veya CSV gibi yapılandırılmış içeriğe sahip bloblar da dahil olmak üzere dizinde tek bir arama belgesi olarak dizine alınır. Ancak iç yapısı (sınırlayıcılar) olan JSON veya CSV belgeleri için ayrıştırma modları atayarak her satır veya öğe için ayrıştırma belgeleri 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.

Belgenin metin içeriği "content" adlı bir dize alanına ayıklanır. Standart ve kullanıcı tanımlı meta verileri de ayıklayabilirsiniz.

Not

Azure Yapay Zeka Arama, fiyatlandırma katmanına bağlı olarak ayıklanan metin miktarına dizin oluşturucu sınırları uygular. Belgeler kesilirse dizin oluşturucu durum yanıtında bir uyarı görüntülenir.

İçerik ayıklama için blob dizin oluşturucu kullanma

Dizin oluşturucu, Azure Yapay Zeka Arama içerisinde, veri örneklemesi yapma, verileri ve meta verileri okuma ile alma ve yerel biçimlerden JSON belgelerine dönüştürme gibi işlemler için içsel mantığa sahip, veri kaynaklarını tanıyan bir alt hizmettir.

Azure Depolama'daki bloblar, blob dizin oluşturucu kullanılarak dizinlenir. Bu dizin oluşturucuyu Azure Depolama'daki Azure Yapay Zeka Arama komutunu, Azure portalındaki Verileri içeri aktarma sihirbazını , REST API'yi veya .NET SDK'sını kullanarak çağırabilirsiniz. Kodda bu dizin oluşturucuyu türü ayarlayarak ve bir blob kapsayıcısıyla birlikte Azure Depolama hesabı içeren bağlantı bilgilerini sağlayarak kullanırsınız. Daha sonra parametre olarak geçirebileceğiniz bir sanal dizin oluşturarak veya dosya türü uzantısını filtreleyerek bloblarınızı alt kümeleyebilirsiniz.

Dizin oluşturucu, içeriği incelemek için bir blob açarak "belgeyi analiz ediyor". Veri kaynağına bağlandıktan sonra işlem hattındaki ilk adımdır. Blob verileri için pdf, Office belgeleri ve diğer içerik türleri burada algılanır. Metin ayıklama yoluyla belgeye erişim ücretsizdir. Bloblarınız görüntü içeriği içeriyorsa, yapay zeka zenginleştirmesi eklemediğiniz takdirde görüntüler yoksayılır. Standart dizin oluşturma yalnızca metin içeriği için geçerlidir.

Azure blob dizin oluşturucu yapılandırma parametreleriyle birlikte gelir ve temel alınan veriler yeterli bilgi sağlıyorsa değişiklik izlemeyi destekler. Azure Blob Depolama verileri dizine alma bölümünde temel işlevler hakkında daha fazla bilgi edinebilirsiniz.

Desteklenen erişim katmanları

Blob depolama 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.

Desteklenen içerik türleri

Kapsayıcı üzerinde blob dizin oluşturucu çalıştırarak, tek bir sorguyla aşağıdaki içerik türlerinden metin ve meta verileri ayıklayabilirsiniz:

  • 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 alınan blobları denetleme

Blobların hangi dosya türüne göre dizine ekleneceğini ve hangilerinin atlanacağını kontrol edebilir, veya blobların kendilerinde özellikler ayarlayarak dizin oluşturucunun bunları atlamasını sağlayabilirsiniz.

Belirli dosya uzantılarını, virgülle ayrılmış dosya uzantıları listesine ayarlayarak "indexedFileNameExtensions" (baştaki noktayla) ekleyin. Belirli dosya uzantılarını hariç tutmak için, atlanacak uzantıları "excludedFileNameExtensions" olarak ayarlayın. Aynı uzantı her iki listede de yer alırsa dizin oluşturmanın dışında tutulur.

PUT /indexers/[indexer name]?api-version=2026-04-01
{
    "parameters" : { 
        "configuration" : { 
            "indexedFileNameExtensions" : ".pdf, .docx",
            "excludedFileNameExtensions" : ".png, .jpeg" 
        } 
    }
}

Bloğa "atla" meta verisini ekle

Dizin oluşturucu yapılandırma parametreleri kapsayıcıdaki veya klasördeki tüm bloblara uygulanır. Bazen tek tek blobların nasıl dizine eklendiğini denetlemek istersiniz.

Blob Depolama'daki bloblara aşağıdaki meta veri özelliklerini ve değerlerini ekleyin. Dizin oluşturucu bu özellikle karşılaştığında, dizin oluşturma çalıştırmasında blobu veya içeriğini atlar.

Özellik adı Özellik değeri Açıklama
AzureSearch_Skip "true" Blob dizin oluşturucusunun blobu tamamen atlamasını sağlar. Ne meta veriler ne de içerik ayıklama deneniyor. Bu, 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" Bu, "dataToExtract": "allMetadata" açıklanan ayara eşdeğerdir ancak kapsamı yalnızca belirli bir blobla belirlenmiştir.

Blob meta verilerini dizinleme

Herhangi bir içerik türünde bloblar arasında sıralamayı kolaylaştıran yaygın bir senaryo, her blob için hem özel meta verileri hem de sistem özelliklerini dizine almaktır. Bu şekilde, arama hizmetinizdeki bir dizinde depolanan belge türü ne olursa olsun tüm bloblar için bilgiler dizine eklenir. Yeni dizininizi kullanarak tüm Blob depolama içeriğinde sıralama, filtreleme ve model oluşturma işlemlerine devam edebilirsiniz.

Not

Blob Dizini etiketleri, Blob depolama hizmeti tarafından yerel olarak dizinlenir ve sorgulama için kullanıma sunulur. Bloblarınızın anahtar/değer öznitelikleri dizin oluşturma ve filtreleme özellikleri gerektiriyorsa, meta veriler yerine Blob Dizini etiketleri kullanılmalıdır.

Blob Dizini hakkında daha fazla bilgi edinmek için bkz. Blob Dizini ile Azure Blob Depolama verilerini yönetme ve bulma.

Arama dizininde blob içeriği arama

Dizin oluşturucunun çıktısı, istemci uygulamasında serbest metin ve filtrelenmiş sorgular kullanılarak etkileşimli araştırma için kullanılan bir arama dizinidir. İçeriğin ilk keşfi ve doğrulaması için, belge yapısını incelemek için Azure portalında Arama Gezgini ile başlamanızı öneririz. Arama gezgini'nde şunları kullanabilirsiniz:

Daha kalıcı bir çözüm, sorgu girişlerini toplamak ve yanıtı bir istemci uygulamasında arama sonuçları olarak sunmaktır.

Sonraki adımlar

  • Son güncelleştirme: