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.
**Topics**
+ [Voraussetzungen](#limitless-add-router.prereqs)
+ [Hinzufügen eines Routers](#limitless-add-router.proc)
+ [Nachverfolgen von Router-Hinzufügungen](#limitless-add-router.track)
+ [Abbrechen einer Router-Hinzufügung](#limitless-add-router.cancel)
## 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 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.
+ 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:
[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/limitless-add-router.html)
Weitere Informationen finden Sie unter [DB-Cluster-Parametergruppen für Amazon-Aurora-DB-Cluster](USER_WorkingWithDBClusterParamGroups.md).
## 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}});
```
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.