Ekspresi proyeksi

Untuk membaca data dari tabel, Anda menggunakan operasi seperti GetItem, Query, atau Scan. Amazon DynamoDB mengembalikan semua atribut item secara default. Untuk mendapatkan beberapa saja, bukan semua atribut, gunakan ekspresi proyeksi.

Ekspresi proyeksi adalah string yang mengidentifikasi atribut yang Anda inginkan. Untuk mengambil atribut tunggal, tentukan namanya. Untuk beberapa atribut, nama harus dipisahkan koma.

Berikut adalah beberapa contoh ekspresi proyeksi, berdasarkan item ProductCatalog dari Menentukan atribut item saat menggunakan ekspresi:

• Atribut tingkat atas tunggal.

  Title

• Tiga atribut tingkat atas. DynamoDB mengambil seluruh set Color.

  Title, Price, Color

• Empat atribut tingkat atas. DynamoDB mengembalikan seluruh konten RelatedItems dan ProductReviews.

  Title, Description, RelatedItems, ProductReviews

DynamoDB memiliki daftar kata-kata khusus dan karakter khusus. Anda dapat menggunakan nama atribut dalam ekspresi proyeksi, asalkan karakter pertama adalah a-z atau A-Z dan karakter kedua (jika ada) adalah a-z, A-Z, atau 0-9. Jika nama atribut tidak memenuhi persyaratan ini, Anda harus menentukan nama atribut ekspresi sebagai placeholder. Untuk daftar lengkap, lihat Disimpan kata-kata di DynamoDB. Selain itu, karakter berikut memiliki arti khusus dalam DynamoDB: # (hash) dan :(titik dua).

Meskipun DynamoDB mengizinkan Anda menggunakan kata-kata khusus dan karakter khusus ini untuk nama, kami menyarankan agar Anda menghindari melakukannya karena Anda harus menentukan variabel placeholder setiap kali Anda menggunakan nama-nama ini dalam sebuah ekspresi. Untuk informasi selengkapnya, lihat Nama atribut ekspresi di DynamoDB.

AWS CLI Contoh berikut menunjukkan bagaimana menggunakan ekspresi proyeksi dengan GetItem operasi. Ekspresi proyeksi ini mengambil atribut skalar tingkat atas (Description), elemen pertama dalam daftar (RelatedItems[0]), dan daftar bersarang dalam peta (ProductReviews.FiveStar).

aws dynamodb get-item \
    --table-name ProductCatalog \
    --key file://key.json \
    --projection-expression "Description, RelatedItems[0], ProductReviews.FiveStar"

JSON berikut akan dikembalikan untuk contoh ini.

{
    "Item": {
        "Description": {
            "S": "123 description"
        },
        "ProductReviews": {
            "M": {
                "FiveStar": {
                    "L": [
                        {
                            "S": "Excellent! Can't recommend it highly enough! Buy it!"
                        },
                        {
                            "S": "Do yourself a favor and buy this."
                        }
                    ]
                }
            }
        },
        "RelatedItems": {
            "L": [
                {
                    "N": "341"
                }
            ]
        }
    }
}

Argumen untuk --key disimpan dalam file key.json.

{
    "Id": { "N": "123" }
}

Untuk contoh kode khusus bahasa pemrograman, lihat Memulai dengan DynamoDB dan SDK AWS.