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
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
{ }