重启 Amazon DocumentDB实例

有时您可能需要重启 Amazon DocumentDB实例，这通常是出于维护原因。如果您进行了某些更改，例如更改与集群关联的集群参数组，则必须重启集群中的实例才能使更改生效。您可以使用 AWS 管理控制台或 AWS CLI. 重启指定的实例。

重启实例会重新启动数据库引擎服务。重启将导致短暂中断，在此期间，实例的状态将设置为 rebooting. 重新启动完成后，即会创建 Amazon DocumentDB 事件。

重启实例不会导致故障转移。要对 Amazon DocumentDB 集群进行故障转移，请使用 AWS 管理控制台或 AWS CLI 操作 failover-db-cluster. 有关更多信息，请参阅 Amazon DocumentDB故障转移.

如果实例未处于可用 状态，则无法重启实例。数据库可能会由于几个原因而不可用，例如，以前请求的修改或维护时段操作。有关实例状态的更多信息，请参阅监控 Amazon DocumentDB 实例的状态.

使用 重启实例AWS 管理控制台

以下过程将使用控制台重启您指定的实例。

  1. 通过以下网址登录 AWS 管理控制台并打开 Amazon DocumentDB 控制台：https://console.aws.amazon.com/docdb。

  2. 在导航窗格中，选择 Clusters.

    提示

    如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (重启 实例 - 图1)。

  3. 在“Clusters （集群）”导航窗格中，您将看到 Cluster Identifier （集群标识符） 列。您的实例将在集群下列出，与以下屏幕截图类似。

    重启 实例 - 图2

  4. 选中要重启的实例左侧的框。

  5. 选择 Actions （操作），选择 Reboot （重启），然后选择 Reboot （重启） 以确认重启。

实例重启需要几分钟时间。只有在实例状态为 available (可用). 时，才能使用实例。您可以使用控制台或 监控实例状态。AWS CLI. 有关更多信息，请参阅 监控 Amazon DocumentDB 实例的状态.

使用 重启实例AWS CLI

要重启 Amazon DocumentDB 实例，请使用具有 reboot-db-instance 参数的 --db-instance-identifier 操作。此参数指定要重启的实例的标识符。

以下代码将重启实例 sample-instance.

对于 Linux、macOS 或 Unix:

  1. aws docdb reboot-db-instance \
  2.        --db-instance-identifier sample-instance

对于 Windows:

  1. aws docdb reboot-db-instance ^
  2.        --db-instance-identifier sample-instance

此操作的输出将类似于下文。

  1. {
  2.     "DBInstance": {
  3.         "DBInstanceIdentifier": "sample-instance",
  4.         "DBInstanceClass": "db.r5.large",
  5.         "Engine": "docdb",
  6.         "DBInstanceStatus": "rebooting",
  7.         "Endpoint": {
  8.             "Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
  9.             "Port": 27017,   
  10.             "HostedZoneId": "ABCDEFGHIJKLM"
  11.         },
  12.         "InstanceCreateTime": "2020-03-27T08:05:56.314Z",
  13.         "PreferredBackupWindow": "02:00-02:30",
  14.         "BackupRetentionPeriod": 1,
  15.         "VpcSecurityGroups": [
  16.             {
  17.                 "VpcSecurityGroupId": "sg-abcd0123",
  18.                 "Status": "active"
  19.             }
  20.         ],
  21.         "AvailabilityZone": "us-east-1c",
  22.         "DBSubnetGroup": {
  23.             "DBSubnetGroupName": "default",
  24.             "DBSubnetGroupDescription": "default",
  25.             "VpcId": "vpc-abcd0123",
  26.             "SubnetGroupStatus": "Complete",
  27.             "Subnets": [
  28.                 {
  29.                     "SubnetIdentifier": "subnet-abcd0123",
  30.                     "SubnetAvailabilityZone": {
  31.                         "Name": "us-east-1a"
  32.                     },
  33.                     "SubnetStatus": "Active"
  34.                 },
  35.                 {
  36.                     "SubnetIdentifier": "subnet-wxyz0123",
  37.                     "SubnetAvailabilityZone": {
  38.                         "Name": "us-east-1b"
  39.                     },
  40.                     "SubnetStatus": "Active"
  41.                 }
  42.             ]
  43.         },
  44.         "PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
  45.         "PendingModifiedValues": {},
  46.         "EngineVersion": "3.6.0",
  47.         "AutoMinorVersionUpgrade": true,
  48.         "PubliclyAccessible": false,
  49.         "DBClusterIdentifier": "sample-cluster",
  50.         "StorageEncrypted": true,
  51.         "KmsKeyId": "arn:aws:kms:us-east-1:<accountID>:key/sample-key",
  52.         "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
  53.         "CACertificateIdentifier": "rds-ca-2019",
  54.         "PromotionTier": 1,
  55.         "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance",
  56.         "EnabledCloudwatchLogsExports": [
  57.             "profiler"
  58.         ]
  59.     }
  60. }
  61.

实例重启需要几分钟时间。只有在实例状态为 available (可用). 时，才能使用实例。您可以使用控制台或 监控实例状态。AWS CLI. 有关更多信息，请参阅 监控 Amazon DocumentDB 实例的状态.