Amministrazione dei servizi per Azure ricerca cognitiva nel portale di AzureService administration for Azure Cognitive Search in the Azure portal

Azure ricerca cognitiva è un servizio di ricerca completamente gestito basato sul cloud, usato per creare un'esperienza di ricerca avanzata nelle app personalizzate.Azure Cognitive Search is a fully managed, cloud-based search service used for building a rich search experience into custom apps. Questo articolo illustra le attività di amministrazione del servizio che è possibile eseguire nel portale di Azure per un servizio di ricerca di cui si è già effettuato il provisining.This article covers the service administration tasks that you can perform in the Azure portal for a search service that you've already provisioned. L'amministrazione del servizio è leggera come previsto dalla progettazione ed è limitata alle attività seguenti:Service administration is lightweight by design, limited to the following tasks:

  • Controllare lo spazio di archiviazione usando il collegamento di utilizzo a metà pagina.Check storage using the mid-page Usage link.
  • Controllare la latenza e i volumi di query usando il collegamento di monitoraggio a metà pagina e se le richieste sono state limitate.Check query volumes and latency using the mid-page Monitoring link, and whether requests were throttled.
  • Gestire l'accesso con la pagina chiavi a sinistra.Manage access using the Keys page to the left.
  • Modificare la capacità usando la pagina scala a sinistra.Adjust capacity using the Scale page to the left.

Le stesse attività eseguite nel portale possono essere gestite anche a livello di codice tramite le API di gestione e il modulo AZ. search PowerShell.The same tasks performed in the portal can also be handled programmatically through the Management APIs and Az.Search PowerShell module. Le attività amministrative sono completamente rappresentate tra le interfacce del portale e a livello di codice.Administrative tasks are fully represented across portal and programmatic interfaces. Nessuna attività amministrativa specifica disponibile in una sola modalità.There is no specific administrative task that is available in only one modality.

Azure ricerca cognitiva sfrutta altri servizi di Azure per un monitoraggio e una gestione più approfonditi.Azure Cognitive Search leverages other Azure services for deeper monitoring and management. Di per sé, gli unici dati archiviati con un servizio di ricerca sono il contenuto, ovvero indici, indicizzatori e definizioni delle origini dati e altri oggetti.By itself, the only data stored with a search service is content (indexes, indexer and data source definitions, and other objects). Le metriche segnalate alle pagine del portale vengono estratte da log interni in un ciclo di 30 giorni in sequenza.Metrics reported out to portal pages are pulled from internal logs on a rolling 30-day cycle. Per la conservazione dei log controllata dall'utente e per gli eventi aggiuntivi, è necessario monitoraggio di Azure.For user-controlled log retention and additional events, you will need Azure Monitor.

Proprietà del servizio fisseFixed service properties

Alcuni aspetti di un servizio di ricerca sono determinati quando viene eseguito il provisioning del servizio e non possono essere modificati in un secondo momento:Several aspects of a search service are determined when the service is provisioned and cannot be changed later:

  • Nome del servizio (non è possibile rinominare un servizio)Service name (you cannot rename a service)
  • Posizione del servizio (attualmente non è possibile spostare un servizio intatto in un'altra area)Service location (you cannot currently move an intact service to another region)
  • Numero massimo di repliche e partizioni (determinate dal livello Basic o standard)Maximum replica and partition counts (determined by the tier, Basic or Standard)

Se si inizia con Basic con il massimo di una partizione e sono ora necessarie più partizioni, sarà necessario creare un nuovo servizio a un livello superiore e ricreare il contenuto nel nuovo servizio.If you started with Basic with its maximum of one partition, and you now need more partitions, you will need to create a new service at a higher tier and recreate your content on the new service.

Diritti di amministratoreAdministrator rights

Il provisioning o il ritiro delle autorizzazioni per il servizio in sé può essere effettuato da un amministratore o da un coamministratore della sottoscrizione di Azure.Provisioning or decommissioning the service itself can be done by an Azure subscription administrator or co-administrator.

Per quanto riguarda l'accesso all'endpoint, chiunque disponga dell'accesso all'URL del servizio e una chiave API può accedere al contenuto.Regarding access to the endpoint, anyone with access to the service URL and an api-key has access to content. Per altre informazioni sulle chiavi, vedere gestire le chiavi API.For more information about keys, see Manage the api-keys.

  • L'accesso in sola lettura al servizio è costituito da diritti di query, in genere concessi a un'applicazione client assegnando l'URL e una chiave API di query.Read-only access to the service is query rights, typically granted to a client application by giving it the URL and a query api-key.
  • L'accesso in lettura/scrittura consente di aggiungere, eliminare o modificare oggetti server, tra cui chiavi API, indici, indicizzatori, origini dati e pianificazioni. L'accesso in lettura/scrittura viene concesso assegnando l'URL, una chiave API di amministrazione.Read-write access provides the ability to add, delete, or modify server objects, including api-keys, indexes, indexers, data sources, and schedules.Read-write access is granted by giving the URL, an admin API key.

I diritti per l'apparecchio di provisioning del servizio vengono concessi tramite assegnazioni di ruolo.Rights to the service provisioning apparatus is granted through role assignments. Il controllo degli accessi in base al ruolo di Azure (RBAC di Azure) è un sistema di autorizzazione basato su Azure Resource Manager per il provisioning delle risorse di Azure.Azure role-based access control (Azure RBAC) is an authorization system built on Azure Resource Manager for provisioning of Azure resources.

Nel contesto di Azure ricerca cognitiva le assegnazioni di ruolo di Azure determineranno chi può eseguire attività, indipendentemente dal fatto che stiano usando il portale, PowerShello le API REST di gestione:In the context of Azure Cognitive Search, Azure role assignments will determine who can perform tasks, regardless of whether they are using the portal, PowerShell, or the Management REST APIs:

  • Creare o eliminare un servizioCreate or delete a service
  • Ridimensionare il servizioScale the service
  • Eliminare o rigenerare le chiavi APIDelete or regenerate API keys
  • Abilitare la registrazione diagnostica (crea servizi)Enable diagnostic logging (create services)
  • Abilitare analisi del traffico (creare servizi)Enable traffic analytics (create services)

Suggerimento

Usando i meccanismi a livello di Azure, è possibile bloccare una sottoscrizione o una risorsa per evitare l'eliminazione accidentale o non autorizzata del servizio di ricerca da parte degli utenti con diritti di amministratore.Using Azure-wide mechanisms, you can lock a subscription or resource to prevent accidental or unauthorized deletion of your search service by users with admin rights. Per altre informazioni, vedere bloccare le risorse per impedire l'eliminazione imprevista.For more information, see Lock resources to prevent unexpected deletion.

Informazioni di sistema e registrazioneLogging and system information

Al livello Basic e superiore, Microsoft monitora tutti i servizi ricerca cognitiva di Azure per la disponibilità del 99,9% per ogni contratto di servizio.At the Basic tier and above, Microsoft monitors all Azure Cognitive Search services for 99.9% availability per service level agreements (SLA). Se il servizio è lento o la velocità effettiva delle richieste è al di sotto delle soglie dei contratti di servizio, i team di supporto esaminano i file di log disponibili e risolvono il problema.If the service is slow or request throughput falls below SLA thresholds, support teams review the log files available to them and address the issue.

Azure ricerca cognitiva sfrutta monitoraggio di Azure per raccogliere e archiviare le attività di indicizzazione e query.Azure Cognitive Search leverages Azure Monitor to collect and store indexing and query activity. Un servizio di ricerca da solo archivia il proprio contenuto (indici, definizioni dell'indicizzatore, definizioni delle origini dati, definizioni di competenze, mappe sinonimi).A search service by itself stores just its content (indexes, indexer definitions, data source definitions, skillset definitions, synonym maps). La memorizzazione nella cache e le informazioni registrate vengono archiviate fuori servizio, spesso in un account di archiviazione di Azure.Caching and logged information is stored off-service, often in an Azure Storage account. Per altre informazioni sulla registrazione dei carichi di lavoro di indicizzazione e query, vedere raccogliere e analizzare i dati di log.For more information about logging indexing and query workloads, see Collect and analyze log data.

In termini di informazioni generali sul servizio, usando solo le funzionalità predefinite di Azure ricerca cognitiva, è possibile ottenere informazioni nei modi seguenti:In terms of general information about your service, using just the facilities built into Azure Cognitive Search itself, you can obtain information in the following ways:

  • Utilizzo della pagina Panoramica servizio tramite notifiche, proprietà e messaggi di stato.Using the service Overview page, through notifications, properties, and status messages.
  • Usare PowerShell o l' API REST di gestione per ottenere le proprietà del servizio.Using PowerShell or the Management REST API to get service properties. Al livello programmatico non sono state fornite nuove informazioni o operazioni.There is no new information or operations provided at the programmatic layer. Le interfacce sono disponibili per consentire la scrittura di script.The interfaces exist so that you can write scripts.

Monitorare l'uso delle risorseMonitor resource usage

Nel dashboard il monitoraggio delle risorse è limitato alle informazioni visualizzate nel dashboard del servizio e ad alcune metriche che è possibile ottenere effettuando query sul servizio.In the dashboard, resource monitoring is limited to the information shown in the service dashboard and a few metrics that you can obtain by querying the service. Nella sezione Utilizzo del Dashboard servizi è possibile determinare rapidamente se i livelli delle risorse di partizione sono adeguati per l'applicazione.On the service dashboard, in the Usage section, you can quickly determine whether partition resource levels are adequate for your application. È possibile effettuare il provisioning di risorse esterne, ad esempio monitoraggio di Azure, se si desidera acquisire e rendere permanente gli eventi registrati.You can provision external resources, such as Azure monitoring, if you want to capture and persist logged events. Per altre informazioni, vedere monitoraggio di Azure ricerca cognitiva.For more information, see Monitoring Azure Cognitive Search.

Usando l'API REST del servizio di ricerca, è possibile ottenere un conteggio dei documenti e degli indici a livello di codice:Using the search service REST API, you can get a count on documents and indexes programmatically:

Interruzioni di servizio e ripristino di emergenzaDisaster recovery and service outages

Sebbene sia possibile recuperare i dati, Azure ricerca cognitiva non fornisce il failover immediato del servizio in caso di interruzione a livello di cluster o di data center.Although we can salvage your data, Azure Cognitive Search does not provide instant failover of the service if there is an outage at the cluster or data center level. Se un cluster non funziona nel data center, il team operativo lo rileverà e provvederà a ripristinare il servizio.If a cluster fails in the data center, the operations team will detect and work to restore service. Si verificheranno tempi di inattività durante il ripristino del servizio ma è possibile richiedere i crediti del servizio per compensarne la non disponibilità in base al Contratto di servizio (SLA).You will experience downtime during service restoration, but you can request service credits to compensate for service unavailability per the Service Level Agreement (SLA).

Se un servizio continuo è necessario in caso di errori irreversibili che Microsoft non può controllare, è necessario eseguire il provisioning di un servizio aggiuntivo in un'area diversa e implementare una strategia di replica geografica per garantire che gli indici siano completamente ridondanti in tutti i servizi.If continuous service is required in the event of catastrophic failures outside of Microsoft’s control, you could provision an additional service in a different region and implement a geo-replication strategy to ensure indexes are fully redundant across all services.

I clienti che usano gli indicizzatori per compilare e aggiornare gli indici possono gestire il ripristino di emergenza tramite gli indicizzatori specifici per l'area geografica che sfruttando la stessa origine dati.Customers who use indexers to populate and refresh indexes can handle disaster recovery through geo-specific indexers leveraging the same data source. Due servizi in diverse aree, ognuno dei quali esegue un indicizzatore, possono indicizzare la stessa origine dati per ottenere la ridondanza geografica.Two services in different regions, each running an indexer, could index the same data source to achieve geo-redundancy. Se si esegue l'indicizzazione da origini dati anche con ridondanza geografica, tenere presente che gli indicizzatori di Azure ricerca cognitiva possono eseguire solo l'indicizzazione incrementale (Unione di aggiornamenti da documenti nuovi, modificati o eliminati) dalle repliche primarie.If you are indexing from data sources that are also geo-redundant, be aware that Azure Cognitive Search indexers can only perform incremental indexing (merging updates from new, modified, or deleted documents) from primary replicas. In un evento di failover, assicurarsi di puntare di nuovo all'indicizzatore per la nuova replica primaria.In a failover event, be sure to re-point the indexer to the new primary replica.

Se non si usano gli indicizzatori, l'utente userà il codice dell'applicazione per eseguire il push sugli oggetti e i dati per diversi servizi in parallelo.If you do not use indexers, you would use your application code to push objects and data to different search services in parallel. Per altre informazioni, vedere prestazioni e ottimizzazione in Azure ricerca cognitiva.For more information, see Performance and optimization in Azure Cognitive Search.

Backup e ripristinoBackup and restore

Poiché ricerca cognitiva di Azure non è una soluzione di archiviazione dati primaria, non è disponibile un meccanismo formale per il backup e il ripristino self-service.Because Azure Cognitive Search is not a primary data storage solution, we do not provide a formal mechanism for self-service backup and restore. Tuttavia, è possibile usare il codice di esempio index-backup-restore in questo repository di esempio di Azure ricerca cognitiva .NET per eseguire il backup della definizione dell'indice e dello snapshot in una serie di file JSON e quindi usare questi file per ripristinare l'indice, se necessario.However, you can use the index-backup-restore sample code in this Azure Cognitive Search .NET sample repo to backup your index definition and snapshot to a series of JSON files, and then use these files to restore the index, if needed. Questo strumento può inoltre spostare gli indici tra i livelli di servizio.This tool can also move indexes between service tiers.

In caso contrario, il codice dell'applicazione utilizzato per creare e popolare un indice è l'opzione di ripristino de facto se si elimina un indice per errore.Otherwise, your application code used for creating and populating an index is the de facto restore option if you delete an index by mistake. Per ricompilare un indice, è necessario eliminarlo (supponendo che sia presente), ricreare l'indice nel servizio e ricaricare recuperando i dati dall'archivio dati primario.To rebuild an index, you would delete it (assuming it exists), recreate the index in the service, and reload by retrieving data from your primary data store.

Aumentare o ridurre la quantità di risorseScale up or down

Ogni servizio di ricerca viene creato con un minimo di una replica e una partizione.Every search service starts with a minimum of one replica and one partition. Se è stata eseguita l'iscrizione a un livello che supporta una maggiore capacità, fare clic su Ridimensiona nel riquadro di spostamento a sinistra per modificare l'utilizzo delle risorse.If you signed up for a tier that supports more capacity, click Scale on the left navigation pane to adjust resource usage.

Quando si aggiunge capacità tramite l'una o l'altra risorsa, la risorsa aggiunta viene usata dal servizio in modo automatico.When you add capacity through either resource, the service uses them automatically. Non sono necessarie altre azioni da parte dell'utente, ma vi sarà un lieve ritardo prima che l'impatto delle nuove risorse sia apprezzabile.No further action is required on your part, but there is a slight delay before the impact of the new resource is realized. Possono essere necessari 15 o più minuti per il provisioning delle risorse aggiuntive.It can take 15 minutes or more to provision additional resources.

Aggiungere replicheAdd replicas

L'aumento delle query al secondo o il raggiungimento della disponibilità elevata si ottengono mediante l'aggiunta di repliche.Increasing queries per second (QPS) or achieving high availability is done by adding replicas. Ogni replica presenta una copia di un indice, quindi l'aggiunta di un'altra replica si traduce in un indice aggiuntivo disponibile per la gestione delle richieste di query del servizio.Each replica has one copy of an index, so adding one more replica translates to one more index available for handling service query requests. Per la disponibilità elevata sono necessari almeno 3 repliche. per informazioni dettagliate, vedere regolazione della capacità .A minimum of 3 replicas are required for high availability (see Adjust capacity for details).

Un servizio di ricerca con un numero superiore di repliche può eseguire il bilanciamento del carico delle richieste di query su un numero maggiore di indici.A search service having more replicas can load balance query requests over a larger number of indexes. Per un determinato volume di query, la velocità effettiva delle query sarà maggiore in presenza di più copie dell'indice disponibili per soddisfare la richiesta.Given a level of query volume, query throughput is going to be faster when there are more copies of the index available to service the request. Se si verificano latenze delle query, ci si può aspettare un netto miglioramento delle prestazioni una volta portate online le repliche aggiuntive.If you are experiencing query latency, you can expect a positive impact on performance once the additional replicas are online.

Sebbene la velocità effettiva delle query aumenti quando si aggiungono repliche, non viene effettivamente raddoppiata o triplicata in rapporto al numero di repliche aggiunte.Although query throughput goes up as you add replicas, it does not precisely double or triple as you add replicas to your service. Tutte le applicazioni di ricerca sono influenzate da fattori esterni che possono influire sulle prestazioni di query.All search applications are subject to external factors that can impinge on query performance. Query complesse e latenza di rete sono due fattori che contribuiscono alle variazioni nei tempi di risposta alle query.Complex queries and network latency are two factors that contribute to variations in query response times.

Aggiungere partizioniAdd partitions

È più comune aggiungere repliche, ma quando l'archiviazione è vincolata, è possibile aggiungere partizioni per ottenere una maggiore capacità.It's more common to add replicas, but when storage is constrained, you can add partitions to get more capacity. Il livello in cui è stato effettuato il provisioning del servizio determina se è possibile aggiungere partizioni.The tier at which you provisioned the service determines whether partitions can be added. Il livello Basic è bloccato in una partizione.The Basic tier is locked at one partition. I livelli standard e versioni successive supportano partizioni aggiuntive.Standard tiers and above support additional partitions.

Le partizioni vengono aggiunte in divisori di 12 (in particolare 1, 2, 3, 4, 6 o 12).Partitions are added in divisors of 12 (specifically, 1, 2, 3, 4, 6, or 12). Si tratta di un elemento del partizionamento orizzontale.This is an artifact of sharding. Un indice viene creato in 12 sottopartizioni, tutte archiviabili a propria volta in 1 partizione o equamente distribuibili in 2, 3, 4, 6 o 12 partizioni (in quest'ultimo caso, una per partizione).An index is created in 12 shards, which can all be stored on 1 partition or equally divided into 2, 3, 4, 6, or 12 partitions (one shard per partition).

Rimuovere replicheRemove replicas

Dopo periodi di alti volumi di query è possibile usare il dispositivo di scorrimento per ridurre le repliche dopo che i carichi di query di ricerca si sono normalizzati, ad esempio al termine di un periodo di vendite per le feste.After periods of high query volumes, you can use the slider to reduce replicas after search query loads have normalized (for example, after holiday sales are over). Non vi sono altre azioni richieste da parte dell'utente.There are no further steps required on your part. La riduzione del numero di repliche comporta il rilascio di macchine virtuali nel data center.Lowering the replica count relinquishes virtual machines in the data center. Le operazioni di query e di inserimento dati verranno ora elaborate su un numero minore di VM rispetto a prima.Your query and data ingestion operations will now run on fewer VMs than before. Il requisito minimo è una replica.The minimum requirement is one replica.

Rimuovere partizioniRemove partitions

A differenza della rimozione di repliche, che non richiede operazioni aggiuntive da parte dell'utente, potrebbe essere richiesto lavoro aggiuntivo se si occupa più archiviazione di quanta se ne vuole ottenere dopo una riduzione.In contrast with removing replicas, which requires no extra effort on your part, you might have some work to do if you are using more storage than can be reduced. Ad esempio, se la soluzione usa tre partizioni, il ridimensionamento a una o due partizioni genererà un errore se il nuovo spazio di archiviazione è meno di quello necessario per l'hosting dell'indice.For example, if your solution is using three partitions, downsizing to one or two partitions will generate an error if the new storage space is less than required for hosting your index. Come è prevedibile, la scelta è di eliminare indici o documenti in un indice associato per liberare spazio oppure di mantenere la configurazione attuale.As you might expect, your choices are to delete indexes or documents within an associated index to free up space, or keep the current configuration.

Non è disponibile un metodo di rilevamento che indichi quante sottopartizioni di indice sono archiviate su una partizione specifica.There is no detection method that tells you which index shards are stored on specific partitions. Ogni partizione fornisce approssimativamente 25 GB di spazio di archiviazione, pertanto sarà necessario ridurre l'archiviazione a una dimensione che possa essere contenuta nel numero disponibile di partizioni.Each partition provides approximately 25 GB in storage, so you will need to reduce storage to a size that can be accommodated by the number of partitions you have. Se si vuole tornare a una partizione, questa dovrà contenere tutte e 12 le sottopartizioni.If you want to revert to one partition, all 12 shards will need to fit.

Per pianificare in anticipo le esigenze future, è possibile verificare l'archiviazione (usando Ottieni statistiche indice) per verificare quanta archiviazione è stata effettivamente usata.To help with future planning, you might want to check storage (using Get Index Statistics) to see how much you actually used.

Passaggi successiviNext steps