C# .NET uygulamasında Azure.Search.Documtaları kullanma

Bu makalede, C# ve Azure.Search.Documstalar (sürüm 11) istemci kitaplığı kullanılarak arama nesnelerinin nasıl oluşturulduğu ve yönetileceği açıklanmaktadır.

Sürüm 11 hakkında

.NET için Azure SDK, Azure SDK ekibi 'nden Microsoft. Azure. Search istemci kitaplıklarına işlevsel olarak denk olan yeni bir Azure.Search.Documstalar istemci kitaplığı ekler, ancak uygun yerlerde yaygın yaklaşımlar ve kuralları kullanır. Bazı örneklere AzureKeyCredential anahtar kimlik doğrulaması ve üzerindeSystem.Text.Jsdahildir. JSON serileştirme için serileştirme.

Önceki sürümlerde olduğu gibi, bu kitaplığı kullanarak şunları yapabilirsiniz:

• Arama dizinleri, veri kaynakları, Dizin oluşturucular, becerileri ve eş anlamlı haritalar oluşturun ve yönetin
• Dizinde arama belgelerini yükleme ve yönetme
• HTTP ve JSON ayrıntıları ile uğraşmak zorunda kalmadan sorguları yürütün

Kitaplık, bir arama hizmetine programlı erişim için kullanılan tüm API 'Leri içeren tek bir Azure.Search.DocUmstak NuGet paketiolarak dağıtılır.

İstemci kitaplığı, ve gibi işlemleri ve ve sınıfları gibi sınıfları tanımlar SearchIndex SearchField SearchDocument SearchIndexClient.CreateIndex SearchClient.Search SearchIndexClient SearchClient . Bu sınıflar aşağıdaki ad alanları halinde düzenlenmiştir:

• Azure.Search.Documents
• Azure.Search.Documents.Indexes
• Azure.Search.Documents.Indexes.Models
• Azure.Search.Documents.Models

Azure.Search.Docmestalar (sürüm 11) 2020-06-30 Azure bilişsel arama REST API 'ınhedeflediği sürüm.

İstemci kitaplığı, arama hizmetleri oluşturma ve ölçekleme ve API anahtarlarını yönetme gibi hizmet yönetimi işlemlerisağlamaz. Arama kaynaklarınızı bir .NET uygulamasından yönetmeniz gerekiyorsa, .NET için Azure SDK 'da Microsoft. Azure. Management. Search kitaplığını kullanın.

V11 sürümüne yükselt

.NET SDK 'sının önceki sürümünü kullanıyorsanız ve geçerli genel kullanıma sunulan sürüme yükseltmek isterseniz, bkz. Azure bilişsel arama .NET SDK sürüm 11 ' e yükseltme

SDK gereksinimleri

• Visual Studio 2019 veya üzeri.

• Kendi Azure Bilişsel Arama hizmetiniz. SDK 'yı kullanmak için hizmetinizin adı ve bir veya daha fazla API anahtarı gerekir. Portalda bir hizmet oluşturun .

• Araçlar NuGet Paket Yöneticisi, Visual Studio 'da çözüm için NuGet Paketlerini Yönet ' i kullanarak Azure.Search.Documstaları paketini indirin > > . Paket adını arayın Azure.Search.Documents .

.NET için Azure SDK, en düşük gereksinimleri .NET Framework 4.6.1 ve .NET Core 2,0 anlamına gelen .NET Standard 2,0' a uyar.

Örnek uygulama

Bu makalede, Azure Bilişsel Arama temel kavramları (özellikle, bir arama dizini oluşturma, yükleme ve sorgulama) göstermek için GitHub 'daki Dotnethowto Code örneğine bağlı olarak "örnek olarak öğretilir" makalesi.

Bu makalenin geri kalanında, sonuçlarda eşleşen birkaç sorguyla birlikte birkaç belgeyle doldurulmuş "oteller" adlı yeni bir dizin olduğunu varsayalım.

Genel akışın gösterildiği ana program aşağıda verilmiştir:

// This sample shows how to delete, create, upload documents and query an index
static void Main(string[] args)
{
    IConfigurationBuilder builder = new ConfigurationBuilder().AddJsonFile("appsettings.json");
    IConfigurationRoot configuration = builder.Build();

    SearchIndexClient indexClient = CreateSearchIndexClient(configuration);

    string indexName = configuration["SearchIndexName"];

    Console.WriteLine("{0}", "Deleting index...\n");
    DeleteIndexIfExists(indexName, indexClient);

    Console.WriteLine("{0}", "Creating index...\n");
    CreateIndex(indexName, indexClient);

    SearchClient searchClient = indexClient.GetSearchClient(indexName);

    Console.WriteLine("{0}", "Uploading documents...\n");
    UploadDocuments(searchClient);

    SearchClient indexClientForQueries = CreateSearchClientForQueries(indexName, configuration);

    Console.WriteLine("{0}", "Run queries...\n");
    RunQueries(indexClientForQueries);

    Console.WriteLine("{0}", "Complete.  Press any key to end application...\n");
    Console.ReadKey();
}

Sonraki bir deyişle, bu uygulamayı geçerli bir hizmet adı ve API anahtarlarıyla çalıştırdığınız varsayılarak çıktının kısmi bir ekran görüntüsüdür:

İstemci türleri

İstemci kitaplığı çeşitli işlemler için üç istemci türü kullanır: SearchIndexClient Dizin oluşturmak, güncelleştirmek veya silmek, SearchClient bir dizini yüklemek veya sorgulamak, Dizin SearchIndexerClient oluşturucular ve becerileri ile çalışmak için. Bu makale, ilk iki üzerine odaklanır.

Tüm istemciler, en azından hizmet adı veya uç nokta ve bir API anahtarı gerektirir. Bu bilgileri, appsettings.json Dotnethowto örnek uygulamasınındosyasında buldıklarınız gibi bir yapılandırma dosyasında sağlamak yaygındır. Yapılandırma dosyasından okumak için, using Microsoft.Extensions.Configuration; programınıza ekleyin.

Aşağıdaki ifade, dizinleri oluşturmak, güncelleştirmek veya silmek için kullanılan dizin istemcisini oluşturur. Bir arama uç noktası ve yönetici API anahtarı alır.

private static SearchIndexClient CreateSearchIndexClient(IConfigurationRoot configuration)
{
    string searchServiceEndPoint = configuration["SearchServiceEndPoint"];
    string adminApiKey = configuration["SearchServiceAdminApiKey"];

    SearchIndexClient indexClient = new SearchIndexClient(new Uri(searchServiceEndPoint), new AzureKeyCredential(adminApiKey));
    return indexClient;
}

Sonraki ifade, belgeleri yüklemek veya sorguları çalıştırmak için kullanılan arama istemcisini oluşturur. SearchClient bir dizin gerektirir. Belge yüklemek için bir yönetici API anahtarınız olması gerekir, ancak sorguları çalıştırmak için bir sorgu API 'SI anahtarı kullanabilirsiniz.

string indexName = configuration["SearchIndexName"];

private static SearchClient CreateSearchClientForQueries(string indexName, IConfigurationRoot configuration)
{
    string searchServiceEndPoint = configuration["SearchServiceEndPoint"];
    string queryApiKey = configuration["SearchServiceQueryApiKey"];

    SearchClient searchClient = new SearchClient(new Uri(searchServiceEndPoint), indexName, new AzureKeyCredential(queryApiKey));
    return searchClient;
}

Dizin siliniyor

Geliştirmenin erken aşamalarında, DeleteIndex devam eden bir dizini silmek için bir ifade eklemek isteyebilirsiniz, böylece onu güncelleştirilmiş bir tanım ile yeniden oluşturabilirsiniz. Azure Bilişsel Arama için örnek kod genellikle, örneği yeniden çalıştırabilmeniz için bir silme adımı içerir.

Aşağıdaki satırı çağırır DeleteIndexIfExists :

Console.WriteLine("{0}", "Deleting index...\n");
DeleteIndexIfExists(indexName, indexClient);

Bu yöntem, SearchIndexClient dizinin mevcut olup olmadığını denetlemek için verilen ' ı kullanır ve varsa, siler:

private static void DeleteIndexIfExists(string indexName, SearchIndexClient indexClient)
{
    try
    {
        if (indexClient.GetIndex(indexName) != null)
        {
            indexClient.DeleteIndex(indexName);
        }
    }
    catch (RequestFailedException e) when (e.Status == 404)
    {
        // Throw an exception if the index name isn't found
        Console.WriteLine("The index doesn't exist. No deletion occurred.");

Dizin oluşturma

SearchIndexClientBir dizin oluşturmak için ' i kullanabilirsiniz.

Aşağıdaki yöntem, SearchIndex SearchField Yeni dizinin şemasını tanımlayan nesnelerin listesini içeren yeni bir nesne oluşturur. Her alan, arama davranışını tanımlayan bir ad, veri türü ve birkaç özniteliğe sahiptir.

Alanlar, kullanarak bir model sınıfından tanımlanabilir FieldBuilder . FieldBuilderSınıfı, SearchField belirtilen model sınıfının ortak özelliklerini ve özniteliklerini inceleyerek, dizin için bir nesne listesi oluşturmak üzere yansıma kullanır Hotel . HotelDaha sonra sınıfa daha yakından bakacağız.

private static void CreateIndex(string indexName, SearchIndexClient indexClient)
{
    FieldBuilder fieldBuilder = new FieldBuilder();
    var searchFields = fieldBuilder.Build(typeof(Hotel));

    var definition = new SearchIndex(indexName, searchFields);

    indexClient.CreateOrUpdateIndex(definition);
}

Alanların yanı sıra, dizine Puanlama profilleri, öneri araçları veya CORS seçenekleri de ekleyebilirsiniz (Bu parametreler, breçekimi için örnekten çıkarılır). Searchındex nesnesi ve bileşen parçaları hakkında daha fazla bilgiyi SearchIndex Özellikler listesinde ve REST API başvurusundabulabilirsiniz.

Main () içinde CreateIndex çağrısı

Main Yukarıdaki yöntemi çağırarak yeni bir "oteller" dizini oluşturur:

Console.WriteLine("{0}", "Creating index...\n");
CreateIndex(indexName, indexClient);

Veri gösterimi için model sınıfı kullanma

DotNetHowTo örneği, otel, Adresve Oda veri yapıları için model sınıfları kullanır. Hotel başvurular Address , tek düzeyli bir karmaşık tür (çok parçalı bir alan) ve Room (çok parçalı alanların koleksiyonu).

Bu türleri kullanarak dizin oluşturabilir ve yükleyebilir ve yanıtı bir sorgudan yapılandırabilirsiniz:

// Use-case: <Hotel> in a field definition
FieldBuilder fieldBuilder = new FieldBuilder();
var searchFields = fieldBuilder.Build(typeof(Hotel));

// Use-case: <Hotel> in a response
private static void WriteDocuments(SearchResults<Hotel> searchResults)
{
    foreach (SearchResult<Hotel> result in searchResults.GetResults())
    {
        Console.WriteLine(result.Document);
    }

    Console.WriteLine();
}

Alternatif bir yaklaşım, bir dizine doğrudan alan eklemektir. Aşağıdaki örnek yalnızca birkaç alanı göstermektedir.

 SearchIndex index = new SearchIndex(indexName)
 {
     Fields =
         {
             new SimpleField("hotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true },
             new SearchableField("hotelName") { IsFilterable = true, IsSortable = true },
             new SearchableField("hotelCategory") { IsFilterable = true, IsSortable = true },
             new SimpleField("baseRate", SearchFieldDataType.Int32) { IsFilterable = true, IsSortable = true },
             new SimpleField("lastRenovationDate", SearchFieldDataType.DateTimeOffset) { IsFilterable = true, IsSortable = true }
         }
 };

Alan tanımları

.NET 'teki veri modeliniz ve buna karşılık gelen dizin şeması, son kullanıcıya vermek istediğiniz arama deneyimini desteklemelidir. Bir arama dizinindeki arama belgesi gibi, .NET içindeki her üst düzey nesne, Kullanıcı arabiriminizdeki mevcut bir arama sonucuna karşılık gelir. Örneğin, bir otel arama uygulamasında son kullanıcılarınızın otel adına, otel özelliklerine veya belirli bir odanın özelliklerine göre arama yapmak isteyebilirsiniz.

Her bir sınıfta, bir alan, nasıl kullanıldığını tanımlayan bir veri türü ve öznitelikleri ile tanımlanır. Her sınıftaki her bir ortak özelliğin adı, Dizin tanımında aynı ada sahip bir alana eşlenir.

Otel sınıfından birkaç alan tanımı çeken aşağıdaki kod parçacığına göz atın. Adres ve odalar 'ın kendi sınıf tanımlarına sahip C# türleri olduğuna dikkat edin (bunları görüntülemek istiyorsanız örnek koda bakın). Her ikisi de karmaşık türlerdir. Daha fazla bilgi için bkz. karmaşık türleri Modelme.

public partial class Hotel
{
    [SimpleField(IsKey = true, IsFilterable = true)]
    public string HotelId { get; set; }

    [SearchableField(IsSortable = true)]
    public string HotelName { get; set; }

    [SearchableField(AnalyzerName = LexicalAnalyzerName.Values.EnLucene)]
    public string Description { get; set; }

    [SearchableField(IsFilterable = true, IsSortable = true, IsFacetable = true)]
    public string Category { get; set; }

    [JsonIgnore]
    public bool? SmokingAllowed => (Rooms != null) ? Array.Exists(Rooms, element => element.SmokingAllowed == true) : (bool?)null;

    [SearchableField]
    public Address Address { get; set; }

    public Room[] Rooms { get; set; }

Alan sınıfı seçme

Alanları tanımlarken, temel SearchField sınıfını kullanabilir veya önceden yapılandırılmış özelliklerle "Şablonlar" olarak görev yapan türev yardımcı modelleri kullanabilirsiniz.

Dizininizdeki tek bir alan, belge anahtarı () olarak kullanılmalıdır IsKey = true . Bu bir dize olmalıdır ve her belgeyi benzersiz şekilde tanımlamalıdır. Ayrıca IsHidden = true , bu, arama sonuçlarında görünemediği anlamına gelen olması gerekir.

Temel SearchField API 'yi veya yardımcı modellerden birini kullanmanıza bakılmaksızın, filtre, model ve sıralama özniteliklerini açıkça etkinleştirmeniz gerekir. Örneğin, yukarıdaki örnekte gösterildiği gibi ısfilterable, ıssıralanabilirve ıbıı tablosu açıkça adlandırılmalıdır.

Alan öznitelikleri ekleme

Her alanın,, ve gibi özniteliklerle nasıl tasarlandığına dikkat edin IsFilterable IsSortable IsKey AnalyzerName . Bu öznitelikler, bir Azure bilişsel arama dizininde karşılık gelen alan özniteliklerinedoğrudan eşlenir. FieldBuilderSınıfı, dizin için alan tanımları oluşturmak üzere bu özellikleri kullanır.

Alan türü eşleme

Özelliklerin .NET türleri, Dizin tanımındaki eşdeğer alan türleriyle eşlenir. Örneğin, Category dize özelliği Edm.String türündeki category alanına eşlenir. ,,, Vb. arasında benzer tür eşlemeleri vardır bool? Edm.Boolean DateTimeOffset? Edm.DateTimeOffset .

Özelliği fark etmeniz mı istiyordunuz SmokingAllowed ?

[JsonIgnore]
public bool? SmokingAllowed => (Rooms != null) ? Array.Exists(Rooms, element => element.SmokingAllowed == true) : (bool?)null;

JsonIgnoreBu özelliğindeki öznitelik, FieldBuilder öğesine onu bir alan olarak dizine serileştirmeyeceğini söyler. Bu, uygulamanızda yardımcılar olarak kullanabileceğiniz istemci tarafı hesaplanmış Özellikler oluşturmanın harika bir yoludur. Bu durumda, SmokingAllowed özelliği koleksiyonda herhangi birinin Room Rooms smome izin verip etmediğini yansıtır. Tümü yanlışsa, tüm otelin smome izin vermiyor olduğunu gösterir.

Dizin yükleme

İçindeki sonraki adım, Main Yeni oluşturulan "oteller" dizinini doldurur. Bu dizin oluşturma işlemi şu yöntemde yapılır: (bazı kodlar "... ile değiştirilmiştir" illüstrasyon amaçlıdır. Tam veri popülasyon kodu için tam örnek çözümüne bakın.)

private static void UploadDocuments(SearchClient searchClient)
{
    IndexDocumentsBatch<Hotel> batch = IndexDocumentsBatch.Create(
        IndexDocumentsAction.Upload(
            new Hotel()
            {
                HotelId = "1",
                HotelName = "Secret Point Motel",
                ...
                Address = new Address()
                {
                    StreetAddress = "677 5th Ave",
                    ...
                },
                Rooms = new Room[]
                {
                    new Room()
                    {
                        Description = "Budget Room, 1 Queen Bed (Cityside)",
                        ...
                    },
                    new Room()
                    {
                        Description = "Budget Room, 1 King Bed (Mountain View)",
                        ...
                    },
                    new Room()
                    {
                        Description = "Deluxe Room, 2 Double Beds (City View)",
                        ...
                    }
                }
            }),
        IndexDocumentsAction.Upload(
            new Hotel()
            {
                HotelId = "2",
                HotelName = "Twin Dome Motel",
                ...
                {
                    StreetAddress = "140 University Town Center Dr",
                    ...
                },
                Rooms = new Room[]
                {
                    new Room()
                    {
                        Description = "Suite, 2 Double Beds (Mountain View)",
                        ...
                    },
                    new Room()
                    {
                        Description = "Standard Room, 1 Queen Bed (City View)",
                        ...
                    },
                    new Room()
                    {
                        Description = "Budget Room, 1 King Bed (Waterfront View)",
                        ...
                    }
                }
            }),
        IndexDocumentsAction.Upload(
            new Hotel()
            {
                HotelId = "3",
                HotelName = "Triple Landscape Hotel",
                ...
                Address = new Address()
                {
                    StreetAddress = "3393 Peachtree Rd",
                    ...
                },
                Rooms = new Room[]
                {
                    new Room()
                    {
                        Description = "Standard Room, 2 Queen Beds (Amenities)",
                        ...
                    },
                    new Room ()
                    {
                        Description = "Standard Room, 2 Double Beds (Waterfront View)",
                        ...
                    },
                    new Room()
                    {
                        Description = "Deluxe Room, 2 Double Beds (Cityside)",
                        ...
                    }
                }
            }
        };

    try
    {
        IndexDocumentsResult result = searchClient.IndexDocuments(batch);
    }
    catch (Exception)
    {
        // Sometimes when your Search service is under load, indexing will fail for some of the documents in
        // the batch. Depending on your application, you can take compensating actions like delaying and
        // retrying. For this simple demo, we just log the failed document keys and continue.
        Console.WriteLine("Failed to index some of the documents: {0}");
    }

    Console.WriteLine("Waiting for documents to be indexed...\n");
    Thread.Sleep(2000);

Bu yöntemin dört bölümü vardır. İlki, Hotel Room dizine yüklemek üzere giriş verilerimizde kullanılacak 3 nesne ile her biri 3 nesneden oluşan bir dizi oluşturur. Bu veriler kolaylık sağlaması için sabit olarak kodlanır. Gerçek bir uygulamada, veriler büyük olasılıkla SQL veritabanı gibi bir dış veri kaynağından gelmiş olacaktır.

İkinci bölüm, IndexDocumentsBatch belgeleri içeren bir oluşturur. Bu durumda, çağırarak, toplu işe uygulamak istediğiniz işlemi bu durumda belirtirsiniz IndexDocumentsAction.Upload . Batch daha sonra yöntemi tarafından Azure Bilişsel Arama dizinine yüklenir IndexDocuments .

Bu yöntemin üçüncü bölümü, dizin oluşturma için önemli bir hata durumunu işleyen bir catch bloğudur. Arama hizmetiniz toplu işteki bazı belge dizinini dizinlemezse, bir IndexBatchException tarafından oluşturulur IndexDocuments . Bu özel durum, hizmetiniz ağır yük altındayken belge dizinleniyorsa gerçekleşebilir. Bu durumu açık bir şekilde kodunuzda işlemenizi kesinlikle öneririz. Başarısız olan belgelere dizin oluşturmayı geciktirip sonra yeniden deneyebilir veya günlük tutup örneğin devam ettiği şekilde devam edebilir veya uygulamanızın veri tutarlılığı gereksinimlerine bağlı olarak başka bir şey yapabilirsiniz.

Son olarak, UploadDocuments Yöntem iki saniye gecikdi. Arama hizmetinizde dizin oluşturma zaman uyumsuz olarak gerçekleştirilir, bu nedenle örnek uygulamanın, belgelerin aranabilmesi için kullanılabilir olduğundan emin olmak için kısa bir süre beklemesi gerekir. Bu gibi gecikmeler genellikle yalnızca gösterilerde, testlerde ve örnek uygulamalarda gereklidir.

Main () içinde UploadDocuments çağırma

Aşağıdaki kod parçacığı, SearchClient ındexclient metodunu kullanarak bir örneğini ayarlar GetSearchClient . Indexclient, isteklerinde belge yükleme veya yenileme için gereken bir yönetici API anahtarı kullanır.

Alternatif bir yaklaşım doğrudan çağrı yapmak SearchClient ve üzerinde bir yönetıcı API anahtarı geçirmektir AzureKeyCredential .

SearchClient searchClient = indexClient.GetSearchClient(indexName);

Console.WriteLine("{0}", "Uploading documents...\n");
UploadDocuments(searchClient);

Sorgu çalıştırma

İlk olarak, SearchClient üzerindeappsettings.js arama uç noktasını ve sorgu API anahtarını okuyan bir a ayarlayın:

private static SearchClient CreateSearchClientForQueries(string indexName, IConfigurationRoot configuration)
{
    string searchServiceEndPoint = configuration["SearchServiceEndPoint"];
    string queryApiKey = configuration["SearchServiceQueryApiKey"];

    SearchClient searchClient = new SearchClient(new Uri(searchServiceEndPoint), indexName, new AzureKeyCredential(queryApiKey));
    return searchClient;
}

İkinci olarak, bir sorgu isteği gönderen bir yöntem tanımlayın.

Yöntem bir sorguyu her yürüttüğünde, yeni bir SearchOptions nesne oluşturur. Bu nesne, sorgu için sıralama, filtreleme, sayfalama ve Faks oluşturma gibi ek seçenekleri belirtmek için kullanılır. Bu yöntemde,, Filter Select ve OrderBy özelliğini farklı sorgular için ayarlıyoruz. Arama sorgusu ifade sözdizimi hakkında daha fazla bilgi için, basit sorgu söz dizimi.

Sonraki adım aslında arama sorgusunu yürütmekte. Aramayı çalıştırmak yöntemi kullanılarak yapılır SearchClient.Search . Her sorgu için, arama metnini dize olarak kullanılacak şekilde geçirin (veya "*" arama metni yoksa) ve daha önce oluşturulan arama seçeneklerini kullanın. Ayrıca Hotel SearchClient.Search , SDK 'nın arama sonuçlarındaki belgelerin türünü türündeki nesnelere serisini oluşturmasını söyleyen için tür parametresi olarak da belirttik Hotel .

private static void RunQueries(SearchClient searchClient)
{
    SearchOptions options;
    SearchResults<Hotel> results;

    Console.WriteLine("Query 1: Search for 'motel'. Return only the HotelName in results:\n");

    options = new SearchOptions();
    options.Select.Add("HotelName");

    results = searchClient.Search<Hotel>("motel", options);

    WriteDocuments(results);

    Console.Write("Query 2: Apply a filter to find hotels with rooms cheaper than $100 per night, ");
    Console.WriteLine("returning the HotelId and Description:\n");

    options = new SearchOptions()
    {
        Filter = "Rooms/any(r: r/BaseRate lt 100)"
    };
    options.Select.Add("HotelId");
    options.Select.Add("Description");

    results = searchClient.Search<Hotel>("*", options);

    WriteDocuments(results);

    Console.Write("Query 3: Search the entire index, order by a specific field (lastRenovationDate) ");
    Console.Write("in descending order, take the top two results, and show only hotelName and ");
    Console.WriteLine("lastRenovationDate:\n");

    options =
        new SearchOptions()
        {
            Size = 2
        };
    options.OrderBy.Add("LastRenovationDate desc");
    options.Select.Add("HotelName");
    options.Select.Add("LastRenovationDate");

    results = searchClient.Search<Hotel>("*", options);

    WriteDocuments(results);

    Console.WriteLine("Query 4: Search the HotelName field for the term 'hotel':\n");

    options = new SearchOptions();
    options.SearchFields.Add("HotelName");

    //Adding details to select, because "Location" is not supported yet when deserialize search result to "Hotel"
    options.Select.Add("HotelId");
    options.Select.Add("HotelName");
    options.Select.Add("Description");
    options.Select.Add("Category");
    options.Select.Add("Tags");
    options.Select.Add("ParkingIncluded");
    options.Select.Add("LastRenovationDate");
    options.Select.Add("Rating");
    options.Select.Add("Address");
    options.Select.Add("Rooms");

    results = searchClient.Search<Hotel>("hotel", options);

    WriteDocuments(results);
}

Üçüncü olarak, her belgeyi konsola yazdırarak yanıtı yazan bir yöntem tanımlayın:

private static void WriteDocuments(SearchResults<Hotel> searchResults)
{
    foreach (SearchResult<Hotel> result in searchResults.GetResults())
    {
        Console.WriteLine(result.Document);
    }

    Console.WriteLine();
}

Main () içinde RunQueries çağrısı yapın

SearchClient indexClientForQueries = CreateSearchClientForQueries(indexName, configuration);

Console.WriteLine("{0}", "Running queries...\n");
RunQueries(indexClientForQueries);

Sorgu yapılarını keşfet

Her sorguya sırayla daha yakından göz atalım. İlk sorguyu yürütmek için kod aşağıda verilmiştir:

options = new SearchOptions();
options.Select.Add("HotelName");

results = searchClient.Search<Hotel>("motel", options);

WriteDocuments(results);

Bu durumda, herhangi bir aranabilir alanda "Motel" sözcüğünün tüm dizinini arıyor ve yalnızca seçenekte belirtilen otel adlarını almak istiyoruz Select . Sonuçlar şunlardır:

Name: Secret Point Motel

Name: Twin Dome Motel

İkinci sorguda, gece ücreti $100 ' dan az olan oda seçmek için bir filtre kullanın. Sonuçlarda yalnızca otel KIMLIĞI ve açıklaması Döndür:

options = new SearchOptions()
{
    Filter = "Rooms/any(r: r/BaseRate lt 100)"
};
options.Select.Add("HotelId");
options.Select.Add("Description");

results = searchClient.Search<Hotel>("*", options);

Yukarıdaki sorgu, $filter Rooms/any(r: r/BaseRate lt 100) dizinde bulunan belgeleri filtrelemek Için bir OData ifadesi kullanır. Bu, Oda koleksiyonundaki her öğeye ' BaseRate lt 100 ' öğesini uygulamak için Any işlecini kullanır. Daha fazla bilgi için bkz. OData filtresi sözdizimi.

Üçüncü sorguda en son yeniden kiralanan en son iki oteller bulun ve otel adı ile son yeniden oluşturma tarihini gösterin. Kod aşağıdaki gibidir:

options =
    new SearchOptions()
    {
        Size = 2
    };
options.OrderBy.Add("LastRenovationDate desc");
options.Select.Add("HotelName");
options.Select.Add("LastRenovationDate");

results = searchClient.Search<Hotel>("*", options);

WriteDocuments(results);

Son sorguda, "otel" kelimesiyle eşleşen tüm oteller adlarını bulun:

options.Select.Add("HotelId");
options.Select.Add("HotelName");
options.Select.Add("Description");
options.Select.Add("Category");
options.Select.Add("Tags");
options.Select.Add("ParkingIncluded");
options.Select.Add("LastRenovationDate");
options.Select.Add("Rating");
options.Select.Add("Address");
options.Select.Add("Rooms");

results = searchClient.Search<Hotel>("hotel", options);

WriteDocuments(results);

Bu bölüm, .NET SDK 'ya giriş sonucuna varır, ancak burada durmayın. Sonraki bölümde, Azure Bilişsel Arama ile programlama hakkında daha fazla bilgi edinmek için ek kaynaklar önerilir.

Sonraki adımlar

• Azure.Search.Documlar ve REST API için API başvuru belgelerine bakın

• Azure-Search-DotNet-Samples ve Search-Başlarken-dotnet ' de Azure.Search.Documtları temel alarak diğer kod örneklerine gözatın

• Çeşitli nesneleri adlandırmayla ilgili kuralları öğrenmek için adlandırma kurallarını gözden geçirin

• Desteklenen veri türlerini gözden geçirin