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à.
# Tutorial: Guida introduttiva ad Amazon OpenSearch Serverless
Questo tutorial illustra i passaggi di base per avviare rapidamente una raccolta di *ricerche* Amazon OpenSearch Serverless. Una raccolta di ricerche ti consente di potenziare le applicazioni nelle tue reti interne e le applicazioni connesse a Internet, come la ricerca di siti di e-commerce e la ricerca di contenuti.
Per informazioni su come utilizzare una raccolta di ricerca *vettoriale*, consulta. [Lavorare con le raccolte di ricerca vettoriale](serverless-vector-search.md) Per informazioni più dettagliate sull'uso delle raccolte, consulta [Gestione delle raccolte Amazon OpenSearch Serverless](serverless-manage.md) e gli altri argomenti di questa guida.
In questo tutorial completerai le seguenti fasi:
1. [Configurazione delle autorizzazioni](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-permissions)
1. [Creazione di una raccolta](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-create)
1. [Caricamento e ricerca dei dati](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-index)
1. [Eliminazione della raccolta](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-delete)
**Nota**
Ti consigliamo di utilizzare solo caratteri ASCII per il tuo`IndexName`. Se non utilizzi caratteri ASCII per i tuoi caratteri`IndexName`, le CloudWatch metriche `IndexName` in verranno convertite in un formato con codifica URL per caratteri non ASCII.
## Fase 1: configurazione delle autorizzazioni
Per completare questo tutorial e per utilizzare OpenSearch Serverless in generale, devi disporre delle autorizzazioni IAM corrette. In questo tutorial creerai una raccolta, caricherai i dati e farai una ricerca, quindi eliminerai la raccolta.
L'utente o il ruolo devono avere una [policy basata sull'identità](security-iam-serverless.md#security-iam-serverless-id-based-policies) allegata con le seguenti autorizzazioni minime:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"aoss:CreateCollection",
"aoss:ListCollections",
"aoss:BatchGetCollection",
"aoss:DeleteCollection",
"aoss:CreateAccessPolicy",
"aoss:ListAccessPolicies",
"aoss:UpdateAccessPolicy",
"aoss:CreateSecurityPolicy",
"aoss:GetSecurityPolicy",
"aoss:UpdateSecurityPolicy",
"iam:ListUsers",
"iam:ListRoles"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
```
------
Per ulteriori informazioni sulle autorizzazioni IAM OpenSearch Serverless, consulta. [Identity and Access Management per Amazon OpenSearch Serverless](security-iam-serverless.md)
## Fase 2: creazione di una raccolta
Una raccolta è un gruppo di OpenSearch indici che interagiscono per supportare un carico di lavoro o un caso d'uso specifici.
**Per creare una raccolta Serverless OpenSearch**
1. Apri la console OpenSearch di Amazon Service a [https://console.aws.amazon.com/aos/casa](https://console.aws.amazon.com/aos/home ).
1. Scegli **Collections** (Raccolte) nel pannello di navigazione a sinistra e scegli **Create collection** (Crea raccolta).
1. Nomina la raccolta **movies** (film).
1. Per il tipo di raccolta, scegli **Search** (Cerca). Per ulteriori informazioni, consulta [Scelta di un tipo di raccolta](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html#serverless-usecase).
1. Per **Sicurezza**, scegli **Standard create**.
1. In **Crittografia**, seleziona **Usa Chiave di proprietà di AWS**. Questo è AWS KMS key quello che OpenSearch Serverless utilizzerà per crittografare i tuoi dati.
1. In **Network** (Rete), configura le impostazioni di rete per la raccolta.
+ Per il tipo di accesso, seleziona **Public** (Pubblico).
+ Per il tipo di risorsa, scegli sia **Abilita l'accesso agli OpenSearch endpoint** che **Abilita l'accesso ai dashboard. OpenSearch ** Poiché caricherai e cercherai dati utilizzando OpenSearch le dashboard, devi abilitare entrambe.
1. Scegli **Next (Successivo)**.
1. Per **Configure data access** (Configura l'accesso ai dati), configura le impostazioni di accesso per la raccolta. [Le policy di accesso ai dati](serverless-data-access.md) consentono a utenti e ruoli di accedere ai dati all'interno di una raccolta. In questo tutorial, forniremo a un singolo utente le autorizzazioni necessarie per indicizzare e cercare i dati nella raccolta denominata *movies*.
Crea una singola regola che fornisca l'accesso alla raccolta *movies*. Nomina la regola **Accesso alla raccolta movies**.
1. Scegli **Aggiungi responsabili**, **utenti e ruoli IAM e** seleziona l'utente o il ruolo che utilizzerai per accedere alle OpenSearch dashboard e indicizzare i dati. Scegli **Save** (Salva).
1. In **Index permissions** (Autorizzazioni relative all'indice), seleziona tutte le autorizzazioni.
1. Scegli **Next (Successivo)**.
1. Per le impostazioni della policy di accesso, scegli **Create a new data access policy** (Crea una nuova policy di accesso ai dati) e assegna alla policy il nome **movies**.
1. Scegli **Next (Successivo)**.
1. Controlla le impostazioni della raccolta e scegli **Submit** (Invia). Attendi alcuni minuti affinché lo stato della raccolta diventi `Active`.
## Fase 3: Caricamento e ricerca dei dati
Puoi caricare dati in una raccolta OpenSearch Serverless utilizzando [Postman o cURL](https://www.postman.com/downloads/). Per brevità, questi esempi utilizzano **Dev Tools** all'interno della console Dashboards. OpenSearch
**Indicizzazione e ricerca dei dati nella raccolta movies**
1. Scegli **Collections** (Raccolte) nel pannello di navigazione a sinistra e seleziona la raccolta **movies** per aprire la rispettiva pagina dei dettagli.
1. Scegli l'URL delle OpenSearch dashboard per la raccolta. L'URL assume il formato `https://dashboards.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id}`.
1. All'interno di OpenSearch Dashboards, apri il riquadro di navigazione a sinistra e scegli **Dev** Tools.
1. Per creare un singolo indice denominato *movies-index*, invia la seguente richiesta:
```
PUT movies-index
```
![\[OpenSearch Dashboards console showing PUT request for movies-index with JSON response.\]](http://docs.aws.amazon.com/it_it/opensearch-service/latest/developerguide/images/serverless-gsg-create.png)
1. Per indicizzare un singolo documento in *movies-index*, invia la seguente richiesta:
```
PUT movies-index/_doc/1
{
"title": "Shawshank Redemption",
"genre": "Drama",
"year": 1994
}
```
1. Per cercare dati nei OpenSearch dashboard, devi configurare almeno un modello di indice. OpenSearch utilizza questi modelli per identificare gli indici da analizzare. Apri il pannello di navigazione a sinistra, scegli **Stack Management** (Gestione stack), scegli **Index Patterns** (Modelli di indice), quindi scegli **Create index pattern** (Crea modello di indice). Per questo tutorial, digita *movies*.
1. Scegliere **Fase successiva** quindi selezionare **Crea modello di indice**. Dopo aver creato il modello, è possibile visualizzare i vari campi del documento, ad esempio `title` e `genre`.
1. Per iniziare a cercare i dati, apri di nuovo il pannello di navigazione a sinistra e scegli **Discover** (Rileva) o utilizza l'[API di ricerca](https://opensearch.org/docs/latest/api-reference/search/) nei Dev Tools.
## Gestione degli errori
Quando si eseguono operazioni di indicizzazione e ricerca, è possibile che vengano visualizzate le seguenti risposte di errore:
+ `HTTP 507`— Indica che si è verificato un errore interno del server. Questo errore indica in genere che le unità di OpenSearch calcolo (OCUs) sono sovraccaricate dal volume o dalla complessità delle richieste. Sebbene OpenSearch Serverless sia scalabile automaticamente per gestire il carico, può verificarsi un ritardo nella distribuzione di risorse aggiuntive.
Per mitigare questo errore, implementa una politica esponenziale di backoff e ripetizione dei tentativi. Questo approccio riduce temporaneamente la frequenza delle richieste per gestire efficacemente il carico. Per maggiori dettagli, consulta il [comportamento di riprova](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) nella *Guida di riferimento agli strumenti AWS SDKs e agli strumenti*.
+ `HTTP 402`— Indica che è stato raggiunto il limite di capacità dell'unità di OpenSearch calcolo massima (OCU). Ottimizza il carico di lavoro per ridurre l'utilizzo dell'OCU o richiedere un aumento della quota.
## Fase 4: Eliminazione della raccolta
Poiché la raccolta *movies* è stata creata per finalità di prova, è consigliabile eliminarla una volta terminate le prove in modo da evitare costi aggiuntivi.
**Per eliminare una raccolta Serverless OpenSearch**
1. Torna alla console di **Amazon OpenSearch Service**.
1. Scegli **Collections** (Raccolte) nel pannello di navigazione a sinistra e seleziona la raccolta **movies**.
1. Scegli **Elimina** e conferma l'eliminazione.
## Fasi successive
Adesso che è chiaro come creare una raccolta e i dati di indice, è possibile provare a completare alcuni degli esercizi seguenti:
+ Scopri ulteriori opzioni avanzate per la creazione di una raccolta. Per ulteriori informazioni, consulta [Gestione delle raccolte Amazon OpenSearch Serverless](serverless-manage.md).
+ Scopri come configurare le policy di sicurezza per gestire la sicurezza delle raccolte su larga scala. Per ulteriori informazioni, consulta [Panoramica della sicurezza in Amazon OpenSearch Serverless](serverless-security.md).
+ Scopri altri modi per indicizzare i dati nelle raccolte. Per ulteriori informazioni, consulta [Inserimento di dati in raccolte Amazon Serverless OpenSearch](serverless-clients.md).