重启 Amazon DocumentDB 实例 - Amazon DocumentDB

重启 Amazon DocumentDB 实例

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

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

重启实例不会导致失效转移。要对 Amazon DocumentDB 集群进行失效转移，请使用 AWS Management Console 或 AWS CLI 操作 failover-db-cluster。有关更多信息，请参阅 Amazon DocumentDB 失效转移。

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

Using the AWS Management Console

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

  1. 登录到 AWS Management Console 并打开 Amazon DocumentDB 控制台，网址：https://console.aws.amazon.com/docdb。

  2. 在导航窗格中，选择 Clusters（集群）。

    提示

    如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (Hamburger menu icon with three horizontal lines.)。

  3. 在集群导航框中，您将看到“集群标识符”列。您的实例列于集群下，类似于以下屏幕截图。

    DocumentDB clusters list showing two clusters with their identifiers and roles.

  4. 勾选您希望重启的实例左侧的复选框。

  5. 选择 Actions (操作)、Reboot (重启)，然后选择 Reboot (重启) 以确认重启。

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

Using the AWS CLI

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

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

对于 Linux、macOS 或 Unix：

aws docdb reboot-db-instance \
       --db-instance-identifier sample-instance

对于 Windows：

aws docdb reboot-db-instance ^
       --db-instance-identifier sample-instance

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

{
    "DBInstance": {
        "DBInstanceIdentifier": "sample-instance",
        "DBInstanceClass": "db.r5.large",
        "Engine": "docdb",
        "DBInstanceStatus": "rebooting",
        "Endpoint": {
            "Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
            "Port": 27017,   
            "HostedZoneId": "ABCDEFGHIJKLM"
        },
        "InstanceCreateTime": "2020-03-27T08:05:56.314Z",
        "PreferredBackupWindow": "02:00-02:30",
        "BackupRetentionPeriod": 1,
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-abcd0123",
                "Status": "active"
            }
        ],
        "AvailabilityZone": "us-east-1c",
        "DBSubnetGroup": {
            "DBSubnetGroupName": "default",
            "DBSubnetGroupDescription": "default",
            "VpcId": "vpc-abcd0123",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-abcd0123",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1a"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-wxyz0123",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1b"
                    },
                    "SubnetStatus": "Active"
                }
            ]
        },
        "PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
        "PendingModifiedValues": {},
        "EngineVersion": "3.6.0",
        "AutoMinorVersionUpgrade": true,
        "PubliclyAccessible": false,
        "DBClusterIdentifier": "sample-cluster",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:<accountID>:key/sample-key",
        "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "CACertificateIdentifier": "rds-ca-2019",
        "PromotionTier": 1,
        "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance",
        "EnabledCloudwatchLogsExports": [
            "profiler"
        ]
    }
}

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