Aggiornamento all'API REST di Ricerca di Azure versione 2016-09-01Upgrading to the Azure Search Service REST API version 2016-09-01

Se si usa la versione 2015-02-28 o 2015-02-28-Preview dell'API REST di Ricerca di Azure, questo articolo consente di aggiornare l'applicazione alla prima versione disponibile a livello generale dell'API, la versione 2016-09-01.If you're using version 2015-02-28 or 2015-02-28-Preview of the Azure Search Service REST API, this article will help you upgrade your application to use the next generally available API version, 2016-09-01.

La versione 2016-09-01 dell'API REST include alcune modifiche rispetto alle versioni precedenti.Version 2016-09-01 of the REST API contains some changes from earlier versions. Le versioni sono abbastanza compatibili tra loro, pertanto la modifica del codice richiede un impegno minimo, a seconda della versione in uso prima.These are mostly backward compatible, so changing your code should require only minimal effort, depending on which version you were using before. Per istruzioni su come modificare il codice per usare la nuova versione dell'API, vedere Steps to upgrade (Passaggi per eseguire l'aggiornamento).See Steps to upgrade for instructions on how to change your code to use the new API version.

Nota

L'istanza del servizio Ricerca di Azure supporta diverse versioni di API REST, inclusa quella più recente.Your Azure Search service instance supports several REST API versions, including the latest one. È possibile continuare a usare una versione anche se non è la più recente, ma si consiglia di migrare il codice per usare la versione più recente.You can continue to use a version when it is no longer the latest one, but we recommend that you migrate your code to use the newest version.

Novità della versione 2016-09-01What's new in version 2016-09-01

La versione 2016-09-01 è la seconda disponibile a livello generale dell'API REST di Ricerca di Azure.Version 2016-09-01 is the second generally available release of the Azure Search Service REST API. Le nuove funzionalità in questa versione dell'API includono:New features in this API version include:

  • Gli analizzatori personalizzati, che consentono di controllare il processo di conversione del testo in token indicizzabili e ricercabili.Custom analyzers, which allow you to take control over the process of converting text into indexable and searchable tokens.
  • Gli indicizzatori Archiviazione BLOB di Azure e Archiviazione tabelle di Azure, che consentono di importare facilmente dati da Archiviazione di Azure in Ricerca di Azure in base a una pianificazione o su richiesta.Azure Blob Storage and Azure Table Storage indexers, which allow you to easily import data from Azure storage into Azure Search on a schedule or on-demand.
  • Mapping dei campi, che consentono di personalizzare la modalità di importazione dei dati da parte degli indicizzatori in Ricerca di Azure.Field mappings, which allow you to customize how indexers import data into Azure Search.
  • ETag, che consentono di aggiornare le definizioni di indici, indicizzatori e origini dati in modo indipendente dalla concorrenza.ETags, which allow you to update the definitions of indexes, indexers, and data sources in a concurrency-safe manner.

Passaggi per eseguire l'aggiornamentoSteps to upgrade

Se esegue l'aggiornamento dalla versione 2015-02-28, probabilmente non è necessario apportare modifiche al codice, oltre alla modifica del numero di versione.If you are upgrading from version 2015-02-28, you probably won't have to make any changes to your code, other than to change the version number. Le uniche situazioni in cui può essere necessario modificare il codice si verificano quando:The only situations in which you may need to change code are when:

  • Il codice ha esito negativo quando vengono restituite proprietà sconosciute in una risposta API.Your code fails when unrecognized properties are returned in an API response. Per impostazione predefinita, l'applicazione deve ignorare le proprietà che non riconosce.By default your application should ignore properties that it does not understand.
  • Il codice rende persistenti le richieste API e tenta di inviarle nuovamente alla nuova versione dell'API.Your code persists API requests and tries to resend them to the new API version. Ad esempio, questa situazione può verificarsi se l'applicazione mantiene i token di continuazione restituiti dall'API di ricerca. Per altre informazioni, cercare @search.nextPageParameters nel riferimento all'API di ricerca.For example, this might happen if your application persists continuation tokens returned from the Search API (for more information, look for @search.nextPageParameters in the Search API Reference).

Se una delle situazioni seguenti si applica al caso dell'utente, può essere necessario modificare il codice in modo appropriato.If either of these situations apply to you, then you may need to change your code accordingly. In caso contrario, non sono necessarie modifiche a meno che non si voglia iniziare a usre le nuove funzionalità della versione 2016-09-01.Otherwise, no changes should be necessary unless you want to start using the new features of version 2016-09-01.

Se si esegue l'aggiornamento dalla versione 2015-02-28-Preview, si applica la situazione precedente, ma è necessario essere consapevoli che alcune funzionalità di anteprima non sono disponibili nella versione 2016-09-01:If you are upgrading from version 2015-02-28-Preview, the above also applies, but you must also be aware that some preview features are not available in version 2016-09-01:

  • Supporto per gli indicizzatori di Archiviazione BLOB di Azure per i file e i BLOB con estensione csv contenenti matrici JSON.Azure Blob Storage indexer support for CSV files and blobs containing JSON arrays.
  • SinonimiSynonyms
  • Query "Altri elementi simili""More like this" queries

Se il codice usa queste funzionalità, non sarà possibile eseguire l'aggiornamento alla versione 2016-09-01 senza rimuovere l'utilizzo di tali funzionalità.If your code uses these features, you will not be able to upgrade to 2016-09-01 without removing your usage of them.

Importante

Si ricordi che le API di anteprima servono per il test e la valutazione e non devono essere usate negli ambienti di produzione.Please remember, preview APIs are intended for testing and evaluation, and should not be used in production environments.

ConclusioneConclusion

Per altre informazioni sull'uso dell'API REST di Ricerca di Azure, vedere il riferimento all'API su MSDN aggiornato di recente.If you need more details on using the Azure Search Service REST API, see the recently updated API Reference on MSDN.

I commenti degli utenti su Ricerca di Azure sono molto apprezzati.We welcome your feedback on Azure Search. In caso di problemi, è possibile richiedere assistenza nel forum MSDN su Ricerca di Azure o in StackOverflow.If you encounter problems, feel free to ask us for help on the Azure Search MSDN forum or StackOverflow. Se si pongono domande su Ricerca di Azure in StackOverflow, assicurarsi di contrassegnarle con azure-search.If you're asking a question about Azure Search on StackOverflow, make sure to tag it with azure-search.

Grazie per avere usato Ricerca di Azure.Thank you for using Azure Search!