

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à.

# Creazione di raccolte
<a name="serverless-create"></a>

Puoi utilizzare la console o il AWS CLI per creare una raccolta serverless. Questi passaggi spiegano come creare una raccolta di *ricerche o di* *serie temporali*. Per creare una raccolta di *ricerca vettoriale*, vedi[Lavorare con le raccolte di ricerca vettoriale](serverless-vector-search.md). 

**Topics**
+ [Creazione di una raccolta (console)](serverless-create-console.md)
+ [Creazione di una raccolta (CLI)](serverless-create-cli.md)

# Creazione di una raccolta (console)
<a name="serverless-create-console"></a>

Utilizzate le procedure descritte in questa sezione per creare una raccolta utilizzando. Console di gestione AWS Questi passaggi spiegano come creare una raccolta *di ricerche* o di *serie temporali*. Per creare una raccolta di *ricerca vettoriale*, vedi[Lavorare con le raccolte di ricerca vettoriale](serverless-vector-search.md). 

**Topics**
+ [Configurare le impostazioni della raccolta](#serverless-create-console-step-2)
+ [Configura campi di ricerca aggiuntivi](#serverless-create-console-step-3)

## Configurare le impostazioni della raccolta
<a name="serverless-create-console-step-2"></a>

Utilizza la seguente procedura per configurare le informazioni sulla tua raccolta. 

**Per configurare le impostazioni della raccolta utilizzando la console**

1. Accedi alla console di Amazon OpenSearch Service a [https://console.aws.amazon.com/aos/casa/](https://console.aws.amazon.com/aos/home/).

1. Espandi **Serverless** nel pannello di navigazione a sinistra e scegli **Collections** (Raccolte). 

1. Scegli **Create collection** (Crea raccolta).

1. Fornisci un nome e una descrizione per la raccolta. Il nome deve soddisfare i seguenti criteri:
   + È unico per il tuo account e Regione AWS
   + Contiene solo lettere minuscole a-z, i numeri da 0 a 9 e i trattini (-)
   + Contiene da 3 a 32 caratteri

1. Scegli un tipo di raccolta:
   + **Serie temporali**: segmento di analisi dei log che si concentra sull'analisi di grandi volumi di dati semistrutturati generati da macchine. Almeno 24 ore di dati vengono archiviate su indici caldi e il resto rimane in una memoria a caldo.
   + **Ricerca**: l'opzione della ricerca full-text supporta le applicazioni nelle reti interne e le applicazioni connesse a Internet. Tutti i dati di ricerca vengono memorizzati in un'archiviazione ad accesso frequente per garantire tempi di risposta rapidi alle query.
**Nota**  
Scegliete questa opzione se state abilitando la ricerca semantica automatica, come descritto in. [Configurare le impostazioni della raccolta](#serverless-create-console-step-2)
   + **Ricerca vettoriale: ricerca** semantica su incorporamenti vettoriali che semplifica la gestione dei dati vettoriali. Potenzia le esperienze di ricerca aumentata di machine learning (ML) e le applicazioni di intelligenza artificiale generativa come chatbot, assistenti personali e rilevamento delle frodi.

   Per ulteriori informazioni, consulta [Scelta di un tipo di raccolta](serverless-overview.md#serverless-usecase).

1. Per il **tipo di implementazione**, scegli l'impostazione di ridondanza per la tua raccolta. Per impostazione predefinita, ogni raccolta presenta ridondanza, il che significa che le unità di OpenSearch calcolo di indicizzazione e ricerca (OCUs) hanno ciascuna le proprie repliche in standby in una zona di disponibilità diversa. Per scopi di sviluppo e test, puoi scegliere di disabilitare la ridondanza, in modo da ridurre a due il numero di file presenti nella raccolta. OCUs Per ulteriori informazioni, consulta [Come funziona](serverless-overview.md#serverless-process).

1. Per la **sicurezza**, scegli **Standard** create.

1. Per la **crittografia**, scegli una AWS KMS chiave con cui crittografare i tuoi dati. OpenSearch Serverless ti avvisa se il nome della raccolta che hai inserito corrisponde a uno schema definito in una politica di crittografia. Puoi scegliere di mantenere tale corrispondenza o di sostituirla con impostazioni di crittografia specifiche. Per ulteriori informazioni, consulta [Crittografia in Amazon OpenSearch Serverless](serverless-encryption.md).

1. Per **le impostazioni di accesso alla rete**, configura l'accesso alla rete per la raccolta.
   + Per **Tipo di accesso**, seleziona pubblico o privato. 

     Se scegli privato, specifica quali endpoint VPC Servizi AWS possono accedere alla raccolta.
     + **Endpoint VPC per l'accesso**: specifica uno o più endpoint VPC per consentire l'accesso. Per creare un endpoint VPC, consulta la sezione [Accesso al piano dati tramite AWS PrivateLink](serverless-vpc.md).
     + **Servizio AWS accesso privato**: seleziona uno o più servizi supportati a cui consentire l'accesso.
   + Per **Tipo di risorsa**, seleziona se gli utenti possono accedere alla raccolta tramite il relativo *OpenSearch*endpoint (per effettuare chiamate API tramite CURL, Postman e così via), tramite *OpenSearch l'*endpoint Dashboards (per lavorare con le visualizzazioni ed effettuare chiamate API tramite la console) o entrambi.
**Nota**  
Servizio AWS l'accesso privato si applica solo all'endpoint, non all' OpenSearchendpoint Dashboards. OpenSearch 

   OpenSearch Serverless ti avvisa se il nome della raccolta che hai inserito corrisponde a uno schema definito in una politica di rete. Puoi scegliere di mantenere tale corrispondenza o di sostituirla con impostazioni di rete personalizzate. Per ulteriori informazioni, consulta [Accesso alla rete per Amazon OpenSearch Serverless](serverless-network.md).

1. (Facoltativo) Aggiungi uno o più tag alla raccolta. Per ulteriori informazioni, consulta [Etichettatura delle raccolte Amazon OpenSearch Serverless](tag-collection.md).

1. Scegli **Next (Successivo)**.

## Configura campi di ricerca aggiuntivi
<a name="serverless-create-console-step-3"></a>

Le opzioni visualizzate a pagina due del flusso di lavoro per la creazione di una raccolta dipendono dal tipo di raccolta che state creando. Questa sezione descrive come configurare campi di ricerca aggiuntivi per ogni tipo di raccolta. Questa sezione descrive anche come configurare l'arricchimento semantico automatico. Salta qualsiasi sezione che non si applica al tuo tipo di collezione.

**Topics**
+ [Configura l'arricchimento semantico automatico](#serverless-create-console-step-3-semantic-enrichment-fields)
+ [Configura i campi di ricerca delle serie temporali](#serverless-create-console-step-3-time-series-fields)
+ [Configura i campi di ricerca lessicali](#serverless-create-console-step-3-lexical-fields)
+ [Configura i campi di ricerca vettoriale](#serverless-create-console-step-3-vector-search-fields)

### Configura l'arricchimento semantico automatico
<a name="serverless-create-console-step-3-semantic-enrichment-fields"></a>

Quando crei o modifichi una raccolta, puoi configurare l'arricchimento semantico automatico, che semplifica l'implementazione e le funzionalità della ricerca semantica in Amazon Service. OpenSearch La ricerca semantica restituisce risultati di query che incorporano non solo la corrispondenza delle parole chiave, ma anche l'intento e il significato contestuale della ricerca dell'utente. Per ulteriori informazioni, consulta [Arricchimento semantico automatico per Serverless](serverless-semantic-enrichment.md).

**Per configurare l'arricchimento semantico automatico**

1. Nella sezione **Dettagli dell'indice**, per **Nome dell'indice, specifica un nome**.

1. Nella sezione **Campi di arricchimento semantico automatico, scegli Aggiungi campo** **di ricerca semantico**.

1. Nel **campo Nome del campo di input per l'arricchimento semantico**, inserisci il nome di un campo che desideri arricchire.

1. **Il **tipo di dati** è Testo.** Non puoi modificare questo valore.

1. Per **Lingua**, scegli **Inglese** o **Multilingue**.

1. Scegli **Aggiungi campo**.

1. **Dopo aver completato la configurazione dei campi opzionali per la raccolta, scegli Avanti.** Controlla le modifiche e scegli **Invia** per creare la raccolta.

### Configura i campi di ricerca delle serie temporali
<a name="serverless-create-console-step-3-time-series-fields"></a>

Le opzioni nella sezione **Campi di ricerca delle serie temporali** riguardano i dati delle serie temporali e i flussi di dati. Per ulteriori informazioni su questi argomenti, vedere. [Gestione dei dati di serie temporali in Amazon OpenSearch Service con flussi di dati](data-streams.md)

**Per configurare i campi di ricerca delle serie temporali**

1. Nella sezione **Campi di ricerca delle serie temporali**, scegli **Aggiungi campo delle serie temporali**.

1. Per **Nome campo**, inserisci un nome.

1. Per **Tipo di dati**, scegli un tipo dall'elenco.

1. Scegli **Aggiungi campo**

1. Dopo aver completato la configurazione dei campi opzionali per la tua raccolta, scegli **Avanti**. Controlla le modifiche e scegli **Invia** per creare la raccolta.

### Configura i campi di ricerca lessicali
<a name="serverless-create-console-step-3-lexical-fields"></a>

La ricerca lessicale cerca una corrispondenza esatta tra una query di ricerca e termini o parole chiave indicizzati.

**Per configurare i campi di ricerca lessicali**

1. Nella sezione **Campi di ricerca lessicali**, scegli **Aggiungi campo di ricerca**.

1. Per **Nome campo**, inserisci un nome.

1. Per **Tipo di dati**, scegli un tipo dall'elenco.

1. Scegli **Aggiungi campo**

1. Dopo aver completato la configurazione dei campi opzionali per la tua raccolta, scegli **Avanti**. Controlla le modifiche e scegli **Invia** per creare la raccolta.

### Configura i campi di ricerca vettoriale
<a name="serverless-create-console-step-3-vector-search-fields"></a>

**Per configurare i campi di ricerca vettoriali**

1. Nella sezione **Campi vettoriali**, scegli **Aggiungi campo vettoriale**.

1. Per **Nome campo**, inserisci un nome.

1. Per **Engine**, scegli un tipo dall'elenco.

1. Immettete il numero di dimensioni.

1. Per **Distance Metric**, scegliete un tipo dall'elenco.

1. **Dopo aver completato la configurazione dei campi opzionali per la raccolta, scegli Avanti.**

1. Controlla le modifiche e scegli **Invia** per creare la raccolta.

# Creazione di una raccolta (CLI)
<a name="serverless-create-cli"></a>

Utilizza le procedure in questa sezione per creare una raccolta OpenSearch Serverless utilizzando. AWS CLI

**Topics**
+ [Prima di iniziare](#serverless-create-cli-before-you-begin)
+ [Creazione di una raccolta](#serverless-create-cli-creating)
+ [Creazione di una raccolta con un indice di arricchimento semantico automatico](#serverless-create-cli-automatic-semantic-enrichment)

## Prima di iniziare
<a name="serverless-create-cli-before-you-begin"></a>

Prima di creare una raccolta utilizzando la AWS CLI, utilizzate la procedura seguente per creare le politiche richieste per la raccolta.

**Nota**  
In ciascuna delle seguenti procedure, quando si specifica un nome per una raccolta, il nome deve soddisfare i seguenti criteri:  
È unico per il tuo account e Regione AWS
Contiene solo lettere minuscole a-z, i numeri da 0 a 9 e i trattini (-)
Contiene da 3 a 32 caratteri

**Per creare le politiche necessarie per una raccolta**

1. Aprite AWS CLI ed eseguite il comando seguente per creare una [politica di crittografia](serverless-encryption.md) con un modello di risorse che corrisponda al nome previsto della raccolta. 

   ```
   &aws opensearchserverless create-security-policy \
     --name policy name \
     --type encryption --policy "{\"Rules\":[{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/collection name\"]}],\"AWSOwnedKey\":true}"
   ```

   Ad esempio, se intendi dare un nome all'*applicazione dei log* della raccolta, potresti creare una policy di crittografia come questa:

   ```
   &aws opensearchserverless create-security-policy \
     --name logs-policy \
     --type encryption --policy "{\"Rules\":[{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/logs-application\"]}],\"AWSOwnedKey\":true}"
   ```

   Se prevedi di utilizzare la policy per raccolte aggiuntive, puoi rendere la regola più ampia, come `collection/logs*` o `collection/*`.

1. Eseguite il comando seguente per configurare le impostazioni di rete per la raccolta utilizzando una [politica di rete](serverless-network.md). È possibile creare policy di rete dopo aver creato una raccolta, tuttavia consigliamo di farlo prima.

   ```
   &aws opensearchserverless create-security-policy \
     --name policy name \
     --type network --policy "[{\"Description\":\"description\",\"Rules\":[{\"ResourceType\":\"dashboard\",\"Resource\":[\"collection\/collection name\"]},{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/collection name\"]}],\"AllowFromPublic\":true}]"
   ```

   Utilizzando l'esempio precedente *applicazione-log*, è possibile creare la seguente policy di rete:

   ```
   &aws opensearchserverless create-security-policy \
     --name logs-policy \
     --type network --policy "[{\"Description\":\"Public access for logs collection\",\"Rules\":[{\"ResourceType\":\"dashboard\",\"Resource\":[\"collection\/logs-application\"]},{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/logs-application\"]}],\"AllowFromPublic\":true}]"
   ```

## Creazione di una raccolta
<a name="serverless-create-cli-creating"></a>

La procedura seguente utilizza l'azione [CreateCollection](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_CreateCollection.html)API per creare una raccolta di tipo `SEARCH` o`TIMESERIES`. Se non specifichi un tipo di raccolta nella richiesta, il valore predefinito sarà `TIMESERIES`. Per ulteriori informazioni su questi tipi, vedere[Scelta di un tipo di raccolta](serverless-overview.md#serverless-usecase). Per creare una raccolta di *ricerca vettoriale*, vedere[Lavorare con le raccolte di ricerca vettoriale](serverless-vector-search.md). 

Se la raccolta è crittografata con un Chiave di proprietà di AWS, `kmsKeyArn` è `auto` anziché un ARN.

**Importante**  
Dopo aver creato una raccolta, non potrai accedervi a meno che non corrisponda a una policy di accesso ai dati. Per ulteriori informazioni, consulta [Controllo dell'accesso ai dati per Amazon OpenSearch Serverless](serverless-data-access.md).

**Come creare una raccolta**

1. Verifica di aver creato le politiche richieste descritte in[Prima di iniziare](#serverless-create-cli-before-you-begin).

1. Eseguire il seguente comando seguente. Per `type` specificare `SEARCH` o`TIMESERIES`.

   ```
   &aws opensearchserverless create-collection --name "collection name" --type collection type --description "description"
   ```

## Creazione di una raccolta con un indice di arricchimento semantico automatico
<a name="serverless-create-cli-automatic-semantic-enrichment"></a>

Utilizzare la procedura seguente per creare una nuova raccolta OpenSearch Serverless con un indice configurato per l'arricchimento semantico [automatico](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-semantic-enrichment.html). La procedura utilizza l'azione OpenSearch Serverless [CreateIndex](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_CreateIndex.html)API.

**Per creare una nuova raccolta con un indice configurato per l'arricchimento semantico automatico**

Eseguite il comando seguente per creare la raccolta e un indice.

```
&aws opensearchserverless create-index \
--region Region ID \
--id collection name --index-name index name \
--index-schema \
'mapping in json'
```

Ecco un esempio:

```
&aws opensearchserverless create-index \
--region us-east-1 \
--id conversation_history --index-name conversation_history_index \
--index-schema \ 
'{
    "mappings": {
        "properties": {
            "age": {
                "type": "integer"
            },
            "name": {
                "type": "keyword"
            },
            "user_description": {
                "type": "text"
            },
            "conversation_history": {
                "type": "text",
                "semantic_enrichment": {
                    "status": "ENABLED",
                    // Specifies the sparse tokenizer for processing multi-lingual text
                    "language_option": "MULTI-LINGUAL", 
                    // If embedding_field is provided, the semantic embedding field will be set to the given name rather than original field name + "_embedding"
                    "embedding_field": "conversation_history_user_defined" 
                }
            },
            "book_title": {
                "type": "text",
                "semantic_enrichment": {
                    // No embedding_field is provided, so the semantic embedding field is set to "book_title_embedding"
                    "status": "ENABLED",
                    "language_option": "ENGLISH"
                }
            },
            "abstract": {
                "type": "text",
                "semantic_enrichment": {
                    // If no language_option is provided, it will be set to English.
                    // No embedding_field is provided, so the semantic embedding field is set to "abstract_embedding"
                    "status": "ENABLED" 
                }
            }
        }
    }
}'
```