本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
DynamoDB 全域資料表版本
有兩種版本的 DynamoDB 全域資料表可供使用:全域資料表版本 2019.11.21 (目前) 和全域資料表版本 2017.11.29 (舊版)。我們建議您使用 Global Tables 2019.11.21 版 (目前),因為與 2017.11.29 版 (舊版) 相比,更易於使用、支援更多區域,以及大多數工作負載的成本更低。
判斷全域資料表的版本
使用 判斷版本 AWS CLI
識別 2019.11.21 版 (目前) 全域資料表複本
若要判斷資料表是否為全域資料表版本 2019.11.21 (目前) 複本,請叫用資料表的 describe-table
命令。如果輸出包含值為 "2019.11.21" 的GlobalTableVersion
屬性,則資料表為 2019.11.21 版 (目前) 全域資料表複本。
的 CLI 命令範例describe-table
:
aws dynamodb describe-table \ --table-name users \ --region us-east-2
(橋接) 輸出包含值為 "2019.11.21" 的 GlobalTableVersion
屬性,因此此資料表是 2019.11.21 版 (目前) 全域資料表複本。
{ "Table": { "AttributeDefinitions": [ { "AttributeName": "id", "AttributeType": "S" }, { "AttributeName": "name", "AttributeType": "S" } ], "TableName": "users", ... "GlobalTableVersion": "2019.11.21", "Replicas": [ { "RegionName": "us-west-2", "ReplicaStatus": "ACTIVE", } ], ... } }
識別 2017.11.29 版 (舊版) 全域資料表複本
全域資料表 2017.11.29 版 (舊版) 使用一組專用命令進行全域資料表管理。若要判斷資料表是否為全域資料表版本 2017.11.29 (舊版) 複本,請叫用資料表的 describe-global-table
命令。如果您收到成功的回應,則資料表是 2017.11.29 版 (舊版) 全域資料表複本。如果describe-global-table
命令傳回GlobalTableNotFoundException
錯誤,則資料表不是 2017.11.29 版 (舊版) 複本。
的 CLI 命令範例describe-global-table
:
aws dynamodb describe-global-table \ --table-name users \ --region us-east-2
命令會傳回成功的回應,因此此資料表是 2017.11.29 版 (舊版) 全域資料表複本。
{ "GlobalTableDescription": { "ReplicationGroup": [ { "RegionName": "us-west-2" }, { "RegionName": "us-east-2" } ], "GlobalTableArn": "arn:aws:dynamodb::123456789012:global-table/users", "CreationDateTime": "2025-06-10T13:55:53.630000-04:00", "GlobalTableStatus": "ACTIVE", "GlobalTableName": "users" } }
使用 DynamoDB 主控台判斷版本
若要識別全域資料表複本的版本,請執行下列動作:
-
在 https://console.aws.amazon.com/dynamodb/home
開啟 DynamoDB 主控台。 -
在主控台左側的導覽窗格中,選擇 Tables (資料表)。
-
選擇您要識別全域資料表版本的資料表。
-
選擇 Global Tables (全域資料表) 標籤。
摘要區段會顯示正在使用的全域資料表版本。
舊版和目前版本之間行為的差異
下列清單說明全域資料表舊版和目前版本之間行為的差異。
-
與 2019.11.21 版 (舊版) 相比, 版 2017.11.29(目前) 對數個 DynamoDB 操作使用較少的寫入容量,因此,對大多數客戶來說更具成本效益。這些 DynamoDB 操作的差異如下:
-
為區域中的 1KB 項目叫用 PutItem 並複寫到其他區域需要 2017.11.29 每個區域 2 rWRUs (舊版),但 2019.11.21 (目前) 只需要 1 個 rWRU。
-
呼叫 1KB 項目的 UpdateItem 在來源區域中需要 2 個 rWRUs在 2017.11.29 (舊版) 的每個目的地區域需要 1 個 rWRU,但 2019.11.21 (目前) 的來源和目的地區域只需要 1 個 rWRU。
-
呼叫 1KB 項目的 DeleteItem 在來源區域中需要 1 個 rWRU,在 2017.11.29 (舊版) 的每個目的地區域需要 2 rWRUs,但在 2019.11.21 (目前) 的來源或目的地區域只需要 1 個 rWRU。
下表顯示兩個區域中 1KB 項目的 2017.11.29 (舊版) 和 2019.11.21 (目前) 資料表的 rWRU 耗用。
作業 2017.11.29 (舊版) 2019.11.21 (目前) 節省 PutItem 4 rWRUs 2 rWRUs 50% UpdateItem 3 rWRUs 2 rWRUs 33% DeleteItem 3 rWRUs 2 rWRUs 33% -
-
2017.11.29 版 (舊版) 僅適用於 11 AWS 區域。不過,2019.11.21 版 (目前) 可在所有 中使用 AWS 區域。
-
您可以先建立一組空白區域資料表,然後叫用 CreateGlobalTable API 來形成全域資料表,以建立 2017.11.29 版 (舊版) 全域資料表。您可以透過叫用 UpdateTable API 將複本新增至現有的區域資料表來建立 2019.11.21 版 (目前) 全域資料表。
-
2017.11.29 版 (舊版) 會要求您先清空資料表中的所有複本,才能在新區域中新增複本 (包括建立期間)。2019.11.21 版 (目前) 支援您在已包含資料的資料表上新增和移除複本至區域。
-
2017.11.29 版 (舊版) 使用下列專用控制平面 APIs 來管理複本:
2019.11.21 版 (目前) 使用 DescribeTable 和 UpdateTable APIs 來管理複本。
-
2017.11.29 版 (舊版) 會針對每個寫入發佈兩個 DynamoDB Streams 記錄。2019.11.21 版 (目前) 只會針對每個寫入發佈一個 DynamoDB Streams 記錄。
-
2017.11.29 版 (舊版) 會填入和更新
aws:rep:deleting
、aws:rep:updateregion
和aws:rep:updatetime
屬性。2019.11.21 版 (目前) 不會填入或更新這些屬性。 -
2017.11.29 版 (舊版) 不會同步跨複本在 DynamoDB 中使用存留時間 (TTL)的設定。2019.11.21 版 (目前) 會同步跨複本的 TTL 設定。
-
2017.11.29 版 (舊版) 不會將 TTL 刪除複寫至其他複本。2019.11.21 版 (目前) 會將 TTL 刪除複寫至所有複本。
-
2017.11.29 版 (舊版) 不會同步跨複本的自動擴展設定。2019.11.21 版 (目前) 會同步跨複本的自動擴展設定。
-
2017.11.29 版 (舊版) 不會同步跨複本的全域次要索引 (GSI) 設定。2019.11.21 版 (目前) 會同步跨複本的 GSI 設定。
-
2017.11.29 版 (舊版) 不會同步跨複本的靜態加密設定。2019.11.21 版 (目前) 會同步跨複本的靜態加密設定。
-
2017.11.29 版 (舊版) 發佈
PendingReplicationCount
指標。2019.11.21 版 (目前) 不會發佈此指標。
升級到目前版本
全域資料表升級所需的許可
若要升級至 2019.11.21 版 (目前),您必須在具有複本的所有區域中擁有dynamodb:UpdateGlobalTableversion
許可。除了存取 DynamoDB 主控台和檢視資料表所需的許可之外,還需要這些許可。
下列 IAM 政策授予將任何全域資料表升級至 2019.11.21 版 (目前) 的許可。
{ "version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "dynamodb:UpdateGlobalTableversion", "Resource": "*" } ] }
下列 IAM 政策僅授予許可,將兩個區域中具有複本的Music
全域資料表升級至 2019.11.21 版 (目前)。
{ "version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "dynamodb:UpdateGlobalTableversion", "Resource": [ "arn:aws:dynamodb::123456789012:global-table/Music", "arn:aws:dynamodb:ap-southeast-1:123456789012:table/Music", "arn:aws:dynamodb:us-east-2:123456789012:table/Music" ] } ] }
升級期間預期會發生的情況
-
升級時,所有全域資料表複本將繼續處理讀取和寫入流量。
-
升級程序需要幾分鐘到幾個小時,取決於資料表大小和複本數量。
-
在升級過程中,TableStatus 的值會從 變更為
ACTIVE
UPDATING
。您可以透過叫用 DescribeTable API 或使用 中的資料表檢視來檢視資料表的狀態。 -
升級資料表時,自動擴展不會調整全域資料表的佈建容量設定。強烈建議您在升級期間將資料表設定為隨需容量模式。
-
如果您選擇在升級期間使用佈建容量模式搭配自動擴展,則必須增加政策的最低讀取和寫入輸送量,以適應任何預期的流量增加,以避免在升級期間限流。
-
ReplicationLatency
指標可以暫時報告延遲峰值,或在升級過程中停止報告指標資料。如需詳細資訊,請參閱 ReplicationLatency。 -
升級程序完成時,您的資料表狀態會變更為
ACTIVE
。
升級之前、期間和之後的 DynamoDB Streams 行為
作業 | 複本區域 | 升級前的行為 | 升級期間的行為 | 升級後的行為 |
---|---|---|---|---|
放置或更新 |
來源 |
時間戳記人口使用 UpdateItem 發生。 | 時間戳記人口使用 PutItem 發生。 | 不會產生客戶可見的時間戳記。 |
會產生兩個串流記錄。第一個記錄包含客戶寫入的屬性。第二個記錄包含aws:rep:* 屬性。 |
會產生兩個串流記錄。第一個記錄包含客戶寫入的屬性。第二個記錄包含aws:rep:* 屬性。 |
會產生包含客戶撰寫屬性的單一串流記錄。 | ||
每個客戶寫入會耗用兩個 rWCUs。 | 每個客戶寫入會耗用兩個 rWCUs。 | 每次客戶寫入都會使用一個 rWCU。 | ||
ReplicationLatency 和 PendingReplicationCount 指標會在 CloudWatch 中發佈。 |
ReplicationLatency 和 PendingReplicationCount 指標會在 CloudWatch 中發佈。 |
ReplicationLatency 指標會在 CloudWatch 中發佈。 |
||
目的地 |
複寫會使用 PutItem 進行。 | 複寫會使用 PutItem 進行。 | 複寫會使用 PutItem 進行。 | |
會產生單一串流記錄,其中包含客戶撰寫的屬性和aws:rep:* 屬性。 |
會產生單一串流記錄,其中包含客戶撰寫的屬性和aws:rep:* 屬性。 |
會產生單一 Streams 記錄,其中僅包含客戶撰寫的屬性,沒有複寫屬性。 | ||
如果項目存在於目的地區域中,則會使用一個 rWCU。如果項目不存在於目的地區域中,則會使用兩個 rWCUs。 | 如果項目存在於目的地區域中,則會使用一個 rWCU。如果項目不存在於目的地區域中,則會使用兩個 rWCUs。 | 每次客戶寫入都會使用一個 rWCU。 | ||
ReplicationLatency 和 PendingReplicationCount 指標會在 CloudWatch 中發佈。 |
ReplicationLatency 和 PendingReplicationCount 指標會在 CloudWatch 中發佈。 |
ReplicationLatency 指標會在 CloudWatch 中發佈。 |
||
刪除 |
來源 |
使用 DeleteItem 刪除時間戳記較小的任何項目。 | 使用 DeleteItem 刪除時間戳記較小的任何項目。 | 使用 DeleteItem 刪除時間戳記較小的任何項目。 |
會產生單一串流記錄,其中包含客戶撰寫的屬性和aws:rep:* 屬性。 |
會產生單一串流記錄,其中包含客戶撰寫的屬性和aws:rep:* 屬性。 |
會產生單一串流記錄,其中包含客戶撰寫的屬性。 | ||
每個客戶刪除都會使用一個 rWCU。 | 每個客戶刪除都會使用一個 rWCU。 | 每個客戶刪除都會使用一個 rWCU。 | ||
ReplicationLatency 和 PendingReplicationCount 指標會在 CloudWatch 中發佈。 |
ReplicationLatency 和 PendingReplicationCount 指標會在 CloudWatch 中發佈。 |
ReplicationLatency 指標會在 CloudWatch 中發佈。 |
||
目的地 |
進行兩階段刪除:
|
使用 DeleteItem 刪除項目。 | 使用 DeleteItem 刪除項目。 | |
會產生兩個串流記錄。第一個記錄包含 aws:rep:deleting 欄位的變更。第二個記錄包含客戶撰寫的屬性和aws:rep:* 屬性。 |
會產生單一串流記錄,其中包含客戶撰寫的屬性。 | 會產生單一串流記錄,其中包含客戶撰寫的屬性。 | ||
每個客戶刪除會耗用兩個 rWCUs。 | 每個客戶刪除都會使用一個 rWCU。 | 每個客戶刪除都會使用一個 rWCU。 | ||
ReplicationLatency 和 PendingReplicationCount 指標會在 CloudWatch 中發佈。 |
ReplicationLatency 指標會在 CloudWatch 中發佈。 |
ReplicationLatency 指標會在 CloudWatch 中發佈。 |
升級到 2019.11.21 版 (目前)
執行下列步驟,使用 升級您的 DynamoDB 全域資料表版本 AWS Management Console。
將全域資料表升級至 2019.11.21 版 (目前)
-
在 https://console.aws.amazon.com/dynamodb/home
開啟 DynamoDB 主控台。 -
在主控台左側的導覽窗格中,選擇資料表,然後選取您要升級至 2019.11.21 版 (目前) 的全域資料表。
-
選擇 Global Tables (全域資料表) 標籤。
-
選擇 Update version (更新版本)。
-
閱讀並同意新的要求,然後選擇 Continue (繼續)。
-
升級程序完成後,主控台上出現的全域資料表版本會變更為 2019.11.21。