AWS SDK untuk JavaScript V2 telah mencapai akhir dukungan. Kami menyarankan Anda bermigrasi ke AWS SDK untuk JavaScript v3. Untuk detail dan informasi tambahan tentang cara bermigrasi, silakan lihat pengumuman ini.

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

Menggunakan Klien Dokumen DynamoDB

Contoh Node.js kode ini menunjukkan:

Skenario

Klien dokumen DynamoDB menyederhanakan bekerja dengan item dengan mengabstraksi gagasan nilai atribut. Abstraksi ini menganotasi JavaScript tipe asli yang disediakan sebagai parameter input, serta mengubah data respons beranotasi ke tipe asli. JavaScript

Untuk informasi selengkapnya tentang kelas Klien Dokumen DynamoDB, lihat AWS.DynamoDB.DocumentClient di Referensi API. Untuk informasi selengkapnya tentang pemrograman dengan Amazon DynamoDB, lihat Pemro graman dengan DynamoDB di Panduan Pengembang Amazon DynamoDB.

Dalam contoh ini, Anda menggunakan serangkaian Node.js modul untuk melakukan operasi dasar pada tabel DynamoDB menggunakan klien dokumen. Kode menggunakan SDK untuk menanyakan dan JavaScript memindai tabel menggunakan metode ini dari kelas Klien Dokumen DynamoDB:

Tugas Prasyarat

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

Mendapatkan Item dari Tabel

Buat Node.js modul dengan nama fileddbdoc_get.js. Pastikan untuk mengkonfigurasi SDK seperti yang ditunjukkan sebelumnya. Untuk mengakses DynamoDB, buat objekAWS.DynamoDB.DocumentClient. Buat objek JSON yang berisi parameter yang diperlukan dapatkan item dari tabel, yang dalam contoh ini mencakup nama tabel, nama kunci hash dalam tabel itu, dan nilai kunci hash untuk item yang ingin Anda dapatkan. Panggil get metode klien dokumen DynamoDB.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create DynamoDB document client
var docClient = new AWS.DynamoDB.DocumentClient({ apiVersion: "2012-08-10" });

var params = {
  TableName: "EPISODES_TABLE",
  Key: { KEY_NAME: VALUE },
};

docClient.get(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data.Item);
  }
});

Untuk menjalankan contoh, ketik berikut ini di baris perintah.

node ddbdoc_get.js

Kode sampel ini dapat ditemukan di sini GitHub.

Menempatkan Item di Tabel

Buat Node.js modul dengan nama fileddbdoc_put.js. Pastikan untuk mengkonfigurasi SDK seperti yang ditunjukkan sebelumnya. Untuk mengakses DynamoDB, buat objekAWS.DynamoDB.DocumentClient. Buat objek JSON yang berisi parameter yang diperlukan untuk menulis item ke tabel, yang dalam contoh ini mencakup nama tabel dan deskripsi item untuk ditambahkan atau diperbarui yang mencakup hashkey dan nilai serta nama dan nilai untuk atribut yang ditetapkan pada item. Panggil put metode klien dokumen DynamoDB.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create DynamoDB document client
var docClient = new AWS.DynamoDB.DocumentClient({ apiVersion: "2012-08-10" });

var params = {
  TableName: "TABLE",
  Item: {
    HASHKEY: VALUE,
    ATTRIBUTE_1: "STRING_VALUE",
    ATTRIBUTE_2: VALUE_2,
  },
};

docClient.put(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

Untuk menjalankan contoh, ketik berikut ini di baris perintah.

node ddbdoc_put.js

Kode sampel ini dapat ditemukan di sini GitHub.

Memperbarui Item dalam Tabel

Buat Node.js modul dengan nama fileddbdoc_update.js. Pastikan untuk mengkonfigurasi SDK seperti yang ditunjukkan sebelumnya. Untuk mengakses DynamoDB, buat objekAWS.DynamoDB.DocumentClient. Buat objek JSON yang berisi parameter yang diperlukan untuk menulis item ke tabel, yang dalam contoh ini mencakup nama tabel, kunci item yang akan diperbarui, satu set UpdateExpressions yang menentukan atribut item untuk diperbarui dengan token yang Anda tetapkan nilainya dalam ExpressionAttributeValues parameter. Panggil update metode klien dokumen DynamoDB.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create DynamoDB document client
var docClient = new AWS.DynamoDB.DocumentClient({ apiVersion: "2012-08-10" });

// Create variables to hold numeric key values
var season = SEASON_NUMBER;
var episode = EPISODES_NUMBER;

var params = {
  TableName: "EPISODES_TABLE",
  Key: {
    Season: season,
    Episode: episode,
  },
  UpdateExpression: "set Title = :t, Subtitle = :s",
  ExpressionAttributeValues: {
    ":t": "NEW_TITLE",
    ":s": "NEW_SUBTITLE",
  },
};

docClient.update(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

Untuk menjalankan contoh, ketik berikut ini di baris perintah.

node ddbdoc_update.js

Kode sampel ini dapat ditemukan di sini GitHub.

Melakukan Kueri Tabel

Contoh ini menanyakan tabel yang berisi informasi episode tentang seri video, mengembalikan judul episode dan subtitle episode musim kedua setelah episode 9 yang berisi frasa tertentu dalam subtitle mereka.

Buat Node.js modul dengan nama fileddbdoc_query.js. Pastikan untuk mengkonfigurasi SDK seperti yang ditunjukkan sebelumnya. Untuk mengakses DynamoDB, buat objekAWS.DynamoDB.DocumentClient. Buat objek JSON yang berisi parameter yang diperlukan untuk menanyakan tabel, yang dalam contoh ini mencakup nama tabel, yang ExpressionAttributeValues dibutuhkan oleh kueri, dan KeyConditionExpression yang menggunakan nilai-nilai tersebut untuk menentukan item mana yang dikembalikan kueri. Panggil query metode klien dokumen DynamoDB.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create DynamoDB document client
var docClient = new AWS.DynamoDB.DocumentClient({ apiVersion: "2012-08-10" });

var params = {
  ExpressionAttributeValues: {
    ":s": 2,
    ":e": 9,
    ":topic": "PHRASE",
  },
  KeyConditionExpression: "Season = :s and Episode > :e",
  FilterExpression: "contains (Subtitle, :topic)",
  TableName: "EPISODES_TABLE",
};

docClient.query(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data.Items);
  }
});

Untuk menjalankan contoh, ketik berikut ini di baris perintah.

node ddbdoc_query.js

Kode sampel ini dapat ditemukan di sini GitHub.

Menghapus Item dari Tabel

Buat Node.js modul dengan nama fileddbdoc_delete.js. Pastikan untuk mengkonfigurasi SDK seperti yang ditunjukkan sebelumnya. Untuk mengakses DynamoDB, buat objekAWS.DynamoDB.DocumentClient. Buat objek JSON yang berisi parameter yang diperlukan untuk menghapus item dalam tabel, yang dalam contoh ini mencakup nama tabel serta nama dan nilai hashkey dari item yang ingin Anda hapus. Panggil delete metode klien dokumen DynamoDB.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create DynamoDB document client
var docClient = new AWS.DynamoDB.DocumentClient({ apiVersion: "2012-08-10" });

var params = {
  Key: {
    HASH_KEY: VALUE,
  },
  TableName: "TABLE",
};

docClient.delete(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

Untuk menjalankan contoh, ketik berikut ini di baris perintah.

node ddbdoc_delete.js

Kode sampel ini dapat ditemukan di sini GitHub.