Membuat dan menggunakan tabel di DynamoDB - AWS SDK for JavaScript

Panduan Referensi API AWS SDK for JavaScript V3 menjelaskan secara rinci semua operasi API untuk AWS SDK for JavaScript versi 3 (V3).

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

Membuat dan menggunakan tabel di DynamoDB

JavaScript code example that applies to Node.js execution

Contoh kode Node.js ini menunjukkan:

  • Cara membuat dan mengelola tabel yang digunakan untuk menyimpan dan mengambil data dari DynamoDB.

Skenario

Mirip dengan sistem basis data lainnya, DynamoDB menyimpan data dalam tabel. Tabel DynamoDB adalah kumpulan data yang disusun ke dalam item yang analog dengan baris. Untuk menyimpan atau mengakses data di DynamoDB, Anda membuat dan bekerja dengan tabel.

Dalam contoh ini, Anda menggunakan serangkaian modul Node.js untuk melakukan operasi dasar dengan tabel DynamoDB. Kode menggunakan SDK for JavaScript untuk membuat dan bekerja dengan tabel dengan menggunakan metode kelas DynamoDB klien berikut:

Tugas prasyarat

Untuk mengatur dan menjalankan contoh ini, pertama-tama selesaikan tugas-tugas ini:

  • Siapkan lingkungan proyek untuk menjalankan contoh Node.js ini, dan instal modul wajib AWS SDK for JavaScript dan pihak ketiga. Ikuti instruksi pada GitHub.

  • Instal SDK untuk klien JavaScript DynamoDB. Untuk informasi selengkapnya, lihat Apa yang baru di Versi 3.

  • Buat file konfigurasi bersama dengan kredensi pengguna Anda. Untuk informasi selengkapnya tentang menyediakan file kredensyal bersama, lihat File konfigurasi dan kredensyal bersama di Panduan Referensi AWS SDK dan Alat.

penting

Contoh-contoh ini menggunakan ECMAScript6 (ES6). Ini membutuhkan Node.js versi 13.x atau lebih tinggi. Untuk mengunduh dan menginstal versi terbaru dari Node.js, lihat unduhan Node.js. .

Namun, jika Anda lebih suka menggunakan sintaks CommonJS, silakan merujuk ke. JavaScript ES6/CommonJS sintaks

catatan

Untuk informasi tentang tipe data yang digunakan dalam contoh ini, lihat Tipe data yang didukung dan aturan penamaan di Amazon DynamoDB.

Membuat tabel

Buat modul Node.js dengan nama filecreate-table.js. Pastikan untuk mengonfigurasi SDK seperti yang ditunjukkan sebelumnya, termasuk mengunduh klien dan paket yang diperlukan. Untuk mengakses DynamoDB, buat objek layanan klienDynamoDB. Buat objek JSON yang berisi parameter yang diperlukan untuk membuat tabel, yang dalam contoh ini mencakup nama dan tipe data untuk setiap atribut, skema kunci, nama tabel, dan unit throughput untuk penyediaan. Panggil CreateTableCommand metode objek layanan DynamoDB.

import { CreateTableCommand, DynamoDBClient } from "@aws-sdk/client-dynamodb"; const client = new DynamoDBClient({}); export const main = async () => { const command = new CreateTableCommand({ TableName: "EspressoDrinks", // For more information about data types, // see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html#HowItWorks.DataTypes and // https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.LowLevelAPI.html#Programming.LowLevelAPI.DataTypeDescriptors AttributeDefinitions: [ { AttributeName: "DrinkName", AttributeType: "S", }, ], KeySchema: [ { AttributeName: "DrinkName", KeyType: "HASH", }, ], ProvisionedThroughput: { ReadCapacityUnits: 1, WriteCapacityUnits: 1, }, }); const response = await client.send(command); console.log(response); return response; };

Untuk menjalankan contoh, masukkan yang berikut ini di command prompt.

node create-table.js

Kode contoh ini dapat ditemukan di sini GitHub.

Daftar tabel Anda

Buat modul Node.js dengan nama filelist-tables.js. Pastikan untuk mengonfigurasi SDK seperti yang ditunjukkan sebelumnya, termasuk mengunduh klien dan paket yang diperlukan. Untuk mengakses DynamoDB, buat objek layanan klienDynamoDB. Buat objek JSON yang berisi parameter yang diperlukan untuk daftar tabel Anda, yang dalam contoh ini membatasi jumlah tabel yang terdaftar ke 10. Panggil ListTablesCommand metode objek layanan DynamoDB.

import { ListTablesCommand, DynamoDBClient } from "@aws-sdk/client-dynamodb"; const client = new DynamoDBClient({}); export const main = async () => { const command = new ListTablesCommand({}); const response = await client.send(command); console.log(response); return response; };

Untuk menjalankan contoh, masukkan yang berikut ini di command prompt.

node list-tables.js

Kode contoh ini dapat ditemukan di sini GitHub.

Menjelaskan tabel

Buat modul Node.js dengan nama filedescribe-table.js. Pastikan untuk mengonfigurasi SDK seperti yang ditunjukkan sebelumnya, termasuk mengunduh klien dan paket yang diperlukan. Untuk mengakses DynamoDB, buat objek layanan klienDynamoDB. Buat objek JSON yang berisi parameter yang diperlukan untuk menggambarkan DescribeTableCommand metode objek layanan DynamoDB.

import { DescribeTableCommand, DynamoDBClient } from "@aws-sdk/client-dynamodb"; const client = new DynamoDBClient({}); export const main = async () => { const command = new DescribeTableCommand({ TableName: "Pastries", }); const response = await client.send(command); console.log(`TABLE NAME: ${response.Table.TableName}`); console.log(`TABLE ITEM COUNT: ${response.Table.ItemCount}`); return response; };

Untuk menjalankan contoh, masukkan yang berikut ini di command prompt.

node describe-table.js

Kode contoh ini dapat ditemukan di sini GitHub.

Menghapus tabel

Buat modul Node.js dengan nama filedelete-table.js. Pastikan untuk mengonfigurasi SDK seperti yang ditunjukkan sebelumnya, termasuk mengunduh klien dan paket yang diperlukan. Untuk mengakses DynamoDB, buat objek layanan klienDynamoDB. Buat objek JSON yang berisi parameter yang diperlukan untuk menghapus tabel, yang dalam contoh ini mencakup nama tabel yang disediakan sebagai parameter baris perintah. Panggil DeleteTableCommand metode objek layanan DynamoDB.

import { DeleteTableCommand, DynamoDBClient } from "@aws-sdk/client-dynamodb"; const client = new DynamoDBClient({}); export const main = async () => { const command = new DeleteTableCommand({ TableName: "DecafCoffees", }); const response = await client.send(command); console.log(response); return response; };

Untuk menjalankan contoh, masukkan yang berikut ini di command prompt.

node delete-table.js

Kode contoh ini dapat ditemukan di sini GitHub.