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

PDFRSS

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

Voraussetzungen

Für das Hinzufügen eines Routers gelten die folgenden Voraussetzungen:

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

• Ein Benutzer muss das rds_aurora_limitless_cluster_admin Recht haben. Der rds_superuser hat dieses Recht; daher hat es auch der Masterbenutzer. Er rds_superuser kann das Privileg anderen Benutzern 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 Ihr AWS-Konto Standard-CA-Zertifikat ä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.

• Um das systeminitiierte Hinzufügen eines Routers zu aktivieren, 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 oder add_router add_router,split_shard

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

Einen Router hinzufügen

Verwenden Sie die rds_aurora.limitless_add_router Funktion, 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 Jobs auf die Rückgabe einer Job-ID, zum Beispiel:

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

Router-Ergänzungen verfolgen

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

SELECT * FROM rds_aurora.limitless_list_router_scale_jobs(job_id);

Beispielsweise:

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 übergeben.

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 zusätzlichen Router-Jobs verfolgen, indem Sie dieselbe Abfrage ohne Job-ID verwenden, 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 sein:

• IN_PROGRESS— Der Auftrag zum Hinzufügen eines Routers wurde eingereicht und ist in Bearbeitung. Sie können jeweils nur einen Job in Bearbeitung haben.

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

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

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

• FAILED— Der Job zum Hinzufügen eines Routers ist fehlgeschlagen. Das message Feld enthält die Einzelheiten des Fehlers und alle Maßnahmen, die als Folgemaßnahme zu dem fehlgeschlagenen Job ergriffen werden können.

Anmerkung

Es gibt keinen PENDING Status, da Router-Ergänzungen nicht finalisiert werden müssen. Sie haben keine Ausfallzeiten.

Stornieren eines Router-Hinzufügens

Sie können einen Router-Zusatz stornieren, der IN_PROGRESS Sie benötigen die Job-ID, um ihn zu stornieren.

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 die Kündigung mithilfe einer Job-Tracking-Abfrage verfolgen.