資料庫遷移服務 (DMS) | 建立來源端點 (S3)

使用為 S3 建立 Database Migration Service (DMS) 來源端點。

完整分類：部署 | 進階堆疊元件 | Database Migration Service (DMS) | 建立來源端點 (S3)

變更類型詳細資訊

變更類型 ID	ct-2oxl37nphsrjz
目前版本	1.0
預期的執行持續時間	60 分鐘
AWS 核准	必要
客戶核准	非必要
執行模式	自動化

其他資訊

S3 的 DMS 來源端點：建立

AMS 主控台中此變更類型的螢幕擷取畫面：

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

運作方式：

導覽至建立 RFC 頁面：在 AMS 主控台的左側導覽窗格中，按一下 RFCs以開啟 RFCs清單頁面，然後按一下建立 RFC。
在預設瀏覽變更類型檢視中選擇熱門的變更類型 (CT)，或在依類別選擇檢視中選擇 CT。
- 依變更類型瀏覽：您可以在快速建立區域中按一下熱門的 CT，以立即開啟執行 RFC 頁面。請注意，您無法透過快速建立選擇較舊的 CT 版本。
  
  若要排序 CTs，請使用卡片或資料表檢視中的所有變更類型區域。在任一檢視中，選取 CT，然後按一下建立 RFC 以開啟執行 RFC 頁面。如果適用，建立較舊版本選項會顯示在建立 RFC 按鈕旁。
- 依類別選擇：選取類別、子類別、項目和操作，如果適用，CT 詳細資訊方塊會開啟，其中包含使用較舊版本建立的選項。按一下建立 RFC 以開啟執行 RFC 頁面。
在執行 RFC 頁面上，開啟 CT 名稱區域以查看 CT 詳細資訊方塊。需要主旨（如果您在瀏覽變更類型檢視中選擇 CT，則會為您填入）。開啟其他組態區域以新增 RFC 的相關資訊。

在執行組態區域中，使用可用的下拉式清單或輸入必要參數的值。若要設定選用的執行參數，請開啟其他組態區域。
完成後，請按一下執行。如果沒有錯誤，RFC 成功建立的頁面會顯示已提交的 RFC 詳細資訊，以及初始的執行輸出。
開啟執行參數區域以查看您提交的組態。重新整理頁面以更新 RFC 執行狀態。或者，取消 RFC 或使用頁面頂端的選項建立 RFC 的副本。

運作方式：

使用內嵌建立（您發出包含所有 RFC 和執行參數的create-rfc命令）或範本建立（您建立兩個 JSON 檔案，一個用於 RFC 參數，另一個用於執行參數），並使用兩個檔案作為輸入發出create-rfc命令。此處說明這兩種方法。
使用傳回的 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 狀態變更時取得通知，請將此行新增至請求的 --notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}" RFC 參數部分（而非執行參數）。如需所有 CreateRfc 參數的清單，請參閱 AMS 變更管理 API 參考。

內嵌建立：

使用內嵌提供的執行參數發出建立 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\"}"

範本建立：

將此變更類型的執行參數輸出至名為 CreateDmsSeS3Params.json.


aws amscm get-change-type-version --change-type-id "ct-2oxl37nphsrjz" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateDmsSeS3Params.json

修改並儲存執行參數 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",
      }
}

將 JSON 範本輸出至目前資料夾中的檔案；此範例會將其命名為 CreateDmsSeS3Rfc.json:
```
aws amscm create-rfc --generate-cli-skeleton > CreateDmsSeS3Rfc.json
```

修改並儲存 CreateDmsSeS3Rfc.json 檔案。例如，您可以將內容取代為如下內容：


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

建立 RFC，指定執行參數檔案和 CreateDmsSeS3Rfc 檔案：
```
aws amscm create-rfc --cli-input-json file://CreateDmsSeS3Rfc.json --execution-parameters file://CreateDmsSeS3Params.json
```
您會在回應中收到新 RFC 的 ID，並且可以使用它來提交和監控 RFC。在您提交之前，RFC 會保持在編輯狀態，不會啟動。

注意

您最多可以新增 50 個標籤，但若要這樣做，您必須啟用其他組態檢視。

AMS DMS 可以使用 S3 或任何關聯式資料庫服務 (RDS) 來源端點。如需 Mongo 資料庫來源端點，請參閱 MongoDB 的 DMS 來源端點：建立。

執行輸入參數

如需執行輸入參數的詳細資訊，請參閱變更類型的結構描述 ct-2oxl37nphsrjz。

範例：必要參數


Example not available.

範例：所有參數


{
  "Description": "This is a test description",
  "Name": "Test Stack",
  "Parameters": {
    "EndpointIdentifier": "my-endpoint",
    "EngineName": "s3",
    "S3BucketFolder": "my-folder",
    "S3BucketName": "my-bucket",
    "S3CompressionType": "NONE",
    "S3CsvDelimiter": ",",
    "S3CsvRowDelimiter": "\n",
    "S3ExternalTableDefinition": "false",
    "S3ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3service-role"
  },
  "StackTemplateId": "stm-pud4ghhkp7395n9bc",
  "TimeoutInMinutes": 60,
  "VpcId": "vpc-01234567890abcdef"
}

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

資料庫遷移服務 (DMS) | 建立來源端點 (MongoDB)

資料庫遷移服務 (DMS) | 建立目標端點