Introduzione a Ricerca di Azure in Node.jsGet started with Azure Search in Node.js

Informazioni su come compilare un'applicazione di ricerca Node.js personalizzata che usa Ricerca di Azure per l'esperienza di ricerca.Learn how to build a custom Node.js search application that uses Azure Search for its search experience. L'esercitazione utilizza l’ API REST del servizio Ricerca di Azure per costruire gli oggetti e le operazioni utilizzati in questo esercizio.This tutorial uses the Azure Search Service REST API to construct the objects and operations used in this exercise.

Sono stati usati Node.js NPM, Sublime Text 3e Windows PowerShell in Windows 8.1 per sviluppare e testare il codice.We used Node.js and NPM, Sublime Text 3, and Windows PowerShell on Windows 8.1 to develop and test this code.

Per eseguire questo esempio, è necessario un servizio di Ricerca di Azure, a cui è possibile iscriversi nel portale di Azure.To run this sample, you must have an Azure Search service, which you can sign up for in the Azure portal. Per istruzioni dettagliate, vedere Creare un servizio di Ricerca di Azure nel portale .See Create an Azure Search service in the portal for step-by-step instructions.

Informazioni sui datiAbout the data

L’applicazione di esempio usa i dati dei servizi geologici degli Stati Uniti (USGS)con il filtro dello stato del Rhode Island per ridurre la dimensione del set di dati.This sample application uses data from the United States Geological Services (USGS), filtered on the state of Rhode Island to reduce the dataset size. Tali dati saranno usati per compilare un'applicazione di ricerca che restituisce gli edifici di riferimento quali ospedali e scuole nonché caratteristiche geologiche come fiumi, laghi e vette.We'll use this data to build a search application that returns landmark buildings such as hospitals and schools, as well as geological features like streams, lakes, and summits.

In questa applicazione, il programma DataIndexer compila e carica l'indice utilizzando un costrutto Indexer , recuperando il set di dati filtrato dei servizi geologici degli Stati Uniti da un database SQL di Azure pubblico.In this application, the DataIndexer program builds and loads the index using an Indexer construct, retrieving the filtered USGS dataset from a public Azure SQL Database. Nel codice del programma vengono fornite credenziali e connessioni all'origine dati online.Credentials and connection information to the online data source is provided in the program code. Non è necessaria ulteriore configurazione.No further configuration is necessary.

Nota

A questo set di dati è stato applicato un filtro per restare sotto il limite di 10.000 documenti del livello di prezzo gratuito.We applied a filter on this dataset to stay under the 10,000 document limit of the free pricing tier. Se si usa il livello standard, questo limite non si applica.If you use the standard tier, this limit does not apply. Per altre informazioni sulla capacità per ogni piano tariffario, vedere Limiti del servizio di ricerca.For details about capacity for each pricing tier, see Search service limits.

Individuare il nome del servizio e la chiave API del servizio Ricerca di AzureFind the service name and api-key of your Azure Search service

Dopo aver creato il servizio, tornare al portale per ottenere l'URL o api-key.After you create the service, return to the portal to get the URL or api-key. Per le connessioni al servizio Ricerca è necessario disporre sia dell'URL che di una api-key per l'autenticazione della chiamata.Connections to your Search service require that you have both the URL and an api-key to authenticate the call.

  1. Accedere al portale di Azure.Sign in to the Azure portal.
  2. Nella barra di spostamento, fare clic su Servizio di ricerca per elencare tutti i servizi di Ricerca di Azure con provisioning per la sottoscrizione.In the jump bar, click Search service to list all Azure Search services provisioned for your subscription.
  3. Selezionare il servizio che si vuole usare.Select the service you want to use.
  4. Nel dashboard del servizio sono presenti i riquadri per le informazioni essenziali, ad esempio l'icona della chiave per l'accesso alle chiavi di amministrazione.On the service dashboard, you should see tiles for essential information, such as the key icon for accessing the admin keys.
  5. Copiare l'URL del servizio, una chiave di amministrazione e una chiave di query.Copy the service URL, an admin key, and a query key. Saranno necessari in seguito, quando verranno aggiunti al file config.js.You need all three later when you add them to the config.js file.

Scaricare i file di esempioDownload the sample files

Utilizzare uno degli approcci seguenti per scaricare l'esempio.Use either one of the following approaches to download the sample.

  1. Andare a AzureSearchNodeJSIndexerDemo.Go to AzureSearchNodeJSIndexerDemo.
  2. Fare clic su Download ZIP, salvare il file con estensione zip su disco e quindi estrarre tutti i file in esso contenuti.Click Download ZIP, save the .zip file, and then extract all the files it contains.

Tutte le successive modifiche e le istruzioni di esecuzione vengono effettuate sui file in questa cartella.All subsequent file modifications and run statements are made against files in this folder.

Aggiornare config.js.Update the config.js. con l'URL del servizio di ricerca e la chiave APIwith your Search service URL and api-key

Utilizzando l'URL e la chiave API copiati in precedenza, specificare l'URL, la chiave di amministrazione e la chiave di query nel file di configurazione.Using the URL and api-key that you copied earlier, specify the URL, admin-key, and query-key in configuration file.

Le chiavi di amministrazione forniscono il controllo completo sulle operazioni del servizio, incluse creazione ed eliminazione di un indice e caricamento di documenti.Admin keys grant full control over service operations, including creating or deleting an index and loading documents. Le chiavi di query, invece, sono per le operazioni di sola lettura, in genere utilizzate dalle applicazioni client che si connettono a Ricerca di Azure.In contrast, query keys are for read-only operations, typically used by client applications that connect to Azure Search.

In questo esempio, è necessario includere la chiave di query per rafforzare la procedura consigliata di utilizzo della chiave di query nelle applicazioni client.In this sample, we include the query key to help reinforce the best practice of using the query key in client applications.

La seguente schermata mostra config.js aperto in un editor di testo con le voci pertinenti delimitate in modo che sia possibile sapere dove aggiornare il file con i valori validi per il servizio di ricerca.The following screenshot shows config.js open in a text editor, with the relevant entries demarcated so that you can see where to update the file with the values that are valid for your search service.

Ospitare un ambiente di runtime per l'esempioHost a runtime environment for the sample

L'esempio richiede un server HTTP, che è possibile installare a livello globale tramite npm.The sample requires an HTTP server, which you can install globally using npm.

Eseguire i comandi seguenti da una finestra di PowerShell:Use a PowerShell window for the following commands.

  1. Passare alla cartella che contiene il file package.json .Navigate to the folder that contains the package.json file.
  2. Digitare npm install.Type npm install.
  3. Digitare npm install -g http-server.Type npm install -g http-server.

Compilare l’indice ed eseguire l'applicazione.Build the index and run the application

  1. Digitare npm run indexDocuments.Type npm run indexDocuments.
  2. Digitare npm run build.Type npm run build.
  3. Digitare npm run start_server.Type npm run start_server.
  4. Inserire nel browser l'indirizzo http://localhost:8080/index.htmlDirect your browser at http://localhost:8080/index.html

Eseguire ricerche sui dati dei servizi geologici degli Stati UnitiSearch on USGS data

Il set di dati dei servizi geologici degli Stati Uniti include i dati relativi allo stato del Rhode Island.The USGS data set includes records that are relevant to the state of Rhode Island. Se si fa clic su Ricerca su una casella di ricerca vuota, si ottengono le prime 50 voci, ossia l'impostazione predefinita.If you click Search on an empty search box, you get the top 50 entries, which is the default.

L'immissione di un termine di ricerca fornisce al motore di ricerca un elemento con cui continuare.Entering a search term gives the search engine something to go on. Provare a immettere un nome locale.Try entering a regional name. "Roger Williams" è stato il primo governatore del Rhode Island."Roger Williams" was the first governor of Rhode Island. Numerosi parchi, edifici e scuole prendono il suo nome.Numerous parks, buildings, and schools are named after him.

È inoltre possibile tentare con uno dei termini seguenti:You could also try any of these terms:

  • PawtucketPawtucket
  • PembrokePembroke
  • goose +capegoose +cape

Passaggi successiviNext steps

Questa è la prima esercitazione di Ricerca di Azure basata su Node.js e sul set di dati dei servizi geologici degli Stati Uniti.This is the first Azure Search tutorial based on Node.js and the USGS dataset. Nel corso del tempo, l’esercitazione sarà ampliata per illustrare le funzionalità di ricerca aggiuntive che potrebbero essere utili nelle soluzioni personalizzate.Over time, we'll extend this tutorial to demonstrate additional search features you might want to use in your custom solutions.

Se si dispone già delle nozioni di base di Ricerca di Azure, è possibile usare questo esempio come base di prova per i suggerimenti di alternative (query di suggerimento per la digitazione e completamento automatico), filtri ed esplorazione basata su facet.If you already have some background in Azure Search, you can use this sample as a springboard for trying suggesters (type-ahead or autocomplete queries), filters, and faceted navigation. È inoltre possibile migliorare la pagina dei risultati della ricerca aggiungendo conteggi e raggruppando i documenti in modo che gli utenti possano sfogliare i risultati.You can also improve upon the search results page by adding counts and batching documents so that users can page through the results.

Novità in Ricerca di AzureNew to Azure Search? È consigliabile provare altre esercitazioni per acquisire consapevolezza di ciò che è possibile creare.We recommend trying other tutorials to develop an understanding of what you can create. Visitare la pagina della documentazione per trovare ulteriori risorse.Visit our documentation page to find more resources. È inoltre possibile visualizzare i collegamenti nell'elenco di video ed esercitazioni per accedere ad altre informazioni.You can also view the links in our Video and Tutorial list to access more information.