Verwaltung von Amazon DocumentDB serverlos

Die Konfiguration des Skalierungskapazitätsbereichs eines Clusters anzeigen und ändern

Das ServerlessV2ScalingConfiguration Argument gibt den Skalierungskapazitätsbereich Ihrer serverlosen DocumentDB-Instances an. Es besteht aus den minimalen und maximalen DCU (DocumentDB Capacity Unit) -Werten, die für alle serverlosen DocumentDB-Instances im Cluster gelten.

• MinCapacity— Die minimale Skalierungskapazität aller serverlosen DocumentDB-Instances im Cluster.

• MaxCapacity— Die maximale Skalierungskapazität aller serverlosen DocumentDB-Instanzen im Cluster.

Anmerkung

Für die folgenden Änderungen der Skalierungskonfiguration ist ein Neustart der Instanz erforderlich, um die neuen MinCapacity UND-Werte widerzuspiegeln: MaxCapacity

• Alle Änderungen des MaxCapacity Werts

• Änderung des MinCapacity Werts von einem höheren Wert auf 1,0 oder niedriger

• Änderung des MinCapacity Werts von einem niedrigeren Wert auf einen Wert über 1,0

Weitere Informationen zur Skalierungskonfiguration und zur Auswahl geeigneter Skalierungskapazitätsgrenzen finden Sie unterServerlose Skalierungskonfiguration von Amazon DocumentDB.

Using the AWS-Managementkonsole

Das folgende AWS-Managementkonsole Konfigurationsbeispiel zeigt, wie die Skalierungskonfigurationseinstellungen eines serverlosen DocumentDB-Clusters angezeigt und bearbeitet werden.

1. Melden Sie sich bei der Amazon DocumentDB-Konsole an AWS-Managementkonsole und öffnen Sie sie.

2. Klicken Sie im Navigationsbereich auf Cluster.

   Tipp

   Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol () aus.

   Die Cluster-Tabelle wird angezeigt.

3. Wählen Sie in der Cluster-Tabelle das Kontrollkästchen des Clusters aus, für den Sie die Skalierungskapazität ändern möchten.

4. Wählen Sie Actions (Aktionen) und dann Modify (Ändern) aus.

   Das Dialogfeld „Cluster ändern“ wird angezeigt.

5. Suchen Sie den Abschnitt „Serverlose Kapazitätseinstellung“ und legen Sie die Skalierungskonfiguration (Kapazitätsbereich) auf der Grundlage der Kapazitätsbeschreibung im Dialogfeld fest.

   Weitere Informationen zur Skalierung und zu Kapazitätsbereichen finden Sie unterServerlose Skalierungskonfiguration von Amazon DocumentDB.

6. Klicken Sie auf Weiter.

7. Wählen Sie für Scheduling of modifications (Einplanung von Änderungen) die Option Apply immediately (Sofort anwenden) aus.

8. Wählen Sie Cluster bearbeiten aus.

9. Sobald die Änderung abgeschlossen ist, sollte jede serverlose Instanz neu gestartet werden. Um die Nichtverfügbarkeit des Writers zu minimieren, führen Sie die folgende Abfolge von Vorgängen aus:

   1. Starten Sie jede serverlose Reader-Instanz neu.

      1. Wählen Sie die Reader-Instance aus, wählen Sie Actions und anschließend Reboot.

      2. Warten Sie, bis der Instanzstatus wieder verfügbar ist.

   2. Führen Sie ein Failover zu einer neu gestarteten serverlosen Instance durch.

      1. Wählen Sie den Cluster aus, wählen Sie Aktionen und dann Failover.

      2. Warten Sie, bis der Failover-Vorgang abgeschlossen ist.

   3. Starten Sie die verbleibende serverlose Instanz neu.

      1. Wählen Sie die verbleibende Instanz aus, wählen Sie Aktionen und dann Neustart.

      2. Warten Sie, bis der Instanzstatus wieder verfügbar ist.

Using the AWS CLI

Das folgende AWS CLI Konfigurationsbeispiel zeigt die aktuelle Skalierungskonfiguration.

Ersetzen Sie im folgenden Beispiel jedes user input placeholder durch Ihre eigenen Informationen oder Konfigurationsparameter.

Die aktuelle Skalierungskonfiguration des Clusters kann mit dem describe-db-clusters AWS CLI folgenden Befehl angezeigt werden:

aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[0].ServerlessV2ScalingConfiguration'

Die Ausgabe dieses Befehls ist wie folgt:

{
    "MinCapacity": 0.5,
    "MaxCapacity": 16.0
}

Die Skalierungskonfiguration des Clusters kann mit dem modify-db-cluster folgenden Befehl geändert werden:

aws docdb modify-db-cluster \
    --db-cluster-identifier sample-cluster \
    --serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=32

Sobald der Vorgang abgeschlossen ist, sollte jede serverlose Instanz neu gestartet werden. Um die Nichtverfügbarkeit des Writers zu minimieren, können wir die folgende Abfolge von Vorgängen ausführen:

aws docdb reboot-db-instance \
    --db-instance-identifier sample-serverless-instance-reader

aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-reader

aws docdb failover-db-cluster \
   --db-cluster-identifier sample-cluster \
   --target-db-instance-identifier sample-serverless-instance-reader

aws docdb reboot-db-instance \
    --db-instance-identifier sample-serverless-instance-writer

aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-writer

aws docdb failover-db-cluster \
   --db-cluster-identifier sample-cluster \
   --target-db-instance-identifier sample-serverless-instance-writer

Die Angebotsstufe für serverlose Lesegeräte anzeigen und ändern

Achten Sie bei Clustern, die mehrere serverlose DocumentDB-Instances oder eine Mischung aus bereitgestellten und serverlosen Instances enthalten, auf die Einstellung der Aufstiegsstufe für jede serverlose Instance. Diese Einstellung steuert mehr Verhalten für serverlose Instances als für bereitgestellte Instances.

Bei bereitgestellten Instances bestimmt die Wahl der Stufen 0—15 nur die Reihenfolge, in der Amazon DocumentDB auswählt, welche Reader-Instance während eines Failover-Vorgangs an den Writer heraufgestuft werden soll. Bei serverlosen Instances bestimmt die Tier-Nummer jedoch auch, ob die Instance entsprechend der Kapazität der Writer-Instance hochskaliert wird, oder ob sie unabhängig von ihrer eigenen Arbeitslast skaliert wird. Serverlose Reader-Instances der Stufe 0 oder 1 werden auf einer Mindestkapazität gehalten, die mindestens so hoch ist wie die Writer-Instance. Auf diese Weise sind sie bereit, im Falle eines Failovers die Writer-Instanz zu ersetzen. Wenn es sich bei der Writer-Instance um eine bereitgestellte Instance handelt, schätzt Amazon DocumentDB die entsprechende serverlose DocumentDB-Kapazität. Diese Schätzung wird als Mindestkapazität für die serverlose Reader-Instance verwendet.

Für serverlose DocumentDB-Leser-Instances der Stufen 2—15 gelten nicht dieselben Beschränkungen in Bezug auf ihre Mindestkapazität. Wenn sie inaktiv sind, können sie auf den Mindestwert der DocumentDB-Kapazitätseinheit (DCU) herunterskaliert werden, der im Kapazitätsbereich des Clusters angegeben ist.

Using the AWS-Managementkonsole

Das folgende AWS-Managementkonsole Konfigurationsbeispiel zeigt, wie die Einstellungen für die Werbestufe eines serverlosen DocumentDB-Instance-Readers angezeigt und geändert werden.

1. Melden Sie sich bei der Amazon DocumentDB-Konsole an AWS-Managementkonsole und öffnen Sie sie.

   Die Promotion-Stufen jeder Instance werden in der Spalte Promotion-Stufe in der AWS-Managementkonsole angezeigt.

2. Klicken Sie im Navigationsbereich auf Cluster.

   Tipp

   Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol () aus.

   Die Cluster-Tabelle wird angezeigt.

3. Wählen Sie in der Cluster-Tabelle das Kontrollkästchen der Instance aus, für die Sie die Promotion-Stufe ändern möchten.

4. Wählen Sie Actions (Aktionen) und dann Modify (Ändern) aus.

   Das Dialogfeld „Instanz ändern“ wird angezeigt.

5. Suchen Sie den Abschnitt Failover und stellen Sie die Promotion-Stufe auf die gewünschte Stufe ein.

6. Klicken Sie auf Weiter.

7. Wählen Sie für Scheduling of modifications (Einplanung von Änderungen) die Option Apply immediately (Sofort anwenden) aus.

8. Wählen Sie Modify instance (Instance ändern).

Using the AWS CLI

Das folgende AWS CLI Konfigurationsbeispiel zeigt die aktuelle Skalierungskonfiguration.

Ersetzen Sie im folgenden Beispiel jedes user input placeholder durch Ihre eigenen Informationen oder Konfigurationsparameter.

Die Promotion-Stufen aller Instances in einem Cluster können mit dem describe-db-clusters AWS CLI folgenden Befehl angezeigt werden:

aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[0].DBClusterMembers' \
    --output table

Die Ausgabe dieses Befehls ist wie folgt:

--------------------------------------------------------------------------------------------------------
|                                          DescribeDBClusters                                          |
+--------------------------------+---------------------------------+------------------+----------------+
|  DBClusterParameterGroupStatus |      DBInstanceIdentifier       | IsClusterWriter  | PromotionTier  |
+--------------------------------+---------------------------------+------------------+----------------+
|  in-sync                       |  sample-serverless-instance-2   |  False           |  1             |
|  in-sync                       |  sample-serverless-instance-1   |  True            |  1             |
+--------------------------------+---------------------------------+------------------+----------------+

Die Promotion-Stufe einer bestimmten Instanz kann mit dem modify-db-instance folgenden Befehl geändert werden:

aws docdb modify-db-instance \
    --db-instance-identifier sample-serverless-instance-2 \
    --promotion-tier 3