Hinzufügen eines Routers zu einer DB-Shard-Gruppe - Amazon Aurora
VoraussetzungenHinzufügen eines RoutersNachverfolgen von Router-HinzufügungenAbbrechen einer Router-Hinzufügung

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.

Hinzufügen eines Routers zu einer DB-Shard-Gruppe

Sie können einen Router zu einer DB-Shard-Gruppe hinzufügen.

Voraussetzungen

Folgende Voraussetzungen gelten für das Hinzufügen eines Routers:

  • Sie müssen über eine DB-Shard-Gruppe verfügen.

  • Ein Benutzer muss die Berechtigung rds_aurora_limitless_cluster_admin haben. Der rds_superuser hat dieses Recht; daher hat es auch der Masterbenutzer. Der rds_superuser kann anderen Benutzern das Privileg gewähren:

    /* Logged in as the master user or a user with rds_superuser privileges */
CREATE USER username;
GRANT rds_aurora_limitless_cluster_admin to username;
    Anmerkung

    Wenn Sie das Standard-CA-Zertifikat Ihres AWS-Kontos ändern, nachdem die DB-Shard-Gruppe erstellt wurde, verwendet der neue Router das neue CA-Zertifikat, das sich vom CA-Zertifikat des vorhandenen Routers unterscheidet. Abhängig von Ihrem Trust Store können einige Verbindungen fehlschlagen.

  • Wenn Sie möchten, dass das System das Hinzufügen von Routern initiiert, legen Sie die folgenden DB-Cluster-Parameter in einer benutzerdefinierten DB-Cluster-Parametergruppe fest, die Ihrem DB-Cluster zugeordnet ist:

    Parameter Wert

    rds_aurora.limitless_enable_auto_scale

    on

    rds_aurora.limitless_auto_scale_options

    Entweder add_router oder add_router,split_shard

    Weitere Informationen finden Sie unter DB-Cluster-Parametergruppen für Amazon-Aurora-DB-Cluster.

Hinzufügen eines Routers

Verwenden Sie die Funktion rds_aurora.limitless_add_router, um einen Router hinzuzufügen. Diese Funktion startet einen Auftrag zum Hinzufügen eines Routers, der asynchron ausgeführt wird.

SELECT rds_aurora.limitless_add_router();

Warten Sie nach erfolgreicher Übermittlung des Auftrags auf die Rückgabe einer Auftrags-ID, zum Beispiel:

    job_id
---------------
 1691300000000
(1 row)
Anmerkung

Gleichzeitige Aufträge zum Hinzufügen von Routern werden nicht unterstützt. Führen Sie die Aufträge nacheinander aus und schließen Sie jeden Auftrag ab, bevor Sie eine weitere Hinzufügung einleiten.

Nachverfolgen von Router-Hinzufügungen

Sie können die Auftrags-ID verwenden, um einen Auftrag zum Hinzufügen eines Routers nachzuverfolgen. Führen Sie die folgende Abfrage aus, um einen bestimmten Auftrag zu beschreiben und weitere Informationen dazu zu erhalten:

SELECT * FROM rds_aurora.limitless_list_router_scale_jobs(job_id);

Zum Beispiel:

SELECT * FROM rds_aurora.limitless_list_router_scale_jobs(1691300000000);

    job_id     |   action   |        job_details       | status  |    submission_time     |                   message                   
---------------+------------+--------------------------+---------+------------------------+-------------------------------------------
 1691300000000 | ADD_ROUTER | Add 1 new Router by User | SUCCESS | 2023-08-06 05:33:20+00 | Scaling job succeeded.                  +
               |            |                          |         |                        | New router instance with ID 7 was created.
(1 row)

Die Abfrage gibt einen Fehler zurück, wenn Sie einen nicht vorhandenen Auftrag als Eingabe übermitteln.

SELECT * from rds_aurora.limitless_list_router_scale_jobs(1691300000001);

ERROR:  no job found with the job ID provided

Sie können den Status aller Router-Hinzufügungen verfolgen, indem Sie dieselbe Abfrage ohne Auftrags-ID ausführen, zum Beispiel:

SELECT * FROM rds_aurora.limitless_list_router_scale_jobs();

    job_id     |   action   |        job_details       |   status    |    submission_time     |                  message                   
---------------+------------+--------------------------+-------------+------------------------+-------------------------------------------
 1691200000000 | ADD_ROUTER | Add 1 new Router by User | IN_PROGRESS | 2023-08-05 01:46:40+00 | 
 1691300000000 | ADD_ROUTER | Add 1 new Router by User | SUCCESS     | 2023-08-06 05:33:20+00 | Scaling job succeeded.                +
               |            |                          |             |                        | New router instance with ID 7 was created.
 1691400000000 | ADD_ROUTER | Add 1 new Router by User | FAILED      | 2023-08-07 09:20:00+00 | Error occurred for the add router job 1691400000000.
               |            |                          |             |                        | Retry the command. If the issue persists, contact AWS Support.
 1691500000000 | ADD_ROUTER | Add 1 new Router by User | CANCELED    | 2023-08-07 09:20:00+00 | Scaling job was cancelled.
(4 rows)

Der Auftragsstatus kann einer der folgenden Werte sein:

  • IN_PROGRESS: Der Auftrag zum Hinzufügen eines Routers wurde übermittelt und ist in Bearbeitung. Sie können nur einen Auftrag nach dem anderen ausführen.

  • CANCELLATION_IN_PROGRESS: Der Auftrag zum Hinzufügen eines Routers wird vom Benutzer abgebrochen.

  • CANCELED: Der Auftrag zum Hinzufügen eines Routers wurde vom Benutzer oder vom System erfolgreich abgebrochen.

  • SUCCESS: Der Auftrag zum Hinzufügen eines Routers wurde erfolgreich abgeschlossen. Das Feld message enthält die Instance-ID des neuen Routers.

  • FAILED: Der Auftrag zum Hinzufügen eines Routers ist fehlgeschlagen. Das Feld message enthält die Einzelheiten zu dem Fehler und alle Maßnahmen, die zu dem fehlgeschlagenen Auftrag ergriffen werden können.

Anmerkung

Es gibt keinen Status PENDING, da Router-Hinzufügungen nicht finalisiert werden müssen. Sie verursachen keine Ausfallzeiten.

Abbrechen einer Router-Hinzufügung

Sie können einen Router-Hinzufügung mit dem Status IN_PROGRESS abbrechen. Sie benötigen die Auftrags-ID, um den Auftrag abzubrechen.

SELECT * from rds_aurora.limitless_cancel_router_scale_jobs(job_id);

Es wird keine Ausgabe zurückgegeben, es sei denn, es liegt ein Fehler vor. Sie können den Abbruch mithilfe einer Abfrage zur Auftragsverfolgung überwachen.