3： AWS DMS 源端点：创建、为 Mongo 数据库创建、为 S3 创建 - AMS 高级应用程序开发者指南
DMS 源端点：创建适用于 MongoDB 的 DMS 源端点：正在创建适用于 S3 的 DMS 源端点：创建

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

3： AWS DMS 源端点：创建、为 Mongo 数据库创建、为 S3 创建

您可以使用 AMS 控制台或 API/CLI 为各种数据库创建 AMS DMS 源端点，我们提供了三个示例。

DMS 源端点：创建

AMS 控制台中此更改类型的屏幕截图：

变更 type details for creating a DMS source endpoint, including ID and version.

它是如何运作的：

  1. 导航到 “创建 RFC” 页面：在 AMS 控制台的左侧导航窗格中，单击RFCs打开 RFCs 列表页面，然后单击 “创建 R FC”。

  2. 在默认的 “浏览更改类型” 视图中选择常用更改类型 (CT)，或者在 “按类别选择” 视图中选择 CT。

    • 按更改类型浏览：您可以单击 “快速创建” 区域中的常用 CT，立即打开 “运行 RFC” 页面。请注意，您不能使用快速创建来选择较旧的 CT 版本。

      要进行排序 CTs，请使用卡片视图或表格视图中的所有更改类型区域。在任一视图中，选择一个 CT，然后单击 “创建 RFC” 打开 “运行 RFC” 页面。如果适用，“创建 RFC” 按钮旁边会显示 “使用旧版本创建” 选项。

    • 按类别选择：选择类别、子类别、项目和操作，CT 详细信息框将打开，并显示 “使用旧版本创建” 选项（如果适用）。单击 “创建 RFC” 打开 “运行 RFC” 页面。

  3. 在 “运行 RFC” 页面上，打开 CT 名称区域以查看 CT 详细信息框。必须填写主题（如果您在 “浏览更改类型” 视图中选择 CT，则会为您填写此主题）。打开其他配置区域以添加有关 RFC 的信息。

    在执行配置区域中，使用可用的下拉列表或输入所需参数的值。要配置可选的执行参数，请打开其他配置区域。

  4. 完成后，单击 “运行”。如果没有错误，则会显示成功创建的 RFC 页面，其中包含已提交的 RFC 详细信息和初始运行输出。

  5. 打开运行参数区域以查看您提交的配置。刷新页面以更新 RFC 的执行状态。（可选）取消 RFC 或使用页面顶部的选项创建一个 RFC 的副本。

它是如何运作的：

  1. 使用 Inline Create（您发出包含所有 RFC 和执行参数的create-rfc命令）或模板创建（创建两个 JSON 文件，一个用于 RFC 参数，一个用于执行参数），然后以这两个文件作为输入发出create-rfc命令。这里描述了这两种方法。

  2. 提交带有返回的 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 参考》。

内联创建：

使用内联提供的执行参数（内联提供执行参数时使用转义引号）发出 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

  2. 修改并保存执行参数 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",}
    }
}

  3. 将 JSON 模板输出到当前文件夹中的一个文件中；此示例将其命名为 CreateDmsSeRfc .json：

    aws amscm create-rfc --generate-cli-skeleton > CreateDmsSeRfc.json

  4. 修改并保存 CreateDmsSeRfc .json 文件。例如，你可以用这样的东西替换内容：

    {
"ChangeTypeVersion":    "1.0",
"ChangeTypeId":         "ct-0attesnjqy2cx",
"Title":                "MariaDB-DMS-Source-Endpoint"
}

  5. 创建 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 用户指南中的创建源端点和目标端点。

要了解更多信息，请参阅数据迁移来源。

有关 S3 源终端节点，请参阅适用于 S3 的 DMS 源端点：创建。

有关 Mongo 数据库源端点的信息，请参阅适用于 MongoDB 的 DMS 源端点：正在创建。

适用于 MongoDB 的 DMS 源端点：正在创建

AMS 控制台中此更改类型的屏幕截图：

变更 type details for creating a DMS source endpoint for MongoDB, including ID and version.

它是如何运作的：

  1. 导航到 “创建 RFC” 页面：在 AMS 控制台的左侧导航窗格中，单击RFCs打开 RFCs 列表页面，然后单击 “创建 R FC”。

  2. 在默认的 “浏览更改类型” 视图中选择常用更改类型 (CT)，或者在 “按类别选择” 视图中选择 CT。

    • 按更改类型浏览：您可以单击 “快速创建” 区域中的常用 CT，立即打开 “运行 RFC” 页面。请注意，您不能使用快速创建来选择较旧的 CT 版本。

      要进行排序 CTs，请使用卡片视图或表格视图中的所有更改类型区域。在任一视图中，选择一个 CT，然后单击 “创建 RFC” 打开 “运行 RFC” 页面。如果适用，“创建 RFC” 按钮旁边会显示 “使用旧版本创建” 选项。

    • 按类别选择：选择类别、子类别、项目和操作，CT 详细信息框将打开，并显示 “使用旧版本创建” 选项（如果适用）。单击 “创建 RFC” 打开 “运行 RFC” 页面。

  3. 在 “运行 RFC” 页面上，打开 CT 名称区域以查看 CT 详细信息框。必须填写主题（如果您在 “浏览更改类型” 视图中选择 CT，则会为您填写此主题）。打开其他配置区域以添加有关 RFC 的信息。

    在执行配置区域中，使用可用的下拉列表或输入所需参数的值。要配置可选的执行参数，请打开其他配置区域。

  4. 完成后，单击 “运行”。如果没有错误，则会显示成功创建的 RFC 页面，其中包含已提交的 RFC 详细信息和初始运行输出。

  5. 打开运行参数区域以查看您提交的配置。刷新页面以更新 RFC 的执行状态。（可选）取消 RFC 或使用页面顶部的选项创建一个 RFC 的副本。

它是如何运作的：

  1. 使用 Inline Create（您发出包含所有 RFC 和执行参数的create-rfc命令）或模板创建（创建两个 JSON 文件，一个用于 RFC 参数，一个用于执行参数），然后以这两个文件作为输入发出create-rfc命令。这里描述了这两种方法。

  2. 提交带有返回的 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 参考》。

内联创建：

使用内联提供的执行参数（内联提供执行参数时使用转义引号）发出 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

  2. 修改并保存执行参数 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"
    }
}

  3. 将 JSON 模板输出到当前文件夹中的一个文件中；此示例将其命名为 CreateDmsSeMongoRfc .json：

    aws amscm create-rfc --generate-cli-skeleton > CreateDmsSeMongoRfc.json

  4. 修改并保存 CreateDmsSeMongoRfc .json 文件。例如，你可以用这样的东西替换内容：

    {
"ChangeTypeVersion":    "1.0",
"ChangeTypeId":         "ct-2hxcllf1b4ey0",
"Title":                "DMS_Source_MongoDB"
}

  5. 创建 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 源端点：创建。

适用于 S3 的 DMS 源端点：创建

AMS 控制台中此更改类型的屏幕截图：

变更 type details for creating a DMS source endpoint for S3, including ID and version.

它是如何运作的：

  1. 导航到 “创建 RFC” 页面：在 AMS 控制台的左侧导航窗格中，单击RFCs打开 RFCs 列表页面，然后单击 “创建 R FC”。

  2. 在默认的 “浏览更改类型” 视图中选择常用更改类型 (CT)，或者在 “按类别选择” 视图中选择 CT。

    • 按更改类型浏览：您可以单击 “快速创建” 区域中的常用 CT，立即打开 “运行 RFC” 页面。请注意，您不能使用快速创建来选择较旧的 CT 版本。

      要进行排序 CTs，请使用卡片视图或表格视图中的所有更改类型区域。在任一视图中，选择一个 CT，然后单击 “创建 RFC” 打开 “运行 RFC” 页面。如果适用，“创建 RFC” 按钮旁边会显示 “使用旧版本创建” 选项。

    • 按类别选择：选择类别、子类别、项目和操作，CT 详细信息框将打开，并显示 “使用旧版本创建” 选项（如果适用）。单击 “创建 RFC” 打开 “运行 RFC” 页面。

  3. 在 “运行 RFC” 页面上，打开 CT 名称区域以查看 CT 详细信息框。必须填写主题（如果您在 “浏览更改类型” 视图中选择 CT，则会为您填写此主题）。打开其他配置区域以添加有关 RFC 的信息。

    在执行配置区域中，使用可用的下拉列表或输入所需参数的值。要配置可选的执行参数，请打开其他配置区域。

  4. 完成后，单击 “运行”。如果没有错误，则会显示成功创建的 RFC 页面，其中包含已提交的 RFC 详细信息和初始运行输出。

  5. 打开运行参数区域以查看您提交的配置。刷新页面以更新 RFC 的执行状态。（可选）取消 RFC 或使用页面顶部的选项创建一个 RFC 的副本。

它是如何运作的：

  1. 使用 Inline Create（您发出包含所有 RFC 和执行参数的create-rfc命令）或模板创建（创建两个 JSON 文件，一个用于 RFC 参数，一个用于执行参数），然后以这两个文件作为输入发出create-rfc命令。这里描述了这两种方法。

  2. 提交带有返回的 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 参考》。

内联创建：

使用内联提供的执行参数（内联提供执行参数时使用转义引号）发出 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

  2. 修改并保存执行参数 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",
      }
}

  3. 将 JSON 模板输出到当前文件夹中的一个文件中；此示例将其命名 CreateDmsSe为 s3rfc.json：

    aws amscm create-rfc --generate-cli-skeleton > CreateDmsSeS3Rfc.json

  4. 修改并保存 CreateDmsSe s3rfc.json 文件。例如，你可以用这样的东西替换内容：

    {
"ChangeTypeVersion":    "1.0",
"ChangeTypeId":         "ct-2oxl37nphsrjz",
"Title":                "DMS_Source_S3"
}

  5. 创建 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 源端点：正在创建。