DynamoDB 速查表 - Amazon DynamoDB
初始設定SDK 或 CLI基本動作命名規則服務配額基本概念其他資訊

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

DynamoDB 速查表

此備忘單提供使用 Amazon DynamoDB 及其各種 AWS SDKs快速參考。

初始設定

  1. 註冊 AWS。

  2. 取得 AWS 存取金鑰，以程式設計方式存取 DynamoDB。

  3. 設定您 DynamoDB 憑證。

另請參閱:

SDK 或 CLI

選擇您偏好的 SDK，或設定 AWS CLI。

注意

當您 AWS CLI 在 Windows 上使用 時，不在引號內的反斜線 (\) 會視為歸位字元。此外，您必須逸出其他引號內的任何引號和大括號。如需範例，請參閱下一章節「建立資料表」的 Windows 標籤。

另請參閱:

基本動作

本節提供基本 DynamoDB 任務的程式碼。如需這些任務的詳細資訊，請參閱 DynamoDB 和 AWS SDKs入門。

建立資料表

Default
aws dynamodb create-table \
    --table-name Music \
    --attribute-definitions \
        AttributeName=Artist,AttributeType=S \
        AttributeName=SongTitle,AttributeType=S \
    --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \
    --billing-mode PAY_PER_REQUEST \
    --table-class STANDARD
Windows
aws dynamodb create-table ^
    --table-name Music ^
    --attribute-definitions ^
        AttributeName=Artist,AttributeType=S ^
        AttributeName=SongTitle,AttributeType=S ^
    --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE ^
    --billing-mode PAY_PER_REQUEST ^
    --table-class STANDARD

將項目寫入資料表

aws dynamodb put-item \ --table-name Music \ --item file://item.json

從資料表讀取項目

aws dynamodb get-item \ --table-name Music \ --item file://item.json

從資料表刪除項目

aws dynamodb delete-item --table-name Music --key file://key.json

查詢資料表

aws dynamodb query --table-name Music 
--key-condition-expression "ArtistName=:Artist and SongName=:Songtitle"

刪除資料表

aws dynamodb delete-table --table-name Music

列出資料表名稱

aws dynamodb list-tables

命名規則

  • 所有名稱都必須使用 UTF-8 編碼並區分大小寫。

  • 資料表名稱與索引名稱長度必須介於 3 到 255 個字元之間，而且只能包含下列字元：

    • a-z

    • A-Z

    • 0-9

    • _ (底線)

    • - (破折號)

    • . (點號)

  • 屬性名稱至少必須為一個字元長，而且大小不能超過 64KB。

如需詳細資訊，請參閱命名規則。

服務配額基本概念

讀取和寫入單位

  • 讀取容量單位 (RCU) – 每秒一個高度一致性讀取，或每秒兩個最終一致讀取，適用於大小上限為 4 KB 的項目。

  • 寫入容量單位 (WCU) – 每秒一個寫入，適用於大小上限為 1 KB 的項目。

資料表限制

  • 資料表大小 – 資料表大小沒有任何實際限制。就項目數或位元組數而言，資料表是沒有限制的。

  • 資料表數量 – 對於任何 AWS 帳戶，每個 AWS 區域的初始配額為 2，500 個資料表。

  • 查詢和掃描的頁面大小限制 — 每個查詢或掃描的每頁限制為 1 MB。若您在資料表上的查詢參數或掃描操作產生超過 1 MB 的資料，DynamoDB 會傳回初始相符項目。同時也會傳回一個 LastEvaluatedKey 屬性，您可以在新的請求中使用該屬性來讀取下一頁。

索引

  • 本機次要索引 (LSI) — 您可以定義最多五個本機次要索引。當索引必須與基礎資料表保持高度一致時，LSI 就特別有用。

  • 全域次要索引 (GSIs) – 每個資料表有 20 個全域次要索引的預設配額。

  • 每份資料表投影次要索引屬性 – 您最多可以投影 100 個屬性到資料表所有的區域和全域次要索引。這只適用於使用者指定的投影屬性。

分割區索引鍵

  • 分割區索引鍵值的長度下限為 1 個位元組。長度上限為 2048 個位元組。

  • 資料表或次要索引中，不同的分割區索引鍵值數目沒有實際限制。

  • 排序索引鍵值的長度下限為 1 個位元組。長度上限為 1024 個位元組。

  • 一般而言，每個分割區索引鍵值的相異排序索引鍵值數目沒有實際限制。例外狀況是有次要索引的資料表。

如需次要索引、分割區索引鍵設計和排序索引鍵設計的詳細資訊，請參閱最佳實務。

常用資料類型限制

  • String (字串) – 字串長度受到項目大小上限 400 KB 的限制。字串是 UTF-8 二進位編碼的 Unicode。

  • 數字 – 數字的精準度最多可達 38 位數，可為正數、負數或零。

  • 二進位 – 二進位長度受到項目大小上限 400 KB 的限制。使用二進位屬性的應用程式必須先以 base64 編碼資料，再傳送到 DynamoDB。

如需支援的完整資料類型清單，請參閱資料類型。如需詳細資訊，請參閱服務配額。

項目、屬性和表達式參數

DynamoDB 的項目大小上限是 400 KB，包括屬性名稱二進位長度 (UTF-8 長度) 和屬性值二進位長度 (UTF-8 長度)。屬性名稱算作大小限制的一部分。

清單、映射或集合中值數目不限，只要含有值的項目符合 400 KB 項目大小限制。

針對表達式參數，任何表達式字串的長度上限為 4 KB。

如需項目大小、屬性和表達式參數的詳細資訊，請參閱服務配額。

其他資訊