適用於 JavaScript 的 AWS SDK v2 已end-of-support。我們建議您遷移至 [適用於 JavaScript 的 AWS SDK v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/)。如需如何遷移的其他詳細資訊和資訊，請參閱此[公告](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/)。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用 DynamoDB 文件用戶端 ![JavaScript code example that applies to Node.js execution](http://docs.aws.amazon.com/zh_tw/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **這個 Node.js 程式碼範例會說明：** + 如何使用文件用戶端存取 DynamoDB 資料表。 ## 使用案例 DynamoDB 文件用戶端透過抽象化屬性值的概念，簡化了項目的使用。此摘錄會標註以輸入參數提供的原生 JavaScript 類型，並將標註的回應資料轉換為原生的 JavaScript 類型。 如需 DynamoDB 文件用戶端類別的詳細資訊，請參閱《 API 參考[https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html)》中的 。如需使用 Amazon DynamoDB 進行程式設計的詳細資訊，請參閱《Amazon [ DynamoDB 開發人員指南》中的使用 DynamoDB 進行程式設計](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.html)。 * DynamoDB * 在此範例中，您會使用一系列 Node.js 模組，使用 文件用戶端在 DynamoDB 資料表上執行基本操作。此程式碼使用適用於 JavaScript 的 SDK，以使用這些 DynamoDB 文件用戶端類別的方法查詢和掃描資料表： + [get](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#get-property) + [put](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#put-property) + [update](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) + [delete](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#delete-property) ## 先決條件任務 若要設定和執行此範例，請先完成這些任務： + 安裝 Node.js。如需詳細資訊，請參閱 [Node.js](https://nodejs.org) 網站。 + 透過使用者登入資料建立共用組態檔。如需提供共用登入資料檔案的詳細資訊，請參閱 [從共用登入資料檔案中在 Node.js 中載入登入資料](loading-node-credentials-shared.md)。 + 建立您可以存取其項目的 DynamoDB 資料表。如需使用適用於 JavaScript 的 SDK 建立 DynamoDB 資料表的詳細資訊，請參閱 [在 DynamoDB 中建立和使用資料表](dynamodb-examples-using-tables.md)。您也可以使用 [DynamoDB 主控台](https://console.aws.amazon.com/dynamodb/)來建立資料表。 ## 從資料表取得項目 以檔名 `ddbdoc_get.js` 建立一個 Node.js 模組。請務必依前述的內容來設定軟體開發套件。若要存取 DynamoDB，請建立 `AWS.DynamoDB.DocumentClient` 物件。建立 JSON 物件，其包含從資料表取得項目所需的參數，在此範例中包括資料表名稱、在該資料表中雜湊索引鍵的名稱，以及您要取得之項目的雜湊索引鍵值。呼叫 DynamoDB 文件用戶端的 `get`方法。 ``` // 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); } }); ``` 若要執行範例，請在命令列中輸入以下內容。 ``` node ddbdoc_get.js ``` 您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_get.js)找到這個範本程式碼。 ## 將項目放置在資料表中 以檔名 `ddbdoc_put.js` 建立一個 Node.js 模組。請務必依前述的內容來設定軟體開發套件。若要存取 DynamoDB，請建立 `AWS.DynamoDB.DocumentClient` 物件。建立 JSON 物件，其包含將項目寫入資料表所需的參數，在此範例中包括資料表名稱和要新增或更新，且內含雜湊索引鍵和值之項目的描述，以及要在項目上設定的屬性名稱和值。呼叫 DynamoDB 文件用戶端的 `put`方法。 ``` // 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); } }); ``` 若要執行範例，請在命令列中輸入以下內容。 ``` node ddbdoc_put.js ``` 您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_put.js)找到這個範本程式碼。 ## 在資料表中更新項目 以檔名 `ddbdoc_update.js` 建立一個 Node.js 模組。請務必依前述的內容來設定軟體開發套件。若要存取 DynamoDB，請建立 `AWS.DynamoDB.DocumentClient` 物件。建立 JSON 物件，其包含將項目寫入資料表所需的參數，在此範例中包括資料表名稱、要更新的項目索引鍵，以及一組 `UpdateExpressions`，其會定義要使用您在 `ExpressionAttributeValues` 參數中將值指派至其中的符記所更新的項目屬性。呼叫 DynamoDB 文件用戶端的 `update`方法。 ``` // 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); } }); ``` 若要執行範例，請在命令列中輸入以下內容。 ``` node ddbdoc_update.js ``` 您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_update.js)找到這個範本程式碼。 ## 查詢資料表 此範例會查詢內含影片系列之相關集資訊的表格，會為超過 9 集且子標題中含有指定片語的第二季集傳回集標題和子標題。 以檔名 `ddbdoc_query.js` 建立一個 Node.js 模組。請務必依前述的內容來設定軟體開發套件。若要存取 DynamoDB，請建立 `AWS.DynamoDB.DocumentClient` 物件。建立 JSON 物件，其包含查詢資料表所需的參數，在此範例中包括資料表名稱、查詢所需的 `ExpressionAttributeValues`，以及使用這些值來定義查詢要傳回之項目的 `KeyConditionExpression`。呼叫 DynamoDB 文件用戶端的 `query`方法。 ``` // 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); } }); ``` 若要執行範例，請在命令列中輸入以下內容。 ``` node ddbdoc_query.js ``` 您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_query.js)找到這個範本程式碼。 ## 從資料表中刪除項目 以檔名 `ddbdoc_delete.js` 建立一個 Node.js 模組。請務必依前述的內容來設定軟體開發套件。若要存取 DynamoDB，請建立 `AWS.DynamoDB.DocumentClient` 物件。建立 JSON 物件，其包含要在資料表中刪除項目所需的參數，在此範例中包括資料表名稱，以及您要刪除之項目的雜湊索引鍵名稱和值。呼叫 DynamoDB 文件用戶端的 `delete`方法。 ``` // 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); } }); ``` 若要執行範例，請在命令列中輸入以下內容。 ``` node ddbdoc_delete.js ``` 您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_delete.js)找到這個範本程式碼。