Menggunakan AWS CLI

Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk mengontrol beberapa layanan AWS dari baris perintah dan mengotomatiskan layanan tersebut melalui skrip. Anda dapat menggunakan AWS CLI untuk operasi ad hoc, seperti membuat tabel. Anda juga dapat menggunakannya untuk menanamkan operasi Amazon DynamoDB dalam skrip utilitas.

Sebelum dapat menggunakan AWS CLI dengan DynamoDB, Anda harus mendapatkan ID kunci akses dan kunci akses rahasia. Untuk informasi selengkapnya, lihat Memberikan akses terprogram .

Untuk daftar lengkap tentang semua perintah yang tersedia untuk DynamoDB di AWS CLI, lihat referensi perintah AWS CLI.

Mengunduh dan mengonfigurasi AWS CLI

AWS CLI tersedia di http://aws.amazon.com/cli. Alat ini berjalan di Windows, macOS, atau Linux. Setelah Anda mengunduh AWS CLI, ikuti langkah berikut untuk menginstal dan mengonfigurasinya:

1. Buka Panduan Pengguna AWS Command Line Interface.

2. Ikuti petunjuk untuk Menginstal AWS CLI dan Mengonfigurasi AWS CLI.

Menggunakan AWS CLI dengan DynamoDB

Format baris perintah terdiri dari nama operasi DynamoDB, diikuti oleh parameter untuk operasi tersebut. AWS CLI mendukung sintaks singkatan untuk nilai parameter, serta JSON.

Misalnya, perintah berikut membuat tabel bernama Music. Kunci partisi adalah Artist, dan kunci sortir adalah SongTitle. (Agar mudah dibaca, perintah panjang di bagian ini dipecah menjadi baris terpisah.)

aws dynamodb create-table \
    --table-name Music \
    --attribute-definitions \
        AttributeName=Artist,AttributeType=S \
        AttributeName=SongTitle,AttributeType=S \
    --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \
    --provisioned-throughput ReadCapacityUnits=1,WriteCapacityUnits=1 \
    --table-class STANDARD

Perintah berikut menambahkan item baru ke tabel. Contoh-contoh ini menggunakan kombinasi sintaks singkatan dan JSON.

aws dynamodb put-item \
    --table-name Music \
    --item \
        '{"Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Call Me Today"}, "AlbumTitle": {"S": "Somewhat Famous"}}' \
    --return-consumed-capacity TOTAL  

aws dynamodb put-item \
    --table-name Music \
    --item '{
        "Artist": {"S": "Acme Band"},
        "SongTitle": {"S": "Happy Day"},
        "AlbumTitle": {"S": "Songs About Life"} }' \
    --return-consumed-capacity TOTAL

Pada baris perintah, menulis JSON yang valid bisa menjadi hal yang sulit. Namun, AWS CLI dapat membaca file JSON. Sebagai contoh, perhatikan potongan kode JSON berikut, yang disimpan dalam sebuah file bernama key-conditions.json.

{
    "Artist": {
        "AttributeValueList": [
            {   
                "S": "No One You Know"
            }   
        ],  
        "ComparisonOperator": "EQ"
    },  
    "SongTitle": {
        "AttributeValueList": [
            {   
                "S": "Call Me Today"
            }   
        ],  
        "ComparisonOperator": "EQ"
    }
}

Sekarang, Anda dapat menerbitkan permintaan Query menggunakan AWS CLI. Dalam contoh ini, isi file kunci-conditions.json digunakan untuk parameter --key-conditions.

aws dynamodb query --table-name Music --key-conditions file://key-conditions.json

Menggunakan AWS CLI dengan DynamoDB lokal

Ini juga AWS CLI dapat berinteraksi dengan DynamoDB lokal (versi yang dapat diunduh) yang berjalan di komputer Anda. Untuk mengaktifkan hal ini, tambahkan parameter berikut ke setiap perintah:

--endpoint-url http://localhost:8000

Contoh berikut menggunakan AWS CLI untuk mencantumkan tabel dalam basis data lokal.

aws dynamodb list-tables --endpoint-url http://localhost:8000

Jika DynamoDB menggunakan nomor port selain nomor default (8000), modifikasi nilai --endpoint-url sebagaimana mestinya.

catatan

Tidak AWS CLI dapat menggunakan DynamoDB lokal (versi yang dapat diunduh) sebagai titik akhir default. Oleh karena itu, Anda harus menentukan --endpoint-url dengan setiap perintah.