Creare un indice di Ricerca di Azure nel portale di AzureCreate an Azure Search index using the Azure Portal

Usare la finestra di progettazione per l'indice predefinita nel portale di Azure per creare un prototipo un indice di ricerca da eseguire sul servizio Ricerca di Azure.Use the built-in index designer in Azure portal to prototype or create a search index to run on your Azure Search service.

PrerequisitiPrerequisites

Questo articolo presuppone la disponibilità di una sottoscrizione di Azure e del servizio Ricerca di Azure.This article assumes an Azure subscription and Azure Search service.

Trovare il servizio di ricercaFind your search service

  1. Accedere alla pagina del portale di Azure ed esaminare i servizi di ricerca per la sottoscrizioneSign in to the Azure portal page and review the search services for your subscription
  2. Selezionare il servizio Ricerca di Azure.Select your Azure Search service.

Assegnare un nome all'indiceName the index

  1. Fare clic sul pulsante Aggiungi indice nella barra dei comandi nella parte superiore della pagina.Click the Add index button in the command bar at the top of the page.
  2. Assegnare un nome all'indice di Ricerca di Azure.Name your Azure Search index.

    • Deve iniziare con una lettera.Start with a letter.
    • Usare solo lettere minuscole, numeri o trattini ("-").Use only lowercase letters, digits, or dashes ("-").
    • Il limite per il nome è di 60 caratteri.Limit the name to 60 characters.

    Il nome dell'indice diventa parte dell'URL dell'endpoint usato per le connessioni all'indice e per l'invio di richieste HTTP nell'API REST di Ricerca di Azure.The index name becomes part of the endpoint URL used on connections to the index and for sending HTTP requests in the Azure Search REST API.

Definire i campi dell'indiceDefine the fields of your index

La composizione dell'indice include un insieme di campi che definisce i dati su cui è possibile eseguire ricerche nell'indice.Index composition includes a Fields collection that defines the searchable data in your index. In particolare, specifica la struttura dei documenti caricati separatamente.More specifically, it specifies the structure of documents that you upload separately. La raccolta campi include i campi obbligatori e facoltativi, denominati e digitati, con gli attributi dell'indice per determinare le modalità d'uso del campo.The Fields collection includes required and optional fields, named and typed, with index attributes to determine how the field can be used.

  1. Nel pannello Aggiungi indice fare clic su Campi > per aprire con effetto di scorrimento il pannello di definizione del campo.In the Add Index blade, click Fields > to slide open the field definition blade.

  2. Accettare il campo chiave generato di tipo Edm.String.Accept the generated key field of type Edm.String. Per impostazione predefinita, il campo viene denominato id ma è possibile rinominarlo, purché la stringa soddisfi le regole di denominazione.By default, the field is named id but you can rename it as long as the string satisfies naming rules. Per ogni indice di Ricerca di Azure è obbligatorio un campo chiave che deve essere una stringa.A key field is mandatory for every Azure Search index and it must be a string.

  3. Aggiungere i campi per specificare tutti i documenti che verranno caricati.Add fields to fully specify the documents you will upload. Se i documenti includono ID, nome hotel, indirizzo, città e area, creare un campo corrispondente per ciascuno di essi nell'indice.If documents consist of an id, hotel name, address, city, and region, create a corresponding field for each one in the index. Rivedere le istruzioni di progettazione nella sezione seguente per informazioni sugli attributi di impostazione.Review the design guidance in the section below for help in setting attributes.

  4. Facoltativamente, aggiungere tutti i campi che vengono usati internamente nelle espressioni di filtro.Optionally, add any fields that are used internally in filter expressions. È possibile impostare gli attributi nel campo per escludere i campi dalle operazioni di ricerca.Attributes on the field can be set to exclude fields from search operations.

  5. Al termine, fare clic su OK per salvare e creare l'indice.When finished, click OK to save and create the index.

Suggerimenti per l'aggiunta di campiTips for adding fields

La creazione di un indice nel portale prevede l'uso quasi esclusivo della tastiera.Creating an index in the portal is keyboard intensive. Abbreviare la procedura seguendo questo flusso di lavoro:Minimize steps by following this workflow:

  1. Innanzitutto, compilare l'elenco dei campi immettendo i nomi impostando i tipi di dati.First, build the field list by entering names and setting data types.

  2. Successivamente, usare le caselle di controllo nella parte superiore di ciascun attributo abilitare in blocco l'impostazione per tutti i campi e quindi cancellare selettivamente le caselle di alcuni campi non necessarie.Next, use the check boxes at the top of each attribute to bulk enable the setting for all fields, and then selectively clear boxes for the few fields that don't require it. Ad esempio, nei i campi della stringa in genere è possibile eseguire ricerche.For example, string fields are typically searchable. Di conseguenza, è possibile fare clic su Recuperabile e Ricercabile sia per restituire i valori del campo nei risultati della ricerca, che per consentire la ricerca full-text nel campo.As such, you might click Retrievable and Searchable to both return the values of the field in search results, as well as allow full text search on the field.

Indicazioni di progettazione per impostare gli attributiDesign guidance for setting attributes

Sebbene sia possibile aggiungere nuovi campi in qualsiasi momento, le definizioni del campo esistente vengono bloccate per la durata dell'indice.Although you can add new fields at any time, existing field definitions are locked in for the lifetime of the index. Per questo motivo, gli sviluppatori in genere usano il portale per la creazione di indici semplici, idee di test o usano le pagine del portale per cercare un'impostazione.For this reason, developers typically use the portal for creating simple indexes, testing ideas, or using the portal pages to look up a setting. L'iterazione frequente su una progettazione degli indici è più efficiente se si segue un approccio basato sul codice in modo che sia possibile ricompilare l'indice con facilità.Frequent iteration over an index design is more efficient if you follow a code-based approach so that you can rebuild the index easily.

Gli analizzatori e gli strumenti suggerimenti vengono associati ai campi prima che venga salvato l'indice.Analyzers and suggesters are associated with fields before the index is saved. Assicurarsi di fare clic su ogni pagina a schede per aggiungere gli analizzatori del linguaggio o gli strumenti suggerimenti alla definizione dell'indice.Be sure to click through each tabbed page to add language analyzers or suggesters to your index definition.

I campi della stringa spesso sono contrassegnati come Ricercabile e Recuperabile.String fields are often marked as Searchable and Retrievable.

I campi usati per limitare i risultati della ricerca includono Classificabile, Filtrabile, e Con facet.Fields used to narrow search results include Sortable, Filterable, and Facetable.

Gli attributi del campo determinano le modalità in cui un campo viene usato, ad esempio se viene usato nella ricerca full-text, nella navigazione con facet, nelle operazioni di ordinamento e così via.Field attributes determine how a field is used, such as whether it is used in full text search, faceted navigation, sort operations, and so forth. Nella tabella seguente sono descritti i singoli attributi.The following table describes each attribute.

AttributoAttribute DescrizioneDescription
searchablesearchable Ricercabile full-text, soggetto ad analisi lessicali, ad esempio alla scomposizione delle parole durante l'indicizzazione.Full-text searchable, subject to lexical analysis such as word-breaking during indexing. Se si imposta un campo ricercabile su un valore come "sunny day", questo viene suddiviso internamente nei singoli token "sunny" e "day".If you set a searchable field to a value like "sunny day", internally it will be split into the individual tokens "sunny" and "day". Per informazioni vedere Funzionamento della ricerca full-text.For details, see How full text search works.
filterablefilterable A cui si fa riferimento nelle query $filter.Referenced in $filter queries. I campi filtrabili di tipo Edm.String o Collection(Edm.String) non sono sottoposti a suddivisione delle parole e quindi i confronti riguardano solo le corrispondenze esatte.Filterable fields of type Edm.String or Collection(Edm.String) do not undergo word-breaking, so comparisons are for exact matches only. Se ad esempio si imposta un campo su "sunny day", $filter=f eq 'sunny' non troverà corrispondenze, mentre $filter=f eq 'sunny day' ne troverà.For example, if you set such a field f to "sunny day", $filter=f eq 'sunny' will find no matches, but $filter=f eq 'sunny day' will.
sortablesortable Per impostazione predefinita il sistema ordina i risultati in base al punteggio, ma è possibile configurare l'ordine in base ai campi nei documenti.By default the system sorts results by score, but you can configure sort based on fields in the documents. I campi di tipo Collection(Edm.String) non possono essere ordinabili.Fields of type Collection(Edm.String) cannot be sortable.
facetablefacetable In genere usato in una presentazione dei risultati della ricerca che include un numero di passaggi per categoria, ad esempio, gli hotel in una specifica città.Typically used in a presentation of search results that includes a hit count by category (for example, hotels in a specific city). Questa opzione non può essere usata con i campi di tipo Edm.GeographyPoint.This option cannot be used with fields of type Edm.GeographyPoint. I campi di tipo Edm.String che sono filtrabili, ordinabili, o con facet possono contenere al massimo 32 kilobyte di lunghezza.Fields of type Edm.String that are filterable, sortable, or facetable can be at most 32 kilobytes in length. Per altri dettagli, vedere Create Index (REST API)(Creare un indice: API REST).For details, see Create Index (REST API).
keykey Identificatore univoco per i documenti all'interno dell'indice.Unique identifier for documents within the index. È necessario scegliere un singolo campo come campo chiave e questo deve essere di tipo Edm.String.Exactly one field must be chosen as the key field and it must be of type Edm.String.
retrievableretrievable Specifica se il campo può essere restituito nel risultato di una ricerca.Determines whether the field can be returned in a search result. Questo attributo è utile quando si vuole usare un campo, ad esempio margine di profitto, come meccanismo di filtro, ordinamento o punteggio ma si preferisce che il campo non sia visibile all'utente finale.This is useful when you want to use a field (such as profit margin) as a filter, sorting, or scoring mechanism, but do not want the field to be visible to the end user. L'attributo deve essere true for key .This attribute must be true for key fields.

Creare l'indice degli hotel usato nelle sezioni API di esempioCreate the hotels index used in example API sections

La documentazione API di Ricerca di Azure include esempi di codice che presentano un semplice indice hotel.Azure Search API documentation includes code examples featuring a simple hotels index. Nelle schermate riportate di seguito, è possibile visualizzare la definizione dell'indice, che include l'analizzatore di lingua francese specificato durante la definizione dell'indice, che è possibile ricreare come esercitazione nel portale.In the screenshots below, you can see the index definition, including the French language analyzer specified during index definition, which you can recreate as a practice exercise in the portal.

Passaggi successiviNext steps

Dopo aver creato un indice di Ricerca di Azure, è possibile passare al passaggio successivo: caricare i dati ricercabili nell'indice.After creating an Azure Search index, you can move to the next step: upload searchable data into the index.

In alternativa, è anche possibile analizzare in modo approfondito gli indici.Alternatively, you could also take a deeper look at indexes. Oltre alla raccolta di campi, un indice specifica anche gli analizzatori, gli strumenti suggerimenti, i profili di punteggio e le impostazioni CORS.In addition to the Fields collection, an index also specifies analyzers, suggesters, scoring profiles, and CORS settings. Il portale offre pagine a schede per definire gli elementi più comuni: i campi, gli analizzatori e gli strumenti di suggerimento.The portal provides tabbed pages for defining the most common elements: Fields, analyzers, and suggesters. Per creare o modificare altri elementi, è possibile usare l'API REST o .NET SDK.To create or modify other elements, you can use the REST API or .NET SDK.

Vedere ancheSee also

Funzionamento della ricerca full-textHow full text search works
API REST del servizio Ricerca .NET SDKSearch service REST API .NET SDK