使用 AWS CLI 的 Aurora DSQL
请参阅以下各节,了解如何使用 AWS CLI 管理集群。
CreateCluster
要创建集群,请使用 create-cluster
命令。
注意
集群创建是异步进行的。调用 GetCluster
API,直到状态为 ACTIVE
。一旦集群变为 ACTIVE
,您就可以连接到该集群。
示例命令
aws dsql create-cluster --region us-east-1
注意
如果要在创建时禁用删除保护,请添加 --no-deletion-protection-enabled
标志。
示例响应
{ "identifier": "abc0def1baz2quux3quuux4", "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4", "status": "CREATING", "creationTime": "2025-05-22T14:03:26.631000-07:00", "encryptionDetails": { "encryptionType": "AWS_OWNED_KMS_KEY", "encryptionStatus": "ENABLED" }, "deletionProtectionEnabled": true }
GetCluster
要描述集群,请使用 get-cluster
命令。
示例命令
aws dsql get-cluster \ --region us-east-1 \ --identifier
<your_cluster_id>
示例响应
{ "identifier": "abc0def1baz2quux3quuux4", "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4", "status": "ACTIVE", "creationTime": "2025-05-22T14:03:26.631000-07:00", "deletionProtectionEnabled": true, "tags": {}, "encryptionDetails": { "encryptionType": "AWS_OWNED_KMS_KEY", "encryptionStatus": "ENABLED" } }
UpdateCluster
要更新现有集群,请使用 update-cluster
命令。
注意
更新是异步进行的。调用 GetCluster
API 直到状态为 ACTIVE
,您将观察到更改。
示例命令
aws dsql update-cluster \ --region us-east-1 \ --no-deletion-protection-enabled \ --identifier
your_cluster_id
示例响应
{
"identifier": "abc0def1baz2quux3quuux4",
"arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
"status": "UPDATING",
"creationTime": "2024-05-24T09:15:32.708000-07:00"
}
DeleteCluster
要删除现有集群,请使用 delete-cluster
命令。
注意
您只能删除禁用了删除保护的集群。在创建新集群时,默认启用删除保护。
示例命令
aws dsql delete-cluster \ --region us-east-1 \ --identifier
your_cluster_id
示例响应
{
"identifier": "abc0def1baz2quux3quuux4",
"arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
"status": "DELETING",
"creationTime": "2024-05-24T09:16:43.778000-07:00"
}
ListClusters
要获取集群的列表,请使用 list-clusters
命令。
示例命令
aws dsql list-clusters --region us-east-1
示例响应
{ "clusters": [ { "identifier": "abc0def1baz2quux3quux4quuux", "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quux4quuux" }, { "identifier": "abc0def1baz2quux3quux4quuuux", "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quux4quuuux" } ] }
多区域集群上的 GetCluster
要获取有关多区域集群的信息,请使用 get-cluster
命令。对于多区域集群,响应将包括关联的集群 ARN。
示例命令
aws dsql get-cluster \ --region us-east-1 \ --identifier
your_cluster_id
示例响应
{ "identifier": "abc0def1baz2quux3quuux4", "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4", "status": "ACTIVE", "creationTime": "2025-05-22T13:56:18.716000-07:00", "deletionProtectionEnabled": true, "multiRegionProperties": { "witnessRegion": "us-west-2", "clusters": [ "arn:aws:dsql:us-east-1:842685632318:cluster/fuabuc7d3szkr37uqd5znkjynu" ] }, "tags": {}, "encryptionDetails": { "encryptionType": "AWS_OWNED_KMS_KEY", "encryptionStatus": "ENABLED" } }