Importazione di dati in Ricerca di AzureData import in Azure Search

In Ricerca di Azure vengono eseguite query sul contenuto caricato in un indice di ricerca.In Azure Search, queries execute over your content loaded into a search index. Questo articolo esamina i due approcci di base per caricare il contenuto in un indice: eseguire il push dei dati nell'indice a livello di codice o puntare a un indicizzatore di Ricerca di Azure in un'origine dati supportata per eseguire il pull nei dati.This article examines the two basic approaches for loading content into an index: push your data into the index programmatically, or point an Azure Search indexer at a supported data source to pull in the data.

Push dei dati in un indicePushing data to an index

Il modello basato sul push, usato per inviare a livello di codice i dati a Ricerca di Azure, è l'approccio più flessibile.The push model, used to programmatically send your data to Azure Search, is the most flexible approach. Prima di tutto non ha restrizioni per il tipo di origine dati.First, it has no restrictions on data source type. È possibile eseguire il push di qualsiasi set di dati costituito da documenti JSON a un indice di Ricerca di Azure, presumendo che ai campi definiti nello schema dell'indice venga eseguito il mapping dei campi di ogni documento del set di dati.Any dataset composed of JSON documents can be pushed to an Azure Search index, assuming each document in the dataset has fields mapping to fields defined in your index schema. In secondo luogo non ha restrizioni per la frequenza di esecuzione.Second, it has no restrictions on frequency of execution. È possibile eseguire il push delle modifiche a un indice ogni volta che si vuole.You can push changes to an index as often as you like. Per applicazioni con requisiti di latenza molto bassa, ad esempio se è necessario che le operazioni di ricerca siano sincronizzate con i database di inventario dinamici, il modello push è l'unica opzione disponibile.For applications having very low latency requirements (for example, if you need search operations to be in sync with dynamic inventory databases), the push model is your only option.

Questo approccio è più flessibile rispetto al modello pull, perché si possono caricare i documenti individualmente o in batch, fino a 1000 per batch o 16 MB, a seconda del limite che viene raggiunto per primo.This approach is more flexible than the pull model because you can upload documents individually or in batches (up to 1000 per batch or 16 MB, whichever limit comes first). Il modello push consente anche di caricare i documenti in Ricerca di Azure indipendentemente dalla posizione dei dati.The push model also allows you to upload documents to Azure Search regardless of where your data is.

Come eseguire il push dei dati a un indice di Ricerca di AzureHow to push data to an Azure Search index

Per caricare uno o più documenti in un indice, è possibile usare le API seguenti:You can use the following APIs to load single or multiple documents into an index:

Non sono attualmente supportati strumenti per il push dei dati tramite il portale.There is currently no tool support for pushing data via the portal.

Per un'introduzione a ogni metodologia, vedere Importare dati usando REST o Importare dati usando .NET.For an introduction to each methodology, see Import data using REST or Import data using .NET.

Pull dei dati in un indicePulling data into an index

Il modello pull effettua una ricerca per indicizzazione su un'origine dati supportata e carica automaticamente i dati nell'indice.The pull model crawls a supported data source and automatically uploads the data into your index. In Ricerca di Azure questa funzionalità viene implementata tramite gli indicizzatori, attualmente disponibili per queste piattaforme:In Azure Search, this capability is implemented through indexers, currently available for these platforms:

Gli indicizzatori connettono un indice a un'origine dati, in genere una tabella, una vista o una struttura equivalente, e mappano i campi di origine ai campi equivalenti nell'indice.Indexers connect an index to a data source (usually a table, view, or equivalent structure), and map source fields to equivalent fields in the index. Durante l'esecuzione il set di righe viene automaticamente trasformato in JSON e caricato nell'indice specificato.During execution, the rowset is automatically transformed to JSON and loaded into the specified index. Tutti gli indicizzatori supportano la pianificazione, in modo da consentire di specificare la frequenza dell'aggiornamento dei dati.All indexers support scheduling so that you can specify how frequently the data is to be refreshed. La maggior parte degli indicizzatori fornisce il rilevamento delle modifiche se l'origine dati lo supporta.Most indexers provide change tracking if the data source supports it. Tramite il rilevamento di modifiche ed eliminazioni nei documenti esistenti, oltre al riconoscimento di nuovi documenti, gli indicizzatori eliminano la necessità di gestire attivamente i dati nell'indice.By tracking changes and deletes to existing documents in addition to recognizing new documents, indexers remove the need to actively manage the data in your index.

Come eseguire il pull dei dati in un indice di Ricerca di AzureHow to pull data into an Azure Search index

La funzionalità di indicizzatore viene esposta nel portale di Azure, nell'API REST e in .NET SDK.Indexer functionality is exposed in the Azure portal, the REST API, and the .NET SDK.

Un vantaggio dell'uso del portale consiste nel fatto che Ricerca di Azure può solitamente generare automaticamente uno schema di indice predefinito leggendo i metadati del set di dati di origine.An advantage to using the portal is that Azure Search can usually generate a default index schema for you by reading the metadata of the source dataset. È possibile modificare l'indice generato fino al termine dell'elaborazione dell'indice. In seguito, sono consentite solo le modifiche che non richiedono la reindicizzazione.You can modify the generated index until the index is processed, after which the only schema edits allowed are those that do not require reindexing. Se le modifiche da apportare influiscono direttamente sullo schema, è necessario ricompilare l'indice.If the changes you want to make impact the schema directly, you would need to rebuild the index.

Verificare l'importazione dei dati con Esplora ricercheVerify data import with Search Explorer

Un modo rapido per eseguire un controllo preliminare sul caricamento del documento consiste nell'usare Esplora ricerche nel portale.A quick way to perform a preliminary check on the document upload is to use Search Explorer in the portal. Esplora ricerche consente di eseguire query su un indice senza che sia necessario scrivere codice.The explorer lets you query an index without having to write any code. L'esperienza di ricerca è basata sulle impostazioni predefinite, ad esempio la sintassi semplice e il parametro di query searchMode predefinito.The search experience is based on default settings, such as the simple syntax and default searchMode query parameter. I risultati vengono restituiti in JSON, in modo che sia possibile esaminare l'intero documento.Results are returned in JSON so that you can inspect the entire document.

Suggerimento

Numerosi esempi di codice di Ricerca di Azure includono set di dati incorporati o immediatamente disponibili, che consentono di iniziare con facilità.Numerous Azure Search code samples include embedded or readily available datasets, offering an easy way to get started. Il portale offre anche un indicizzatore e un'origine dati di esempio, costituita da un piccolo set di dati immobiliari, denominato "realestate-us-sample".The portal also provides a sample indexer and data source consisting of a small real estate dataset (named "realestate-us-sample"). Quando si esegue l'indicizzatore preconfigurato nell'origine dati di esempio, viene creato un indice, che viene caricato con i documenti su cui possono essere eseguite query in Esplora ricerche o tramite codice scritto dall'utente.When you run the preconfigured indexer on the sample data source, an index is created and loaded with documents that can then be queried in Search Explorer or by code that you write.

Vedere ancheSee also