aws-sdk-databasemigrationservice 1.112.0 → 1.113.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7053050e69118a95ba3a94549a0ebd14a1bfd04c2fa65ab29fc86282f0461b51
-  data.tar.gz: e4f770e1481a6ad2ba7ddb5a349d6008f5a7a6fc95f5330eec829e8a7822cbd9
+  metadata.gz: 854d093115eeaafc8986b22532e6e48e92ce2fdc628775c288e8fb6fac1b1064
+  data.tar.gz: f09d70dd579da0ac8064aed73edd13b0be69acb63b5469c5a8b8dc2da95e4508
 SHA512:
-  metadata.gz: cf4f640d030b9351d3ad71edf10c36739bd1c34af5462ef8bff61aa59495a98e738fd65b12c98d50193d0e91d20b432ebb77eb1e85f995afd5105bae0cdb573c
-  data.tar.gz: 5ebba030b43059ef52662bd3ed6c8781b82faeb19d69623d3186ec9bd744ef48a5180a962af77d214b3992be00e081128198199dc6fee33ddad69b08a4f8bb75
+  metadata.gz: 84687eecaed3a75142bf12d50fd579db1ed98224b279f698eb2a0793401bc47383fddc24c576e1e0de67c71d1ceda6d5c9efecf38e49a91a00456bb21b50514a
+  data.tar.gz: 62a4747a62a80640b7ddc7a014236f6631abfd17eb3bc1cb0fe0b25429e4b24d67844e09cc21bd96ee16ebb9268b8629ec934e444580e3071505129975320771

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.113.0 (2025-02-04)
+------------------
+
+* Feature - Introduces TargetDataSettings with the TablePreparationMode option available for data migrations.
+
 1.112.0 (2025-01-15)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.112.0
+1.113.0

data/lib/aws-sdk-databasemigrationservice/client.rb

@@ -734,6 +734,9 @@ module Aws::DatabaseMigrationService
     # @option params [Array<Types::SourceDataSetting>] :source_data_settings
     #   Specifies information about the source data provider.
     #
+    # @option params [Array<Types::TargetDataSetting>] :target_data_settings
+    #   Specifies information about the target data provider.
+    #
     # @option params [Integer] :number_of_jobs
     #   The number of parallel jobs that trigger parallel threads to unload
     #   the tables from the source, and then load them to the target.
@@ -765,6 +768,11 @@ module Aws::DatabaseMigrationService
     #         slot_name: "String",
     #       },
     #     ],
+    #     target_data_settings: [
+    #       {
+    #         table_preparation_mode: "do-nothing", # accepts do-nothing, truncate, drop-tables-on-target
+    #       },
+    #     ],
     #     number_of_jobs: 1,
     #     tags: [
     #       {
@@ -794,6 +802,8 @@ module Aws::DatabaseMigrationService
     #   resp.data_migration.source_data_settings[0].cdc_start_time #=> Time
     #   resp.data_migration.source_data_settings[0].cdc_stop_time #=> Time
     #   resp.data_migration.source_data_settings[0].slot_name #=> String
+    #   resp.data_migration.target_data_settings #=> Array
+    #   resp.data_migration.target_data_settings[0].table_preparation_mode #=> String, one of "do-nothing", "truncate", "drop-tables-on-target"
     #   resp.data_migration.data_migration_statistics.tables_loaded #=> Integer
     #   resp.data_migration.data_migration_statistics.elapsed_time_millis #=> Integer
     #   resp.data_migration.data_migration_statistics.tables_loading #=> Integer
@@ -3415,6 +3425,8 @@ module Aws::DatabaseMigrationService
     #   resp.data_migration.source_data_settings[0].cdc_start_time #=> Time
     #   resp.data_migration.source_data_settings[0].cdc_stop_time #=> Time
     #   resp.data_migration.source_data_settings[0].slot_name #=> String
+    #   resp.data_migration.target_data_settings #=> Array
+    #   resp.data_migration.target_data_settings[0].table_preparation_mode #=> String, one of "do-nothing", "truncate", "drop-tables-on-target"
     #   resp.data_migration.data_migration_statistics.tables_loaded #=> Integer
     #   resp.data_migration.data_migration_statistics.elapsed_time_millis #=> Integer
     #   resp.data_migration.data_migration_statistics.tables_loading #=> Integer
@@ -4965,6 +4977,8 @@ module Aws::DatabaseMigrationService
     #   resp.data_migrations[0].source_data_settings[0].cdc_start_time #=> Time
     #   resp.data_migrations[0].source_data_settings[0].cdc_stop_time #=> Time
     #   resp.data_migrations[0].source_data_settings[0].slot_name #=> String
+    #   resp.data_migrations[0].target_data_settings #=> Array
+    #   resp.data_migrations[0].target_data_settings[0].table_preparation_mode #=> String, one of "do-nothing", "truncate", "drop-tables-on-target"
     #   resp.data_migrations[0].data_migration_statistics.tables_loaded #=> Integer
     #   resp.data_migrations[0].data_migration_statistics.elapsed_time_millis #=> Integer
     #   resp.data_migrations[0].data_migration_statistics.tables_loading #=> Integer
@@ -8769,6 +8783,10 @@ module Aws::DatabaseMigrationService
     #   The new information about the source data provider for the data
     #   migration.
     #
+    # @option params [Array<Types::TargetDataSetting>] :target_data_settings
+    #   The new information about the target data provider for the data
+    #   migration.
+    #
     # @option params [Integer] :number_of_jobs
     #   The number of parallel jobs that trigger parallel threads to unload
     #   the tables from the source, and then load them to the target.
@@ -8797,6 +8815,11 @@ module Aws::DatabaseMigrationService
     #         slot_name: "String",
     #       },
     #     ],
+    #     target_data_settings: [
+    #       {
+    #         table_preparation_mode: "do-nothing", # accepts do-nothing, truncate, drop-tables-on-target
+    #       },
+    #     ],
     #     number_of_jobs: 1,
     #     selection_rules: "SecretString",
     #   })
@@ -8819,6 +8842,8 @@ module Aws::DatabaseMigrationService
     #   resp.data_migration.source_data_settings[0].cdc_start_time #=> Time
     #   resp.data_migration.source_data_settings[0].cdc_stop_time #=> Time
     #   resp.data_migration.source_data_settings[0].slot_name #=> String
+    #   resp.data_migration.target_data_settings #=> Array
+    #   resp.data_migration.target_data_settings[0].table_preparation_mode #=> String, one of "do-nothing", "truncate", "drop-tables-on-target"
     #   resp.data_migration.data_migration_statistics.tables_loaded #=> Integer
     #   resp.data_migration.data_migration_statistics.elapsed_time_millis #=> Integer
     #   resp.data_migration.data_migration_statistics.tables_loading #=> Integer
@@ -11362,6 +11387,8 @@ module Aws::DatabaseMigrationService
     #   resp.data_migration.source_data_settings[0].cdc_start_time #=> Time
     #   resp.data_migration.source_data_settings[0].cdc_stop_time #=> Time
     #   resp.data_migration.source_data_settings[0].slot_name #=> String
+    #   resp.data_migration.target_data_settings #=> Array
+    #   resp.data_migration.target_data_settings[0].table_preparation_mode #=> String, one of "do-nothing", "truncate", "drop-tables-on-target"
     #   resp.data_migration.data_migration_statistics.tables_loaded #=> Integer
     #   resp.data_migration.data_migration_statistics.elapsed_time_millis #=> Integer
     #   resp.data_migration.data_migration_statistics.tables_loading #=> Integer
@@ -12267,6 +12294,8 @@ module Aws::DatabaseMigrationService
     #   resp.data_migration.source_data_settings[0].cdc_start_time #=> Time
     #   resp.data_migration.source_data_settings[0].cdc_stop_time #=> Time
     #   resp.data_migration.source_data_settings[0].slot_name #=> String
+    #   resp.data_migration.target_data_settings #=> Array
+    #   resp.data_migration.target_data_settings[0].table_preparation_mode #=> String, one of "do-nothing", "truncate", "drop-tables-on-target"
     #   resp.data_migration.data_migration_statistics.tables_loaded #=> Integer
     #   resp.data_migration.data_migration_statistics.elapsed_time_millis #=> Integer
     #   resp.data_migration.data_migration_statistics.tables_loading #=> Integer
@@ -12560,7 +12589,7 @@ module Aws::DatabaseMigrationService
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-databasemigrationservice'
-      context[:gem_version] = '1.112.0'
+      context[:gem_version] = '1.113.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-databasemigrationservice/client_api.rb

@@ -471,11 +471,14 @@ module Aws::DatabaseMigrationService
     SybaseSettings = Shapes::StructureShape.new(name: 'SybaseSettings')
     TStamp = Shapes::TimestampShape.new(name: 'TStamp')
     TableListToReload = Shapes::ListShape.new(name: 'TableListToReload')
+    TablePreparationMode = Shapes::StringShape.new(name: 'TablePreparationMode')
     TableStatistics = Shapes::StructureShape.new(name: 'TableStatistics')
     TableStatisticsList = Shapes::ListShape.new(name: 'TableStatisticsList')
     TableToReload = Shapes::StructureShape.new(name: 'TableToReload')
     Tag = Shapes::StructureShape.new(name: 'Tag')
     TagList = Shapes::ListShape.new(name: 'TagList')
+    TargetDataSetting = Shapes::StructureShape.new(name: 'TargetDataSetting')
+    TargetDataSettings = Shapes::ListShape.new(name: 'TargetDataSettings')
     TargetDbType = Shapes::StringShape.new(name: 'TargetDbType')
     TestConnectionMessage = Shapes::StructureShape.new(name: 'TestConnectionMessage')
     TestConnectionResponse = Shapes::StructureShape.new(name: 'TestConnectionResponse')
@@ -616,6 +619,7 @@ module Aws::DatabaseMigrationService
     CreateDataMigrationMessage.add_member(:service_access_role_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "ServiceAccessRoleArn"))
     CreateDataMigrationMessage.add_member(:enable_cloudwatch_logs, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "EnableCloudwatchLogs"))
     CreateDataMigrationMessage.add_member(:source_data_settings, Shapes::ShapeRef.new(shape: SourceDataSettings, location_name: "SourceDataSettings"))
+    CreateDataMigrationMessage.add_member(:target_data_settings, Shapes::ShapeRef.new(shape: TargetDataSettings, location_name: "TargetDataSettings"))
     CreateDataMigrationMessage.add_member(:number_of_jobs, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "NumberOfJobs"))
     CreateDataMigrationMessage.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     CreateDataMigrationMessage.add_member(:selection_rules, Shapes::ShapeRef.new(shape: SecretString, location_name: "SelectionRules"))
@@ -800,6 +804,7 @@ module Aws::DatabaseMigrationService
     DataMigration.add_member(:data_migration_type, Shapes::ShapeRef.new(shape: MigrationTypeValue, location_name: "DataMigrationType"))
     DataMigration.add_member(:data_migration_settings, Shapes::ShapeRef.new(shape: DataMigrationSettings, location_name: "DataMigrationSettings"))
     DataMigration.add_member(:source_data_settings, Shapes::ShapeRef.new(shape: SourceDataSettings, location_name: "SourceDataSettings"))
+    DataMigration.add_member(:target_data_settings, Shapes::ShapeRef.new(shape: TargetDataSettings, location_name: "TargetDataSettings"))
     DataMigration.add_member(:data_migration_statistics, Shapes::ShapeRef.new(shape: DataMigrationStatistics, location_name: "DataMigrationStatistics"))
     DataMigration.add_member(:data_migration_status, Shapes::ShapeRef.new(shape: String, location_name: "DataMigrationStatus"))
     DataMigration.add_member(:public_ip_addresses, Shapes::ShapeRef.new(shape: PublicIpAddressList, location_name: "PublicIpAddresses"))
@@ -1807,6 +1812,7 @@ module Aws::DatabaseMigrationService
     ModifyDataMigrationMessage.add_member(:service_access_role_arn, Shapes::ShapeRef.new(shape: String, location_name: "ServiceAccessRoleArn"))
     ModifyDataMigrationMessage.add_member(:data_migration_type, Shapes::ShapeRef.new(shape: MigrationTypeValue, location_name: "DataMigrationType"))
     ModifyDataMigrationMessage.add_member(:source_data_settings, Shapes::ShapeRef.new(shape: SourceDataSettings, location_name: "SourceDataSettings"))
+    ModifyDataMigrationMessage.add_member(:target_data_settings, Shapes::ShapeRef.new(shape: TargetDataSettings, location_name: "TargetDataSettings"))
     ModifyDataMigrationMessage.add_member(:number_of_jobs, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "NumberOfJobs"))
     ModifyDataMigrationMessage.add_member(:selection_rules, Shapes::ShapeRef.new(shape: SecretString, location_name: "SelectionRules"))
     ModifyDataMigrationMessage.struct_class = Types::ModifyDataMigrationMessage
@@ -2801,6 +2807,11 @@ module Aws::DatabaseMigrationService
 
     TagList.member = Shapes::ShapeRef.new(shape: Tag)
 
+    TargetDataSetting.add_member(:table_preparation_mode, Shapes::ShapeRef.new(shape: TablePreparationMode, location_name: "TablePreparationMode"))
+    TargetDataSetting.struct_class = Types::TargetDataSetting
+
+    TargetDataSettings.member = Shapes::ShapeRef.new(shape: TargetDataSetting)
+
     TestConnectionMessage.add_member(:replication_instance_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "ReplicationInstanceArn"))
     TestConnectionMessage.add_member(:endpoint_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "EndpointArn"))
     TestConnectionMessage.struct_class = Types::TestConnectionMessage

data/lib/aws-sdk-databasemigrationservice/types.rb

@@ -623,6 +623,10 @@ module Aws::DatabaseMigrationService
     #   Specifies information about the source data provider.
     #   @return [Array<Types::SourceDataSetting>]
     #
+    # @!attribute [rw] target_data_settings
+    #   Specifies information about the target data provider.
+    #   @return [Array<Types::TargetDataSetting>]
+    #
     # @!attribute [rw] number_of_jobs
     #   The number of parallel jobs that trigger parallel threads to unload
     #   the tables from the source, and then load them to the target.
@@ -646,6 +650,7 @@ module Aws::DatabaseMigrationService
       :service_access_role_arn,
       :enable_cloudwatch_logs,
       :source_data_settings,
+      :target_data_settings,
       :number_of_jobs,
       :tags,
       :selection_rules)
@@ -1922,6 +1927,11 @@ module Aws::DatabaseMigrationService
     #   provider.
     #   @return [Array<Types::SourceDataSetting>]
     #
+    # @!attribute [rw] target_data_settings
+    #   Specifies information about the data migration's target data
+    #   provider.
+    #   @return [Array<Types::TargetDataSetting>]
+    #
     # @!attribute [rw] data_migration_statistics
     #   Provides information about the data migration's run, including
     #   start and stop time, latency, and data migration progress.
@@ -1961,6 +1971,7 @@ module Aws::DatabaseMigrationService
       :data_migration_type,
       :data_migration_settings,
       :source_data_settings,
+      :target_data_settings,
       :data_migration_statistics,
       :data_migration_status,
       :public_ip_addresses,
@@ -6801,22 +6812,23 @@ module Aws::DatabaseMigrationService
       include Aws::Structure
     end
 
-    # Specifies using Kerberos authentication settings for use with DMS.
+    # Specifies the settings required for kerberos authentication when
+    # creating the replication instance.
     #
     # @!attribute [rw] key_cache_secret_id
-    #   Specifies the secret ID of the key cache for the replication
-    #   instance.
+    #   Specifies the ID of the secret that stores the key cache file
+    #   required for kerberos authentication.
     #   @return [String]
     #
     # @!attribute [rw] key_cache_secret_iam_arn
     #   Specifies the Amazon Resource Name (ARN) of the IAM role that grants
     #   Amazon Web Services DMS access to the secret containing key cache
-    #   file for the replication instance.
+    #   file for the kerberos authentication.
     #   @return [String]
     #
     # @!attribute [rw] krb_5_file_contents
-    #   Specifies the ID of the secret that stores the key cache file
-    #   required for kerberos authentication of the replication instance.
+    #   Specifies the contents of krb5 configuration file required for
+    #   kerberos authentication.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/KerberosAuthenticationSettings AWS API Documentation
@@ -7181,7 +7193,8 @@ module Aws::DatabaseMigrationService
     #   @return [Boolean]
     #
     # @!attribute [rw] authentication_method
-    #   Specifies using Kerberos authentication with Microsoft SQL Server.
+    #   Specifies the authentication method to be used with Microsoft SQL
+    #   Server.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/MicrosoftSQLServerSettings AWS API Documentation
@@ -7368,6 +7381,11 @@ module Aws::DatabaseMigrationService
     #   migration.
     #   @return [Array<Types::SourceDataSetting>]
     #
+    # @!attribute [rw] target_data_settings
+    #   The new information about the target data provider for the data
+    #   migration.
+    #   @return [Array<Types::TargetDataSetting>]
+    #
     # @!attribute [rw] number_of_jobs
     #   The number of parallel jobs that trigger parallel threads to unload
     #   the tables from the source, and then load them to the target.
@@ -7387,6 +7405,7 @@ module Aws::DatabaseMigrationService
       :service_access_role_arn,
       :data_migration_type,
       :source_data_settings,
+      :target_data_settings,
       :number_of_jobs,
       :selection_rules)
       SENSITIVE = [:selection_rules]
@@ -9387,7 +9406,7 @@ module Aws::DatabaseMigrationService
     #   @return [Integer]
     #
     # @!attribute [rw] authentication_method
-    #   Specifies using Kerberos authentication with Oracle.
+    #   Specifies the authentication method to be used with Oracle.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/OracleSettings AWS API Documentation
@@ -14018,6 +14037,23 @@ module Aws::DatabaseMigrationService
       include Aws::Structure
     end
 
+    # Defines settings for a target data provider for a data migration.
+    #
+    # @!attribute [rw] table_preparation_mode
+    #   This setting determines how DMS handles the target tables before
+    #   starting a data migration, either by leaving them untouched,
+    #   dropping and recreating them, or truncating the existing data in the
+    #   target tables.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/TargetDataSetting AWS API Documentation
+    #
+    class TargetDataSetting < Struct.new(
+      :table_preparation_mode)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] replication_instance_arn
     #   The Amazon Resource Name (ARN) of the replication instance.
     #   @return [String]

data/lib/aws-sdk-databasemigrationservice.rb

@@ -55,7 +55,7 @@ module Aws::DatabaseMigrationService
   autoload :EndpointProvider, 'aws-sdk-databasemigrationservice/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-databasemigrationservice/endpoints'
 
-  GEM_VERSION = '1.112.0'
+  GEM_VERSION = '1.113.0'
 
 end
 

data/sig/client.rbs

@@ -153,6 +153,11 @@ module Aws
                                        slot_name: ::String?
                                      },
                                    ],
+                                   ?target_data_settings: Array[
+                                     {
+                                       table_preparation_mode: ("do-nothing" | "truncate" | "drop-tables-on-target")?
+                                     },
+                                   ],
                                    ?number_of_jobs: ::Integer,
                                    ?tags: Array[
                                      {
@@ -1802,6 +1807,11 @@ module Aws
                                        slot_name: ::String?
                                      },
                                    ],
+                                   ?target_data_settings: Array[
+                                     {
+                                       table_preparation_mode: ("do-nothing" | "truncate" | "drop-tables-on-target")?
+                                     },
+                                   ],
                                    ?number_of_jobs: ::Integer,
                                    ?selection_rules: ::String
                                  ) -> _ModifyDataMigrationResponseSuccess

data/sig/types.rbs

@@ -153,6 +153,7 @@ module Aws::DatabaseMigrationService
       attr_accessor service_access_role_arn: ::String
       attr_accessor enable_cloudwatch_logs: bool
       attr_accessor source_data_settings: ::Array[Types::SourceDataSetting]
+      attr_accessor target_data_settings: ::Array[Types::TargetDataSetting]
       attr_accessor number_of_jobs: ::Integer
       attr_accessor tags: ::Array[Types::Tag]
       attr_accessor selection_rules: ::String
@@ -381,6 +382,7 @@ module Aws::DatabaseMigrationService
       attr_accessor data_migration_type: ("full-load" | "cdc" | "full-load-and-cdc")
       attr_accessor data_migration_settings: Types::DataMigrationSettings
       attr_accessor source_data_settings: ::Array[Types::SourceDataSetting]
+      attr_accessor target_data_settings: ::Array[Types::TargetDataSetting]
       attr_accessor data_migration_statistics: Types::DataMigrationStatistics
       attr_accessor data_migration_status: ::String
       attr_accessor public_ip_addresses: ::Array[::String]
@@ -1701,6 +1703,7 @@ module Aws::DatabaseMigrationService
       attr_accessor service_access_role_arn: ::String
       attr_accessor data_migration_type: ("full-load" | "cdc" | "full-load-and-cdc")
       attr_accessor source_data_settings: ::Array[Types::SourceDataSetting]
+      attr_accessor target_data_settings: ::Array[Types::TargetDataSetting]
       attr_accessor number_of_jobs: ::Integer
       attr_accessor selection_rules: ::String
       SENSITIVE: [:selection_rules]
@@ -2879,6 +2882,11 @@ module Aws::DatabaseMigrationService
       SENSITIVE: []
     end
 
+    class TargetDataSetting
+      attr_accessor table_preparation_mode: ("do-nothing" | "truncate" | "drop-tables-on-target")
+      SENSITIVE: []
+    end
+
     class TestConnectionMessage
       attr_accessor replication_instance_arn: ::String
       attr_accessor endpoint_arn: ::String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-databasemigrationservice
 version: !ruby/object:Gem::Version
-  version: 1.112.0
+  version: 1.113.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-01-15 00:00:00.000000000 Z
+date: 2025-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core