Hızlı Başlangıç: Azure portalında sorgu çalıştırmak için Arama gezginini kullanma

Bu hızlı başlangıçta, Azure portalında bir Azure AI Search dizininde sorgu çalıştırmak için yerleşik bir sorgu aracı olan Arama gezginini kullanmayı öğreneceksiniz. Bir sorguyu veya filtre ifadesini test etmek veya içeriğin dizinde mevcut olup olmadığını onaylamak için bu aracı kullanın.

Bu hızlı başlangıçta, Arama gezginini göstermek için mevcut bir dizin kullanılır.

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

• Bu hızlı başlangıçta hotels-sample dizini kullanılmaktadır. Dizini oluşturmak için bu hızlı başlangıçtaki yönergeleri izleyin.

Arama gezginini başlatma

1. Azure portalında arama hizmetinize gidin.

2. Sol bölmeden Genel Bakış'ı seçin.

3. Komut çubuğunda Arama gezgini'ni seçin.

   

   Alternatif olarak, dizin sayfasındaki Arama gezgini sekmesini seçin.

Üç yolla sorgulama

Arama gezgininde sorgulamaya yönelik üç yaklaşım vardır:

• Sorgu görünümü varsayılan bir arama çubuğu sağlar. Boş bir sorguyu veya Boole'larla serbest metin sorgusunu kabul eder, örneğin ocean view + parking gibi.

• Resim görünümü PNG, JPG veya JPEG dosyalarına göz atmak veya dosyaları sürükleyip bırakmak için bir pencere sağlar. Dizininizde görüntü vektörleştiricisi ve eşdeğer bir beceri yoksa, bu görünüm kullanılamaz.

• JSON görünümü parametreli sorguları destekler. Filtreler, orderby, select, count, searchFields ve diğer tüm parametreler JSON görünümünde ayarlanmalıdır.

  

Örnek: Görüntü sorgusu

Arama gezgini görüntüleri Görüntü görünümü aracılığıyla sorgu girişi olarak kabul eder ve bu, desteklenen bir vektörleştirici-beceri çifti kullanmanızı gerektirir. Daha fazla bilgi için bkz. Arama dizininde vektörleştirici yapılandırma.

Hotels-sample dizini görüntü vektörleştirme için yapılandırılmamış. Görüntü sorguları çalıştırmak istiyorsanız, Azure portalında Hızlı Başlangıç: Vektör araması bölümünde açıklandığı gibi bir dizin oluşturun. Hızlı başlangıçta metin tabanlı örnek veriler kullanılır, bu nedenle resim içeren belgeleri kullanmanız gerekir.

Görüntü sorgusu çalıştırmak için, bir görüntüyü seçin veya arama alanına sürükleyin ve ardından Ara'yı seçin. Arama gezgini görüntüyü vektörleştirir ve sorgu yürütmesi için vektöri arama altyapısına gönderir. Arama altyapısı, belirtilen k sonuç sayısına kadar giriş görüntüsüne yeterince benzeyen belgeler döndürür.

Örnekler: JSON sorguları

Aşağıda, Arama gezginini kullanarak çalıştırabileceğiniz JSON sorgularının örnekleri verilmiştir. Bu örnekleri izlemek için JSON görünümüne geçin. Her JSON örneğini metin alanına yapıştırabilirsiniz.

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

Belirtilmemiş sorgu çalıştırma

Arama gezgininde POST istekleri Belgeler - Arama Gönderisi (REST API) kullanılarak dahili olarak formüle edilir ve yanıtlar ayrıntılı JSON belgeleri olarak döndürülür.

İçeriğe ilk kez bakmak için, herhangi bir terim girmeden Ara'yı seçerek boş bir arama yapabilirsiniz. Boş bir arama ilk sorgu olarak kullanışlıdır çünkü belge oluşturmayı gözden geçirebilmeniz için belgelerin tamamını döndürür. Boş bir aramada arama puanı yoktur ve belgeler rastgele sırayla döndürülür ("@search.score": 1 tüm belgeler için). Varsayılan olarak, arama isteği başına 50 belge döndürülür.

Dizinde bulunan eşleşme sayısını almak için ekleyin "count": true . Boş bir aramada sayı, dizindeki toplam belge sayısıdır. Nitelikli bir aramada, sorgu girişiyle eşleşen belge sayısıdır. Hizmetin varsayılan olarak en fazla 50 eşleşmeyi döndürdüğünü, bu yüzden sonuçlarda döndürülenden daha fazla eşleşmenin dizinde bulunabileceğini unutmayın.

Boş bir arama için eşdeğer söz dizimi * veya "search": "*".

{
   "search": "*",
   "count": true
}

Sonuçlar

Serbest metin sorgusu çalıştırma

İşleçler içeren veya olmayan serbest biçimli arama, özel bir uygulamadan Azure AI Search'e gönderilen kullanıcı tanımlı sorguların benzetimini yapmak için kullanışlıdır. Yalnızca dizinde aranabilir olarak özniteliklendirilen alanlar eşleşmeler için taranır.

Serbest metin sorgusu için JSON görünümüne ihtiyacınız yoktur, ancak bu makaledeki diğer örneklerle tutarlılık sağlamak için bunu JSON'da sağlarız.

Sorgu terimleri veya ifadeler gibi arama ölçütlerini sağladığınızda arama sıralamasının devreye girdiğine dikkat edin. Aşağıdaki örnekte serbest metin araması gösterilmektedir. @search.score, varsayılan puanlama algoritması kullanılarak eşleşme için hesaplanan bir ilgi puanıdır.

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast"
}

Sonuçlar

Ctrl-F tuşlarını kullanarak sonuçlarda belirli ilgi çekici terimleri arayabilirsiniz.

Arama sonuçlarında alanları sınırlama

"select" daha okunabilir bir çıktı elde etmek için sonuçları açıkça adlandırılmış alanlarla sınırlamak için ekleyin. Yalnızca dizinde alınabilir olarak özniteliklendirilen alanlar sonuçlarda gösterilebilir.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description"
}

Sonuçlar

Sonraki sonuç toplu işlemini döndür

Azure AI Search, arama sıralamasına göre ilk 50 eşleşmeyi döndürür. Oteller-örnek dizininde yalnızca 50 otel vardır, bu nedenle sayfalamayı göstermek için daha küçük bir sayı kullanırız. Bir sonraki eşleşen belge kümesini almak için, "top": 20 ve "skip": 10 ekleyin ve sonuç kümesini 20 belgeye çıkarın (varsayılan değer 50, en fazla 1000), ilk 10 belgeyi atlayarak. Belgeyi tanımlamak için belge anahtarını (HotelId) de kontrol edebilirsiniz.

Dereceli sonuçlar elde etmek için sorgu terimi veya ifade gibi arama ölçütleri sağlamanız gerektiğini unutmayın. Arama puanları, arama sonuçlarına ulaştığınız kadar derine iner.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description",
   "top": 20,
   "skip": 10
}

Sonuçlar

Filtre ifadeleri (büyüktür, küçüktür, eşittir)

filter Ekleme veya dışlama ölçütlerini belirtmek için parametresini kullanın. Alan, dizinde filtrelenebilir olarak ilişkilendirilmelidir. Bu örnekte dörtten büyük derecelendirmeler aranmaktadır:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating",
    "filter": "Rating gt 4"
}

Sonuçlar

Sonuçları sıralama

Sonuçları arama puanının yanı sıra başka bir alana göre sıralamak için ekleyin orderby . Alan dizinde sıralanabilir olarak ilişkilendirilmelidir. Filtrelenen değerin aynı olduğu durumlarda (örneğin, aynı fiyat), sıra rastgeledir, ancak daha derin sıralama için daha fazla ölçüt ekleyebilirsiniz. Bunu test etmek için kullanabileceğiniz örnek bir ifade aşağıda verilmişti:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating, LastRenovationDate",
    "filter": "Rating gt 4",
    "orderby": "LastRenovationDate desc"
}

Sonuçlar

Öğrenilenler

Bu hızlı başlangıçta, REST API kullanarak bir dizini sorgulamak için Arama gezginini kullandınız.

• Sonuçlar ayrıntılı JSON belgeleri olarak döndürülür, böylece her belgenin yapımını ve içeriğini bütün olarak görüntüleyebilirsiniz. Sorgu select ifadesindeki parametresi hangi alanların döndürülür olduğunu sınırlar.

• Arama sonuçları, dizinde alınabilir olarak özniteliklendirilen tüm alanlardan oluşur. Öznitelikleri gözden geçirmek için Alanlar sekmesini seçin.

• Ticari bir web tarayıcısında girebileceklerinize benzer şekilde anahtar sözcük araması, son kullanıcı deneyimini test etmek için kullanışlıdır. Örneğin, hotels-sample dizinini varsayarsak girebilirsiniz "activities 'outdoor pool' restaurant OR continental breakfast"ve ardından arama sonuçlarındaki terimleri bulmak için Ctrl-F kullanabilirsiniz.

• Sorgu ve filtre ifadeleri, Azure AI Search tarafından uygulanan bir söz diziminde ifade edilir. Varsayılan, basit bir söz dizimidir, ancak isteğe bağlı olarak daha güçlü sorgular için tam Lucene kullanabilirsiniz. Filtre ifadeleri bir OData söz diziminde ifade edilir.

Kaynakları temizleme

Kendi aboneliğinizde çalışırken, artık ihtiyacınız olmayan kaynakları kaldırarak bir projeyi tamamlamak iyi bir fikirdir. Çalışır durumda kalan kaynaklar size pahalıya mal olabilir.

Kaynakları bulmak ve yönetmek için Azure portalında sol bölmeden Tüm kaynaklar veya Kaynak grupları'nı seçin. Kaynakları tek tek silebilir veya tüm kaynakları aynı anda kaldırmak için kaynak grubunu silebilirsiniz.

Ücretsiz arama hizmeti kullanıyorsanız üç dizin, dizin oluşturucu ve veri kaynağıyla sınırlı olduğunuzu unutmayın. Sınırın altında kalmak için portaldaki tek tek öğeleri silebilirsiniz .

Sonraki adım

Sorgu yapıları ve söz dizimi hakkında daha fazla bilgi edinmek için REST istemcisini kullanarak REST API'nin daha fazla bölümünü kullanan sorgu ifadeleri oluşturun. Belgeler - Arama Gönderisi (REST API) özellikle öğrenme ve araştırma için yararlıdır.

Hızlı Başlangıç: Tam metin arama