Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Untuk bekerja dengan Amazon DynamoDB, aplikasi Anda harus menggunakan beberapa operasi API sederhana. Berikut ini adalah ringkasan operasi-operasi ini, yang disusun berdasarkan kategori.
catatan
Untuk daftar lengkap operasi API, lihat Referensi API Amazon DynamoDB.
Bidang kontrol
Operasi bidang kontrol memungkinkan Anda membuat dan mengelola tabel DynamoDB. Operasi ini juga memungkinkan Anda bekerja dengan indeks, aliran, dan objek lain yang tergantung pada tabel.
-
CreateTable
— Membuat tabel baru. Selain itu, Anda dapat membuat satu atau beberapa indeks sekunder, dan mengaktifkan DynamoDB Streams untuk tabel. -
DescribeTable
— Mengembalikan informasi tentang tabel, seperti skema kunci primer, pengaturan throughput, dan informasi indeks. -
ListTables
— Mengembalikan nama semua tabel Anda dalam daftar. -
UpdateTable
— Memodifikasi pengaturan tabel atau indeks, menciptakan atau menghapus indeks baru pada tabel, atau memodifikasi pengaturan DynamoDB Streams untuk tabel. -
DeleteTable
— Menghapus meja dan semua objek yang bergantung dari DynamoDB.
Bidang data
Operasi bidang data memungkinkan Anda membuat, membaca, memperbarui, dan menghapus tindakan (juga disebut CRUD) pada data dalam tabel. Beberapa operasi bidang data juga memungkinkan Anda membaca data dari indeks sekunder.
Anda dapat menggunakanPartiQL - Bahasa kueri yang kompatibel dengan SQL untuk Amazon DynamoDB, untuk melakukan operasi CRUD ini atau Anda dapat menggunakan CRUD klasik DynamoDB APIs yang memisahkan setiap operasi menjadi panggilan API yang berbeda.
PartiQL - Bahasa kueri yang kompatibel dengan SQL
-
ExecuteStatement
– Membaca beberapa item dari tabel. Anda juga dapat menulis atau memperbarui satu item dari tabel. Saat menulis atau memperbarui satu item, Anda harus menentukan atribut kunci primer. -
BatchExecuteStatement
– Menulis, memperbarui, atau membaca beberapa item dari tabel. Ini lebih efisien dariExecuteStatement
karena aplikasi Anda hanya memerlukan satu jaringan bolak-balik untuk menulis atau membaca item.
Klasik APIs
Membuat data
-
PutItem
– Menulis satu item pada tabel. Anda harus menentukan atribut kunci primer, tetapi Anda tidak perlu menentukan atribut lainnya. -
BatchWriteItem
– Menulis hingga 25 item pada tabel. Ini lebih efisien dari menjalankanPutItem
beberapa kali karena aplikasi Anda hanya memerlukan satu jaringan bolak-balik untuk menulis item.
Membaca data
-
GetItem
– Mengambil satu item dari tabel. Anda harus menentukan kunci primer untuk item yang Anda inginkan. Anda dapat mengambil seluruh item, atau hanya sebagian dari atributnya. -
BatchGetItem
– Mengambil hingga 100 item dari satu atau beberapa tabel. Ini lebih efisien dari menjalankanGetItem
beberapa kali karena aplikasi Anda hanya memerlukan satu jaringan bolak-balik untuk membaca item. -
Query
– Mengambil semua item yang memiliki kunci partisi tertentu. Anda harus menentukan nilai kunci partisi. Anda dapat mengambil seluruh item, atau hanya sebagian dari atributnya. Secara opsional, Anda dapat menerapkan ketentuan pada nilai kunci urutan sehingga Anda hanya mengambil subkumpulan data yang memiliki kunci partisi yang sama. Anda dapat menggunakan operasi ini pada tabel, asalkan tabel tersebut memiliki kunci partisi dan kunci urutan. Anda juga dapat menggunakan operasi ini pada indeks, asalkan indeks tersebut memiliki kunci partisi dan kunci urutan. -
Scan
– Mengambil semua item dalam tabel atau indeks yang ditentukan. Anda dapat mengambil seluruh item, atau hanya sebagian dari atributnya. Secara opsional, Anda dapat menerapkan kondisi pemfilteran untuk hanya mengembalikan nilai yang Anda minati dan membuang sisanya.
Memperbarui data
-
UpdateItem
— Memodifikasi satu atau beberapa atribut dalam item. Memodifikasi satu atau lebih atribut dalam suatu item. Anda harus menentukan kunci primer untuk item yang ingin Anda ubah. Anda dapat menambahkan atribut baru dan mengubah atau menghapus atribut yang sudah ada. Anda juga dapat melakukan pembaruan bersyarat, sehingga pembaruan hanya berhasil bila kondisi yang ditentukan pengguna terpenuhi. Secara opsional, Anda dapat menerapkan penghitung atom, yang menambah atau mengurangi atribut numerik tanpa mengganggu permintaan tulis lainnya.
Menghapus data
-
DeleteItem
– Menghapus satu item dari tabel. Anda harus menentukan kunci primer untuk item yang ingin Anda hapus. -
BatchWriteItem
– Menghapus hingga 25 item dari satu atau beberapa tabel. Ini lebih efisien dari menjalankanDeleteItem
beberapa kali karena aplikasi Anda hanya memerlukan satu jaringan bolak-balik untuk menghapus item.catatan
Anda dapat menggunakan
BatchWriteItem
untuk membuat data dan menghapus data.
DynamoDB Streams
Operasi DynamoDB Streams memungkinkan Anda mengaktifkan atau menonaktifkan stream pada tabel, dan memungkinkan akses ke catatan modifikasi data yang terkandung dalam aliran.
-
ListStreams
– Menampilkan daftar semua stream Anda, atau hanya stream untuk tabel tertentu. -
DescribeStream
– Menampilkan informasi tentang stream, seperti Amazon Resource Name (ARN) dan di mana aplikasi Anda dapat mulai membaca beberapa catatan stream pertama. -
GetShardIterator
– Menampilkan iterator serpihan, yang merupakan struktur data yang menggunakan aplikasi Anda untuk mengambil catatan dari stream. -
GetRecords
– Mengambil satu atau lebih catatan stream, menggunakan iterator serpihan yang diberikan.
Transaksi
Transaksi memberikan atomisitas, konsistensi, isolasi, dan daya tahan (ACID) yang memungkinkan Anda menjaga kebenaran data dalam aplikasi Anda dengan lebih mudah.
Anda dapat menggunakanPartiQL - Bahasa kueri yang kompatibel dengan SQL untuk Amazon DynamoDB, untuk melakukan operasi transaksional atau Anda dapat menggunakan CRUD klasik DynamoDB APIs yang memisahkan setiap operasi menjadi panggilan API yang berbeda.
PartiQL - Bahasa kueri yang kompatibel dengan SQL
-
ExecuteTransaction
— Operasi batch yang memungkinkan operasi CRUD ke beberapa item baik di dalam maupun di seluruh tabel dengan all-or-nothing hasil yang dijamin.
Klasik APIs
-
TransactWriteItems
— Operasi batch yang memungkinkanPut
,Update
, danDelete
operasi ke beberapa item baik di dalam maupun di seluruh tabel dengan all-or-nothing hasil yang dijamin. -
TransactGetItems
– Sebuah operasi batch yang memungkinkan operasiGet
untuk mengambil beberapa item dari satu atau beberapa tabel.