Creazione di una raccolta (CLI)

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

Prima di iniziare

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 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/*.

2. Eseguite il comando seguente per configurare le impostazioni di rete per la raccolta utilizzando una politica di rete. È 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

La procedura seguente utilizza l'azione CreateCollectionAPI per creare una raccolta di tipo SEARCH oTIMESERIES. Se non specifichi un tipo di raccolta nella richiesta, il valore predefinito sarà TIMESERIES. Per ulteriori informazioni su questi tipi, vedereScelta di un tipo di raccolta. Per creare una raccolta di ricerca vettoriale, vedereLavorare con le raccolte di ricerca vettoriale.

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.

Per creare una raccolta

1. Verifica di aver creato le politiche richieste descritte inPrima di iniziare.

2. Esegui il comando seguente. Per type specificare SEARCH oTIMESERIES.

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

Creazione di una raccolta con un indice di arricchimento semantico automatico

Utilizzare la procedura seguente per creare una nuova raccolta OpenSearch Serverless con un indice configurato per l'arricchimento semantico automatico. La procedura utilizza l'azione OpenSearch Serverless CreateIndexAPI.

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" 
                }
            }
        }
    }
}'