Kisi-kisi untuk DynamoDB - Amazon DynamoDB
Pengaturan awalSDK atau CLITindakan dasarPeraturan penamaanDasar-dasar kuota layananInformasi lain

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

Kisi-kisi untuk DynamoDB

Lembar contekan ini memberikan referensi cepat untuk bekerja dengan Amazon DynamoDB dan berbagai SDK-nya. AWS

Pengaturan awal

  1. Mendaftar untuk AWS.

  2. Dapatkan kunci akses AWS untuk mengakses DynamoDB secara terprogram.

  3. Konfigurasikan kredenal DynamoDB Anda.

Lihat juga:

SDK atau CLI

Pilih SDK pilihan Anda, atau atur AWS CLI.

catatan

Saat Anda menggunakan AWS CLI on Windows, garis miring terbalik (\) yang tidak ada di dalam kutipan diperlakukan sebagai carriage return. Selain itu, Anda harus menghilangkan tanda kutip dan kurung kurawal apa pun di dalam tanda kutip lainnya. Sebagai contoh, lihat tab Windows di “Buat tabel” di bagian berikutnya.

Lihat juga:

Tindakan dasar

Bagian ini menyediakan kode untuk tugas DynamoDB dasar. Untuk informasi selengkapnya tentang tugas ini, lihat Memulai DynamoDB dan SDK. AWS

Membuat tabel

Default
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=10,WriteCapacityUnits=5
Windows
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=10,WriteCapacityUnits=5

Tulis item ke tabel

aws dynamodb put-item \ --table-name Music \ --item file://item.json

Baca item dari tabel

aws dynamodb get-item \ --table-name Music \ --item file://item.json

Hapus item dari tabel

aws dynamodb delete-item --table-name Music --key file://key.json

Mengkueri Tabel

aws dynamodb query --table-name Music 
--key-condition-expression "ArtistName=:Artist and SongName=:Songtitle"

Menghapus tabel

aws dynamodb delete-table --table-name Music

Daftar nama tabel

aws dynamodb list-tables

Peraturan penamaan

  • Semua nama harus dikodekan menggunakan UTF-8 dan peka huruf besar-kecil.

  • Nama tabel dan nama indeks panjangnya harus antara 3 hingga 255 karakter, dan hanya dapat berisi karakter berikut:

    • a-z

    • A-Z

    • 0-9

    • _(garis bawah)

    • -(dasbor)

    • .(titik)

  • Nama atribut harus memiliki panjang minimal satu karakter dan berukuran kurang dari 64 KB.

Untuk informasi selengkapnya, lihat Aturan penamaan.

Dasar-dasar kuota layanan

Membaca dan menulis unit

  • Unit kapasitas baca (RCU) – Satu pembacaan sangat konsisten per detik, atau dua pembacaan akhirnya konsisten per detik, untuk item berukuran hingga 4 KB.

  • Unit kapasitas tulis (WCU) – Satu tulis per detik, untuk item berukuran hingga 1 KB.

Batasan tabel

  • Ukuran tabel — Tidak ada batas praktis pada ukuran tabel. Tabel tidak dibatasi dalam jumlah item atau jumlah byte.

  • Jumlah tabel — Untuk AWS akun apa pun, ada kuota awal 2.500 tabel per AWS Wilayah.

  • Batas ukuran halaman untuk kueri dan pemindaian – Ada batas 1 MB per halaman, per kueri atau pemindaian. Jika parameter kueri atau operasi pemindaian Anda pada tabel menghasilkan lebih dari 1 MB data, DynamoDB mengembalikan item awal yang cocok. Ini juga mengembalikan properti LastEvaluatedKey yang dapat Anda gunakan dalam permintaan baru untuk membaca halaman berikutnya.

Indeks

  • Indeks sekunder lokal (LSI) – Anda dapat menentukan maksimum lima indeks sekunder lokal. LSI terutama berguna ketika indeks harus memiliki konsistensi yang kuat dengan tabel dasar.

  • Indeks sekunder global (GSI) – Ada kuota default 20 indeks sekunder global per tabel.

  • Atribut indeks sekunder yang diproyeksikan per tabel – Anda dapat memproyeksikan total hingga 100 atribut ke semua indeks lokal tabel dan sekunder global. Ini hanya berlaku untuk atribut proyeksi yang ditentukan pengguna.

Kunci partisi

  • Panjang minimum nilai kunci partisi adalah 1 byte. Panjang maksimum adalah 2048 byte.

  • Tidak ada batasan praktis untuk jumlah nilai kunci partisi yang berbeda, untuk tabel atau indeks sekunder.

  • Panjang minimum nilai kunci urutan adalah 1 byte. Panjang maksimum adalah 1024 byte.

  • Secara umum, tidak ada batas praktis pada jumlah nilai kunci urutan berbeda per nilai kunci partisi. Pengecualian ini adalah untuk tabel dengan indeks sekunder.

Untuk informasi selengkapnya tentang indeks sekunder, desain kunci partisi, dan desain kunci urutan, lihat Praktik terbaik.

Batas untuk jenis data yang umum digunakan

  • String – Panjang string dibatasi oleh ukuran item maksimum 400 KB. String adalah Unicode dengan pengodean biner UTF-8.

  • Angka – Angka dapat memiliki hingga 38 digit presisi, dan dapat positif, negatif, atau nol.

  • Binary – Panjang biner dibatasi oleh ukuran item maksimum 400 KB. Aplikasi yang bekerja dengan atribut binari harus mengodekan data dalam pengodean base64 sebelum mengirimnya ke DynamoDB.

Untuk daftar jenis daya yang didukung, lihat Jenis data. Untuk informasi selengkapnya, lihat Kuota layanan.

Item, atribut, dan parameter ekspresi

Ukuran item maksimum di DynamoDB adalah 400 KB, yang mencakup panjang biner nama atribut (UTF-8 panjang) dan panjang biner nilai atribut (UTF-8 panjang). Nama atribut dihitung terhadap batas ukuran.

Tidak ada batas pada jumlah nilai dalam daftar, peta, atau set, selama item yang berisi nilai-nilai cocok dalam batas ukuran item 400-KB.

Untuk parameter ekspresi, panjang maksimum string ekspresi adalah 4 KB.

Untuk informasi selengkapnya tentang ukuran item, atribut, dan parameter ekspresi, lihat Kuota layanan.

Informasi lain