Ermitteln der globalen Tabellenversion Versionsunterschiede Aktualisieren globaler Tabellen

Versionen von DynamoDB Global Tables

Es sind zwei Versionen von DynamoDB-Tabellen verfügbar: Global Tables Version 2019.11.21 (aktuell) und Global Tables Version 2017.11.29 (Legacy). Wir empfehlen die Verwendung von Global Tables Version 2019.11.21 (aktuell), da sie einfacher zu verwenden ist, in mehr Regionen unterstützt wird und für die meisten Workloads kostengünstiger ist als Version 2017.11.29 (Legacy).

Ermitteln der Version einer globalen Tabelle

Ermitteln der Version mit dem AWS CLI

Identifizieren eines globalen Tabellenreplikats der Version 2019.11.21 (aktuell)

Rufen Sie den Befehl für die Tabelle auf, um festzustellen, ob es sich bei einer Tabelle um ein Replikat der Version 2019.11.21 (aktuell) handelt. describe-table Wenn die Ausgabe das GlobalTableVersion Attribut mit dem Wert „2019.11.21“ enthält, handelt es sich bei der Tabelle um ein globales Tabellenreplikat der Version 2019.11.21 (Aktuell).

Ein Beispiel für einen CLI-Befehl fürdescribe-table:


aws dynamodb describe-table \
--table-name users \
--region us-east-2

Die (gekürzte) Ausgabe enthält das GlobalTableVersion Attribut mit dem Wert „2019.11.21", sodass es sich bei dieser Tabelle um ein globales Tabellenreplikat der Version 2019.11.21 (aktuell) handelt.


{
    "Table": {
        "AttributeDefinitions": [
            {
                "AttributeName": "id",
                "AttributeType": "S"
            },
            {
                "AttributeName": "name",
                "AttributeType": "S"
            }
        ],
        "TableName": "users",
        ...
        "GlobalTableVersion": "2019.11.21",
        "Replicas": [
            {
                "RegionName": "us-west-2",
                "ReplicaStatus": "ACTIVE",
            }
        ],
        ...
    }
}

Identifizieren eines globalen Tabellenreplikats der Version 2017.11.29 (Legacy)

Version 2017.11.29 für globale Tabellen (Legacy) verwendet einen speziellen Befehlssatz für die globale Tabellenverwaltung. Um festzustellen, ob es sich bei einer Tabelle um ein Replikat der globalen Tabellenversion 2017.11.29 (Legacy) handelt, rufen Sie den Befehl für die Tabelle auf. describe-global-table Wenn Sie eine erfolgreiche Antwort erhalten, handelt es sich bei der Tabelle um ein globales Tabellenreplikat der Version 2017.11.29 (Legacy). Wenn der describe-global-table Befehl einen GlobalTableNotFoundException Fehler zurückgibt, handelt es sich bei der Tabelle nicht um ein Replikat der Version 2017.11.29 (Legacy).

Ein Beispiel für einen CLI-Befehl fürdescribe-global-table:


aws dynamodb describe-global-table \
--table-name users \
--region us-east-2

Der Befehl gibt eine erfolgreiche Antwort zurück, sodass es sich bei dieser Tabelle um ein globales Tabellenreplikat der Version 2017.11.29 (Legacy) handelt.


{
    "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"
    }
}

Ermitteln der Version mithilfe der DynamoDB-Konsole

Gehen Sie wie folgt vor, um die Version eines globalen Tabellenreplikats zu identifizieren:

Öffnen Sie die DynamoDB-Konsole zu Hausehttps://console.aws.amazon.com/dynamodb/.
Klicken Sie im Navigationsbereich auf der linken Seite der Konsole auf Tables (Tabellen).
Wählen Sie die Tabelle aus, für die Sie die Version der globalen Tabellen identifizieren möchten.
Wählen Sie die Registerkarte Global Tables (Globale Tabellen) aus.

Im Abschnitt Zusammenfassung wird die Version der verwendeten globalen Tabellen angezeigt.

Unterschiede im Verhalten zwischen älteren und aktuellen Versionen

In der folgenden Liste werden die Verhaltensunterschiede zwischen der Legacy-Version und der aktuellen Version globaler Tabellen beschrieben.

Version 2019.11.21 (Aktuell) verbraucht im Vergleich zu Version 2017.11.29 (Legacy) weniger Schreibkapazität für mehrere DynamoDB-Operationen und ist daher für die meisten Kunden kostengünstiger. Die Unterschiede für diese DynamoDB-Operationen sind wie folgt:

Das Aufrufen PutItemeines 1-KB-Elements in einer Region und das Replizieren in andere Regionen erfordert 2 r WRUs pro Region für 2017.11.29 (Legacy), aber nur 1 RWRU für 2019.11.21 (Aktuell).
UpdateItemZum Aufrufen eines 1-KB-Elements sind 2 r WRUs in der Quellregion und 1 RWRU pro Zielregion für 2017.11.29 (Legacy) erforderlich, aber nur 1 RWRU für Quell- und Zielregion für 2019.11.21 (Aktuell).
Der Aufruf DeleteItemfür ein 1-KB-Element erfordert 1 RWRU in der Quellregion und 2 r WRUs pro Zielregion für 2017.11.29 (Legacy), aber nur 1 RWRU sowohl für die Quell- als auch für die Zielregion für 2019.11.21 (Aktuell).

Die folgende Tabelle zeigt den RWRU-Verbrauch der Tabellen 29.11.2017 (Legacy) und 21.11.2019 (aktuell) für ein 1-KB-Element in zwei Regionen.

Operation	2017.11.29 (Legacy)	2019.11.21 (Aktuell)	Einsparungen
PutItem	4 oder WRUs	2 oder WRUs	50 %
UpdateItem	3 oder WRUs	2 oder WRUs	33%
DeleteItem	3 oder WRUs	2 oder WRUs	33%

Version 2017.11.29 (Legacy) ist nur in Version 11 verfügbar. AWS-Regionen Version 2019.11.21 (Aktuell) ist jedoch in allen Versionen verfügbar. AWS-Regionen
Sie erstellen globale Tabellen der Version 2017.11.29 (Legacy), indem Sie zuerst einen Satz leerer Regionaltabellen erstellen und dann die API aufrufen, um die CreateGlobalTableglobale Tabelle zu bilden. Sie erstellen globale Tabellen der Version 2019.11.21 (aktuell), indem Sie die UpdateTableAPI aufrufen, um einer vorhandenen Regionaltabelle ein Replikat hinzuzufügen.
Version 2017.11.29 (Legacy) erfordert, dass Sie alle Replikate in der Tabelle leeren, bevor Sie ein Replikat in einer neuen Region hinzufügen (auch während der Erstellung). Version 2019.11.21 (Aktuell) unterstützt Sie beim Hinzufügen und Entfernen von Replikaten zu Regionen in einer Tabelle, die bereits Daten enthält.
Version 2017.11.29 (Legacy) verwendet die folgenden speziellen Steuerungsebenen für die Verwaltung von Replikaten: APIs
Version 2019.11.21 (Aktuell) verwendet das und zur Verwaltung von Replikaten. DescribeTable UpdateTable APIs
Version 2017.11.29 (Legacy) veröffentlicht zwei DynamoDB Streams Streams-Datensätze für jeden Schreibvorgang. Version 2019.11.21 (Aktuell) veröffentlicht nur einen DynamoDB Streams Streams-Datensatz für jeden Schreibvorgang.
Version 2017.11.29 (Legacy) füllt und aktualisiert die Attribute, und. Version 2019.11.21 (Aktuell) füllt und aktualisiert aws:rep:deleting diese aws:rep:updateregion Attribute nicht. aws:rep:updatetime
Version 2017.11.29 (Legacy) synchronisiert keine Einstellungen zwischen Replikaten. Version 2019.11.21 (Aktuell) synchronisiert die Time to Live (TTL) in DynamoDB verwenden TTL-Einstellungen zwischen Replikaten.
Version 2017.11.29 (Legacy) repliziert TTL-Löschungen nicht auf andere Replikate. Version 2019.11.21 (Aktuell) repliziert TTL-Löschungen auf alle Replikate.
Version 2017.11.29 (Legacy) synchronisiert Auto Scaling-Einstellungen nicht replikatenübergreifend. Version 2019.11.21 (Aktuell) synchronisiert Auto Scaling-Einstellungen replikatsübergreifend.
Version 2017.11.29 (Legacy) synchronisiert keine Einstellungen für den globalen sekundären Index (GSI) zwischen Replikaten. Version 2019.11.21 (Aktuell) synchronisiert GSI-Einstellungen replikatsübergreifend.
Version 2017.11.29 (Legacy) synchronisiert die Einstellungen für die Verschlüsselung im Ruhezustand nicht zwischen Replikaten. Version 2019.11.21 (Aktuell) synchronisiert die Einstellungen für die Verschlüsselung im Ruhezustand zwischen Replikaten.
Version 2017.11.29 (Legacy) veröffentlicht die Metrik. Version 2019.11.21 (Aktuell) veröffentlicht diese Metrik nicht. PendingReplicationCount

Aktualisierung auf die aktuelle Version

Erforderliche Berechtigungen für das Upgrade globaler Tabellen

Für ein Upgrade auf Version 2019.11.21 (aktuell) benötigen Sie dynamodb:UpdateGlobalTableversion Berechtigungen in allen Regionen mit Replikaten. Diese Berechtigungen sind zusätzlich zu den Berechtigungen erforderlich, die für den Zugriff auf die DynamoDB-Konsole und das Anzeigen von Tabellen erforderlich sind.

Die folgende IAM-Richtlinie gewährt Berechtigungen zum Upgrade jeder globalen Tabelle auf Version 2019.11.21 (aktuell).


{
    "version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "dynamodb:UpdateGlobalTableversion",
            "Resource": "*"
        }
    ]
}

Die folgende IAM-Richtlinie gewährt Berechtigungen, nur die Music globale Tabelle mit Replikaten in zwei Regionen auf Version 2019.11.21 (aktuell) zu aktualisieren.


{
    "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"
            ]
        }
    ]
}

Was ist während des Upgrades zu erwarten

Alle globalen Tabellenreplikate verarbeiten während des Upgrades weiterhin Lese- und Schreibverkehr.
Der Upgrade-Vorgang dauert je nach Tabellengröße und Anzahl der Replikate zwischen einigen Minuten und mehreren Stunden.
Während des Upgrade-Vorgangs TableStatusändert sich der Wert von von ACTIVE aufUPDATING. Sie können den Status der Tabelle anzeigen, indem Sie die DescribeTableAPI aufrufen oder die Tabellenansicht in der.
Auto Scaling passt die bereitgestellten Kapazitätseinstellungen für eine globale Tabelle nicht an, während die Tabelle aktualisiert wird. Es wird dringend empfohlen, die Tabelle während des Upgrades auf den On-Demand-Kapazitätsmodus einzustellen.
Wenn Sie während des Upgrades den Modus für bereitgestellte Kapazität mit Auto Scaling verwenden möchten, müssen Sie den Mindestdurchsatz für Lese- und Schreibvorgänge in Ihren Richtlinien erhöhen, um den erwarteten Anstieg des Datenverkehrs zu berücksichtigen und eine Drosselung während des Upgrades zu vermeiden.
Die ReplicationLatency Metrik kann vorübergehend Latenzspitzen melden oder während des Upgrade-Vorgangs keine Metrikdaten mehr melden. Weitere Informationen finden Sie unterReplicationLatency,.
Wenn der Upgrade-Vorgang abgeschlossen ist, ändert sich Ihr Tabellenstatus aufACTIVE.

Verhalten von DynamoDB Streams vor, während und nach dem Upgrade

Aktualisierung auf Version 2019.11.21 (Aktuell)

Führen Sie die folgenden Schritte aus, um Ihre Version der globalen DynamoDB-Tabellen mithilfe von zu aktualisieren. AWS Management Console

Um globale Tabellen auf Version 2019.11.21 (Aktuell) zu aktualisieren

Öffnen Sie die DynamoDB-Konsole zu Hausehttps://console.aws.amazon.com/dynamodb/.
Wählen Sie im Navigationsbereich auf der linken Seite der Konsole Tabellen und dann die globale Tabelle aus, für die Sie ein Upgrade auf Version 2019.11.21 (Aktuell) durchführen möchten.
Wählen Sie die Registerkarte Global Tables (Globale Tabellen) aus.
Wählen Sie Update version (Version aktualisieren) aus.
Lesen Sie sich die neuen Anforderungen durch und stimmen Sie ihnen zu, wählen Sie dann Update version Version aktualisieren.
Nach Abschluss des Upgrade-Vorgangs wird die Version der globalen Tabellen, die auf der Konsole angezeigt wird, auf 2019.11.21 geändert.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Abrechnung globaler Tabellen

Bewährte Methoden für globale Tabellen

Operation	Region replizieren	Verhalten vor dem Upgrade	Verhalten während des Upgrades	Verhalten nach dem Upgrade
Platzieren oder aktualisieren	Quelle	Die Population mit Zeitstempeln erfolgt unter Verwendung von UpdateItem.	Die Population mit Zeitstempeln erfolgt unter Verwendung von. PutItem	Es wird kein sichtbarer Zeitstempel für den Kunden generiert.
		Zwei Streams-Datensätze werden generiert. Der erste Datensatz enthält die vom Kunden geschriebenen Attribute. Der zweite Datensatz enthält die `aws:rep:*` Attribute.	Zwei Streams-Datensätze werden generiert. Der erste Datensatz enthält die vom Kunden geschriebenen Attribute. Der zweite Datensatz enthält die `aws:rep:*` Attribute.	Es wird ein einziger Streams-Datensatz generiert, der die vom Kunden geschriebenen Attribute enthält.
		Für jeden Schreibvorgang durch den Kunden WCUs werden zwei R verbraucht.	Für jeden Schreibvorgang durch den Kunden WCUs werden zwei R verbraucht.	Für jeden Schreibvorgang durch den Kunden wird eine RWCu verbraucht.
		`ReplicationLatency`und `PendingReplicationCount` Metriken werden in CloudWatch veröffentlicht.	`ReplicationLatency`und `PendingReplicationCount` Metriken werden in veröffentlicht CloudWatch.	`ReplicationLatency`Die Metrik ist veröffentlicht in CloudWatch.
	Zieladresse	Die Replikation erfolgt mit PutItem.	Die Replikation erfolgt unter Verwendung von PutItem.	Die Replikation erfolgt unter Verwendung von PutItem.
		Es wird ein einziger Streams-Datensatz generiert, der sowohl die vom Kunden geschriebenen Attribute als auch die `aws:rep:*` Attribute enthält.	Es wird ein einziger Streams-Datensatz generiert, der sowohl die vom Kunden geschriebenen Attribute als auch die `aws:rep:*` Attribute enthält.	Es wird ein einziger Streams-Datensatz generiert, der nur die vom Kunden geschriebenen Attribute und keine Replikationsattribute enthält.
		Ein RWCu wird verbraucht, wenn das Element in der Zielregion vorhanden ist. Zwei R WCUs werden verbraucht, wenn der Artikel in der Zielregion nicht existiert.	Ein RWCu wird verbraucht, wenn der Artikel in der Zielregion vorhanden ist. Zwei R WCUs werden verbraucht, wenn der Artikel in der Zielregion nicht existiert.	Für jeden Schreibvorgang durch den Kunden wird eine RWCu verbraucht.
		`ReplicationLatency`und `PendingReplicationCount` Metriken werden in CloudWatch veröffentlicht.	`ReplicationLatency`und `PendingReplicationCount` Metriken werden in veröffentlicht CloudWatch.	`ReplicationLatency`Die Metrik ist veröffentlicht in CloudWatch.
Löschen	Quelle	Löschen Sie alle Elemente mit kleinerem Zeitstempel mithilfe von DeleteItem.	Löschen Sie alle Elemente mit kleinerem Zeitstempel mithilfe von. DeleteItem	Löschen Sie alle Elemente mit kleinerem Zeitstempel mithilfe von. DeleteItem
		Es wird ein einziger Streams-Datensatz generiert, der sowohl die vom Kunden geschriebenen Attribute als auch die `aws:rep:*` Attribute enthält.	Es wird ein einziger Streams-Datensatz generiert, der sowohl die vom Kunden geschriebenen Attribute als auch die `aws:rep:*` Attribute enthält.	Es wird ein einziger Streams-Datensatz generiert, der die vom Kunden geschriebenen Attribute enthält.
		Für jeden vom Kunden gelöschten Vorgang wird ein RWCu verbraucht.	Für jeden gelöschten Kunden wird eine RWCu verbraucht.	Für jeden gelöschten Kunden wird eine RWCu verbraucht.
		`ReplicationLatency`und `PendingReplicationCount` Metriken werden in CloudWatch veröffentlicht.	`ReplicationLatency`und `PendingReplicationCount` Metriken werden in veröffentlicht CloudWatch.	`ReplicationLatency`Die Metrik ist veröffentlicht in CloudWatch.
	Zieladresse	Löschungen finden in zwei Phasen statt: In Phase 1 wird das UpdateItem Löschkennzeichen gesetzt. DeleteItem Löscht in Phase 2 das Element.	Löscht das Element mit. DeleteItem	Löscht das Element mit. DeleteItem
		Zwei Streams-Datensätze werden generiert. Der erste Datensatz enthält die Änderung des `aws:rep:deleting` Felds. Der zweite Datensatz enthält die vom Kunden geschriebenen Attribute und die `aws:rep:*` Attribute.	Es wird ein einziger Stream-Datensatz generiert, der die vom Kunden geschriebenen Attribute enthält.	Es wird ein einziger Stream-Datensatz generiert, der die vom Kunden geschriebenen Attribute enthält.
		Für jeden gelöschten Kunden WCUs werden zwei R verbraucht.	Für jeden gelöschten Kunden wird eine RWCu verbraucht.	Für jeden gelöschten Kunden wird eine RWCu verbraucht.
		`ReplicationLatency`und `PendingReplicationCount` Metriken werden in CloudWatch veröffentlicht.	`ReplicationLatency`Die Metrik ist veröffentlicht in CloudWatch.	`ReplicationLatency`Die Metrik ist veröffentlicht in CloudWatch.