Aggiungere un router a un gruppo di shard DB - Amazon Aurora
PrerequisitiAggiungere un routerMonitoraggio delle aggiunte al routerAnnullamento dell'aggiunta di un router

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Aggiungere un router a un gruppo di shard DB

È possibile aggiungere un router a un gruppo di shard DB.

Prerequisiti

L'aggiunta di un router presenta i seguenti prerequisiti:

  • È necessario disporre di un gruppo di shard DB.

  • Un utente deve avere il rds_aurora_limitless_cluster_admin privilegio. rds_superuserHa questo privilegio, quindi lo possiede anche l'utente principale. rds_superuserPossono concedere il privilegio ad altri utenti:

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

    Se modifichi il certificato CA predefinito dopo la creazione Account AWS del gruppo di shard DB, il nuovo router utilizzerà il nuovo certificato CA, che è diverso dal certificato CA del router esistente. A seconda del trust store, alcune connessioni potrebbero fallire.

  • Per abilitare l'aggiunta di router avviata dal sistema, imposta i seguenti parametri del cluster DB in un gruppo di parametri del cluster DB personalizzato associato al cluster DB:

    Parametro Valore

    rds_aurora.limitless_enable_auto_scale

    on

    rds_aurora.limitless_auto_scale_options

    O add_router add_router,split_shard

    Per ulteriori informazioni, consulta Gruppi di parametri del cluster DB per i cluster DB di Amazon Aurora.

Aggiungere un router

Per aggiungere un router, usa la rds_aurora.limitless_add_router funzione. Questa funzione avvia un processo di aggiunta del router che viene eseguito in modo asincrono.

SELECT rds_aurora.limitless_add_router();

Attendi la restituzione di un ID di lavoro dopo l'invio corretto del lavoro, ad esempio:

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

Le operazioni di aggiunta simultanea del router non sono supportate. Esegui le operazioni in sequenza e completa ogni operazione prima di iniziare un'altra operazione di aggiunta.

Monitoraggio delle aggiunte al router

È possibile utilizzare l'ID del lavoro per tenere traccia di un processo di aggiunta al router. Per descrivere un particolare lavoro e ottenere maggiori dettagli al riguardo, esegui la seguente query:

SELECT * FROM rds_aurora.limitless_list_router_scale_jobs(job_id);

Per esempio:

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 query restituisce un errore quando si passa un lavoro inesistente come input.

SELECT * from rds_aurora.limitless_list_router_scale_jobs(1691300000001);

ERROR:  no job found with the job ID provided

È possibile tenere traccia dello stato di tutti i processi di aggiunta del router utilizzando la stessa query senza un ID di lavoro, ad esempio:

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)

Lo stato del lavoro può essere uno dei seguenti:

  • IN_PROGRESS— Il processo di aggiunta del router è stato inviato ed è in corso. È possibile avere un solo lavoro in corso alla volta.

  • CANCELLATION_IN_PROGRESS— Il processo di aggiunta del router viene annullato dall'utente.

  • CANCELED— Il processo di aggiunta del router è stato annullato con successo dall'utente o dal sistema.

  • SUCCESS— Il processo di aggiunta del router è stato completato correttamente. Il message campo contiene l'ID di istanza del nuovo router.

  • FAILED— Il processo di aggiunta del router non è riuscito. Il message campo contiene i dettagli dell'errore e tutte le azioni che possono essere intraprese in seguito al processo fallito.

Nota

Non c'è nessuno PENDING status perché non è necessario finalizzare le aggiunte al router. Non comportano tempi di inattività.

Annullamento dell'aggiunta di un router

Puoi annullare l'aggiunta di un router. IN_PROGRESS È necessario l'ID del lavoro per annullarlo.

SELECT * from rds_aurora.limitless_cancel_router_scale_jobs(job_id);

Non viene restituito alcun output a meno che non si verifichi un errore. Puoi tenere traccia dell'annullamento utilizzando una query di tracciamento del lavoro.