DB 샤드 그룹에 라우터 추가 - Amazon Aurora
사전 조건라우터 추가라우터 추가 추적라우터 추가 취소

DB 샤드 그룹에 라우터 추가

DB 샤드 그룹에 라우터를 추가할 수 있습니다.

사전 조건

라우터를 추가하는 데는 다음과 같은 사전 조건이 있습니다.

  • DB 샤드 그룹이 있어야 합니다.

  • 사용자에게 rds_aurora_limitless_cluster_admin 권한이 있어야 합니다. rds_superuser에는 이 권한이 있으므로 마스터 사용자에게도 권한이 있습니다. rds_superuser는 다른 사용자에게 권한을 부여할 수 있습니다.

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

    DB 샤드 그룹이 만들어진 후 AWS 계정의 기본 CA 인증서를 변경하면 새 라우터는 기존 라우터의 CA 인증서와 다른 새 CA 인증서를 사용합니다. 트러스트 스토어에 따라 일부 연결이 실패할 수 있습니다.

  • 시스템 시작 라우터 추가를 활성화하려면 DB 클러스터와 연결된 사용자 지정 DB 클러스터 파라미터 그룹에서 다음 DB 클러스터 파라미터를 설정합니다.

    파라미터 값

    rds_aurora.limitless_enable_auto_scale

    on

    rds_aurora.limitless_auto_scale_options

    add_router 또는 add_router,split_shard

    자세한 내용은 Amazon Aurora DB 클러스터의 DB 클러스터 파라미터 그룹 섹션을 참조하세요.

라우터 추가

라우터를 추가하려면 rds_aurora.limitless_add_router 함수를 사용합니다. 이 함수는 비동기식으로 실행되는 라우터 추가 작업을 시작합니다.

SELECT rds_aurora.limitless_add_router();

작업을 성공적으로 제출하면 작업 ID가 반환될 때까지 기다립니다. 예를 들면 다음과 같습니다.

    job_id
---------------
 1691300000000
(1 row)
참고

동시 라우터 추가 작업은 지원되지 않습니다. 작업을 순차적으로 실행하고 다른 추가 작업을 시작하기 전에 각 작업을 완료합니다.

라우터 추가 추적

작업 ID를 사용하여 라우터 추가 작업을 추적할 수 있습니다. 특정 작업을 설명하고 이에 대한 세부 정보를 얻으려면 다음 쿼리를 실행합니다.

SELECT * FROM rds_aurora.limitless_list_router_scale_jobs(job_id);

예시:

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)

존재하지 않는 작업을 입력으로 전달하면 쿼리가 오류를 반환합니다.

SELECT * from rds_aurora.limitless_list_router_scale_jobs(1691300000001);

ERROR:  no job found with the job ID provided

작업 ID 없이 동일한 쿼리를 사용하여 모든 라우터 추가 작업의 상태를 추적할 수 있습니다. 예를 들면 다음과 같습니다.

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)

작업 상태는 다음 값 중 하나일 수 있습니다.

  • IN_PROGRESS - 라우터 추가 작업이 제출되어 진행 중입니다. 한 번에 하나의 작업만 진행할 수 있습니다.

  • CANCELLATION_IN_PROGRESS - 사용자가 라우터 추가 작업을 취소하는 중입니다.

  • CANCELED - 사용자 또는 시스템이 라우터 추가 작업을 성공적으로 취소했습니다.

  • SUCCESS - 라우터 추가 작업이 성공적으로 완료되었습니다. message 필드에는 새로운 라우터의 인스턴스 ID가 포함됩니다.

  • FAILED - 라우터 추가 작업이 실패했습니다. message 필드에는 실패에 대한 세부 정보와 실패한 작업에 대한 후속 조치로 수행할 수 있는 작업이 포함되어 있습니다.

참고

라우터 추가를 마무리할 필요가 없으므로 PENDING 상태가 없습니다. 가동 중지 시간이 발생하지 않습니다.

라우터 추가 취소

IN_PROGRESS인 라우터 추가를 취소할 수 있습니다. 취소하려면 작업 ID가 필요합니다.

SELECT * from rds_aurora.limitless_cancel_router_scale_jobs(job_id);

오류가 없으면 출력이 반환되지 않습니다. 작업 추적 쿼리를 사용하여 취소를 추적할 수 있습니다.