AWS SDK untuk JavaScript V2 telah mencapai akhir dukungan. Kami menyarankan Anda bermigrasi ke [AWS SDK untuk JavaScript v3](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/). Untuk detail dan informasi tambahan tentang cara bermigrasi, silakan lihat [ pengumuman ini](https://aws.amazon.com/blogs/developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/).
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: **
+ Cara mengakses tabel DynamoDB menggunakan klien dokumen.
## 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`](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html) di Referensi API. Untuk informasi selengkapnya tentang pemrograman dengan Amazon DynamoDB, lihat Pemro [ graman dengan DynamoDB ](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.html) 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:
+ [dapatkan ](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#get-property)
+ [menaruh ](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#put-property)
+ [memperbarui ](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#update-property)
+ [query](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#query-property)
+ [menghapus ](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#delete-property)
## Tugas Prasyarat
Untuk mengatur dan menjalankan contoh ini, pertama-tama selesaikan tugas-tugas ini:
+ Instal Node.js. Untuk informasi lebih lanjut, lihat situs [ Node.js web](https://nodejs.org).
+ Buat file konfigurasi bersama dengan kredenSIAL pengguna Anda. Untuk informasi selengkapnya tentang menyediakan file kredenSIAL bersama, lihat[Memuat Kredensial di Node.js dari File Kredensial Bersama](loading-node-credentials-shared.md).
+ Buat tabel DynamoDB yang itemnya dapat Anda akses. Untuk informasi selengkapnya tentang membuat tabel DynamoDB menggunakan SDK untuk JavaScript, lihat. [Membuat dan Menggunakan Tabel di DynamoDB](dynamodb-examples-using-tables.md) Anda juga dapat menggunakan konsol [ DynamoDB ](https://console.aws.amazon.com/dynamodb/) untuk membuat tabel.
## Mendapatkan Item dari Tabel
Buat Node.js modul dengan nama file`ddbdoc_get.js`. Pastikan untuk mengkonfigurasi SDK seperti yang ditunjukkan sebelumnya. Untuk mengakses DynamoDB, buat objek`AWS.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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_get.js).
## Menempatkan Item di Tabel
Buat Node.js modul dengan nama file`ddbdoc_put.js`. Pastikan untuk mengkonfigurasi SDK seperti yang ditunjukkan sebelumnya. Untuk mengakses DynamoDB, buat objek`AWS.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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_put.js).
## Memperbarui Item dalam Tabel
Buat Node.js modul dengan nama file`ddbdoc_update.js`. Pastikan untuk mengkonfigurasi SDK seperti yang ditunjukkan sebelumnya. Untuk mengakses DynamoDB, buat objek`AWS.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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_update.js).
## 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 file`ddbdoc_query.js`. Pastikan untuk mengkonfigurasi SDK seperti yang ditunjukkan sebelumnya. Untuk mengakses DynamoDB, buat objek`AWS.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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_query.js).
## Menghapus Item dari Tabel
Buat Node.js modul dengan nama file`ddbdoc_delete.js`. Pastikan untuk mengkonfigurasi SDK seperti yang ditunjukkan sebelumnya. Untuk mengakses DynamoDB, buat objek`AWS.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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_delete.js).