

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Eine Sammlung erstellen (CLI)
<a name="serverless-create-cli"></a>

Verwenden Sie die Verfahren in diesem Abschnitt, um eine OpenSearch serverlose Sammlung mit dem AWS CLI zu erstellen. 

**Topics**
+ [Bevor Sie beginnen](#serverless-create-cli-before-you-begin)
+ [Erstellen einer Sammlung](#serverless-create-cli-creating)
+ [Eine Sammlung mit einem automatischen Index zur semantischen Anreicherung erstellen](#serverless-create-cli-automatic-semantic-enrichment)

## Bevor Sie beginnen
<a name="serverless-create-cli-before-you-begin"></a>

Bevor Sie eine Sammlung mit dem erstellen AWS CLI, verwenden Sie das folgende Verfahren, um die erforderlichen Richtlinien für die Sammlung zu erstellen.

**Anmerkung**  
Wenn Sie in jedem der folgenden Verfahren einen Namen für eine Sammlung angeben, muss der Name die folgenden Kriterien erfüllen:  
ist einzigartig für Ihr Konto und AWS-Region
Enthält nur Kleinbuchstaben a–z, die Zahlen 0–9 und den Bindestrich (-)
Enthält zwischen 3 und 32 Zeichen

**Um die erforderlichen Richtlinien für eine Sammlung zu erstellen**

1. Öffnen Sie den folgenden Befehl AWS CLI und führen Sie ihn aus, um eine [Verschlüsselungsrichtlinie](serverless-encryption.md) mit einem Ressourcenmuster zu erstellen, das dem beabsichtigten Namen der Sammlung entspricht. 

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

   Wenn Sie beispielsweise Ihre Sammlungs-*Protokollanwendung* benennen möchten, können Sie eine Verschlüsselungsrichtlinie wie die folgende erstellen:

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

   Wenn Sie die Richtlinie für weitere Sammlungen verwenden möchten, können Sie die Regel breiter fassen, wie z. B. `collection/logs*` oder `collection/*`.

1. Führen Sie den folgenden Befehl aus, um die Netzwerkeinstellungen für die Sammlung mithilfe einer [Netzwerkrichtlinie](serverless-network.md) zu konfigurieren. Sie können Netzwerkrichtlinien erstellen, nachdem Sie eine Sammlung erstellt haben. Wir empfehlen jedoch, dies vorher zu tun.

   ```
   &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}]"
   ```

   Unter Verwendung des vorherigen Beispiels für die *Protokollanwendung* könnten Sie die folgende Netzwerkrichtlinie erstellen:

   ```
   &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}]"
   ```

## Erstellen einer Sammlung
<a name="serverless-create-cli-creating"></a>

Das folgende Verfahren verwendet die [CreateCollection](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_CreateCollection.html)API-Aktion, um eine Sammlung des Typs `SEARCH` oder zu erstellen`TIMESERIES`. Wenn Sie in der Anfrage keinen Sammlungstyp angeben, wird standardmäßig `TIMESERIES` verwendet. Weitere Informationen zu diesen Typen finden Sie unter[Auswahl eines Sammlungstyps](serverless-overview.md#serverless-usecase). Informationen zum Erstellen einer *Vektorsuchsammlung* finden Sie unter[Arbeiten mit Vektorsuchsammlungen](serverless-vector-search.md). 

Wenn Ihre Sammlung mit einem AWS-eigener Schlüssel, dem `kmsKeyArn` ist und `auto` nicht mit einem ARN verschlüsselt ist.

**Wichtig**  
Nachdem Sie eine Sammlung erstellt haben, können Sie nicht darauf zugreifen, es sei denn, sie entspricht einer Datenzugriffsrichtlinie. Weitere Informationen finden Sie unter [Datenzugriffskontrolle für Amazon OpenSearch Serverless](serverless-data-access.md).

**So erstellen Sie eine Sammlung**

1. Vergewissern Sie sich, dass Sie die unter beschriebenen erforderlichen Richtlinien erstellt haben[Bevor Sie beginnen](#serverless-create-cli-before-you-begin).

1. Führen Sie den folgenden Befehl aus. `type`Geben Sie entweder `SEARCH` oder an`TIMESERIES`.

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

## Eine Sammlung mit einem automatischen Index zur semantischen Anreicherung erstellen
<a name="serverless-create-cli-automatic-semantic-enrichment"></a>

Gehen Sie wie folgt vor, um eine neue OpenSearch serverlose Sammlung mit einem Index zu erstellen, der für die [automatische](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-semantic-enrichment.html) semantische Anreicherung konfiguriert ist. Das Verfahren verwendet die OpenSearch Serverless [CreateIndex](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_CreateIndex.html)API-Aktion.

**Um eine neue Sammlung mit einem Index zu erstellen, der für die automatische semantische Anreicherung konfiguriert ist**

Führen Sie den folgenden Befehl aus, um die Sammlung und einen Index zu erstellen.

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

Ein Beispiel:

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