Aracılığıyla paylaş

Hızlı Başlangıç: Azure portalında arama dizini oluşturma

Önemli

Verileri içeri aktarma (yeni) sihirbazı artık daha önce yalnızca Verileri içeri aktarma sihirbazında kullanılabilen anahtar sözcük aramasını destekliyor. Geliştirilmiş bir arama deneyimi için yeni sihirbazı öneririz. Sihirbazları nasıl birleştirdiğimiz hakkında daha fazla bilgi için bkz. Azure portalında veri içeri aktarma sihirbazları.

Bu hızlı başlangıçta, ilk arama dizininizi oluşturmak için Verileri içeri aktarma (yeni) sihirbazını ve kurgusal oteller hakkındaki örnek verileri kullanacaksınız. Sihirbaz, dizin oluşturmak için kod gerektirmez ve dakikalar içinde ilginç sorgular yazmanıza yardımcı olur.

Sihirbaz, arama hizmetinizde aranabilir dizin, dizin oluşturucu ve otomatik veri alma için bir veri kaynağı bağlantısı dahil olmak üzere birden çok nesne oluşturur. Bu hızlı başlangıcın sonunda her nesneyi gözden geçireceksiniz.

Önkoşullar

  • Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.

  • Azure AI Arama hizmeti. Geçerli aboneliğinizde bir hizmet oluşturun veya mevcut bir hizmeti bulun. Bu hızlı başlangıç için ücretsiz bir hizmet kullanabilirsiniz.

  • Bir Azure Depolama hesabı. Standart performans (genel amaçlı v2) hesabında Azure Blob Depolama veya Azure Data Lake Storage 2. Nesil'i (hiyerarşik ad alanına sahip depolama hesabı) kullanın. Bant genişliği ücretlerinden kaçınmak için Azure AI Search ile aynı bölgeyi kullanın.

Ağ erişimini denetleme

Bu hızlı başlangıçta, Azure portal düğümlerinin bunlara erişebilmesi için önceki tüm kaynakların genel erişimi etkinleştirilmelidir. Aksi takdirde sihirbaz başarısız olur. Sihirbaz çalıştırıldıktan sonra, güvenlik için tümleştirme bileşenlerinde güvenlik duvarlarını ve özel uç noktaları etkinleştirebilirsiniz. Daha fazla bilgi için bkz . İçeri aktarma sihirbazlarında güvenli bağlantılar.

Alan denetleme

Birçok müşteri üç dizin, üç dizin oluşturucu ve üç veri kaynağıyla sınırlı olan ücretsiz bir arama hizmetiyle başlar. Bu hızlı başlangıçta her birinden bir tane oluşturulur, bu nedenle başlamadan önce ek nesneler için yer açtığınızdan emin olun.

Şu anda sahip olduğunuz dizin, dizin oluşturucu ve veri kaynağı sayısını görmek için Genel Bakış sayfasında Kullanım'ı seçin.

Azure portalında dizinlerin, dizin oluşturucuların ve veri kaynaklarının sayısını gösteren Azure yapay zeka Arama hizmeti örneğine yönelik Genel Bakış sayfasının ekran görüntüsü.

Örnek verileri hazırlama

Bu hızlı başlangıçta 50 kurgusal otel için meta veriler içeren bir JSON belgesi kullanılır, ancak kendi dosyalarınızı da kullanabilirsiniz.

Bu hızlı başlangıç için örnek verileri hazırlamak için:

  1. Örnek JSON belgesini indirin.

  2. Azure portalında oturum açın ve Azure Depolama hesabınızı seçin.

  3. Sol bölmeden Veri depolama>Kapsayıcıları'nı seçin.

  4. hotels-sample adlı bir kapsayıcı oluşturun.

  5. HotelsData_toAzureBlobs.json dosyasını kapsayıcıya yükleyin.

Sihirbazı başlatma

Bu hızlı başlatma sihirbazını başlatmak için:

  1. Azure portalında oturum açın ve arama hizmetinizi seçin.

  2. Genel Bakış sayfasında Verileri içeri aktar (yeni) öğesini seçin.

    Azure portalında yeni içeri aktarma sihirbazının nasıl açılacağını gösteren ekran görüntüsü.

  3. Veri kaynağınızı seçin: Azure Blob Depolama veya Azure Data Lake Storage 2. Nesil.

    Sihirbazda veri kaynağı seçme seçeneklerinin ekran görüntüsü.

  4. Anahtar sözcük arama'yı seçin.

    Azure portalındaki anahtar sözcük arama kutucuğunun ekran görüntüsü.

Arama dizini oluşturma ve yükleme

Bu bölümde, beş adımda bir dizin oluşturup yükleyebilirsiniz.

Veri kaynağına bağlanma

Azure AI Search, içerik alımı ve dizin oluşturma için bir veri kaynağına bağlantı gerektirir. Bu durumda veri kaynağı, Azure Depolama hesabınızdır.

Örnek verilere bağlanmak için:

  1. Verilerinize bağlanın sayfasında Azure aboneliğinizi seçin.

  2. Depolama hesabınızı ve ardından hotels-sample kapsayıcısını seçin.

  3. Ayrıştırma modu için JSON dizisi'ni seçin.

    Azure portalında Verilerinize bağlanın sayfasının ekran görüntüsü.

  4. sonrakiseçin.

Beceriler için yapılandırmayı geç

Sihirbaz, dizin oluşturma sırasında beceri kümesi oluşturmayı ve yapay zeka zenginleştirmesini destekler ve bu da bu hızlı başlangıcın kapsamının dışındadır. İleri'yi seçerek bu adımı atlayın.

İpucu

Yapay zeka zenginleştirmesine odaklanan benzer bir kılavuz için bkz . Hızlı Başlangıç: Azure portalında beceri kümesi oluşturma.

Dizini yapılandırma

Örnek otel verilerinin yapısına ve içeriğine bağlı olarak sihirbaz, arama dizininiz için bir şema çıkartır.

Dizini yapılandırmak için:

  1. Aşağıdaki alanların her biri için Alanı yapılandır'ı seçin ve ilgili öznitelikleri ayarlayın.

    Fields Attributes
    HotelId Anahtar, Alınabilir, Filtrelenebilir, Sıralanabilir, Aranabilir
    HotelName, Category Alınabilir, Filtrelenebilir, Sıralanabilir, Aranabilir
    Description, Description_fr Alınabilir, Aranabilir
    Tags Alınabilir, Filtrelenebilir, Aranabilir
    ParkingIncluded, IsDeleted, Location Alınabilir, Filtrelenebilir, Yüzeylenebilir
    LastRenovationDate, Rating Alınabilir, Filtrelenebilir, Sıralanabilir
    Address.StreetAddress, Rooms.Description, Rooms.Description_fr Alınabilir, Aranabilir
    Address.City, Address.StateProvince, Address.PostalCode, Address.Country Alınabilir, Filtrelenebilir, Modellenebilir, Aranabilir, Sıralanabilir
    Rooms.Type, Rooms.BedOptions, Rooms.Tags Alınabilir, Filtrelenebilir, Yüzeylenebilir, Aranabilir
    Rooms.BaseRate, Rooms.SleepsCount, Rooms.SmokingAllowed Alınabilir, Filtrelenebilir, Yüzeylenebilir

    Dizindeki alanlar için özniteliklerin nasıl yapılandırıldığını gösteren GIF.

  2. sonrakiseçin.

Dizin için en azından bir ad ve alan koleksiyonu gerekir. Sihirbaz benzersiz dize alanlarını tarar ve belge anahtarı olarak birini işaretler ve bu anahtar dizindeki her belgeyi benzersiz olarak tanımlar.

Her alanın dizinde nasıl kullanıldığını denetleen bir adı, veri türü ve öznitelikleri vardır. Aşağıdaki öznitelikleri etkinleştirebilir veya devre dışı bırakabilirsiniz:

Özellik Açıklama Geçerli veri türleri
Alınabilir Sorguya verilen yanıt içerisindeki alanlar. Dizeler ve tamsayılar
Filtrelenebilir Filtre ifadesini kabul eden alanlar. Dizeler ve tamsayılar
Sıralanabilir Orderby ifadesini kabul eden alanlar. Dizeler ve tamsayılar
Modellenebilir Fasetli gezinme yapısında kullanılan alanlar. Dizeler ve tamsayılar
Aranabilir Tam metin aramasında kullanılan alanlar. Dizeler aranabilir, ancak sayısal ve Boole alanları genellikle aranamaz olarak işaretlenir. Dize

Öznitelikler depolamayı farklı şekillerde etkiler. Örneğin, filtrelenebilir alanlar daha fazla depolama alanı tüketirken, erişilebilir alanlar tüketmez. Öznitelikler ve veri türleri hakkında daha fazla bilgi için bkz. Alan tanımlarını yapılandırma.

Otomatik tamamlama veya önerilen sorgular istiyorsanız Önericiler'i belirtin.

Gelişmiş ayarları atla

Sihirbaz, bu hızlı başlangıcın kapsamı dışında olan anlamsal derecelendirme ve dizin zamanlaması için gelişmiş ayarlar sunar. İleri'yi seçerek bu adımı atlayın.

Nesneleri gözden geçirme ve oluşturma

Son adım, yapılandırmanızı gözden geçirmek ve arama hizmetinizde dizin, dizin oluşturucu ve veri kaynağı oluşturmaktır. Dizin oluşturucu, veri kaynağınızdan içerik ayıklama ve dizine yükleme işlemini otomatikleştirerek anahtar sözcük aramasını etkinleştirir.

Nesneleri gözden geçirmek ve oluşturmak için:

  1. Nesne adı ön ekini hotels-sample olarak değiştirin.

  2. Nesne yapılandırmalarını gözden geçirin.

    Azure portalındaki nesne yapılandırma sayfasının ekran görüntüsü.

    Yapay zeka zenginleştirmesi, anlam dereceleyicisi ve dizin oluşturucu zamanlaması devre dışı bırakılır veya sihirbaz adımlarını atladığınız için varsayılan değerlerine ayarlanır.

  3. Nesneleri aynı anda oluşturmak ve dizin oluşturucuyu çalıştırmak için Oluştur'u seçin.

Dizin oluşturucu ilerleme durumunu izleme

Dizin oluşturucunun ve dizinin oluşturulmasını Azure portalında izleyebilirsiniz. Genel Bakış sayfası, arama hizmetinizde oluşturulan nesnelerin bağlantılarını sağlar.

Dizin oluşturucunun ilerleme durumunu izlemek için:

  1. Sol bölmeden Dizinleyiciler'i seçin.

  2. Listede hotels-sample-indexer öğesini bulun.

    Azure portalında devam eden dizin oluşturucunun oluşturulmasını gösteren ekran görüntüsü.

    Sonuçların güncelleştirilmiş olması birkaç dakika sürebilir. Yeni oluşturulmuş dizin oluşturucunun, Devam ediyor veya Başarılı durumunda olduğunu görmelisiniz. Listede ayrıca dizine alınan belge sayısı da gösterilir.

Arama dizini sonuçlarını denetleme

  1. Sol bölmeden Dizinler'i seçin.

  2. hotels-sample-index öğesini seçin. Dizinde sıfır belge veya depolama alanı varsa Azure portalının yenilenmesini bekleyin.

    Azure portalındaki Azure AI Search hizmeti panosundaki Dizinler listesinin ekran görüntüsü.

  3. Dizin şemasını görüntülemek için Alanlar sekmesini seçin.

  4. Hangi alanların Filtrelenebilir veya Sıralanabilir olduğunu denetlediğinizden, hangi sorguların yazıldığını bilirsiniz.

    Azure portalındaki Azure AI Search hizmetindeki bir dizinin şema tanımını gösteren ekran görüntüsü.

Alan ekleme veya değiştirme

Alanlar sekmesinde, Alanekle'yi seçip bir ad, desteklenen veri türü ve öznitelikler belirterek bir alan oluşturabilirsiniz.

Mevcut alanları değiştirmek daha zordur. Mevcut alanların arama dizininde fiziksel bir gösterimi vardır, bu nedenle kodda bile değiştirilemezler. Var olan bir alanı temelden değiştirmek için, özgün alanı değiştirmek için yeni bir alan oluşturmanız gerekir. İstediğiniz zaman puanlama profilleri ve CORS seçenekleri gibi diğer yapıları bir dizine ekleyebilirsiniz.

Dizin tasarımı sırasında neleri düzenleyebileceğinizi ve düzenleyememenizi anlamak için dizin tanımı seçeneklerini gözden geçirin. Bir seçenek soluk görünüyorsa, bu seçeneği değiştiremez veya silemezsiniz.

Arama gezgini ile sorgulama

Artık Arama gezgini kullanılarak sorgulanabilen ve Belgeler - Arama Gönderisi (REST API) ile uyumlu REST çağrıları gönderen bir arama dizininiz var. Bu araç, anahtar sözcük araması için basit sorgu söz dizimlerini ve tam Lucene sorgu söz dizimlerini destekler.

Arama dizininizi sorgulamak için:

  1. Arama gezgini sekmesinde, aranacak metni girin.

    Arama Gezgini aracında sorgunun nasıl girildiğini ve çalıştırıldığını gösteren ekran görüntüsü.

  2. Çıkışın görünür olmayan alanlarına atlamak için mini haritayı kullanın.

    Arama Gezgini aracında ve mini haritada bir sorgunun uzun sonuçlarını gösteren ekran görüntüsü.

  3. Söz dizimini belirtmek için JSON görünümüne geçin.

    JSON görünüm seçicisinin ekran görüntüsü.

Hotels-sample dizini için örnek sorgular

Aşağıdaki örneklerde JSON görünümü ve en son önizleme REST API sürümü varsayılır.

İpucu

JSON görünümü, parametre adı tamamlama için intellisense'i destekler. İmlecinizi JSON görünümünün içine getirin ve tüm sorgu parametrelerinin listesini görmek için bir boşluk karakteri girin. Ayrıca, yalnızca bu harfle başlayan sorgu parametrelerini görmek için gibi sbir harf de girebilirsiniz.

IntelliSense geçersiz parametreleri dışlamaz, bu nedenle en iyi kararınızı kullanın.

Filtre örnekleri

Park yeri, etiketler, yenileme tarihi, derecelendirme ve konum filtrelenebilir.

{
    "search": "beach OR spa",
    "select": "HotelId, HotelName, Description, Rating",
    "count": true,
    "top": 10,
    "filter": "Rating gt 4"
}

Boole filtreleri varsayılan olarak "true" kabul eder.

{
    "search": "beach OR spa",
    "select": "HotelId, HotelName, Description, Rating",
    "count": true,
    "top": 10,
    "filter": "ParkingIncluded"
}

Jeo-uzamsal arama filtre tabanlıdır. İşlev, geo.distance konumsal veriler için tüm sonuçları belirtilen Location ve geography'POINT koordinatlara göre filtreler. Sorgu, "Redmond, Washington, ABD" olan enlem ve boylam koordinatlarının -122.12 47.67beş kilometre içindeki otelleri arar. Sorgu, otel adları ve adres konumlarıyla toplam eşleşme &$count=true sayısını görüntüler.

{
    "search": "*",
    "select": "HotelName, Address/City, Address/StateProvince",
    "count": true,
    "top": 10,
    "filter": "geo.distance(Location, geography'POINT(-122.12 47.67)') le 5"
}

Tam Lucene söz dizimi örnekleri

Varsayılan söz dizimi basit söz dizimidir, ancak belirsiz arama, terim artırma veya normal ifadeler istiyorsanız, tam söz dizimini belirtin.

{
    "queryType": "full",
    "search": "seatle~",
    "select": "HotelId, HotelName,Address/City, Address/StateProvince",
    "count": true
}

Yanlış yazılmış sorgu terimleri, seatle yerine Seattle, tipik bir aramada eşleşmeleri döndürmez. queryType=full parametresi, tilde (~) işlenenini destekleyen tam Lucene sorgu ayrıştırıcısını çağırır. Bu parametreleri kullandığınızda, sorgu belirtilen anahtar sözcük için benzer bir arama gerçekleştirir ve benzer ancak tam eşleşme olmayan terimlerle eşleşir.

Dizininizde bu örnek sorguları denemek için bir dakikanızı ayırın. Daha fazla bilgi için bkz. Azure AI Search'te sorgulama.

Kaynakları temizleme

Kendi aboneliğinizde çalışırken, oluşturduğunuz kaynaklara hala ihtiyacınız olup olmadığını belirlemek, projenin sonunda iyi bir fikirdir. Çalışır durumda bırakılan kaynaklar maliyetlerin artmasına neden olabilir. Kaynakları teker teker silebilir veya tüm kaynak grubunu silerek kaynak kümesinin tamamını kaldırabilirsiniz.

Azure portalında, sol bölmeden Tüm kaynaklar veya Kaynak grupları'nı seçerek kaynakları bulabilir ve yönetebilirsiniz.

Not

Ücretsiz arama hizmeti kullanıyorsanız sınırın üç dizin, üç dizin oluşturucu ve üç veri kaynağı olduğunu unutmayın. Sınırın altında kalmak için Azure portalında tek tek nesneleri silebilirsiniz.

Sonraki adım

Tarayıcıda çalışan kullanıma hazır bir web uygulaması oluşturmak için azure portal sihirbazını deneyin. Bu hızlı başlangıçta oluşturduğunuz küçük dizinde bu sihirbazı kullanın veya daha zengin bir arama deneyimi için örnek verileri kullanın.

Hızlı Başlangıç: Azure portalında tanıtım arama uygulaması oluşturma

  • Last updated on