# 还原 Aurora Serverless v1 数据库集群
<a name="aurora-serverless.restorefromsnapshot"></a>

**重要**  
AWS 已[宣布 Aurora Serverless v1 的生命周期终止日期为：2025 年 3 月 31 日](https://repost.aws/questions/QUhcMVoChXRm2HLi8F-yih1g/announcement-support-for-aurora-s/announcement-support-for-aurora-serverless-v1-ending-soon)。所有在 2025 年 3 月 31 日之前未迁移的 Aurora Serverless v1 集群都将在维护时段内迁移到 Aurora Serverless v2。如果升级失败，Amazon Aurora 会在维护时段内将 Serverless v1 集群转换为具有等效引擎版本的预置集群。如果适用，Amazon Aurora 将在 Amazon RDS 扩展支持中注册转换后的预置集群。有关更多信息，请参阅 [Amazon Aurora 的 Amazon RDS 扩展支持](extended-support.md)。

 当您使用 AWS CLI 或 RDS API 还原预调配数据库集群快照时，可以配置 Aurora Serverless v1 数据库集群。

 在将快照还原到 Aurora Serverless v1 数据库集群时，您可以设置以下特定值：
+  **Minimum Aurora capacity unit (最小 Aurora 容量单元)** – Aurora Serverless v1 可以将容量减少到该容量单元。
+  **Maximum Aurora capacity unit (最大 Aurora 容量单元)** – Aurora Serverless v1 可以将容量增加到该容量单元。
+  **超时操作** – 当容量修改操作因找不到扩展点而超时时要执行的操作。Aurora Serverless v1如果设置了 **Force scaling the capacity to the specified values... (强制将容量扩展至指定值…)** 选项，数据库集群就可以强制数据库集群使用新的容量设置。或者，如果您不选择该选项，它将可以回滚容量更改以取消它。有关更多信息，请参阅“[容量更改超时操作](aurora-serverless-v1.how-it-works.md#aurora-serverless.how-it-works.timeout-action)”。
+  **不活动后暂停** – 从无数据库流量到缩减到零处理容量之间的时间长度。当数据库流量恢复后，Aurora 将自动恢复处理容量并进行扩展以处理流量。

 有关从快照还原数据库集群的一般信息，请参阅[从数据库集群快照还原](aurora-restore-snapshot.md)。

## AWS CLI
<a name="aurora-serverless.restorefromsnapshot.cli"></a>

您可以在使用 AWS 管理控制台、AWS CLI 或 RDS API 还原预置数据库集群快照时配置 Aurora Serverless 数据库集群。

在将快照还原到 Aurora Serverless 数据库集群时，您可以设置以下特定值：
+ **Minimum Aurora capacity unit (最小 Aurora 容量单元)** – Aurora Serverless 可以将容量减少到该容量单元。
+ **Maximum Aurora capacity unit (最大 Aurora 容量单元)** – Aurora Serverless 可以将容量增加到该容量单元。
+ **超时操作** – 当容量修改操作因找不到扩展点而超时时要执行的操作。Aurora Serverless v1如果设置了 **Force scaling the capacity to the specified values... (强制将容量扩展至指定值…)** 选项，数据库集群就可以强制数据库集群使用新的容量设置。或者，如果您不选择该选项，它将可以回滚容量更改以取消它。有关更多信息，请参阅“[容量更改超时操作](aurora-serverless-v1.how-it-works.md#aurora-serverless.how-it-works.timeout-action)”。
+ **不活动后暂停** – 从无数据库流量到缩减到零处理容量之间的时间长度。当数据库流量恢复后，Aurora 将自动恢复处理容量并进行扩展以处理流量。

**注意**  
数据库集群快照的版本必须与 Aurora Serverless v1 兼容。有关所支持版本的列表，请参阅 [Aurora Serverless v1](Concepts.Aurora_Fea_Regions_DB-eng.Feature.ServerlessV1.md)。

 要将快照还原到与 MySQL 5.7 兼容的 Aurora Serverless v1 集群，请包括以下附加参数：
+  `--engine aurora-mysql` 
+  `--engine-version 5.7` 

 `--engine` 和 `--engine-version` 参数允许您从与 MySQL 5.6 兼容的 Aurora 或 Aurora Serverless v1 快照，创建与 MySQL 5.7 兼容的 Aurora Serverless v1 集群。以下示例将快照从名为 *mydbclustersnapshot* 的与 MySQL 5.6 兼容的集群，还原到名为 *mynewdbcluster* 的与 MySQL 5.7 兼容的 Aurora Serverless v1 集群。

对于 Linux、macOS 或 Unix：

```
aws rds restore-db-cluster-from-snapshot \
    --db-cluster-identifier mynewdbcluster \
    --snapshot-identifier mydbclustersnapshot \
    --engine-mode serverless \
    --engine aurora-mysql \
    --engine-version 5.7
```

对于 Windows：

```
aws rds restore-db-cluster-from-snapshot ^
    --db-instance-identifier mynewdbcluster ^
    --db-snapshot-identifier mydbclustersnapshot ^
    --engine aurora-mysql ^
    --engine-version 5.7
```

 您可以选择指定 `--scaling-configuration` 选项来配置最小容量、最大容量以及无连接时的自动暂停。有效的容量值包括：
+  Aurora MySQL：`1`、`2`、`4`、`8`、`16`、`32`、`64`、`128` 和 `256`。
+  Aurora PostgreSQL：`2`、`4`、`8`、`16`、`32`、`64`、`192` 和 `384`。

 在以下示例中，您将从之前创建的名为 *mydbclustersnapshot* 的数据库集群，还原到名为 *mynewdbcluster* 的新数据库集群。您可以设置 `--scaling-configuration`，以便新 Aurora Serverless v1 数据库集群可以根据需要，从 8 ACU 扩展到 64 ACU（Aurora 容量单元），以处理工作负载。处理完成且没有支持的连接 1000 秒后，集群将关闭，直到连接请求提示它重新启动。

对于 Linux、macOS 或 Unix：

```
aws rds restore-db-cluster-from-snapshot \
    --db-cluster-identifier mynewdbcluster \
    --snapshot-identifier mydbclustersnapshot \
    --engine-mode serverless --scaling-configuration MinCapacity=8,MaxCapacity=64,TimeoutAction='ForceApplyCapacityChange',SecondsUntilAutoPause=1000,AutoPause=true
```

对于 Windows：

```
aws rds restore-db-cluster-from-snapshot ^
    --db-instance-identifier mynewdbcluster ^
    --db-snapshot-identifier mydbclustersnapshot ^
    --engine-mode serverless --scaling-configuration MinCapacity=8,MaxCapacity=64,TimeoutAction='ForceApplyCapacityChange',SecondsUntilAutoPause=1000,AutoPause=true
```

## RDS API
<a name="aurora-serverless.restorefromsnapshot.api"></a>

 要在使用 RDS API 从数据库集群中还原时配置 Aurora Serverless v1 数据库集群，请运行 [RestoreDBClusterFromSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterFromSnapshot.html) 操作并为 `serverless` 参数指定 `EngineMode`。

 您可以选择指定 `ScalingConfiguration` 参数来配置最小容量、最大容量以及无连接时的自动暂停。有效的容量值包括：
+  Aurora MySQL：`1`、`2`、`4`、`8`、`16`、`32`、`64`、`128` 和 `256`。
+  Aurora PostgreSQL：`2`、`4`、`8`、`16`、`32`、`64`、`192` 和 `384`。