Guida introduttiva: Creare un indice di ricerca usando la libreria client legacy Microsoft.Azure.Search v10

Questo articolo è la guida introduttiva per C# per la libreria client legacy Microsoft.Azure.Search (versione 10), ora sostituita dalla libreria client Azure.Search.Documents (versione 11).

Informazioni su questa guida introduttiva

Creare un'applicazione console .NET Core in C# che crea, carica ed esegue query su un indice di Ricerca cognitiva di Azure usando Visual Studio e le librerie client Microsoft.Azure.Search.

Questo articolo illustra come creare l'applicazione. È anche possibile scaricare ed eseguire l'applicazione completa.

Prerequisiti

Prima di iniziare, devi avere il seguente:

• Un account Azure con una sottoscrizione attiva. Creare un account gratuito.

• Servizio Ricerca cognitiva di Azure. Creare un servizio o trovarne uno esistente nella sottoscrizione corrente. È possibile usare un servizio gratuito per questo avvio rapido.

• Visual Studio, qualsiasi edizione. Il codice di esempio e le istruzioni sono stati testati nell'edizione Community Edition gratuita.

Ottenere una chiave e un URL

Le chiamate al servizio richiedono un endpoint URL e una chiave di accesso per ogni richiesta. Un servizio di ricerca viene creato con entrambi, quindi se Ricerca cognitiva di Azure è stata aggiunta alla sottoscrizione, seguire questa procedura per ottenere le informazioni necessarie:

1. Accedere al portale di Azure e nella pagina Panoramica del servizio di ricerca ottenere l'URL. Un endpoint di esempio potrebbe essere simile a https://mydemo.search.windows.net.

2. In Impostazioni>Chiavi ottenere una chiave amministratore per diritti completi sul servizio. Sono disponibili due chiavi amministratore interscambiabili, fornite per continuità aziendale nel caso in cui sia necessario eseguire il rollover di una di esse. È possibile usare la chiave primaria o secondaria nelle richieste per l'aggiunta, la modifica e l'eliminazione di oggetti.

   Ottieni anche la chiave dell'interrogazione. È una buona pratica inviare richieste di query con accesso in sola lettura.

Tutte le richieste richiedono una chiave API per ogni richiesta inviata al servizio. La presenza di una chiave valida stabilisce una relazione di trust, in base alle singole richieste, tra l'applicazione che invia la richiesta e il servizio che la gestisce.

Configurare l'ambiente

Iniziare aprendo Visual Studio e creando un nuovo progetto di app console che può essere eseguito in .NET Core.

Installare i pacchetti NuGet

Il pacchetto Microsoft.Azure.Search è costituito da alcune librerie client distribuite come pacchetti NuGet.

Per questo progetto, usare la versione 10 del Microsoft.Azure.Search pacchetto NuGet e il pacchetto NuGet più recente Microsoft.Extensions.Configuration.Json .

1. In Strumenti>Gestione pacchetti NuGet, selezionare Gestisci pacchetti NuGet per la soluzione.

2. Fare clic su Sfoglia.

3. Cercare Microsoft.Azure.Search e selezionare la versione 10.

4. Fare clic su Installa a destra per aggiungere l'assembly al progetto e alla soluzione.

5. Ripetere per Microsoft.Extensions.Configuration.Json, selezionando la versione 2.2.0 o successiva.

Aggiungere informazioni sul servizio Ricerca cognitiva di Azure

1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e selezionare Aggiungi>nuovo elemento... .

2. In Aggiungi nuovo elemento cercare "JSON" per restituire un elenco di tipi di elemento correlato a JSON.

3. Scegliere File JSON, assegnare al file il nome "appsettings.json" e fare clic su Aggiungi.

4. Aggiungere il file alla directory di output. Fare clic con il pulsante destro del mouse appsettings.json e scegliere Proprietà. In Copia nella directory di output, selezionare Copia se più recente.

5. Copiare il codice JSON seguente nel nuovo file JSON.

   {
     "SearchServiceName": "<YOUR-SEARCH-SERVICE-NAME>",
     "SearchServiceAdminApiKey": "<YOUR-ADMIN-API-KEY>",
     "SearchIndexName": "hotels-quickstart"
   }
   

6. Sostituire il nome del servizio di ricerca (YOUR-SEARCH-SERVICE-NAME) e la chiave API di amministrazione (YOUR-ADMIN-API-KEY) con valori validi. Se l'endpoint di servizio è https://mydemo.search.windows.net, il nome del servizio sarà "mydemo".

Aggiungere file di classe ".Method" al proprio progetto

Questo passaggio è necessario per produrre un output significativo nella console. Quando si stampano i risultati nella finestra della console, i singoli campi dell'oggetto Hotel devono essere restituiti come stringhe. Questo passaggio implementa ToString() per eseguire questa attività, copiando il codice necessario in due nuovi file.

1. Aggiungere due definizioni di classi vuote al progetto: Address.Methods.cs, Hotel.Methods.cs

2. In Address.Methods.cs sovrascrivere il contenuto predefinito con il codice seguente, righe da 1 a 25.

3. In Hotel.Methods.cs, copia le righe da 1 a 68.

1 - Creare un indice

L'indice degli hotel è costituito da campi semplici e complessi, in cui un campo semplice è "HotelName" o "Description" e i campi complessi sono un indirizzo con campi secondari o una raccolta di sale. Quando un indice include tipi complessi, isolare le definizioni di campo complesse in classi separate.

1. Aggiungere due definizioni di classi vuote al progetto: Address.cs, Hotel.cs

2. In Address.cs sovrascrivere il contenuto predefinito con il codice seguente:

   using System;
   using Microsoft.Azure.Search;
   using Microsoft.Azure.Search.Models;
   using Newtonsoft.Json;
   
   namespace AzureSearchQuickstart
   {
       public partial class Address
       {
           [IsSearchable]
           public string StreetAddress { get; set; }
   
           [IsSearchable, IsFilterable, IsSortable, IsFacetable]
           public string City { get; set; }
   
           [IsSearchable, IsFilterable, IsSortable, IsFacetable]
           public string StateProvince { get; set; }
   
           [IsSearchable, IsFilterable, IsSortable, IsFacetable]
           public string PostalCode { get; set; }
   
           [IsSearchable, IsFilterable, IsSortable, IsFacetable]
           public string Country { get; set; }
       }
   }
   

3. In Hotel.cs la classe definisce la struttura complessiva dell'indice, inclusi i riferimenti alla classe address.

   namespace AzureSearchQuickstart
   {
       using System;
       using Microsoft.Azure.Search;
       using Microsoft.Azure.Search.Models;
       using Newtonsoft.Json;
   
       public partial class Hotel
       {
           [System.ComponentModel.DataAnnotations.Key]
           [IsFilterable]
           public string HotelId { get; set; }
   
           [IsSearchable, IsSortable]
           public string HotelName { get; set; }
   
           [IsSearchable]
           [Analyzer(AnalyzerName.AsString.EnMicrosoft)]
           public string Description { get; set; }
   
           [IsSearchable]
           [Analyzer(AnalyzerName.AsString.FrLucene)]
           [JsonProperty("Description_fr")]
           public string DescriptionFr { get; set; }
   
           [IsSearchable, IsFilterable, IsSortable, IsFacetable]
           public string Category { get; set; }
   
           [IsSearchable, IsFilterable, IsFacetable]
           public string[] Tags { get; set; }
   
           [IsFilterable, IsSortable, IsFacetable]
           public bool? ParkingIncluded { get; set; }
   
           [IsFilterable, IsSortable, IsFacetable]
           public DateTimeOffset? LastRenovationDate { get; set; }
   
           [IsFilterable, IsSortable, IsFacetable]
           public double? Rating { get; set; }
   
           public Address Address { get; set; }
       }
   }
   

   Gli attributi nel campo determinano la modalità di utilizzo in un'applicazione. Ad esempio, l'attributo IsSearchable deve essere assegnato a ogni campo che deve essere incluso in una ricerca full-text.

   Nota

   In .NET SDK i campi devono essere attribuiti in modo esplicito come IsSearchable, IsFilterable, IsSortablee IsFacetable. Questo comportamento è in contrasto con l'API REST che abilita in modo implicito l'attribuzione in base al tipo di dati ( ad esempio, i campi stringa semplici sono ricercabili automaticamente).

   Esattamente un campo nell'indice di tipo string deve essere il campo chiave , identificando in modo univoco ogni documento. In questo schema la chiave è HotelId.

   In questo indice i campi della descrizione usano la proprietà facoltativa analyzer, che si specifica quando si desidera eseguire l'override dell'analizzatore Lucene standard predefinito. Il description_fr campo usa l'analizzatore Lucene francese (FrLucene) perché archivia il testo francese. description usa l'analizzatore del linguaggio Microsoft facoltativo (EnMicrosoft).

4. In Program.cs creare un'istanza della SearchServiceClient classe per connettersi al servizio usando i valori archiviati nel file di configurazione dell'applicazione (appsettings.json).

   SearchServiceClient dispone di una Indexes proprietà che fornisce tutti i metodi necessari per creare, elencare, aggiornare o eliminare indici di Ricerca cognitiva di Azure.

   using System;
   using System.Linq;
   using System.Threading;
   using Microsoft.Azure.Search;
   using Microsoft.Azure.Search.Models;
   using Microsoft.Extensions.Configuration;
   
   namespace AzureSearchQuickstart
   {
       class Program {
           // Demonstrates index delete, create, load, and query
           // Commented-out code is uncommented in later steps
           static void Main(string[] args)
           {
               IConfigurationBuilder builder = new ConfigurationBuilder().AddJsonFile("appsettings.json");
               IConfigurationRoot configuration = builder.Build();
   
               SearchServiceClient serviceClient = CreateSearchServiceClient(configuration);
   
               string indexName = configuration["SearchIndexName"];
   
               Console.WriteLine("{0}", "Deleting index...\n");
               DeleteIndexIfExists(indexName, serviceClient);
   
               Console.WriteLine("{0}", "Creating index...\n");
               CreateIndex(indexName, serviceClient);
   
               // Uncomment next 3 lines in "2 - Load documents"
               // ISearchIndexClient indexClient = serviceClient.Indexes.GetClient(indexName);
               // Console.WriteLine("{0}", "Uploading documents...\n");
               // UploadDocuments(indexClient);
   
               // Uncomment next 2 lines in "3 - Search an index"
               // Console.WriteLine("{0}", "Searching index...\n");
               // RunQueries(indexClient);
   
               Console.WriteLine("{0}", "Complete.  Press any key to end application...\n");
               Console.ReadKey();
           }
   
           // Create the search service client
           private static SearchServiceClient CreateSearchServiceClient(IConfigurationRoot configuration)
           {
               string searchServiceName = configuration["SearchServiceName"];
               string adminApiKey = configuration["SearchServiceAdminApiKey"];
   
               SearchServiceClient serviceClient = new SearchServiceClient(searchServiceName, new SearchCredentials(adminApiKey));
               return serviceClient;
           }
   
           // Delete an existing index to reuse its name
           private static void DeleteIndexIfExists(string indexName, SearchServiceClient serviceClient)
           {
               if (serviceClient.Indexes.Exists(indexName))
               {
                   serviceClient.Indexes.Delete(indexName);
               }
           }
   
           // Create an index whose fields correspond to the properties of the Hotel class.
           // The Address property of Hotel will be modeled as a complex field.
           // The properties of the Address class in turn correspond to sub-fields of the Address complex field.
           // The fields of the index are defined by calling the FieldBuilder.BuildForType() method.
           private static void CreateIndex(string indexName, SearchServiceClient serviceClient)
           {
               var definition = new Microsoft.Azure.Search.Models.Index()
               {
                   Name = indexName,
                   Fields = FieldBuilder.BuildForType<Hotel>()
               };
   
               serviceClient.Indexes.Create(definition);
           }
       }
   }    
   

   Se possibile, condividere una singola istanza di SearchServiceClient nell'applicazione per evitare l'apertura di troppe connessioni. I metodi di classe sono thread-safe per consentire tale condivisione.

   La classe ha diversi costruttori. Quello che desideri prende il nome del servizio di ricerca e un oggetto SearchCredentials come parametri. SearchCredentials avvolge la tua chiave API.

   Nella definizione dell'indice il modo più semplice per creare gli Field oggetti consiste nel chiamare il FieldBuilder.BuildForType metodo , passando una classe modello per il parametro di tipo . Una classe modello ha proprietà che si collegano ai campi dell'indice. Questo mapping consente di associare documenti dall'indice di ricerca alle istanze della classe del modello.

   Nota

   Se non si prevede di usare una classe modello, è comunque possibile definire l'indice creando Field direttamente gli oggetti. È possibile specificare il nome del campo al costruttore, insieme al tipo di dati (o analizzatore per i campi stringa). È anche possibile impostare altre proprietà, come IsSearchable, IsFilterable, solo per citarne alcuni.

5. Premere F5 per compilare l'app e creare l'indice.

   Se il progetto viene compilato correttamente, viene visualizzata una finestra della console che scrive messaggi di stato sullo schermo per l'eliminazione e la creazione dell'indice.

2 - Caricare documenti

In Ricerca cognitiva di Azure i documenti sono strutture di dati che sono entrambi input per l'indicizzazione e gli output delle query. In quanto ottenuti da un'origine dati esterna, gli input dei documenti possono essere righe in un database, blob nello storage BLOB, o documenti JSON su disco. Per brevità, in questo esempio i documenti JSON per i quattro alberghi verranno incorporati nel codice stesso.

Quando si caricano documenti, è necessario usare un IndexBatch oggetto . Un IndexBatch oggetto contiene una raccolta di IndexAction oggetti, ognuno dei quali contiene un documento e una proprietà che indica a Ricerca cognitiva di Azure quale azione eseguire (caricamento, unione, eliminazione e mergeOrUpload).

1. In Program.cs creare una matrice di documenti e azioni di indice e quindi passare la matrice a IndexBatch. I documenti seguenti sono conformi all'indice hotel-quickstart, come definito dalle classi hotel e address.

   // Upload documents as a batch
   private static void UploadDocuments(ISearchIndexClient indexClient)
   {
       var actions = new IndexAction<Hotel>[]
       {
           IndexAction.Upload(
               new Hotel()
               {
                   HotelId = "1",
                   HotelName = "Secret Point Motel",
                   Description = "The hotel is ideally located on the main commercial artery of the city in the heart of New York. A few minutes away is Time's Square and the historic centre of the city, as well as other places of interest that make New York one of America's most attractive and cosmopolitan cities.",
                   DescriptionFr = "L'hôtel est idéalement situé sur la principale artère commerciale de la ville en plein cœur de New York. A quelques minutes se trouve la place du temps et le centre historique de la ville, ainsi que d'autres lieux d'intérêt qui font de New York l'une des villes les plus attractives et cosmopolites de l'Amérique.",
                   Category = "Boutique",
                   Tags = new[] { "pool", "air conditioning", "concierge" },
                   ParkingIncluded = false,
                   LastRenovationDate = new DateTimeOffset(1970, 1, 18, 0, 0, 0, TimeSpan.Zero),
                   Rating = 3.6,
                   Address = new Address()
                   {
                       StreetAddress = "677 5th Ave",
                       City = "New York",
                       StateProvince = "NY",
                       PostalCode = "10022",
                       Country = "USA"
                   }
               }
           ),
           IndexAction.Upload(
               new Hotel()
               {
                   HotelId = "2",
                   HotelName = "Twin Dome Motel",
                   Description = "The hotel is situated in a  nineteenth century plaza, which has been expanded and renovated to the highest architectural standards to create a modern, functional and first-class hotel in which art and unique historical elements coexist with the most modern comforts.",
                   DescriptionFr = "L'hôtel est situé dans une place du XIXe siècle, qui a été agrandie et rénovée aux plus hautes normes architecturales pour créer un hôtel moderne, fonctionnel et de première classe dans lequel l'art et les éléments historiques uniques coexistent avec le confort le plus moderne.",
                   Category = "Boutique",
                   Tags = new[] { "pool", "free wifi", "concierge" },
                   ParkingIncluded = false,
                   LastRenovationDate =  new DateTimeOffset(1979, 2, 18, 0, 0, 0, TimeSpan.Zero),
                   Rating = 3.60,
                   Address = new Address()
                   {
                       StreetAddress = "140 University Town Center Dr",
                       City = "Sarasota",
                       StateProvince = "FL",
                       PostalCode = "34243",
                       Country = "USA"
                   }
               }
           ),
           IndexAction.Upload(
               new Hotel()
               {
                   HotelId = "3",
                   HotelName = "Triple Landscape Hotel",
                   Description = "The Hotel stands out for its gastronomic excellence under the management of William Dough, who advises on and oversees all of the Hotel’s restaurant services.",
                   DescriptionFr = "L'hôtel est situé dans une place du XIXe siècle, qui a été agrandie et rénovée aux plus hautes normes architecturales pour créer un hôtel moderne, fonctionnel et de première classe dans lequel l'art et les éléments historiques uniques coexistent avec le confort le plus moderne.",
                   Category = "Resort and Spa",
                   Tags = new[] { "air conditioning", "bar", "continental breakfast" },
                   ParkingIncluded = true,
                   LastRenovationDate = new DateTimeOffset(2015, 9, 20, 0, 0, 0, TimeSpan.Zero),
                   Rating = 4.80,
                   Address = new Address()
                   {
                       StreetAddress = "3393 Peachtree Rd",
                       City = "Atlanta",
                       StateProvince = "GA",
                       PostalCode = "30326",
                       Country = "USA"
                   }
               }
           ),
           IndexAction.Upload(
               new Hotel()
               {
                   HotelId = "4",
                   HotelName = "Sublime Cliff Hotel",
                   Description = "Sublime Cliff Hotel is located in the heart of the historic center of Sublime in an extremely vibrant and lively area within short walking distance to the sites and landmarks of the city and is surrounded by the extraordinary beauty of churches, buildings, shops and monuments. Sublime Cliff is part of a lovingly restored 1800 palace.",
                   DescriptionFr = "Le sublime Cliff Hotel est situé au coeur du centre historique de sublime dans un quartier extrêmement animé et vivant, à courte distance de marche des sites et monuments de la ville et est entouré par l'extraordinaire beauté des églises, des bâtiments, des commerces et Monuments. Sublime Cliff fait partie d'un Palace 1800 restauré avec amour.",
                   Category = "Boutique",
                   Tags = new[] { "concierge", "view", "24-hour front desk service" },
                   ParkingIncluded = true,
                   LastRenovationDate = new DateTimeOffset(1960, 2, 06, 0, 0, 0, TimeSpan.Zero),
                   Rating = 4.6,
                   Address = new Address()
                   {
                       StreetAddress = "7400 San Pedro Ave",
                       City = "San Antonio",
                       StateProvince = "TX",
                       PostalCode = "78216",
                       Country = "USA"
                   }
               }
           ),
       };
   
       var batch = IndexBatch.New(actions);
   
       try
       {
           indexClient.Documents.Index(batch);
       }
       catch (IndexBatchException e)
       {
           // When a service is under load, indexing might fail for some documents in the batch. 
           // Depending on your application, you can compensate by 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}",
               String.Join(", ", e.IndexingResults.Where(r => !r.Succeeded).Select(r => r.Key)));
       }
   
       // Wait 2 seconds before starting queries 
       Console.WriteLine("Waiting for indexing...\n");
       Thread.Sleep(2000);
   }
   

   Dopo aver inizializzato l'oggettoIndexBatch , è possibile inviarlo all'indice chiamando Documents.Index sull'oggetto SearchIndexClient . Documents è una proprietà di SearchIndexClient che fornisce metodi per l'aggiunta, la modifica, l'eliminazione o l'esecuzione di query sui documenti nell'indice.

   L'oggetto try/catch che circonda la chiamata al metodo Index rileva errori di indicizzazione, che possono verificarsi se il servizio è sottoposto a un carico elevato. Nel codice di produzione è possibile ritardare e quindi ripetere l'indicizzazione dei documenti non riusciti o registrare e continuare come l'esempio oppure gestirli in un altro modo che soddisfi i requisiti di coerenza dei dati dell'applicazione.

   Il ritardo di due secondi compensa l'indicizzazione, che è asincrona, in modo che tutti i documenti possano essere indicizzati prima dell'esecuzione delle query. La scrittura di codice in un ritardo è in genere necessaria solo in applicazioni di esempio, test e demo.

2. In Program.cs, in main, rimuovere il commento dalle righe per "2 - Carica documenti".

   // Uncomment next 3 lines in "2 - Load documents"
   ISearchIndexClient indexClient = serviceClient.Indexes.GetClient(indexName);
   Console.WriteLine("{0}", "Uploading documents...\n");
   UploadDocuments(indexClient);
   

3. Premere F5 per ricompilare l'app.

   Se il progetto viene compilato correttamente, viene visualizzata una finestra della console, scrivendo messaggi di stato, questa volta con un messaggio relativo al caricamento dei documenti. Nella pagina Panoramica del servizio di ricerca del portale di Azure l'indice hotels-quickstart dovrebbe ora avere 4 documenti.

Per altre informazioni sull'elaborazione dei documenti, vedere "Come .NET SDK gestisce i documenti".

3 - Cercare un indice

È possibile ottenere risultati della query subito dopo l'indicizzazione del primo documento, ma per il test effettivo dell'indice è necessario attendere il completamento dell'indicizzazione di tutti i documenti.

In questa sezione vengono aggiunte elementi di funzionalità, ovvero la logica di query e i risultati. Per le query, usare il Search metodo . Questo metodo accetta testo di ricerca e altri parametri.

La DocumentsSearchResult classe rappresenta i risultati.

1. In Program.cs creare un metodo WriteDocuments che stampa i risultati della ricerca nella console.

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

2. Creare un metodo RunQueries per eseguire query e restituire i risultati. I risultati sono oggetti di tipo Hotel. È possibile usare il parametro select per visualizzare singoli campi. Se un campo non è incluso nel parametro select, la proprietà Hotel corrispondente sarà nulla.

   private static void RunQueries(ISearchIndexClient indexClient)
   {
       SearchParameters parameters;
       DocumentSearchResult<Hotel> results;
   
       // Query 1 
       Console.WriteLine("Query 1: Search for term 'Atlanta' with no result trimming");
       parameters = new SearchParameters();
       results = indexClient.Documents.Search<Hotel>("Atlanta", parameters);
       WriteDocuments(results);
   
       // Query 2
       Console.WriteLine("Query 2: Search on the term 'Atlanta', with trimming");
       Console.WriteLine("Returning only these fields: HotelName, Tags, Address:\n");
       parameters =
           new SearchParameters()
           {
               Select = new[] { "HotelName", "Tags", "Address" },
           };
       results = indexClient.Documents.Search<Hotel>("Atlanta", parameters);
       WriteDocuments(results);
   
       // Query 3
       Console.WriteLine("Query 3: Search for the terms 'restaurant' and 'wifi'");
       Console.WriteLine("Return only these fields: HotelName, Description, and Tags:\n");
       parameters =
           new SearchParameters()
           {
               Select = new[] { "HotelName", "Description", "Tags" }
           };
       results = indexClient.Documents.Search<Hotel>("restaurant, wifi", parameters);
       WriteDocuments(results);
   
       // Query 4 -filtered query
       Console.WriteLine("Query 4: Filter on ratings greater than 4");
       Console.WriteLine("Returning only these fields: HotelName, Rating:\n");
       parameters =
           new SearchParameters()
           {
               Filter = "Rating gt 4",
               Select = new[] { "HotelName", "Rating" }
           };
       results = indexClient.Documents.Search<Hotel>("*", parameters);
       WriteDocuments(results);
   
       // Query 5 - top 2 results
       Console.WriteLine("Query 5: Search on term 'boutique'");
       Console.WriteLine("Sort by rating in descending order, taking the top two results");
       Console.WriteLine("Returning only these fields: HotelId, HotelName, Category, Rating:\n");
       parameters =
           new SearchParameters()
           {
               OrderBy = new[] { "Rating desc" },
               Select = new[] { "HotelId", "HotelName", "Category", "Rating" },
               Top = 2
           };
       results = indexClient.Documents.Search<Hotel>("boutique", parameters);
       WriteDocuments(results);
   }
   

   Esistono due modi per trovare la corrispondenza dei termini in una query: la ricerca full-text e i filtri. Una query di ricerca full-text cerca uno o più termini nei campi IsSearchable del tuo indice. Un filtro è un'espressione booleana valutata sui IsFilterable campi in un indice. È possibile usare la ricerca full-text e i filtri insieme o separatamente.

   Sia le ricerche che i filtri vengono eseguiti usando il Documents.Search metodo . È possibile passare una query di ricerca nel searchText parametro , mentre un'espressione di filtro può essere passata nella Filter proprietà della SearchParameters classe . Per filtrare senza eseguire ricerche, è sufficiente passare "*" per il searchText parametro . Per eseguire la ricerca senza filtro, lasciare la proprietà Filter non impostata oppure non passare affatto un'istanza SearchParameters.

3. In Program.cs, in Main, rimuovere il commento dalle righe per "3 - Ricerca".

   // Uncomment next 2 lines in "3 - Search an index"
   Console.WriteLine("{0}", "Searching documents...\n");
   RunQueries(indexClient);
   

4. La soluzione è stata completata. Premere F5 per ricompilare l'app ed eseguire il programma completo.

   L'output include gli stessi messaggi di prima, con l'aggiunta di informazioni e risultati delle query.

Pulire le risorse

Quando si lavora all'interno del proprio abbonamento, è consigliabile, alla fine di un progetto, valutare se hai ancora bisogno delle risorse create. Le risorse lasciate in esecuzione possono finire per costarti denaro. È possibile eliminare risorse singole oppure gruppi di risorse per eliminare l'intero set di risorse.

È possibile trovare e gestire le risorse nel portale usando il collegamento Tutte le risorse o gruppi di risorse nel riquadro di spostamento a sinistra.

Se si usa un servizio gratuito, tenere presente che sono limitati a tre indici, indicizzatori e origini dati. È possibile eliminare singoli elementi nel portale per rimanere al di sotto del limite.

Passaggi successivi

In questa guida introduttiva per C# sono state eseguite una serie di attività per creare un indice, caricarlo con documenti ed eseguire query. In diverse fasi sono state adottate delle scorciatoie per semplificare il codice e renderlo più leggibile e comprensibile. Se si ha familiarità con i concetti di base, è consigliabile consultare l'articolo successivo per un'esplorazione di approcci e concetti alternativi che verranno approfonditi.

Il codice di esempio e l'indice sono versioni espanse di questa versione. L'esempio successivo aggiunge una raccolta Rooms, usa classi e azioni diverse e esamina in modo più approfondito il funzionamento dell'elaborazione.

Si vuole ottimizzare e risparmiare sulla spesa per il cloud?