Administre los clústeres en Aurora DSQL con el AWS CLI - Amazon Aurora DSQL

Amazon Aurora DSQL se proporciona como un servicio de vista previa. Para obtener más información, consulte las versiones beta y las vistas previas en las condiciones del AWS servicio.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Administre los clústeres en Aurora DSQL con el AWS CLI

Consulte las siguientes secciones para obtener información sobre cómo administrar los clústeres con AWS CLI.

CreateCluster

Para crear un clúster, usa el create-cluster comando.

nota

La creación del clúster se produce de forma asíncrona. Llama a la GetCluster API hasta que el estado sea. ACTIVE Puede conectarse a un clúster una vez que se convierta enACTIVE.

Ejemplo de comando

aws dsql create-cluster --region us-east-1
nota

Si desea deshabilitar la protección contra la eliminación al crearla, incluya la --no-deletion-protection-enabled marca.

Respuesta de ejemplo

{ "identifier": "foo0bar1baz2quux3quuux4", "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuux4", "status": "CREATING", "creationTime": "2024-05-25T16:56:49.784000-07:00", "deletionProtectionEnabled": true }

GetCluster

Para describir un clúster, utilice el get-cluster comando.

Ejemplo de comando

aws dsql get-cluster \ --region us-east-1 \ --identifier <your_cluster_id>

Respuesta de ejemplo

{ "identifier": "foo0bar1baz2quux3quuux4", "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuux4", "status": "ACTIVE", "creationTime": "2024-05-24T09:15:32.708000-07:00", "deletionProtectionEnabled": false }

UpdateCluster

Para actualizar un clúster existente, utilice el update-cluster comando.

nota

Las actualizaciones se realizan de forma asíncrona. Llama a la GetCluster API hasta que se muestre el estado ACTIVE y podrás observar los cambios.

Ejemplo de comando

aws dsql update-cluster \ --region us-east-1 \ --no-deletion-protection-enabled \ --identifier your_cluster_id

Respuesta de ejemplo

{ "identifier": "foo0bar1baz2quux3quuux4", "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuux4", "status": "UPDATING", "creationTime": "2024-05-24T09:15:32.708000-07:00", "deletionProtectionEnabled": true }

DeleteCluster

Para eliminar un clúster existente, utilice el delete-cluster comando.

nota

Solo puede eliminar un clúster que tenga la protección de eliminación desactivada. La protección contra la eliminación está habilitada de forma predeterminada al crear nuevos clústeres.

Ejemplo de comando

aws dsql delete-cluster \ --region us-east-1 \ --identifier your_cluster_id

Respuesta de ejemplo

{ "identifier": "foo0bar1baz2quux3quuux4", "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuux4", "status": "DELETING", "creationTime": "2024-05-24T09:16:43.778000-07:00", "deletionProtectionEnabled": false }

ListClusters

Para obtener la a de los clústeres, utilice el list-clusters comando.

Ejemplo de comando

aws dsql list-clusters --region us-east-1

Respuesta de ejemplo

{ "clusters": [ { "identifier": "foo0bar1baz2quux3quux4quuux", "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quux4quuux" }, { "identifier": "foo0bar1baz2quux3quux4quuuux", "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quux4quuuux" }, { "identifier": "foo0bar1baz2quux3quux4quuuuux", "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quux4quuuuux" } ] }

CreateMultiRegionClusters

Para crear clústeres enlazados de varias regiones, utilice el create-multi-region-clusters comando. Puede ejecutar el comando desde cualquiera de las regiones de lectura y escritura del par de clústeres enlazados.

Ejemplo de comando

aws dsql create-multi-region-clusters \ --region us-east-1 \ --linked-region-list us-east-1 us-east-2 \ --witness-region us-west-2 \ --client-token test-1

Si la operación de la API se realiza correctamente, ambos clústeres enlazados pasan al CREATING estado y la creación del clúster se realizará de forma asíncrona. Para supervisar el progreso, puedes llamar a la GetCluster API de cada región hasta que el estado devuelto muestre ACTIVO. Puedes conectarte a un clúster una vez que ambos clústeres enlazados estén ACTIVOS.

nota

Durante la vista previa, si te encuentras con un clúster ACTIVE y otroFAILED, te recomendamos que elimines los clústeres enlazados y los vuelvas a crear.

{ "linkedClusterArns": [ "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuux4", "arn:aws:dsql:us-east-2:111122223333:cluster/bar0foo1baz2quux3quuux4" ] }

GetCluster en clústeres multirregionales

Para obtener información sobre un clúster multirregional, utilice el get-cluster comando. En el caso de los clústeres multirregionales, la respuesta incluirá el clúster vinculado. ARNs

Ejemplo de comando

aws dsql get-cluster \ --region us-east-1 \ --identifier your_cluster_id

Respuesta de ejemplo

{ "identifier": "aaabtjp7shql6wz7w5xqzpxtem", "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuux4", "status": "ACTIVE", "creationTime": "2024-07-17T10:24:23.325000-07:00", "deletionProtectionEnabled": true, "witnessRegion": "us-west-2", "linkedClusterArns": [ "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuux4", "arn:aws:dsql:us-east-2:111122223333:cluster/bar0foo1baz2quux3quuux4" ] }

DeleteMultiRegionClusters

Para eliminar clústeres de varias regiones, utilice la delete-multi-region-clusters operación desde cualquiera de las regiones del clúster vinculadas.

Tenga en cuenta que no puede eliminar solo una región de un par de clústeres vinculado.

Ejemplo de AWS CLI comando

aws dsql delete-multi-region-clusters \ --region us-east-1 --linked-cluster-arns "arn:aws:dsql:us-east-2:111122223333:cluster/bar0foo1baz2quux3quuux4" "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuux4"

Si esta operación de API se realiza correctamente, ambos clústeres entran en el DELETING estado. Para determinar el estado exacto de los clústeres, utilice la operación de la get-cluster API en cada clúster vinculado en su región correspondiente.

Respuesta de ejemplo

{ }