Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Che cos'è Amazon CloudSearch?
**Importante**
Amazon non CloudSearch è più disponibile per i nuovi clienti. I clienti esistenti di Amazon CloudSearch possono continuare a utilizzare il servizio come di consueto. [Ulteriori informazioni](https://aws.amazon.com/blogs/big-data/transition-from-amazon-cloudsearch-to-amazon-opensearch-service/).
Amazon CloudSearch è un servizio completamente gestito nel cloud che semplifica la configurazione, la gestione e la scalabilità di una soluzione di ricerca per il tuo sito Web o la tua applicazione.
Con Amazon CloudSearch puoi cercare grandi raccolte di dati come pagine web, file di documenti, post di forum o informazioni sui prodotti. Puoi aggiungere in modo veloce funzionalità di ricerca anche senza essere un esperto nella ricerca e senza doverti preoccupare del provisioning, dell'impostazione e della manutenzione dell'hardware. In base alle fluttuazioni del volume di dati e del traffico, Amazon si CloudSearch adatta alle tue esigenze.
**Nota**
Questo documento descrive l'API Amazon CloudSearch 2013-01-01. [Se disponi di domini di ricerca 2011-02-01 e devi fare riferimento alla vecchia documentazione, puoi scaricare un PDF della Guida per gli sviluppatori del 01/02/2011.](https://s3.amazonaws.com/awsdocs/cloudsearch/2011-02-01/cloudsearch-dg-2011-02-01.pdf)
Puoi usare Amazon CloudSearch per indicizzare e cercare sia dati strutturati che testo semplice. CloudSearch Caratteristiche di Amazon:
+ Ricerca di testo completo con elaborazione di testo specifica della lingua
+ Ricerca booleana
+ Ricerche di prefissi
+ Ricerche di intervalli
+ Assegnazione di priorità ai termini
+ Faceting
+ Evidenziazione
+ I suggerimenti di completamento automatico
È possibile ottenere risultati di ricerca in formato JSON o XML, ordinare e filtrare i risultati in base ai valori di campo e ordinare i risultati in ordine alfabetico, numerico o in base a espressioni personalizzate.
Per creare una soluzione di ricerca con Amazon CloudSearch, procedi nel seguente modo:
+ **Crea e configura un dominio di ricerca.** Un dominio di ricerca include i dati ricercabili e le istanze di ricerca che gestiscono le richieste di ricerca. Se hai più raccolte di dati che desideri rendere ricercabili, puoi creare domini di ricerca multipli.
+ **Carica i dati che desideri cercare nel tuo dominio.** Amazon CloudSearch indicizza i tuoi dati e distribuisce l'indice di ricerca in una o più istanze di ricerca.
+ **Eseguire ricerche nel dominio.** Invii una richiesta di ricerca all'endpoint di ricerca del tuo dominio come richiesta GET. HTTP/HTTPS
**Topics**
+ [Sei nuovo su Amazon CloudSearch?](#new-to-cloudsearch)
+ [Come funziona la ricerca](how-search-works.md)
+ [Scalabilità automatica in Amazon CloudSearch](concepts-scaling.md)
+ [Accesso ad Amazon CloudSearch](#accessing-cloudsearch)
+ [Domande frequenti](#faq)
## Sei nuovo su Amazon CloudSearch?
Per una panoramica di alto livello di Amazon CloudSearch, i punti salienti del servizio e le informazioni sui prezzi, consulta la [pagina dei CloudSearch dettagli di Amazon](https://aws.amazon.com/cloudsearch/). Se sei pronto per iniziare a utilizzare Amazon CloudSearch, dovresti iniziare con[Guida introduttiva ad Amazon CloudSearch](getting-started.md).
Puoi interagire con Amazon CloudSearch tramite AWS SDKs o AWS CLI. Console di gestione AWS Puoi anche inviare richieste API direttamente ad Amazon CloudSearch, firmarle AWS CLI automaticamente secondo necessità SDKs e fornire strumenti centralizzati per interagire con i CloudSearch domini Amazon in combinazione con altri servizi AWS. Per informazioni su AWS SDKs, consulta [Tools for Amazon Web Services](https://aws.amazon.com/tools/). Per informazioni sull'installazione e l'utilizzo di AWS CLI, consulta la [Guida AWS Command Line Interface per l'utente](https://docs.aws.amazon.com/cli/latest/userguide/).
Per ulteriori informazioni sulla configurazione e la gestione dei domini di ricerca, l'inserimento dei dati in Amazon CloudSearch, l'invio di richieste di ricerca e l'elaborazione delle risposte, consulta:
+ [Preparazione dei dati](preparing-data.md)—come formattare i dati in modo da poterli caricare su un CloudSearch dominio Amazon per l'indicizzazione
+ [Configurazione dei campi dell'indice](configuring-index-fields.md)—come configurare le opzioni di indicizzazione per un dominio Amazon CloudSearch
+ [Ricerca nei tuoi dati con Amazon CloudSearch](searching.md)—come usare il linguaggio di CloudSearch interrogazione Amazon
+ [Controllo dei risultati delle ricerche](controlling-search-results.md)—come ordinare, filtrare e impaginare i risultati di ricerca
# Come funziona la ricerca
La raccolta di dati in cui si desidera eseguire le ricerche (talvolta definita *corpus*) può essere costituita da documenti di testo non strutturati, documenti semistrutturati, ad esempio quelli formattati in linguaggi di markup come XML, o dati strutturati conformi a un modello di dati preciso. Ogni voce in cui intendi eseguire le ricerche, ad esempio un post di forum o una pagina Web, è rappresentata come documento. Ogni documento ha un ID univoco e uno o più campi che contengono i dati in cui desideri eseguire le ricerche e che intendi includere nei risultati.
Per rendere i tuoi dati ricercabili, li rappresenti come un batch di documenti in JSON o XML e carichi il batch nel tuo dominio di ricerca. Amazon genera CloudSearch quindi un indice di ricerca dai dati del documento in base alle opzioni di configurazione del dominio. Puoi inviare query a questo indice per individuare i documenti che soddisfano criteri di ricerca specifici.
Quando i tuoi dati cambiano, devi inviare gli aggiornamenti per aggiungere, modificare o eliminare i documenti dall’indice. Gli aggiornamenti vengono applicati in modo continuo nell'ordine in cui vengono ricevuti.
Per informazioni su come formattare i dati, vedi [Preparazione dei dati](preparing-data.md).
## Indicizzazione in Amazon CloudSearch
Per creare un indice di ricerca a partire dai tuoi dati, Amazon CloudSearch necessita delle seguenti informazioni:
+ In quali campi del documento intendi eseguire le ricerche.
+ Quali valori dei campi del documento desideri recuperare con i risultati di ricerca.
+ Quali campi del documento rappresentano categorie che desideri utilizzare per perfezionare e filtrare i risultati della ricerca.
+ Come deve essere elaborato il testo all'interno di un determinato campo.
Puoi definire questi metadati nella configurazione del tuo dominio specificando le opzioni di indicizzazione. È possibile utilizzare le opzioni di indicizzazione per specificare i campi inclusi nell'indice di ricerca e controllare le modalità di utilizzo di tali campi.
Devi configurare un campo indice corrispondente per ogni campo del documento presente nei tuoi dati: esiste una one-to-one mappatura tra i campi del documento e i campi del tuo indice Amazon. CloudSearch Oltre al nome del campo dell'indice, è necessario specificare:
+ Tipo di campo dell'indice
+ Se il campo è ricercabile (i campi `text` e `text-array` sono sempre ricercabili)
+ Se il campo può essere utilizzato come categoria (facet)
+ Se nei risultati di ricerca può essere restituito il valore del campo.
+ Se il campo può essere utilizzato per ordinare i risultati.
+ Se per il campo possono essere restituite evidenziazioni.
+ Un valore predefinito da utilizzare se non viene specificato alcun valore nei dati del documento.
Per informazioni su come configurare i campi indice per Amazon CloudSearch, consulta[Configurazione dei campi dell'indice](configuring-index-fields.md).
## Sfaccettature su Amazon CloudSearch
Un facet è un campo dell'indice che rappresenta una categoria che desideri utilizzare per perfezionare e filtrare i risultati della ricerca. Quando invii richieste di ricerca ad Amazon CloudSearch, puoi richiedere informazioni sui facet per scoprire quanti risultati condividono lo stesso valore in un facet. Puoi visualizzare queste informazioni insieme ai risultati della ricerca e utilizzarle per consentire agli utenti di affinare le loro ricerche in modo interattivo. (tale attività viene spesso indicata come navigazione o ricerca con facet).
Un facet può essere qualsiasi campo datale, letterale o numerico con sfaccettatura abilitata nella configurazione del dominio. Per ogni sfaccettatura, Amazon CloudSearch calcola il numero di accessi che condividono lo stesso valore. Puoi definire dei bucket per calcolare il numero di sfaccettature per particolari sottoinsiemi dei valori delle sfaccettature. Solo i bucket con corrispondenze vengono inclusi nei risultati delle faccette.
Per informazioni sulla configurazione dei facet, vedi [Configurazione dei campi dell'indice](configuring-index-fields.md). Per informazioni sull'utilizzo delle informazioni sui facet per supportare la navigazione con facet, vedi [Acquisizione e utilizzo delle informazioni Facet in Amazon CloudSearch](faceting.md).
## Elaborazione del testo in Amazon CloudSearch
Durante l'indicizzazione, Amazon CloudSearch elabora i contenuti `text` e `text-array` i campi in base allo schema di analisi specifico della lingua configurato per il campo. Uno schema di analisi controlla il modo in cui il testo viene normalizzato, tokenizzato e derivato e specifica eventuali stopword o sinonimi da tenere in considerazione durante l'indicizzazione. Amazon CloudSearch fornisce schemi di analisi predefiniti per ogni lingua supportata. Per informazioni sulla configurazione di schemi di analisi personalizzati, vedi [Configurazione degli schemi di analisi](configuring-analysis-schemes.md). Per informazioni su come Amazon CloudSearch normalizza e tokenizza il testo e applica le opzioni di testo configurate durante l'indicizzazione dei campi di testo e l'elaborazione delle richieste di ricerca, consulta. [Elaborazione del testo in Amazon CloudSearch](text-processing.md)
## Ordinamento dei risultati in Amazon CloudSearch
È possibile personalizzare il modo in cui i risultati di ricerca vengono classificati definendo espressioni che calcolano i valori personalizzati per ogni documento che soddisfa i criteri di ricerca. Ad esempio, potresti definire un'espressione che tenga conto del valore nel `popularity` campo di un documento e del punteggio di pertinenza predefinito calcolato da Amazon CloudSearch Expressions. Sono semplicemente espressioni numeriche che utilizzano operatori e funzioni numerici standard. Le espressioni possono fare riferimento ai campi `int` e `double`, ad altre espressioni, al punteggio di rilevanza (\$1score) di un documento e all'epoca (\$1time). Quando si inviano richieste di ricerca, è necessario specificare le espressioni che si desidera utilizzare per ordinare i risultati di ricerca. È inoltre possibile fare riferimento a espressioni all'interno dei criteri di ricerca.
Lo `_score` di rilevanza di un documento indica la frequenza di una determinata occorrenza in una richiesta di ricerca. Per calcolare il punteggio di pertinenza, Amazon CloudSearch tiene conto del numero di volte in cui i termini di ricerca compaiono in un documento rispetto agli altri documenti dell'indice.
Per informazioni su come configurare le espressioni per il tuo dominio, vedi [Configurazione di espressioni](configuring-expressions.md).
## Richieste di ricerca in Amazon CloudSearch
Invii le richieste di ricerca all'endpoint di ricerca del tuo dominio come richieste HTTP/HTTPS GET. È possibile specificare una serie di opzioni per limitare la ricerca, richiedere informazioni sui facet, controllare la classificazione e specificare cosa si desidera che venga restituito nei risultati. È possibile ottenere risultati di ricerca in formato JSON o XML. Per impostazione predefinita, Amazon CloudSearch restituisce i risultati in formato JSON.
Quando invii una richiesta di ricerca, Amazon CloudSearch esegue l'elaborazione del testo sulla stringa di ricerca. La stringa di ricerca viene elaborata per:
+ Convertire tutti i caratteri in minuscoli
+ Suddividere la stringa in termini separati in corrispondenza di delimitazioni di spazi e punteggiatura
+ Rimuovere i termini che sono nell'elenco delle stopword per il campo in cui viene eseguita la ricerca.
+ Mappa le radici e i sinonimi in base alle opzioni di derivazione e sinonimo configurate per il campo in cui si cerca.
Una volta completata questa preelaborazione, Amazon CloudSearch cerca i termini di ricerca nell'indice e identifica tutti i documenti che corrispondono alla richiesta. Per generare una risposta, Amazon CloudSearch elabora questo elenco di risultati di ricerca per filtrare e ordinare i documenti e i facet di calcolo corrispondenti. Amazon restituisce CloudSearch quindi la risposta in JSON o XML.
Per impostazione predefinita, Amazon CloudSearch restituisce i risultati di ricerca classificati in base ai \$1punteggi di pertinenza dei risultati. In alternativa, la richiesta può specificare il campo di indice o l'espressione che si desidera utilizzare per ordinare le occorrenze. Ad esempio, è possibile ordinare le occorrenze in base a un campo dell'indice che contiene il prezzo o un'espressione che calcola la popolarità.
Per ulteriori informazioni su come cercare, classificare e scorrere e pagine dei risultati, vedi [Ricerca nei tuoi dati con Amazon CloudSearch](searching.md).
# Scalabilità automatica in Amazon CloudSearch
Un dominio di ricerca presenta una o più istanze di ricerca, ognuna con una quantità limitata di RAM e risorse CPU per l'indicizzazione dei dati e l'elaborazione delle richieste. Il numero di istanze di ricerca che servono a un dominio dipende dai documenti contenuti nella raccolta e dal volume e dalla complessità delle richieste di ricerca.
Amazon CloudSearch è in grado di determinare la dimensione e il numero di istanze di ricerca necessarie per fornire prestazioni di ricerca a bassa latenza e throughput elevato. Quando carichi i dati e configuri l'indice, Amazon CloudSearch crea un indice e sceglie il tipo di istanza di ricerca iniziale appropriato. Man mano che utilizzi il tuo dominio di ricerca, Amazon CloudSearch può adattarsi alla quantità di dati caricati nel dominio e al volume e alla complessità delle richieste di ricerca.
Quando si crea un dominio di ricerca, viene distribuita una singola istanza per il dominio. Come illustrato nella figura seguente, hai sempre almeno un'istanza per il tuo dominio. Amazon ridimensiona CloudSearch automaticamente il dominio aggiungendo istanze all'aumentare del volume di dati o del traffico.
![\[Dimensionamento per dati e traffico\]](http://docs.aws.amazon.com/it_it/cloudsearch/latest/developerguide/images/cloudsearch-scaling-diagram.png)
## Dimensionamento per i dati
Quando la quantità di dati che aggiungi al tuo dominio supera la capacità del tipo di istanza di ricerca iniziale, Amazon CloudSearch ridimensiona il tuo dominio di ricerca a un tipo di istanza di ricerca più grande. Dopo che un dominio supera la capacità del tipo di istanza di ricerca più grande, Amazon CloudSearch partiziona l'indice di ricerca su più istanze di ricerca. (Il numero di istanze di ricerca necessario per contenere le partizioni di indice viene talvolta definito *larghezza* del dominio).
Quando il volume di dati nel tuo dominio si riduce, Amazon CloudSearch ridimensiona il dominio a un numero inferiore di istanze di ricerca o a un tipo di istanza di ricerca più piccolo per ridurre al minimo i costi.
**Nota**
Se il dominio è stato ridimensionato per adattarsi alle dimensioni dell'indice e elimini un gran numero di documenti, il dominio si ridimensiona alla successiva ricostruzione dell'indice completo. Sebbene l'indice venga ricostruito automaticamente e periodicamente, per ridurlo il più rapidamente possibile puoi [eseguire esplicitamente l'indicizzazione](indexing.md) al termine dell'eliminazione dei documenti.
## Dimensionamento per il traffico
Con l'aumentare del volume di richieste di ricerca o della complessità, diventa necessaria una potenza di elaborazione maggiore per gestire il carico. Anche un volume elevato di caricamenti di documenti aumenta il carico per le istanze di ricerca di un dominio. Quando un'istanza di ricerca si avvicina al suo carico massimo, Amazon CloudSearch distribuisce un'istanza di ricerca duplicata per fornire potenza di elaborazione aggiuntiva. (Il numero di istanze di ricerca duplicate viene talvolta definito* profondità* del dominio).
Quando il traffico diminuisce, Amazon CloudSearch rimuove le istanze di ricerca per ridurre al minimo i costi. Ad esempio, un nuovo dominio potrebbe aumentare le risorse per gestire l'afflusso di documenti iniziale e ridimensionarle dopo aver completato il caricamento dei dati, quando si stanno solo inviando gli aggiornamenti.
Se il tuo dominio subisce un improvviso aumento del traffico, Amazon CloudSearch distribuisce istanze di ricerca aggiuntive. La configurazione di nuove istanze richiede tuttavia alcuni minuti, pertanto potrebbe verificarsi un aumento degli errori 5xx prima che le nuove istanze riescano a iniziare l'elaborazione delle richieste. Per ulteriori informazioni sulla gestione degli errori 5xx, consultare [Gestione degli errori](error-handling.md).
Il tipo e la complessità delle richieste di ricerca influenzano le prestazioni generali di ricerca e, in alcuni casi, aumentano il numero di istanze di ricerca necessarie per gestire il dominio. L'invio di un volume elevato di batch di documenti di piccole dimensioni o a documento singolo può avere effetti sulle prestazioni del dominio di ricerca. Per ulteriori informazioni, consulta [Ottimizzazione delle prestazioni delle richieste di ricerca in Amazon CloudSearch](tuning-search.md).
## Accesso ad Amazon CloudSearch
Puoi accedere ad Amazon CloudSearch tramite la CloudSearch console Amazon SDKs, AWS o AWS CLI.
+ La [ CloudSearchconsole Amazon](https://console.aws.amazon.com/cloudsearch/home?region=us-west-2) ti consente di creare, configurare e monitorare facilmente i tuoi domini di ricerca, caricare documenti ed eseguire ricerche di prova. L'uso della console è il modo più semplice per iniziare a usare Amazon CloudSearch e fornisce un centro di comando centrale per la gestione continua dei tuoi domini di ricerca.
+ [AWS SDKs](https://aws.amazon.com/code) supporta tutte le operazioni delle CloudSearch API Amazon, semplificando la gestione e l'interazione con i tuoi domini di ricerca utilizzando la tua tecnologia preferita. Firmano SDKs automaticamente le richieste secondo necessità utilizzando le tue credenziali AWS.
+ [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/)Racchiude tutte le operazioni dell' CloudSearch API Amazon per fornire un modo semplice per creare e configurare domini di ricerca, caricare i dati che desideri cercare e inviare richieste di ricerca. Firma AWS CLI automaticamente le richieste secondo necessità utilizzando le tue credenziali AWS.
### Regioni ed endpoint per Amazon CloudSearch
Amazon CloudSearch fornisce endpoint regionali per accedere al servizio di configurazione e endpoint specifici del dominio per accedere ai servizi di ricerca e documentazione.
Puoi usare il servizio di configurazione per creare e gestire i domini di ricerca. Gli endpoint del servizio di configurazione specifici della regione sono nel formato: `cloudsearch.region.amazonaws.com`. Ad esempio, `cloudsearch.us-east-1.amazonaws.com`. Per un elenco corrente delle regioni supportate, consulta [Regioni ed endpoint](https://docs.aws.amazon.com/general/latest/gr/rande.html#cloudsearch_region) in Riferimenti generali di AWS.
Per accedere ai servizi CloudSearch di ricerca e documentazione di Amazon, utilizzi endpoint separati specifici del dominio:
+ `http://doc-domainname-domainid.us-east-1.cloudsearch.amazonaws.com`—l'endpoint del servizio documentale di un dominio viene utilizzato per caricare documenti
+ `http://search-domainname-domainid.us-east-1.cloudsearch.amazonaws.com`—l'endpoint di ricerca di un dominio viene utilizzato per inviare richieste di ricerca
### Firma CloudSearch delle richieste Amazon
Se utilizzi un linguaggio per il quale AWS fornisce un SDK, ti consigliamo di utilizzare l'SDK per inviare richieste Amazon CloudSearch . Tutti gli AWS semplificano SDKs enormemente il processo di firma delle richieste e consentono di risparmiare una notevole quantità di tempo rispetto all'utilizzo CloudSearch APIs diretto di Amazon. Si SDKs integrano facilmente con il tuo ambiente di sviluppo e forniscono un facile accesso ai comandi correlati. Puoi anche utilizzare la CloudSearch console Amazon e AWS CLI per inviare richieste firmate senza sforzi aggiuntivi.
Se scegli di chiamare CloudSearch APIs direttamente Amazon, devi firmare le tue richieste. Le richieste del servizio di configurazione devono essere sempre firmate. Le richieste di caricamento, ricerca e suggerimento devono essere firmate, a meno che non configuri l'accesso anonimo per tali servizi. Per firmare una richiesta, devi calcolare una firma digitale utilizzando una funzione hash crittografica, che restituisce un valore hash basato sull'input. L'input include il testo della richiesta e la tua chiave di accesso segreta. La funzione hash restituisce un valore hash che includi nella richiesta come firma. La firma è parte dell'intestazione di autorizzazione della richiesta. Dopo aver ricevuto la richiesta, Amazon CloudSearch ricalcola la firma utilizzando la stessa funzione di hash e lo stesso input che hai usato per firmare la richiesta. Se la firma risultante corrisponde alla firma nella richiesta, Amazon CloudSearch elabora la richiesta. In caso contrario, la richiesta viene respinta.
Amazon CloudSearch supporta l'autenticazione tramite AWS Signature versione 4. Per ulteriori informazioni, consulta la sezione relativa al [processo di firma di Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html).
## Domande frequenti
Qual è il limite per i «clienti attuali»?
Abbiamo creato una lista di account consentiti IDs che utilizzano già Amazon CloudSearch. Tuttavia, consentiremo di inserire nell'elenco qualsiasi nuovo account di clienti che in precedenza utilizzavano Amazon CloudSearch. In caso di difficoltà, invia un ticket di assistenza.
Cosa intendiamo per «accesso» al servizio?
I clienti attuali possono fare tutto ciò che potevano fare in precedenza. L'unica modifica è che i clienti non attuali non possono accedere ad Amazon CloudSearch.
CloudSearch I clienti Amazon esistenti possono creare nuovi repository se erano già CloudSearch Amazon?
Sì. In caso di difficoltà, invia un ticket di assistenza