Guida introduttiva: Creare un servizio Ricerca cognitiva di Azure nel portaleQuickstart: Create an Azure Cognitive Search service in the portal

Ricerca cognitiva di Azure è una risorsa autonoma usata per aggiungere un'esperienza di ricerca alle app personalizzate.Azure Cognitive Search is a standalone resource used to plug in a search experience in custom apps. Ricerca cognitiva di Azure si integra facilmente con altri servizi di Azure, ma è possibile usarlo anche come componente autonomo oppure integrarlo con le app nei server di rete o con il software in esecuzione in altre piattaforme cloud.Although Azure Cognitive Search integrates easily with other Azure services, you can also use it as a standalone component, or integrate it with apps on network servers, or with software running on other cloud platforms.

In questo articolo verrà illustrato come creare una risorsa nel portale di Azure.In this article, learn how to create a resource in the Azure portal.

GIF animataAnimated GIF

Se si preferisce PowerShell,Prefer PowerShell? usare il modello di servizio di Azure Resource Manager.Use the Azure Resource Manager service template. Per informazioni su come iniziare, vedere Gestire il servizio Ricerca cognitiva di Azure con PowerShell.For help with getting started, see Manage Azure Cognitive Search with PowerShell.

Sottoscrizione gratuita o a pagamentoSubscribe (free or paid)

Aprire un account Azure gratuito e usare i crediti per provare i servizi di Azure a pagamento.Open a free Azure account and use free credits to try out paid Azure services. Dopo avere consumato i crediti, mantenere l'account e continuare a usare i servizi di Azure gratuiti, ad esempio Siti Web.After credits are used up, keep the account and continue to use free Azure services, such as Websites. Verranno applicati addebiti alla carta di credito solo se l'utente modifica le impostazioni e richiede esplicitamente l'addebito.Your credit card is never charged unless you explicitly change your settings and ask to be charged.

In alternativa, attivare i benefici della sottoscrizione MSDN.Alternatively, activate MSDN subscriber benefits. Con la sottoscrizione MSDN ogni mese si accumulano crediti che è possibile usare per i servizi di Azure a pagamento.An MSDN subscription gives you credits every month you can use for paid Azure services.

  1. Accedere al portale di Azure.Sign in to the Azure portal.
  2. Fare clic sul segno più ("+ Crea risorsa") nell'angolo superiore sinistro.Click the plus sign ("+ Create Resource") in the top-left corner.
  3. Usare la barra di ricerca per trovare "Ricerca cognitiva di Azure" o passare alla risorsa selezionando Web > Ricerca cognitiva di Azure.Use the search bar to find "Azure Cognitive Search" or navigate to the resource through Web > Azure Cognitive Search.

Creare una risorsa nel portaleCreate a resource in the portal

Scegliere una sottoscrizione.Choose a subscription

Se sono disponibili più sottoscrizioni, sceglierne una per il servizio di ricerca.If you have more than one subscription, choose one for your search service.

Impostare un gruppo di risorseSet a resource group

Un gruppo di risorse è necessario e utile per la gestione a livello globale delle risorse, inclusi i costi.A resource group is required and is useful for managing resources all-up, including costs. Un gruppo di risorse può essere costituito da un servizio o da più servizi usati in combinazione.A resource group can consist of one service, or multiple services used together. Se, ad esempio, si usa Ricerca cognitiva di Azure per l'indicizzazione di un database di Azure Cosmos DB, è possibile inserire i due servizi nello stesso gruppo di risorse per agevolarne la gestione.For example, if you are using Azure Cognitive Search to index an Azure Cosmos DB database, you could make both services part of the same resource group for management purposes.

Se non si combinano le risorse in un singolo gruppo o se i gruppi di risorse esistenti sono riempiti con risorse usate in soluzioni non correlate, creare un nuovo gruppo di risorse solo per la risorsa Ricerca cognitiva di Azure.If you aren't combining resources into a single group, or if existing resource groups are filled with resources used in unrelated solutions, create a new resource group just for your Azure Cognitive Search resource.

Creare un nuovo gruppo di risorseCreate a new resource group

Nel tempo, è possibile tenere traccia dei costi correnti e previsti a livello globale, come illustrato nello screenshot, oppure scorrere verso il basso per visualizzare i costi per le singole risorse.Over time, you can track current and projected costs all-up (as shown in the screenshot) or scroll down to view charges for individual resources. Lo screenshot seguente mostra il tipo di informazioni sui costi che è possibile prevedere quando si combinano più risorse in un unico gruppo.The following screenshot shows the kind of cost information you can eventually expect to see when you combine multiple resources into one group.

Gestire i costi a livello di gruppo di risorseManage costs at the resource group level

Suggerimento

I gruppi di risorse semplificano la pulizia, in quanto l'eliminazione di un gruppo elimina anche i servizi al suo interno.Resource groups simplify cleanup because deleting a group also deletes the services within it. Per i progetti prototipo che usano più servizi, l'inserimento di tutti gli elementi nello stesso gruppo di risorse ne semplifica l'eliminazione al termine del progetto.For prototype projects utilizing multiple services, putting all of them in the same resource group makes cleanup easier after the project is over.

Assegnare un nome al servizioName the service

In Dettagli istanza fornire un nome per il servizio nel campo URL.In Instance Details, provide a service name in the URL field. Questo nome fa parte dell'endpoint dell'URL in cui vengono eseguite le chiamate API: https://your-service-name.search.windows.net.The name is part of the URL endpoint against which API calls are issued: https://your-service-name.search.windows.net. Se ad esempio si vuole che l'endpoint sia https://myservice.search.windows.net, immettere myservice.For example, if you want the endpoint to be https://myservice.search.windows.net, you would enter myservice.

Requisiti per i nomi di servizio:Service name requirements:

  • Deve essere univoco all'interno dello spazio dei nomi search.windows.netIt must be unique within the search.windows.net namespace
  • lunghezza compresa tra 2 e 60 caratteri2 and 60 characters in length
  • È possibile usare lettere minuscole, cifre o trattini ("-")Use lowercase letters, digits, or dashes ("-")
  • Non può contenere un trattino ("-") nei primi 2 caratteri o nell'ultimo carattereAvoid dashes ("-") in the first 2 characters or as the last single character
  • Non deve contenere trattini consecutivi ("--")No consecutive dashes ("--") anywhere

Suggerimento

Se si prevede di usare più servizi, è consigliabile includere l'area o la località nel nome del servizio come convenzione di denominazione.If you think you'll be using multiple services, we recommend including the region (or location) in the service name as a naming convention. I servizi all'interno della stessa area possono scambiare dati gratuitamente, quindi se Ricerca cognitiva di Azure si trova nell'area Stati Uniti occidentali e in quest'area sono presenti altri servizi, un nome come mysearchservice-westus può consentire di evitare di dover visualizzare la pagina delle proprietà per decidere come combinare o collegare le risorse.Services within the same region can exchange data at no charge, so if Azure Cognitive Search is in West US, and you have other services also in West US, a name like mysearchservice-westus can save you a trip to the properties page when deciding how to combine or attach resources.

Scegliere una posizioneChoose a location

Ricerca cognitiva di Azure, in qualità di servizio di Azure, può essere ospitato nei data center di tutto il mondo.As an Azure service, Azure Cognitive Search can be hosted in datacenters around the world. L'elenco delle aree supportate è disponibile nella pagina dei prezzi.The list of supported regions can be found in the pricing page.

È possibile ridurre al minimo o evitare i costi per la larghezza di banda scegliendo la stessa posizione per più servizi.You can minimize or avoid bandwidth charges by choosing the same location for multiple services. Se, ad esempio, si esegue l'indicizzazione dei dati forniti da un altro servizio di Azure (Archiviazione di Azure, Azure Cosmos DB, database SQL di Azure), creando il servizio Ricerca cognitiva di Azure nella stessa area è possibile evitare i costi relativi alla larghezza di banda, in quanto non vengono addebitati costi per i dati in uscita quando i servizi si trovano nella stessa area.For example, if you are indexing data provided by another Azure service (Azure storage, Azure Cosmos DB, Azure SQL Database), creating your Azure Cognitive Search service in the same region avoids bandwidth charges (there are no charges for outbound data when services are in the same region).

Se inoltre si usano arricchimenti tramite intelligenza artificiale, creare il servizio nella stessa area di Servizi cognitivi.Additionally, if you are using AI enrichment, create your service in the same region as Cognitive Services. Per l'arricchimento tramite intelligenza artificiale, Ricerca cognitiva di Azure e Servizi cognitivi devono trovarsi nella stessa area.Co-location of Azure Cognitive Search and Cognitive Services in the same region is a requirement for AI enrichment.

Nota

L'area India centrale no n è attualmente disponibile per i nuovi servizi.Central India is currently unavailable for new services. Per i servizi già in India centrale, è possibile aumentare le prestazioni senza alcuna restrizione e il servizio è completamente supportato in tale area.For services already in Central India, you can scale up with no restrictions, and your service is fully supported in that region. La restrizione in quest'area è temporanea ed è limitata solo ai nuovi servizi.The restriction on this region is temporary and limited to new services only. Quando la restrizione non sarà più valida, questa nota verrà rimossa.We will remove this note when the restriction no longer applies.

Scegliere un piano tariffario (SKU)Choose a pricing tier (SKU)

Ricerca cognitiva di Azure attualmente è disponibile con vari piani tariffari: Gratuito, Basic o Standard.Azure Cognitive Search is currently offered in multiple pricing tiers: Free, Basic, or Standard. Ogni piano tariffario prevede una specifica capacità e limiti.Each tier has its own capacity and limits. Per indicazioni, vedere Scegliere uno SKU o un piano tariffario per Ricerca di Azure .See Choose a pricing tier or SKU for guidance.

Per carichi di lavoro di produzione viene in genere scelto il piano Basic o Standard, ma la maggior parte dei clienti inizia con il servizio gratuito.Basic and Standard are the most common choices for production workloads, but most customers start with the Free service. Le differenze principali tra i livelli sono la velocità e la dimensione della partizione, nonché i limiti per il numero di oggetti che è possibile creare.Key differences among tiers is partition size and speed, and limits on the number of objects you can create.

Non è possibile modificare il piano tariffario dopo aver creato il servizio.Remember that a pricing tier cannot be changed once the service is created. Se in un secondo momento si vuole passare a un piano tariffario superiore o inferiore, è necessario creare nuovamente il servizio.If you need a higher or lower tier later, you have to re-create the service.

Creare il servizioCreate your service

Dopo aver fornito gli input necessari, procedere con la creazione del servizio.After you've provided the necessary inputs, go ahead and create the service.

Rivedere e creare il servizioReview and create the service

Il servizio, che può essere monitorato tramite le notifiche di Azure, viene distribuito in pochi minuti.Your service is deployed within minutes, which you can monitor through Azure notifications. Aggiungere il servizio al dashboard per accedervi facilmente in futuro.Consider pinning the service to your dashboard for easy access in the future.

Monitorare e aggiungere il servizioMonitor and pin the service

Ottenere una chiave e un endpoint dell'URLGet a key and URL endpoint

A meno che non si usi il portale, per accedere al nuovo servizio a livello di codice è necessario specificare l'endpoint dell'URL e una chiave API di autenticazione.Unless you are using the portal, programmatic access to your new service requires that you provide the URL endpoint and an authentication api-key.

  1. Nella pagina Panoramica individuare e copiare l'endpoint dell'URL visualizzato a destra.On the Overview page, locate and copy the URL endpoint on the right side of the page.

  2. Nella pagina Chiavi copiare una delle chiavi di amministrazione (equivalenti).On the Keys page, copy either one of the admin keys (they are equivalent). Le chiavi API di amministrazione sono necessarie per creare, aggiornare ed eliminare oggetti nel servizio.Admin api-keys are required for creating, updating, and deleting objects on your service. Al contrario, le chiavi di query forniscono l'accesso in lettura al contenuto dell'indice.In contrast, query keys provide read-access to index content.

    Pagina Panoramica del servizio con endpoint dell'URLService overview page with URL endpoint

Per le attività basate sul portale, l'endpoint e la chiave non sono necessari.An endpoint and key are not needed for portal-based tasks. Il portale è già collegato alla risorsa di Ricerca cognitiva di Azure con diritti amministrativi.The portal is already linked to your Azure Cognitive Search resource with admin rights. Per una procedura dettagliata per il portale, iniziare con Avvio rapido: Creare un indice di Ricerca cognitiva di Azure nel portale.For a portal walkthrough, start with Quickstart: Create an Azure Cognitive Search index in the portal.

Ridimensionare il servizioScale your service

Al termine del provisioning del servizio, è possibile ridimensionare il servizio per adattarlo alle proprie esigenze.After your service is provisioned, you can scale it to meet your needs. Se è stato scelto il piano tariffario Standard per il servizio Ricerca cognitiva di Azure, è possibile ridimensionare il servizio in due dimensioni, ovvero partizioni e repliche.If you chose the Standard tier for your Azure Cognitive Search service, you can scale your service in two dimensions: replicas and partitions. Se fosse stato scelto il piano Basic, sarebbe stato possibile aggiungere solo le repliche.Had you chosen the Basic tier, you can only add replicas. Se è stato effettuato il provisioning del servizio Gratuito, la scalabilità non è disponibile.If you provisioned the free service, scale is not available.

Le partizioni consentono di archiviare e di eseguire ricerche in un numero maggiore di documenti nel servizio.Partitions allow your service to store and search through more documents.

Repliche consentire al servizio gestire un carico superiore di query di ricerca.Replicas allow your service to handle a higher load of search queries.

L'aggiunta di risorse fa aumentare la fattura mensile.Adding resources increases your monthly bill. Il calcolatore prezzi consente di capire le ramificazioni della fattura dovute all'aggiunta di risorse.The pricing calculator can help you understand the billing ramifications of adding resources. Tenere presente che è possibile modificare le risorse in base al carico.Remember that you can adjust resources based on load. Ad esempio, è possibile aumentare le risorse per creare un indice iniziale completo e ridurle successivamente a un livello più appropriato per l'indicizzazione incrementale.For example, you might increase resources to create a full initial index, and then reduce resources later to a level more appropriate for incremental indexing.

  1. Passare alla pagina del servizio di ricerca nel portale di Azure.Go to your search service page in the Azure portal.
  2. Nel riquadro di navigazione a sinistra selezionare Impostazioni > Scalabilità.In the left-navigation pane, select Settings > Scale.
  3. Usare la barra di scorrimento per aggiungere risorse di entrambi i tipi.Use the slidebar to add resources of either type.

Aggiungere capacitàAdd capacity

Nota

A livelli superiori la velocità e lo spazio di archiviazione per partizione aumentano.Per-partition storage and speed increases at higher tiers. Per altre informazioni, vedere l'articolo su capacità e limiti.For more information, see capacity and limits.

Aggiunta di un secondo servizioWhen to add a second service

La maggior parte dei clienti usa un solo servizio su cui esegue il provisioning a un livello che offre il giusto equilibrio di risorse.Most customers use just one service provisioned at a tier providing the right balance of resources. Un servizio può ospitare più indici, soggetto ai limiti massimi del livello selezionato, con ciascun indice isolato dall'altro.One service can host multiple indexes, subject to the maximum limits of the tier you select, with each index isolated from another. In Ricerca cognitiva di Azure le richieste possono essere indirizzate solo a un indice, riducendo al minimo le probabilità di recupero di dati accidentale o intenzionale da altri indici nello stesso servizio.In Azure Cognitive Search, requests can only be directed to one index, minimizing the chance of accidental or intentional data retrieval from other indexes in the same service.

Sebbene la maggior parte dei clienti usi un solo servizio, la ridondanza del servizio potrebbe essere necessaria se i requisiti operativi includono i seguenti elementi:Although most customers use just one service, service redundancy might be necessary if operational requirements include the following:

  • Ripristino di emergenza (interruzione del data center).Disaster recovery (data center outage). Ricerca cognitiva di Azure non offre il failover immediato in caso di interruzione.Azure Cognitive Search does not provide instant failover in the event of an outage. Per consigli e informazioni aggiuntive, vedere Amministrazione del servizio.For recommendations and guidance, see Service administration.
  • L'analisi della modellazione multi-tenancy ha determinato che i servizi aggiuntivi siano la progettazione ottimale.Your investigation of multi-tenancy modeling has determined that additional services is the optimal design. Per altre informazioni, vedere Progettazione per multi-tenancy.For more information, see Design for multi-tenancy.
  • Per le applicazioni distribuite globalmente è possibile richiedere un'istanza di Ricerca cognitiva di Azure in più aree per ridurre al minimo la latenza del traffico internazionale dell'applicazione.For globally deployed applications, you might require an instance of Azure Cognitive Search in multiple regions to minimize latency of your application’s international traffic.

Nota

In Ricerca cognitiva di Azure non è possibile isolare le operazioni di indicizzazione e query, quindi non devono essere creati più servizi per i carichi di lavoro isolati.In Azure Cognitive Search, you cannot segregate indexing and querying operations; thus, you would never create multiple services for segregated workloads. Per un indice viene sempre eseguita una query sul servizio in cui è stato creato (non è possibile creare un indice in un servizio e copiarlo in un altro).An index is always queried on the service in which it was created (you cannot create an index in one service and copy it to another).

Non è necessario un secondo servizio per la disponibilità elevata.A second service is not required for high availability. La disponibilità elevata per le query si raggiunge quando si usano 2 o più repliche nello stesso servizio.High availability for queries is achieved when you use 2 or more replicas in the same service. Gli aggiornamenti di replica sono sequenziali, il che significa che almeno uno è operativo quando viene implementato un aggiornamento del servizio. Per altre informazioni sul tempo di attività, vedere i Contratti di servizio.Replica updates are sequential, which means at least one is operational when a service update is rolled out. For more information about uptime, see Service Level Agreements.

Passaggi successiviNext steps

Dopo il provisioning di un servizio, è possibile continuare nel portale con la creazione del primo indice.After provisioning a service, you can continue in the portal to create your first index.