Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Buat koleksi (CLI)
<a name="serverless-create-cli"></a>

Gunakan prosedur di bagian ini untuk membuat koleksi OpenSearch Tanpa Server menggunakan file. AWS CLI

**Topics**
+ [Sebelum Anda mulai](#serverless-create-cli-before-you-begin)
+ [Membuat koleksi](#serverless-create-cli-creating)
+ [Membuat koleksi dengan indeks pengayaan semantik otomatis](#serverless-create-cli-automatic-semantic-enrichment)

## Sebelum Anda mulai
<a name="serverless-create-cli-before-you-begin"></a>

Sebelum Anda membuat koleksi menggunakan AWS CLI, gunakan prosedur berikut untuk membuat kebijakan yang diperlukan untuk koleksi.

**catatan**  
Dalam setiap prosedur berikut, ketika Anda menentukan nama untuk koleksi, nama harus memenuhi kriteria berikut:  
Ini unik untuk akun Anda dan Wilayah AWS
Berisi hanya huruf kecil a-z, angka 0-9, dan tanda hubung (-)
Berisi antara 3 dan 32 karakter

**Untuk membuat kebijakan yang diperlukan untuk koleksi**

1. Buka AWS CLI dan jalankan perintah berikut untuk membuat [kebijakan enkripsi](serverless-encryption.md) dengan pola sumber daya yang cocok dengan nama koleksi yang diinginkan. 

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

   Misalnya, jika Anda berencana memberi nama *aplikasi log* koleksi, Anda dapat membuat kebijakan enkripsi seperti ini:

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

   Jika Anda berencana untuk menggunakan kebijakan untuk koleksi tambahan, Anda dapat membuat aturan lebih luas, seperti `collection/logs*` atau`collection/*`.

1. Jalankan perintah berikut untuk mengkonfigurasi pengaturan jaringan untuk koleksi menggunakan [kebijakan jaringan](serverless-network.md). Anda dapat membuat kebijakan jaringan setelah membuat koleksi, tetapi sebaiknya lakukan terlebih dahulu.

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

   Menggunakan contoh *aplikasi log sebelumnya*, Anda dapat membuat kebijakan jaringan berikut:

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

## Membuat koleksi
<a name="serverless-create-cli-creating"></a>

Prosedur berikut menggunakan tindakan [CreateCollection](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_CreateCollection.html)API untuk membuat koleksi tipe `SEARCH` atau`TIMESERIES`. Jika Anda tidak menentukan jenis koleksi dalam permintaan, defaultnya adalah. `TIMESERIES` Untuk informasi lebih lanjut tentang jenis ini, lihat[Memilih jenis koleksi](serverless-overview.md#serverless-usecase). Untuk membuat koleksi *pencarian vektor*, lihat[Bekerja dengan koleksi pencarian vektor](serverless-vector-search.md). 

Jika koleksi Anda dienkripsi dengan Kunci milik AWS, itu `kmsKeyArn` `auto` bukan ARN.

**penting**  
Setelah membuat koleksi, Anda tidak akan dapat mengaksesnya kecuali cocok dengan kebijakan akses data. Untuk informasi selengkapnya, lihat [Kontrol akses data untuk Amazon Tanpa OpenSearch Server](serverless-data-access.md).

**Untuk membuat koleksi**

1. Verifikasi bahwa Anda membuat kebijakan yang diperlukan yang dijelaskan dalam[Sebelum Anda mulai](#serverless-create-cli-before-you-begin).

1. Jalankan perintah berikut. Untuk `type` menentukan salah satu `SEARCH` atau`TIMESERIES`.

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

## Membuat koleksi dengan indeks pengayaan semantik otomatis
<a name="serverless-create-cli-automatic-semantic-enrichment"></a>

Gunakan prosedur berikut untuk membuat koleksi OpenSearch Tanpa Server baru dengan indeks yang dikonfigurasi untuk pengayaan [semantik otomatis](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-semantic-enrichment.html). Prosedur ini menggunakan aksi [CreateIndex](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_CreateIndex.html)API OpenSearch Tanpa Server.

**Untuk membuat koleksi baru dengan indeks yang dikonfigurasi untuk pengayaan semantik otomatis**

Jalankan perintah berikut untuk membuat koleksi dan indeks.

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

Inilah contohnya.

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