Configuración de clústeres multirregionales

En este capítulo se explica cómo configurar y administrar clústeres que abarcan múltiples Regiones de AWS.

Conexión al clúster multirregional

Los clústeres emparejados multirregionales proporcionan dos puntos de conexión regionales, uno en cada Región de AWS de clúster interconectado. Ambos puntos de conexión presentan una única base de datos lógica que admite operaciones de lectura y escritura simultáneas con una coherencia de datos sólida. Además de los clústeres emparejados, un clúster de varias regiones también tiene una región testigo que almacena una ventana limitada de registros de transacciones cifrados, que se utiliza para mejorar la durabilidad y la disponibilidad de varias regiones. Las regiones testigo de varias regiones no tienen puntos de conexión.

Creación de clústeres multirregionales

Para crear clústeres de varias regiones, primero debe crear un clúster con una región testigo. A continuación, empareje este clúster con un segundo clúster que comparte la misma región testigo que el primer clúster. En el siguiente ejemplo se muestra cómo crear clústeres en Este de EE. UU. (Norte de Virginia) y Este de EE. UU. (Ohio) con Oeste de EE. UU. (Oregón) como región testigo.

Paso 1: creación del clúster 1 en Este de EE. UU. (Norte de Virginia)

Para crear un clúster en la Región de AWS Este de EE. UU. (Norte de Virginia) con propiedades multirregionales, utilice el siguiente comando.

aws dsql create-cluster \
--region us-east-1 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'

{
    "identifier": "abc0def1baz2quux3quuux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
    "status": "UPDATING",
    "encryptionDetails": {
        "encryptionType": "AWS_OWNED_KMS_KEY",
        "encryptionStatus": "ENABLED"
   }
   "creationTime": "2024-05-24T09:15:32.708000-07:00"
}

Paso 2: creación del clúster 2 en Este de EE. UU. (Ohio)

Para crear un clúster en la Región de AWS Este de EE. UU. (Ohio) con propiedades multirregionales, utilice el siguiente comando.

aws dsql create-cluster \
--region us-east-2 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'

{
    "identifier": "foo0bar1baz2quux3quuxquux5",
    "arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
    "status": "PENDING_SETUP",
    "creationTime": "2025-05-06T06:51:16.145000-07:00",
    "deletionProtectionEnabled": true,
    "multiRegionProperties": {
        "witnessRegion": "us-west-2",
        "clusters": [
            "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5"
        ]
    }
}      

Cuando la operación de la API se realiza correctamente, el clúster realiza la transición al estado PENDING_SETUP. La creación del clúster permanece en el estado PENDING_SETUP hasta que lo actualice con el ARN de otro clúster para el emparejamiento.

Paso 3: emparejamiento del clúster en Este de EE. UU. (Norte de Virginia) con Este de EE. UU. (Ohio)

Para emparejar el clúster de Este de EE. UU. (Norte de Virginia) con el clúster de Este de EE. UU. (Ohio), utilice el comando update-cluster. Especifique el nombre del clúster del Este de EE. UU. (Norte de Virginia) y una cadena JSON con el ARN del clúster de Este de EE. UU. (Ohio).

aws dsql update-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4' \
--multi-region-properties '{"witnessRegion": "us-west-2","clusters": ["arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5"]}'

{
    "identifier": "foo0bar1baz2quux3quuxquux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
    "status": "UPDATING",
    "creationTime": "2025-05-06T06:46:10.745000-07:00"
}

Paso 4: emparejamiento del clúster de Este de EE. UU. (Ohio) con el clúster de Este de EE. UU. (Norte de Virginia)

Para emparejar el clúster de Este de EE. UU. (Ohio) con el clúster de Este de EE. UU. (Norte de Virginia), utilice el comando update-cluster. Especifique el nombre del clúster Este de EE. UU. (Ohio) y una cadena JSON con el ARN del clúster Este de EE. UU. (Norte de Virginia).

aws dsql update-cluster \
--region us-east-2 \
--identifier 'foo0bar1baz2quux3quuxquux5' \
--multi-region-properties '{"witnessRegion": "us-west-2", "clusters": ["arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4"]}'

{
    "identifier": "foo0bar1baz2quux3quuxquux5",
    "arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
    "status": "UPDATING",
    "creationTime": "2025-05-06T06:51:16.145000-07:00"
}

Visualización de propiedades de clústeres multirregionales

Al describir un clúster, puede ver las propiedades multirregionales de los clústeres en diferentes Regiones de AWS.

aws dsql get-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4'

{
    "identifier": "foo0bar1baz2quux3quuxquux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
    "status": "PENDING_SETUP", 
    "encryptionDetails": {
    "encryptionType": "AWS_OWNED_KMS_KEY",
    "encryptionStatus": "ENABLED"
},
    "creationTime": "2024-11-27T00:32:14.434000-08:00",
    "deletionProtectionEnabled": false,
    "multiRegionProperties": {
       "witnessRegion": "us-west-2",
       "clusters": [
          "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
          "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5"
       ]
    }
}

Emparejamiento de clústeres durante la creación

Puede reducir el número de pasos si incluye información de emparejamiento durante la creación del clúster. Después de crear el primer clúster en Este de EE. UU. (Norte de Virginia) (paso 1), puede crear el segundo clúster en Este de EE. UU. (Ohio) mientras inicia simultáneamente el proceso de emparejamiento mediante la inclusión del ARN del primer clúster.

aws dsql create-cluster \
--region us-east-2 \
--multi-region-properties '{"witnessRegion":"us-west-2","clusters": ["arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4"]}'

Esto combina los pasos 2 y 4, pero aún deberá completar el paso 3 (actualizar el primer clúster con el ARN del segundo clúster) para establecer la relación de emparejamiento. Una vez completados todos los pasos, ambos clústeres pasarán por los mismos estados que en el proceso estándar: de PENDING_SETUP a CREATING y, finalmente, a ACTIVE cuando estén listos para utilizarse.

Eliminación de clústeres multirregionales

Para eliminar un clúster multirregional, debe completar dos pasos.

Actualización y eliminación del clúster en Este de EE. UU. (Norte de Virginia)

Actualización y eliminación del clúster en Este de EE. UU. (Ohio)