Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

将 Amazon DocumentDB 作为 Amazon Database Migration Service 的目标

有关 Amazon DMS 支持哪些版本的 Amazon DocumentDB（与 MongoDB 兼容）的信息，请参阅的目标 Amazon DMS。您可以使用 Amazon DMS 将数据从 Amazon DMS 支持的任一源数据引擎迁移到 Amazon DocumentDB（与 MongoDB 兼容）。该引擎可以位于 Amazon 托管服务（如 Amazon RD、Aurora 或 Amazon S3）上。或者，该引擎可以位于自管理数据库（如在 Amazon EC2 上或本地运行的 MongoDB）上。

您可以使用 Amazon DMS 将源数据复制到 Amazon DocumentDB 数据库、集合或文档。

MongoDB 以二进制 JSON 格式 (BSON) 存储数据。Amazon DMS 支持 Amazon DocumentDB 支持的所有 BSON 数据类型。有关这些数据类型的列表，请参阅《Amazon DocumentDB 开发人员指南》中的支持的 MongoDB API、操作和数据类型。

如果源端点是关系数据库，则 Amazon DMS 会将数据库对象映射到 Amazon DocumentDB，如下所示：

如果源端点为 Amazon S3，则生成的 Amazon DocumentDB 对象对应于 Amazon S3 的 Amazon DMS 映射规则。例如，考虑以下 URI。

s3://mybucket/hr/employee

在这种情况下，Amazon DMS 将 mybucket 中的对象映射到 Amazon DocumentDB，如下所示：

有关 Amazon S3 的映射规则的更多信息，请参阅将 Amazon S3 作为 Amazon DMS 的源。

有关将 Amazon DocumentDB 作为 Amazon DMS 目标的其他详细信息，请参阅以下章节：

将数据从源映射到 Amazon DocumentDB 目标

Amazon DMS 从源终端节点读取记录，并基于它所读取的数据来构建 JSON 文档。对于每个 JSON 文档，Amazon DMS 必须确定一个 _id 字段以充当唯一标识符。然后，它使用 _id 字段作为主键，将 JSON 文档写入到 Amazon DocumentDB 集合。

单列源数据

如果源数据包含单个列，则数据必须是字符串类型。（根据源引擎，实际数据类型可能是 VARCHAR、NVARCHAR、TEXT、LOB、CLOB 或类似类型。）Amazon DMS 假定数据是有效的 JSON 文档，并按原样将数据复制到 Amazon DocumentDB。

如果生成的 JSON 文档包含名为 _id 的字段，则该字段用作 Amazon DocumentDB 中的唯一 _id。

如果 JSON 不包含 _id 字段，则 Amazon DocumentDB 会自动生成 _id 值。

多列源数据

如果源数据包含多个列，则 Amazon DMS 根据所有这些列来构建 JSON 文档。要确定文档的 _id 字段，Amazon DMS 按如下方式继续：

在目标终端节点强制转换数据类型

Amazon DMS 可以在数据写入到 Amazon DocumentDB 目标端点时修改数据结构。可以通过在源终端节点重命名列和表，或者通过提供运行任务时所应用的转换规则来请求这些更改。

使用嵌套 JSON 文档（json_ 前缀）

要强制转换数据类型，可以手动或使用转换的方式在源列名称中加上前缀 json_（即 json_columnName）。在这种情况下，该列作为目标文档中的嵌套 JSON 文档（而不是作为字符串字段）而创建。

例如，假设您要从 MongoDB 源终端节点迁移以下文档。

{
    "_id": "1", 
    "FirstName": "John", 
    "LastName": "Doe",
    "ContactDetails": "{"Home": {"Address": "Boston","Phone": "1111111"},"Work": { "Address": "Boston", "Phone": "2222222222"}}"
}

如果不强制转换任何源数据类型，则嵌入的 ContactDetails 文档将作为字符串进行迁移。

{
    "_id": "1", 
    "FirstName": "John", 
    "LastName": "Doe",
    "ContactDetails": "{\"Home\": {\"Address\": \"Boston\",\"Phone\": \"1111111\"},\"Work\": { \"Address\": \"Boston\", \"Phone\": \"2222222222\"}}"
}

但是，可以添加一个转换规则，以将 ContactDetails 强制转换为 JSON 对象。例如，假设原始源列名称为 ContactDetails。要将数据类型强制为嵌套 JSON，需要手动或通过转换规则在源端点上添加“*json_*”前缀，将源端点的列重命名为“json_contactDetails”。例如，您可以使用以下转换规则：

{
    "rules": [
    {
    "rule-type": "transformation",
    "rule-id": "1",
    "rule-name": "1",
    "rule-target": "column",
    "object-locator": {
    "schema-name": "%",
    "table-name": "%",
    "column-name": "ContactDetails"
     },
    "rule-action": "rename",
    "value": "json_ContactDetails",
    "old-value": null
    }
    ]
}
                    

Amazon DMS 将 ContactDetails 字段复制为嵌套 JSON，如下所示。

{
    "_id": "1",
    "FirstName": "John",
    "LastName": "Doe",
    "ContactDetails": {
        "Home": {
            "Address": "Boston",
            "Phone": "1111111111"
        },
        "Work": {
            "Address": "Boston",
            "Phone": "2222222222"
        }
    }
}

使用 JSON 数组（array_ 前缀）

要强制转换数据类型，可以手动或使用转换的方式在列名称中加上前缀 array_（即 array_columnName）。在这种情况下，Amazon DMS 将该列视为 JSON 数组，并在目标文档中以这种方式创建它。

假设您要从 MongoDB 源终端节点迁移以下文档。

{
    "_id" : "1",
    "FirstName": "John",
    "LastName": "Doe",

    "ContactAddresses": ["Boston", "New York"],
            
    "ContactPhoneNumbers": ["1111111111", "2222222222"]
}

如果不强制转换任何源数据类型，则嵌入的 ContactDetails 文档将作为字符串进行迁移。

{
    "_id": "1",
    "FirstName": "John",
    "LastName": "Doe",

    "ContactAddresses": "[\"Boston\", \"New York\"]",
            
    "ContactPhoneNumbers": "[\"1111111111\", \"2222222222\"]"

}                

但是，您可以添加转换规则，以将 ContactAddress 和 ContactPhoneNumbers 强制转换为 JSON 数组，如下表所示。

Amazon DMS 复制 ContactAddress 和 ContactPhoneNumbers，如下所示。

{
    "_id": "1",
    "FirstName": "John",
    "LastName": "Doe",
    "ContactAddresses": [
        "Boston",
        "New York"
    ],
    "ContactPhoneNumbers": [
        "1111111111",
        "2222222222"
    ]
}             

使用 TLS 连接到 Amazon DocumentDB

默认情况下，新创建的 Amazon DocumentDB 集群仅接受使用传输层安全性协议 (TLS) 的安全连接。当 TLS 启用时，每个到 Amazon DocumentDB 的连接都需要公有密钥。

您可以通过从 Amazon 托管的 Amazon S3 存储桶下载文件 rds-combined-ca-bundle.pem 来检索 Amazon DocumentDB 的公钥。有关下载此文件的更多信息，请参阅《Amazon DocumentDB 开发人员指南》中的使用 TLS 加密连接

下载此 .pem 文件后，您可以将该文件包含的公有密钥导入到 Amazon DMS 中，如下所述。

Amazon Web Services Management Console

Amazon CLI

使用 aws dms import-certificate 命令，如以下示例所示。

aws dms import-certificate \
    --certificate-identifier docdb-cert \
    --certificate-pem file://./rds-combined-ca-bundle.pem

创建 Amazon DMS 目标终端节点时，请提供证书标识符（例如 docdb-cert）。另外，请将 SSL 模式参数设置为 verify-full。

连接到 Amazon DocumentDB 弹性集群作为目标

在 Amazon DMS 版本 3.4.7 及更高版本中，您可以创建 Amazon DocumentDB 目标端点作为弹性集群。如果您将目标端点创建为弹性集群，则需要将新的 SSL 证书附加到您的 Amazon DocumentDB 弹性集群节点，因为您的现有 SSL 证书无法使用。

下载的 SFSRootCAG2.pem 文件中的新 SSL 证书现已附加到您的 Amazon DocumentDB 弹性集群端点。

以 Amazon DocumentDB 作为目标的持续复制

如果以 Amazon DocumentDB 为目标启用持续复制（变更数据捕获，CDC），则 Amazon DMS 版本 3.5.0 及更高版本提供的性能提升将是之前版本的 20 倍。在之前的版本中，Amazon DMS 每秒最多可处理 250 条记录，Amazon DMS 现在每秒处理大约 5000 条记录。Amazon DMS 还可确保 Amazon DocumentDB 中的文档与源文件保持同步。创建或更新源记录时，Amazon DMS 必须首先通过执行以下操作来确定哪个 Amazon DocumentDB 记录受到影响：

创建新的源记录后，Amazon DMS 会将相应文档写入 Amazon DocumentDB。如果更新了现有的源记录，则 Amazon DMS 会更新 Amazon DocumentDB 中的目标文档中的相应字段。目标文档中存在而源记录中不存在的任何字段均保持不变。

删除源记录后，Amazon DMS 会从 Amazon DocumentDB 中删除相应文档。

源位置的结构变更 (DDL)

通过持续复制，对源数据结构（如表、列等）的任何更改都将传播到其在 Amazon DocumentDB 中的对应项。在关系数据库中，通过使用数据定义语言 (DDL) 语句启动这些更改。可以在下表中查看 Amazon DMS 如何将这些更改传播到 Amazon DocumentDB。

使用 Amazon DocumentDB 作为目标的限制

将 Amazon DocumentDB 作为 Amazon DMS 的目标时存在以下限制：

使用以 Amazon DocumentDB 为目标的端点设置

您可以使用端点设置来配置 Amazon DocumentDB 目标，这与使用额外连接属性类似。您可以在使用 Amazon DMS 控制台创建目标端点时指定设置，或者在 Amazon CLI 中使用符合 --doc-db-settings '{"EndpointSetting": "value", ...}' JSON 语法的 create-endpoint 命令。

下表显示了在将 Amazon DocumentDB 作为目标时可以使用的端点设置。

Amazon DocumentDB 的目标数据类型

在下表中，您可以找到使用 Amazon DMS 时支持的 Amazon DocumentDB 目标数据类型以及来自 Amazon DMS 数据类型的默认映射。有关 Amazon DMS 数据类型的更多信息，请参阅Amazon Database Migration Service 的数据类型。