Buat koleksi (CLI)

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

Sebelum Anda mulai

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

• Hanya berisi 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 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* ataucollection/*.

2. Jalankan perintah berikut untuk mengkonfigurasi pengaturan jaringan untuk koleksi menggunakan kebijakan jaringan. 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

Prosedur berikut menggunakan tindakan CreateCollectionAPI untuk membuat koleksi tipe SEARCH atauTIMESERIES. Jika Anda tidak menentukan jenis koleksi dalam permintaan, defaultnya adalah. TIMESERIES Untuk informasi lebih lanjut tentang jenis ini, lihatMemilih jenis koleksi. Untuk membuat koleksi pencarian vektor, lihatBekerja dengan koleksi pencarian vektor.

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.

Untuk membuat koleksi

1. Verifikasi bahwa Anda membuat kebijakan yang diperlukan yang dijelaskan dalamSebelum Anda mulai.

2. Jalankan perintah berikut. Untuk type menentukan salah satu SEARCH atauTIMESERIES.

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

Membuat koleksi dengan indeks pengayaan semantik otomatis

Gunakan prosedur berikut untuk membuat koleksi OpenSearch Tanpa Server baru dengan indeks yang dikonfigurasi untuk pengayaan semantik otomatis. Prosedur ini menggunakan tindakan CreateIndexAPI 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" 
                }
            }
        }
    }
}'