Ajouter un routeur à un groupe de partitions de base de données - Amazon Aurora
PrérequisAjouter un routeurSuivi des ajouts de routeursAnnulation de l'ajout d'un routeur

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Ajouter un routeur à un groupe de partitions de base de données

Vous pouvez ajouter un routeur à un groupe de partitions de base de données.

Prérequis

L'ajout d'un routeur comporte les conditions préalables suivantes :

  • Vous devez disposer d'un groupe de partitions de base de données.

  • Un utilisateur doit disposer de rds_aurora_limitless_cluster_admin ce privilège. Il rds_superuser possède ce privilège ; par conséquent, l'utilisateur principal l'a également. Ils rds_superuser peuvent accorder le privilège à d'autres utilisateurs :

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

    Si vous modifiez Compte AWS le certificat CA par défaut après la création du groupe de partitions de base de données, le nouveau routeur utilisera le nouveau certificat CA, qui est différent du certificat CA du routeur existant. En fonction de votre magasin de confiance, certaines connexions peuvent échouer.

  • Pour activer l'ajout de routeurs initié par le système, définissez les paramètres de cluster de base de données suivants dans un groupe de paramètres de cluster de base de données personnalisé associé à votre cluster de base de données :

    Paramètre Valeur

    rds_aurora.limitless_enable_auto_scale

    on

    rds_aurora.limitless_auto_scale_options

    L'un add_router ou l'autre add_router,split_shard

    Pour de plus amples informations, veuillez consulter Groupes de paramètres de cluster de base de données pour les clusters de bases de données Amazon Aurora.

Ajouter un routeur

Pour ajouter un routeur, utilisez la rds_aurora.limitless_add_router fonction. Cette fonction lance une tâche d'ajout de routeur qui s'exécute de manière asynchrone.

SELECT rds_aurora.limitless_add_router();

Attendez le retour d'un identifiant de tâche une fois la soumission réussie de la tâche, par exemple :

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

Suivi des ajouts de routeurs

Vous pouvez utiliser l'ID de tâche pour suivre une tâche ajoutée à un routeur. Pour décrire une tâche particulière et obtenir plus de détails à son sujet, exécutez la requête suivante :

SELECT * FROM rds_aurora.limitless_list_router_scale_jobs(job_id);

Par exemple :

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)

La requête renvoie une erreur lorsque vous transmettez une tâche inexistante en entrée.

SELECT * from rds_aurora.limitless_list_router_scale_jobs(1691300000001);

ERROR:  no job found with the job ID provided

Vous pouvez suivre l'état de toutes les tâches d'ajout de routeurs en utilisant la même requête sans identifiant de tâche, par exemple :

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)

Le statut du poste peut être l'un des suivants :

  • IN_PROGRESS— La tâche d'ajout de routeur a été soumise et est en cours. Vous ne pouvez avoir qu'une seule tâche en cours à la fois.

  • CANCELLATION_IN_PROGRESS— La tâche d'ajout du routeur est annulée par l'utilisateur.

  • CANCELED— La tâche d'ajout du routeur a été annulée avec succès par l'utilisateur ou par le système.

  • SUCCESS— La tâche d'ajout du routeur s'est terminée avec succès. Le message champ contient l'ID d'instance du nouveau routeur.

  • FAILED— La tâche d'ajout du routeur a échoué. Le message champ contient les détails de l'échec et toutes les actions qui peuvent être entreprises à la suite de l'échec de la tâche.

Note

Il n'y a aucun PENDING statut car les ajouts de routeurs n'ont pas besoin d'être finalisés. Ils n'entraînent aucun temps d'arrêt.

Annulation de l'ajout d'un routeur

Vous pouvez annuler l'ajout d'un routeur qui estIN_PROGRESS. Vous avez besoin de l'identifiant de la tâche pour l'annuler.

SELECT * from rds_aurora.limitless_cancel_router_scale_jobs(job_id);

Aucune sortie n'est renvoyée sauf en cas d'erreur. Vous pouvez suivre l'annulation à l'aide d'une requête de suivi des offres d'emploi.