Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Aufheben der Zuordnung zu einem globalen Tabellenreplikat
Sie können die Zuordnung eines Replikats zu einer globalen Tabelle aufheben, um die Replikation zu und von diesem Replikat zu beenden, ohne die Tabelle oder Daten zu löschen. Das Replikat wird in derselben Datei zu einer Tabelle mit einer einzelnen Region AWS Konto und Region und behält den Tabellennamen und den Amazon-Ressourcennamen (ARN) bei. Sie können diesen Vorgang nach einer Regions- oder Kontomigration verwenden oder wenn Sie keine Tabelle mehr benötigen, um an der Replikation teilzunehmen.
Mithilfe der Version 2019.11.21 (Current) von globalen Tabellen mit gleichen und mehreren Konten, die für Multiregion Eventual Consistency (MREC) konfiguriert sind, können Sie Replikate von globalen Tabellen trennen, die Version 2019.11.21 (Aktuell) verwenden. Dieser Vorgang wird für Multiregion Strong Consistency (MRSC) oder Global Tables Version 2017.11.29 (Legacy) nicht unterstützt.
Das Ergebnis hängt von der Anzahl der Replikate in der globalen Tabelle ab:
-
Wenn die globale Tabelle drei oder mehr Replikate enthält, wird das Replikat, das Sie trennen, zu einer Tabelle mit einer einzelnen Region. Die verbleibenden Replikate bilden weiterhin eine globale Tabelle.
-
Wenn die globale Tabelle zwei Replikate enthält, werden beide Tabellen zu Tabellen mit einer einzigen Region. Weder die Tabelle noch ihre Daten werden gelöscht.
Die resultierende Tabelle behält ihre Tabelleneinstellungen bei, einschließlich Indizes, DynamoDB-Streams, Time to Live (TTL), Backups, Verschlüsselung, Abrechnungsmodus und Tabellenklasse. Replication-specific Einstellungen und Metriken gelten nicht mehr. Die Tabelle wird als Tabelle mit einer einzelnen Region abgerechnet.
Themen
Verhalten bei der Replikation
Wenn Sie die Trennung beantragen, legt DynamoDB eine Grenze für den Stopp der Replikation fest. Dabei handelt es sich um einen Zeitpunkt, den es nach Annahme der Anforderung festlegt, und wartet, bis jedes verbleibende Replikat alle Schreibvorgänge empfangen hat, die direkt an das ausgehende Replikat bis zu dieser Grenze vorgenommen wurden. Wenn DynamoDB diese Schreibvorgänge nicht an jedes verbleibende Replikat übertragen kann, wird die Trennung nicht abgeschlossen und alle ursprünglichen Replikate verbleiben in der globalen Tabelle.
Die Tabelle stellt während und nach der Trennung weiterhin Lese- und Schreibvorgänge bereit. Sie behält ihre Daten bei, aber da MREC Änderungen asynchron repliziert, enthält sie möglicherweise nicht die neuesten Schreibvorgänge aus anderen Regionen. Wenn die Trennung abgeschlossen ist, sendet oder empfängt die Tabelle keine replizierten Schreibvorgänge mehr.
Schutz und Anforderungen bei der Trennung
Der Trennungsschutz ist standardmäßig für jedes globale Tabellenreplikat aktiviert. Deaktivieren Sie den Trennungsschutz und warten Sie, bis das Update abgeschlossen ist, bevor Sie die Trennung anfordern. Durch die Deaktivierung des Schutzes wird die Replikation nicht gestoppt. Der Trennungsschutz ist unabhängig vom Löschschutz. Durch die Deaktivierung des Löschschutzes wird der Trennungsschutz nicht deaktiviert.
Stellen Sie beide Anfragen von der Region und dem Eigentümerkonto des Replikats aus. Das Replikat muss ACTIVE, alle Replikate müssen erreichbar sein und die für die Replikation erforderlichen Berechtigungen und der Verschlüsselungsschlüsselzugriff müssen weiterhin verfügbar sein. Für eine globale Tabelle kann jeweils nur ein Replikatlebenszyklusvorgang ausgeführt werden. Warten Sie daher, bis andere Vorgänge, einschließlich der Replikaterstellung und einer weiteren Trennung, abgeschlossen sind, bevor Sie die Anforderung absenden.
Die Trennung wird blockiert, wenn ein Replikat den Status von hat INACCESSIBLE_ENCRYPTION_CREDENTIALS, REPLICATION_NOT_AUTHORIZED, ARCHIVING, oder ARCHIVED. Stellen Sie den Zugriff wieder her und beheben Sie Replikationsprobleme, bevor Sie es erneut versuchen.
Bei einer globalen Tabelle mit mehreren Konten kann ein Konto nur die Zuordnung zu seinem eigenen Replikat aufheben. Sie können auch ein Replikat nicht trennen, das als Quelle für ein neues Replikat gedient hat, das in den letzten 24 Stunden hinzugefügt wurde. Warten Sie, bis 24 Stunden seit dem Hinzufügen des neuen Replikats vergangen sind.
Sie können die Trennung nicht rückgängig machen oder dieselbe Tabelle erneut an die globale Tabelle anhängen, die sie verlassen hat. Bevor Sie ein Ersatzreplikat in dieser Region erstellen, wenden Sie alle Änderungen, die Sie an der Standalone-Tabelle beibehalten müssen, auf die verbleibende globale Tabelle an und beheben Sie die Unterschiede mithilfe der Regeln Ihrer Anwendung. Löschen Sie dann die Standalone-Tabelle und fügen Sie ein neues Replikat hinzu. Das neue Replikat kopiert Daten aus der verbleibenden globalen Tabelle.
Erforderliche Berechtigungen
Bei der Trennung wird der verwendet Disassociate Aktion in der ReplicaUpdates Reihe von UpdateTable. Du brauchst beides dynamodb:UpdateTable und dynamodb:DisassociateTableReplica auf dem Tabellen-ARN des lokalen Replikats. dynamodb:DisassociateTableReplica ist eine IAM-Berechtigung, kein separater API-Vorgang. Das Ändern des Zuordnungsschutzes erfordert dynamodb:UpdateTable, und die Überprüfung, ob der Schutz und die Überwachung abgeschlossen sind, benötigen dynamodb:DescribeTable. Die folgende Identitätsrichtlinie gewährt diese Berechtigungen für eine Tabelle. Ersetzen Sie die Region, die Konto-ID und den Tabellennamen durch Ihre Werte.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "dynamodb:UpdateTable", "dynamodb:DisassociateTableReplica", "dynamodb:DescribeTable" ], "Resource": "arn:aws:dynamodb:us-west-2:111122223333:table/Music" } ] }
Aufheben der Zuordnung eines Replikats mit dem AWS CLI
Das folgende Verfahren trennt die Music Replikat in us-west-2. Verwenden Sie Anmeldeinformationen für das Konto, dem dieses Replikat gehört. Ersetzen Music und us-west-2 mit Ihrem Tisch und seiner lokalen Region. Das --table-name Der Parameter akzeptiert den Tabellennamen oder den Tabellen-ARN. Wenn Sie einen ARN verwenden, geben Sie den ARN des Replikats in diesem Konto und dieser Region an.
-
Deaktivieren Sie den Trennungsschutz für das lokale Replikat.
aws dynamodb update-table \ --table-nameMusic\ --regionus-west-2\ --no-disassociation-protection-enabled -
Überprüfen Sie die lokale Tabelle. Wiederholen Sie diesen Befehl, bis die Tabelle
ACTIVEundDisassociationProtectionEnabledistfalse. Fahren Sie nicht fort, wenn das Schutzfeld fehlt odertrue.aws dynamodb describe-table \ --table-nameMusic\ --regionus-west-2\ --query 'Table.{TableStatus:TableStatus,DisassociationProtectionEnabled:DisassociationProtectionEnabled,Replicas:Replicas}' -
Reichen Sie eine separate Anfrage mit einem
DisassociateAktion. Geben Sie die lokale Region an und legen Sie sie explizit festDisassociationModezuWAIT_FOR_REPLICATION.aws dynamodb update-table \ --table-nameMusic\ --regionus-west-2\ --replica-updates '[{"Disassociate":{"RegionName":"us-west-2","DisassociationMode":"WAIT_FOR_REPLICATION"}}]'Eine erfolgreiche Antwort bedeutet, dass DynamoDB die Anfrage akzeptiert hat. Der Vorgang wird asynchron fortgesetzt. Ein
UPDATINGDer Status zeigt an, dass das Update noch läuft. -
Überwachen Sie die lokale Tabelle mit
DescribeTable.aws dynamodb describe-table \ --table-nameMusic\ --regionus-west-2\ --query 'Table.{TableStatus:TableStatus,Replicas:Replicas}'Bestätigen Sie beides
TableStatusistACTIVEund dasReplicaslistet keine Peer-Replikate mehr auf. Die Liste kann fehlen, leer sein oder nur die lokale Tabelle enthalten. Überprüfen Sie auch die aktualisierte Mitgliedschaft eines verbleibenden Replikats, indem Sie Anmeldeinformationen verwenden, die zur Beschreibung dieser Tabelle autorisiert sind.WichtigACTIVEallein bestätigt nicht den Erfolg. Eine Tabelle könnte zurückkehren zuACTIVENach dem Trennen der Verknüpfung wird ein Rollback durchgeführt und ist immer noch ein Mitglied der globalen Tabelle. Überprüfen Sie immer die Replikatmitgliedschaft.
Einzelheiten zur API finden Sie unter UpdateTable und DescribeTable in der Amazon DynamoDB-API-Referenz.
Aufheben der Zuordnung eines Replikats mit CloudFormation
Wenn ein AWS::DynamoDB::GlobalTable Ressource verwaltet das Replikat, verwenden Sie dessen TableType Eigenschaft zum Aufheben der Zuordnung zum Replikat. CloudFormation trennt nur das Replikat im Konto und in der Region des Stacks. Bei einer globalen Tabelle mit mehreren Konten trennt jedes Konto sein eigenes Replikat von seinem eigenen Stapel. Um die Zuordnung eines Replikats in einer anderen Region einer globalen Tabelle mit demselben Konto aufzuheben, importieren Sie dieses Replikat zunächst in einen Stapel in seiner eigenen Region mit TableType gesetzt auf GlobalTableReplica, und führen Sie dann die Updates dort aus. Weitere Informationen finden Sie unter Importieren AWS
Ressourcen in eine CloudFormation stapeln in der AWS CloudFormation Benutzerleitfaden.
Derselbe Stack verwaltet die Tabelle weiter, nachdem sie regional geworden ist. Keine Tabelle oder Daten werden gelöscht. Der IAM-Prinzipal CloudFormation Uses für das Stack-Update benötigt die unter beschriebenen Berechtigungen Erforderliche Berechtigungen. Führen Sie die beiden folgenden Stack-Updates im eigenen Konto und in der Region des Replikats aus.
-
Einstellen
DisassociationProtectionEnabledzufalsein derReplicasEintrag für die Region des Stapels und setTableTypezuGlobalTableReplica. Warten Sie, bis das Stack-Update abgeschlossen ist. Die Replikation wird unverändert fortgesetzt. -
Setzen Sie
TableTypeaufRegional. Behalten Sie nur die Region des Stacks beiReplicas, und entferneDisassociationProtectionEnabledaus diesem Eintrag. entfernenGlobalTableSourceArnundMultiRegionConsistencyfalls vorhanden. Wenn du entfernstGlobalTableSourceArn, deklarieren Sie die Einstellungen, die das Replikat von der Quelltabelle geerbt hat, wieKeySchema,AttributeDefinitions,BillingMode, undStreamSpecification, mit ihren aktuellen Werten. Nehmen Sie jede andere Eigenschaftsänderung in einem separaten Stack-Update vor. Das Stack-Update wird abgeschlossen, nachdem DynamoDB die Trennung abgeschlossen hat.
Das TableType Veränderung erzählt CloudFormation um das Replikat zu trennen, anstatt es zu löschen. Durch das Entfernen der anderen Region-Einträge in diesem Update werden diese Tabellen nicht gelöscht. Ein Replikateintrag wird entfernt, ohne ihn zu ändern TableType zu Regional löscht dieses Replikat, wie bei jedem anderen Stack-Update.
Wenn DynamoDB die Trennung ablehnt oder ein Rollback durchführt, bleibt die Tabelle ein Replikat und das Stack-Update wird rückgängig gemacht. Beheben Sie die Ursache und führen Sie das zweite Update erneut aus. CloudFormation
kann eine abgeschlossene Trennung nicht rückgängig machen. Wenn die Trennung abgeschlossen ist und das Stack-Update dann ein Rollback durchführt, beispielsweise weil eine andere Ressource ausfällt, tritt der Stapel in den UPDATE_ROLLBACK_FAILED Bundesstaat. Setzen Sie das Rollback fort und überspringen Sie die Tabellenressource. Prüfen Sie dann, ob die Tabelle immer noch ein Replikat ist. Wenn die Tabelle jetzt regional ist, wenden Sie das zweite Update erneut an. Weitere Informationen finden Sie unter Rollback einer Aktualisierung fortsetzen im Benutzerhandbuch für AWS CloudFormation . Für die Wiederherstellung des Stacks ist es nicht erforderlich, die Tabelle oder ihre Daten zu löschen. Um diesen Zustand zu vermeiden, ändern Sie keine anderen Ressourcen im selben Stack-Update.
Eine Tabelle kann auch außerhalb des Stacks regional werden. Sie trennen sie beispielsweise von AWS CLI, oder ein anderes Konto trennt das andere Replikat einer globalen Tabelle mit zwei Replikaten. Wenden Sie in beiden Fällen das zweite Update an. CloudFormation erkennt, dass es sich bei der Tabelle bereits um eine regionale Tabelle handelt, und löscht die früheren Replikate nicht. Führen Sie aus Drift-Erkennung danach, um zu bestätigen, dass der Stapel mit der Tabelle übereinstimmt.
Die folgenden Beispiele zeigen die beiden Stack-Aktualisierungen für eine globale Tabelle mit demselben Konto und für eine globale Tabelle mit mehreren Konten in YAML und JSON. In den Beispielen werden fiktive Werte verwendet: der Tabellenname GT-CFN-Table und die Konto-ID 111122223333. Ersetzen Sie sie und die Tabelleneinstellungen durch Ihre eigenen Werte. DeletionPolicy: Retain behält die Tabelle bei, wenn Sie den Stapel später löschen; sie ist für die Trennung nicht erforderlich.
Dieses Beispiel verwendet einen Stack in us-east-1 um die Zuordnung zu trennen us-east-1 Replikat einer globalen Tabelle mit demselben Konto, in der sich Replikate befinden us-east-1, us-east-2, und us-west-2. Nach dem zweiten Update verwaltet der Stack die us-east-1 Tabelle als regionale Tabelle und us-east-2 und us-west-2 Replikate werden weiterhin als globale Tabelle angezeigt. Der Stack verwaltet diese Tabellen nicht mehr. Um die verbleibende globale Tabelle zu verwalten mit CloudFormation, importieren Sie sie in einen Stapel in us-east-2 oder us-west-2.
Update 1: Deaktivieren Sie den Trennungsschutz
Diese Vorlage setzt DisassociationProtectionEnabled zu false auf der us-east-1 Replik und Sets TableType zu GlobalTableReplica. Die anderen Eigenschaften sind unverändert.
Update 2: Trennen Sie die Zuordnung zum Replikat
Diese Vorlagensätze TableType zu Regional, hält nur us-east-1 in Replicas, und entfernt DisassociationProtectionEnabled aus diesem Eintrag.
In diesem Beispiel wird die Verknüpfung getrennt us-east-2 Replikat einer globalen Tabelle mit mehreren Konten. Konto A (111122223333) besitzt die Quelltabelle in us-east-1. Konto B besitzt die us-east-2 repliziert und führt beide Updates von seinem eigenen Stack aus us-east-2. Da die globale Tabelle nur zwei Replikate hat, wird die Tabelle von Konto A ebenfalls regional. Konto A kann dann Folgendes einrichten TableType zu Regional in einer eigenen Vorlage. Dieses Update ist nicht erforderlich, damit die Verknüpfung von Konto B abgeschlossen werden kann.
Update 1: Deaktiviere den Trennungsschutz
Diese Vorlage setzt DisassociationProtectionEnabled zu false auf der us-east-2 Replik und Sets TableType zu GlobalTableReplica. Die anderen Eigenschaften sind unverändert. Das Replikat erbt seine Tabelleneinstellungen von der Quelltabelle, die durch gekennzeichnet ist GlobalTableSourceArn.
Update 2: Trennen Sie das Replikat
Diese Vorlagensätze TableType zu Regional, entfernt GlobalTableSourceArn und DisassociationProtectionEnabled, und deklariert die geerbten Tabelleneinstellungen mit ihren aktuellen Werten.
Behandlung von Fehlern
Eine Anfrage, die während der Validierung oder Autorisierung abgelehnt wurde, führt nicht zur Trennung. Lesen Sie die Fehlerantwort, korrigieren Sie das gemeldete Problem und versuchen Sie es erneut. Deaktivieren Sie beispielsweise den Trennungsschutz, warten Sie, bis ein gleichzeitiger Vorgang abgeschlossen ist, oder stellen Sie den Zugriff auf ein Replikat wieder her, auf das nicht zugegriffen werden kann. Wenn bei einer Anfrage ein Timeout auftritt oder ihre Antwort verloren geht, überprüfen Sie den Status und die Mitgliedschaft der Tabelle, bevor Sie es erneut versuchen, da die Anforderung möglicherweise akzeptiert wurde.
Ein akzeptierter Vorgang kann später fehlschlagen. Wenn Sie beispielsweise den Zugriff auf den Verschlüsselungsschlüssel eines Replikats oder die erforderlichen Replikationsberechtigungen verlieren, kann dies dazu führen, dass die Trennung rückgängig gemacht wird. Nach dem Rollback bleibt das Replikat Teil der globalen Tabelle. Untersuchen ReplicaStatus und ReplicaStatusDescription, stellen Sie den Zugriff bei Bedarf wieder her und warten Sie, bis die Replikate aktiv sind, bevor Sie es erneut versuchen. Die fortgesetzte Unzugänglichkeit hängt immer noch vom bestehenden Wiederherstellungsverhalten der globalen Tabelle ab. Weitere Informationen finden Sie unter Sicherheit von globalen DynamoDB-Tabellen.