本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 3： AWS DMS 源端点：创建、为 Mongo 数据库创建、为 S3 创建 您可以使用 AMS 控制台或 API/CLI 为各种数据库创建 AMS DMS 源端点，我们提供了三个示例。 ## DMS 源端点：创建 ### 使用控制台创建 DMS 源端点 AMS 控制台中此更改类型的屏幕截图： ![](http://docs.aws.amazon.com/zh_cn/managedservices/latest/appguide/images/guiDmsCreateSourceEpCT.png) 工作原理： 1. 导航到 “**创建 RFC**” 页面：在 AMS 控制台的左侧导航窗格中，单击**RFCs**打开 RFCs 列表页面，然后单击 “**创建 R** FC”。 1. 在默认的 “**浏览更改类型” 视图中选择常用更改类型** (CT)，或者在 “**按类别选择” 视图中选择** CT。 + **按更改类型浏览**：您可以单击 “**快速创建**” 区域中的常用 CT，立即打开 “**运行 RFC**” 页面。请注意，您不能使用快速创建来选择较旧的 CT 版本。 要进行排序 CTs，请使用**卡片**视图或**表格**视图中的**所有更改类型**区域。在任一视图中，选择一个 CT，然后单击 “**创建 RFC**” 打开 “**运行 RFC**” 页面。如果适用，“**创建 RFC” 按钮旁边会出现 “使用旧版本****创建**” 选项。 + **按类别选择：选择类别**、子类别、项目和操作，CT 详细信息框将打开，并显示 “使用**旧版本创建**” 选项（如果适用）。单击 “**创建 RFC**” 打开 “**运行 RFC**” 页面。 1. 在 “**运行 RFC**” 页面上，打开 CT 名称区域以查看 CT 详细信息框。必须填写**主题**（如果您在 “**浏览更改类型**” 视图中选择 CT，则会为您填写此主题）。打开**其他配置**区域以添加有关 RFC 的信息。 在**执行配置**区域中，使用可用的下拉列表或输入所需参数的值。要配置可选的执行参数，请打开**其他配置**区域。 1. 完成后，单击 “**运行**”。如果没有错误，则会显示**成功创建的 RFC** 页面，其中包含已提交的 RFC 详细信息和初始**运行**输出。 1. 打开**运行参数**区域以查看您提交的配置。刷新页面以更新 RFC 的执行状态。（可选）取消 RFC 或使用页面顶部的选项创建一个 RFC 的副本。 ### 使用 CLI 创建 DMS 源端点 工作原理： 1. 使用 Inline Create（您发出包含所有 RFC 和执行参数的`create-rfc`命令）或模板创建（创建两个 JSON 文件，一个用于 RFC 参数，一个用于执行参数），然后以这两个文件作为输入发出`create-rfc`命令。这里描述了这两种方法。 1. 提交带有返回的 RFC ID 的 RFC: `aws amscm submit-rfc --rfc-id {{ID}}` 命令。 监控 RFC: `aws amscm get-rfc --rfc-id {{ID}}` 命令。 要检查更改类型版本，请使用以下命令： ``` aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value={{CT_ID}} ``` **注意** 您可以将任何`CreateRfc`参数与任何 RFC 一起使用，无论它们是否属于变更类型的架构的一部分。例如，要在 RFC 状态更改时收到通知，请将此行添加到请求的 RFC 参数部分（不是执行参数）。`--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"`有关所有 CreateRfc 参数的列表，请参阅《[AMS 变更管理 API 参考](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html)》。 *内联创建*： 使用内联提供的执行参数（内联提供执行参数时使用转义引号）发出 create RFC 命令，然后提交返回的 RFC ID。例如，你可以用这样的东西替换内容： ``` aws --profile saml --region us-east-1 amscm create-rfc --title "{{MariaDB-DMS-Source-Endpoint}}" --aws-account-id {{ACCOUNT-ID}} --change-type-id ct-0attesnjqy2cx --change-type-version 1.0 --execution-parameters "{\"Description\":\"{{DESCRIPTION.}}\",\"VpcId\":\"{{VPC-ID}}\",\"Name\":\"{{MariaDB-DMS-SE}}\",\"Parameters\":{\"EngineName\":\"{{mariadb}}\",\"ServerName\":\"{{mariadb.db.example.com}}\",\"Port\":{{3306}},\"Username\":\"{{DB-USER}}\",\"Password\":\"{{DB-PW}}\"},\"TimeoutInMinutes\":60,\"StackTemplateId\":\"stm-pud4ghhkp7395n9bc\"}" ``` *模板创建*： 1. 将此更改类型的执行参数输出到名为 CreateDmsSeParams .json 的 JSON 文件中。 ``` aws amscm get-change-type-version --change-type-id "ct-0attesnjqy2cx" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateDmsSeParams.json ``` 1. 修改并保存执行参数 JSON 文件。例如，你可以用这样的东西替换内容： ``` { "Description": "{{MariaDB-DMS-SE}}", "VpcId": "{{VPC_ID}}", "Name": "{{Test SE}}", "StackTemplateId": "stm-pud4ghhkp7395n9bc", "TimeoutInMinutes": {{60}}, "Parameters": { "Description": "{{DESCRIPTION}}", "EngineName": "{{mariadb}}", "ServerName": "{{mariadb.db.example.com}}", "Port": "{{3306}}", "Username": "{{DB-USER}}", "Password": "{{DB-PW}}",} } } ``` 1. 将 JSON 模板输出到当前文件夹中的一个文件中；此示例将其命名为 CreateDmsSeRfc .json： ``` aws amscm create-rfc --generate-cli-skeleton > CreateDmsSeRfc.json ``` 1. 修改并保存 CreateDmsSeRfc .json 文件。例如，你可以用这样的东西替换内容： ``` { "ChangeTypeVersion": "{{1.0}}", "ChangeTypeId": "ct-0attesnjqy2cx", "Title": "{{MariaDB-DMS-Source-Endpoint}}" } ``` 1. 创建 RFC，指定执行参数文件和 CreateDmsSeRfc 文件： ``` aws amscm create-rfc --cli-input-json file://CreateDmsSeRfc.json --execution-parameters file://CreateDmsSeParams.json ``` 您在响应中收到新 RFC 的 ID，并可以使用它来提交和监控 RFC。在您提交之前，RFC 仍处于编辑状态且无法启动。 ### 提示 在创建 DMS 端点之前，请确保您的密码不包含不支持的字符。有关更多信息，请参阅*AWS Database Migration Service 用户指南*中的[创建源端点和目标端点](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.Creating.html)。 要了解更多信息，[请参阅数据迁移来源](https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Source.html)。 有关 S3 源终端节点，请参阅[适用于 S3 的 DMS 源端点：创建](#ex-dms-se-s3-create-col)。 有关 Mongo 数据库源端点的信息，请参阅[适用于 MongoDB 的 DMS 源端点：正在创建](#ex-dms-se-mongo-create-col)。 ## 适用于 MongoDB 的 DMS 源端点：正在创建 ### 使用控制台创建 DMS Mongo 数据库源端点 AMS 控制台中此更改类型的屏幕截图： ![](http://docs.aws.amazon.com/zh_cn/managedservices/latest/appguide/images/guiDmsCreateSourceEpMongoCT.png) 工作原理： 1. 导航到 “**创建 RFC**” 页面：在 AMS 控制台的左侧导航窗格中，单击**RFCs**打开 RFCs 列表页面，然后单击 “**创建 R** FC”。 1. 在默认的 “**浏览更改类型” 视图中选择常用更改类型** (CT)，或者在 “**按类别选择” 视图中选择** CT。 + **按更改类型浏览**：您可以单击 “**快速创建**” 区域中的常用 CT，立即打开 “**运行 RFC**” 页面。请注意，您不能使用快速创建来选择较旧的 CT 版本。 要进行排序 CTs，请使用**卡片**视图或**表格**视图中的**所有更改类型**区域。在任一视图中，选择一个 CT，然后单击 “**创建 RFC**” 打开 “**运行 RFC**” 页面。如果适用，“**创建 RFC” 按钮旁边会出现 “使用旧版本****创建**” 选项。 + **按类别选择：选择类别**、子类别、项目和操作，CT 详细信息框将打开，并显示 “使用**旧版本创建**” 选项（如果适用）。单击 “**创建 RFC**” 打开 “**运行 RFC**” 页面。 1. 在 “**运行 RFC**” 页面上，打开 CT 名称区域以查看 CT 详细信息框。必须填写**主题**（如果您在 “**浏览更改类型**” 视图中选择 CT，则会为您填写此主题）。打开**其他配置**区域以添加有关 RFC 的信息。 在**执行配置**区域中，使用可用的下拉列表或输入所需参数的值。要配置可选的执行参数，请打开**其他配置**区域。 1. 完成后，单击 “**运行**”。如果没有错误，则会显示**成功创建的 RFC** 页面，其中包含已提交的 RFC 详细信息和初始**运行**输出。 1. 打开**运行参数**区域以查看您提交的配置。刷新页面以更新 RFC 的执行状态。（可选）取消 RFC 或使用页面顶部的选项创建一个 RFC 的副本。 ### 使用 CLI 创建 DMS Mongo 数据库源端点 工作原理： 1. 使用 Inline Create（您发出包含所有 RFC 和执行参数的`create-rfc`命令）或模板创建（创建两个 JSON 文件，一个用于 RFC 参数，一个用于执行参数），然后以这两个文件作为输入发出`create-rfc`命令。这里描述了这两种方法。 1. 提交带有返回的 RFC ID 的 RFC: `aws amscm submit-rfc --rfc-id {{ID}}` 命令。 监控 RFC: `aws amscm get-rfc --rfc-id {{ID}}` 命令。 要检查更改类型版本，请使用以下命令： ``` aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value={{CT_ID}} ``` **注意** 您可以将任何`CreateRfc`参数与任何 RFC 一起使用，无论它们是否属于变更类型的架构的一部分。例如，要在 RFC 状态更改时收到通知，请将此行添加到请求的 RFC 参数部分（不是执行参数）。`--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"`有关所有 CreateRfc 参数的列表，请参阅《[AMS 变更管理 API 参考](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html)》。 *内联创建*： 使用内联提供的执行参数（内联提供执行参数时使用转义引号）发出 create RFC 命令，然后提交返回的 RFC ID。例如，你可以用这样的东西替换内容： ``` aws amscm --profile saml --region us-east-1 create-rfc --change-type-id "ct-2hxcllf1b4ey0" --change-type-version "1.0" --title '{{DMS_Source_MongoDB}}' --description "{{DESCRIPTION}}" --execution-parameters "{\"Description\":\"{{DMS_MongoDB_Source_Endpoint}}\",\"VpcId\":\"{{VPC_ID}}\",\"Name\":\"{{DMS-Mongo-SE}}\",\"StackTemplateId\":\"stm-pud4ghhkp7395n9bc\",\"TimeoutInMinutes\":60,\"Parameters\":{\"DatabaseName\":\"{{mytestdb}}\",\"EngineName\":\"mongodb\",\"Port\":{{27017}},\"ServerName\":\"{{test.example.com}}\"}}" ``` *模板创建*： 1. 将此更改类型的执行参数输出到名为 CreateDmsSeMongoParams .json 的 JSON 文件中。 ``` aws amscm get-change-type-version --change-type-id "ct-2hxcllf1b4ey0" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateDmsSeMongoParams.json ``` 1. 修改并保存执行参数 JSON 文件。例如，你可以用这样的东西替换内容： ``` { "Description": "{{MongoDB-DMS-SE}}", "VpcId": "{{VPC_ID}}", "StackTemplateId": "stm-pud4ghhkp7395n9bc", "Name": "{{Test Mongo SE}}", "TimeoutInMinutes": {{60}}, "Parameters": { "Description": "{{DESCRIPTION}}", "DatabaseName": "{{mytestdb}}", "EngineName": "{{mongodb}}", "ServerName": "{{test.example.com}}", "Port": "{{27017}}" } } ``` 1. 将 JSON 模板输出到当前文件夹中的一个文件中；此示例将其命名为 CreateDmsSeMongoRfc .json： ``` aws amscm create-rfc --generate-cli-skeleton > CreateDmsSeMongoRfc.json ``` 1. 修改并保存 CreateDmsSeMongoRfc .json 文件。例如，你可以用这样的东西替换内容： ``` { "ChangeTypeVersion": "{{1.0}}", "ChangeTypeId": "ct-2hxcllf1b4ey0", "Title": "{{DMS_Source_MongoDB}}" } ``` 1. 创建 RFC，指定执行参数文件和 CreateDmsSeMongoRfc 文件： ``` aws amscm create-rfc --cli-input-json file://CreateDmsSeMongoRfc.json --execution-parameters file://CreateDmsSeMongoParams.json ``` 您在响应中收到新 RFC 的 ID，并可以使用它来提交和监控 RFC。在您提交之前，RFC 仍处于编辑状态且无法启动。 ### 提示 **注意** 您最多可以添加 50 个标签，但要这样做，您必须启用**其他配置**视图。 AMS DMS 可以使用 Mongo 或任何关系数据库服务 (RDS) 作为源端点。有关 S3 源终端节点，请参阅[适用于 S3 的 DMS 源端点：创建](#ex-dms-se-s3-create-col)。 ## 适用于 S3 的 DMS 源端点：创建 ### 使用控制台创建 DMS S3 源端点 AMS 控制台中此更改类型的屏幕截图： ![](http://docs.aws.amazon.com/zh_cn/managedservices/latest/appguide/images/guiDmsCreateSourceEpS3CT.png) 工作原理： 1. 导航到 “**创建 RFC**” 页面：在 AMS 控制台的左侧导航窗格中，单击**RFCs**打开 RFCs 列表页面，然后单击 “**创建 R** FC”。 1. 在默认的 “**浏览更改类型” 视图中选择常用更改类型** (CT)，或者在 “**按类别选择” 视图中选择** CT。 + **按更改类型浏览**：您可以单击 “**快速创建**” 区域中的常用 CT，立即打开 “**运行 RFC**” 页面。请注意，您不能使用快速创建来选择较旧的 CT 版本。 要进行排序 CTs，请使用**卡片**视图或**表格**视图中的**所有更改类型**区域。在任一视图中，选择一个 CT，然后单击 “**创建 RFC**” 打开 “**运行 RFC**” 页面。如果适用，“**创建 RFC” 按钮旁边会出现 “使用旧版本****创建**” 选项。 + **按类别选择：选择类别**、子类别、项目和操作，CT 详细信息框将打开，并显示 “使用**旧版本创建**” 选项（如果适用）。单击 “**创建 RFC**” 打开 “**运行 RFC**” 页面。 1. 在 “**运行 RFC**” 页面上，打开 CT 名称区域以查看 CT 详细信息框。必须填写**主题**（如果您在 “**浏览更改类型**” 视图中选择 CT，则会为您填写此主题）。打开**其他配置**区域以添加有关 RFC 的信息。 在**执行配置**区域中，使用可用的下拉列表或输入所需参数的值。要配置可选的执行参数，请打开**其他配置**区域。 1. 完成后，单击 “**运行**”。如果没有错误，则会显示**成功创建的 RFC** 页面，其中包含已提交的 RFC 详细信息和初始**运行**输出。 1. 打开**运行参数**区域以查看您提交的配置。刷新页面以更新 RFC 的执行状态。（可选）取消 RFC 或使用页面顶部的选项创建一个 RFC 的副本。 ### 使用 CLI 创建 DMS S3 源端点 工作原理： 1. 使用 Inline Create（您发出包含所有 RFC 和执行参数的`create-rfc`命令）或模板创建（创建两个 JSON 文件，一个用于 RFC 参数，一个用于执行参数），然后以这两个文件作为输入发出`create-rfc`命令。这里描述了这两种方法。 1. 提交带有返回的 RFC ID 的 RFC: `aws amscm submit-rfc --rfc-id {{ID}}` 命令。 监控 RFC: `aws amscm get-rfc --rfc-id {{ID}}` 命令。 要检查更改类型版本，请使用以下命令： ``` aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value={{CT_ID}} ``` **注意** 您可以将任何`CreateRfc`参数与任何 RFC 一起使用，无论它们是否属于变更类型的架构的一部分。例如，要在 RFC 状态更改时收到通知，请将此行添加到请求的 RFC 参数部分（不是执行参数）。`--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"`有关所有 CreateRfc 参数的列表，请参阅《[AMS 变更管理 API 参考](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html)》。 *内联创建*： 使用内联提供的执行参数（内联提供执行参数时使用转义引号）发出 create RFC 命令，然后提交返回的 RFC ID。例如，你可以用这样的东西替换内容： ``` aws --profile saml --region us-east-1 amscm create-rfc --title "{{S3DMSSourceEndpoint}}" --aws-account-id {{ACCOUNT-ID}} --change-type-id ct-2oxl37nphsrjz --change-type-version 1.0 --execution-parameters "{\"Description\":\"{{TestS3DMS-SE}}\",\"VpcId\":\"{{VPC-ID}}\",\"Name\":\"{{S3-DMS-SE}}\",\"Parameters\":{\"EngineName\":\"s3\",\"S3BucketName\":\"{{amzn-s3-demo-bucket}}\",\"S3ExternalTableDefinition\":\"{\\\"TableCount\\\":\\\"1\\\",\\\"Tables\\\":[{\\\"TableName\\\":\\\"employee\\\",\\\"TablePath\\\":\\\"hr/employee/\\\",\\\"TableOwner\\\":\\\"hr\\\",\\\"TableColumns\\\":[{\\\"ColumnName\\\":\\\"Id\\\",\\\"ColumnType\\\":\\\"INT8\\\",\\\"ColumnNullable\\\":\\\"false\\\",\\\"ColumnIsPk\\\":\\\"true\\\"},{\\\"ColumnName\\\":\\\"LastName\\\",\\\"ColumnType\\\":\\\"STRING\\\",\\\"ColumnLength\\\":\\\"20\\\"},{\\\"ColumnName\\\":\\\"FirstName\\\",\\\"ColumnType\\\":\\\"STRING\\\",\\\"ColumnLength\\\":\\\"30\\\"},{\\\"ColumnName\\\":\\\"HireDate\\\",\\\"ColumnType\\\":\\\"DATETIME\\\"},{\\\"ColumnName\\\":\\\"OfficeLocation\\\",\\\"ColumnType\\\":\\\"STRING\\\",\\\"ColumnLength\\\":\\\"20\\\"}],\\\"TableColumnsTotal\\\":\\\"5\\\"}]}\",\"S3ServiceAccessRoleArn\":\"{{arn:aws:iam::123456789101:role/ams-ops-ct-authors-dms-s3-test-role}}\"},\"TimeoutInMinutes\":60,\"StackTemplateId\":\"stm-pud4ghhkp7395n9bc\"}" ``` *模板创建*： 1. 将此更改类型的执行参数输出到名为 s CreateDmsSe 3Params.json 的 JSON 文件中。 ``` aws amscm get-change-type-version --change-type-id "ct-2oxl37nphsrjz" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateDmsSeS3Params.json ``` 1. 修改并保存执行参数 JSON 文件。例如，你可以用这样的东西替换内容： ``` { "Description": "{{TestS3DMS-SE}}", "VpcId": "{{VPC_ID}}", "Name": "{{S3-DMS-SE}}", "StackTemplateId": "stm-pud4ghhkp7395n9bc", "TimeoutInMinutes": {{60}}, "Parameters": { "EngineName": "{{s3}}", "S3BucketName": "{{amzn-s3-demo-bucket}}", "S3ExternalTableDefinition": "{{BUCKET-NAME}}", {"TableCount": "{{1}}", "Tables":[{"TableName":"{{employee}}","TablePath":"{{hr/employee/}}","TableOwner":"{{hr}}","TableColumns":[{"ColumnName":"{{Id}}","ColumnType":"{{INT8}}","ColumnNullable":"{{false}}","ColumnIsPk":"{{true}}"},{"ColumnName":"{{LastName}}","ColumnType":"{{STRING}}","ColumnLength":"{{20}}"},{"ColumnName":"{{FirstName}}","ColumnType":"{{STRING}}","ColumnLength":"{{30}}"},{"ColumnName":"{{HireDate}}","ColumnType":"{{DATETIME}}"},{"ColumnName":"{{OfficeLocation}}","ColumnType":"{{STRING}}","ColumnLength":"{{20}}"}],"TableColumnsTotal":"{{5}}"}]}" "S3ServiceAccessRoleArn": "{{arn:aws:iam::123456789101:role/ams-ops-ct-authors-dms-s3-test-role}}", } } ``` 1. 将 JSON 模板输出到当前文件夹中的一个文件中；此示例将其命名 CreateDmsSe为 s3rfc.json： ``` aws amscm create-rfc --generate-cli-skeleton > CreateDmsSeS3Rfc.json ``` 1. 修改并保存 CreateDmsSe s3rfc.json 文件。例如，你可以用这样的东西替换内容： ``` { "ChangeTypeVersion": "{{1.0}}", "ChangeTypeId": "ct-2oxl37nphsrjz", "Title": "{{DMS_Source_S3}}" } ``` 1. 创建 RFC，指定执行参数文件和 CreateDmsSe S3Rfc 文件： ``` aws amscm create-rfc --cli-input-json file://CreateDmsSeS3Rfc.json --execution-parameters file://CreateDmsSeS3Params.json ``` 您在响应中收到新 RFC 的 ID，并可以使用它来提交和监控 RFC。在您提交之前，RFC 仍处于编辑状态且无法启动。 ### 提示 **注意** 您最多可以添加 50 个标签，但要这样做，您必须启用**其他配置**视图。 AMS DMS 可以使用 S3 或任何关系数据库服务 (RDS) Service 源端点。有关 Mongo 数据库源端点的信息，请参阅[适用于 MongoDB 的 DMS 源端点：正在创建](#ex-dms-se-mongo-create-col)。