Struct aws_sdk_databasemigration::operation::start_replication_task::StartReplicationTaskInput
source · #[non_exhaustive]pub struct StartReplicationTaskInput {
pub replication_task_arn: Option<String>,
pub start_replication_task_type: Option<StartReplicationTaskTypeValue>,
pub cdc_start_time: Option<DateTime>,
pub cdc_start_position: Option<String>,
pub cdc_stop_position: Option<String>,
}
Expand description
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.replication_task_arn: Option<String>
The Amazon Resource Name (ARN) of the replication task to be started.
start_replication_task_type: Option<StartReplicationTaskTypeValue>
The type of replication task to start.
When the migration type is full-load
or full-load-and-cdc
, the only valid value for the first run of the task is start-replication
. This option will start the migration.
You can also use ReloadTables
to reload specific tables that failed during migration instead of restarting the task.
The resume-processing
option isn't applicable for a full-load task, because you can't resume partially loaded tables during the full load phase.
For a full-load-and-cdc
task, DMS migrates table data, and then applies data changes that occur on the source. To load all the tables again, and start capturing source changes, use reload-target
. Otherwise use resume-processing
, to replicate the changes from the last stop position.
cdc_start_time: Option<DateTime>
Indicates the start time for a change data capture (CDC) operation. Use either CdcStartTime or CdcStartPosition to specify when you want a CDC operation to start. Specifying both values results in an error.
Timestamp Example: --cdc-start-time “2018-03-08T12:12:12”
cdc_start_position: Option<String>
Indicates when you want a change data capture (CDC) operation to start. Use either CdcStartPosition or CdcStartTime to specify when you want a CDC operation to start. Specifying both values results in an error.
The value can be in date, checkpoint, or LSN/SCN format.
Date Example: --cdc-start-position “2018-03-08T12:12:12”
Checkpoint Example: --cdc-start-position "checkpoint:V1#27#mysql-bin-changelog.157832:1975:-1:2002:677883278264080:mysql-bin-changelog.157832:1876#0#0#*#0#93"
LSN Example: --cdc-start-position “mysql-bin-changelog.000024:373”
When you use this task setting with a source PostgreSQL database, a logical replication slot should already be created and associated with the source endpoint. You can verify this by setting the slotName
extra connection attribute to the name of this logical replication slot. For more information, see Extra Connection Attributes When Using PostgreSQL as a Source for DMS.
cdc_stop_position: Option<String>
Indicates when you want a change data capture (CDC) operation to stop. The value can be either server time or commit time.
Server time example: --cdc-stop-position “server_time:2018-02-09T12:12:12”
Commit time example: --cdc-stop-position “commit_time: 2018-02-09T12:12:12“
Implementations§
source§impl StartReplicationTaskInput
impl StartReplicationTaskInput
sourcepub fn replication_task_arn(&self) -> Option<&str>
pub fn replication_task_arn(&self) -> Option<&str>
The Amazon Resource Name (ARN) of the replication task to be started.
sourcepub fn start_replication_task_type(
&self
) -> Option<&StartReplicationTaskTypeValue>
pub fn start_replication_task_type( &self ) -> Option<&StartReplicationTaskTypeValue>
The type of replication task to start.
When the migration type is full-load
or full-load-and-cdc
, the only valid value for the first run of the task is start-replication
. This option will start the migration.
You can also use ReloadTables
to reload specific tables that failed during migration instead of restarting the task.
The resume-processing
option isn't applicable for a full-load task, because you can't resume partially loaded tables during the full load phase.
For a full-load-and-cdc
task, DMS migrates table data, and then applies data changes that occur on the source. To load all the tables again, and start capturing source changes, use reload-target
. Otherwise use resume-processing
, to replicate the changes from the last stop position.
sourcepub fn cdc_start_time(&self) -> Option<&DateTime>
pub fn cdc_start_time(&self) -> Option<&DateTime>
Indicates the start time for a change data capture (CDC) operation. Use either CdcStartTime or CdcStartPosition to specify when you want a CDC operation to start. Specifying both values results in an error.
Timestamp Example: --cdc-start-time “2018-03-08T12:12:12”
sourcepub fn cdc_start_position(&self) -> Option<&str>
pub fn cdc_start_position(&self) -> Option<&str>
Indicates when you want a change data capture (CDC) operation to start. Use either CdcStartPosition or CdcStartTime to specify when you want a CDC operation to start. Specifying both values results in an error.
The value can be in date, checkpoint, or LSN/SCN format.
Date Example: --cdc-start-position “2018-03-08T12:12:12”
Checkpoint Example: --cdc-start-position "checkpoint:V1#27#mysql-bin-changelog.157832:1975:-1:2002:677883278264080:mysql-bin-changelog.157832:1876#0#0#*#0#93"
LSN Example: --cdc-start-position “mysql-bin-changelog.000024:373”
When you use this task setting with a source PostgreSQL database, a logical replication slot should already be created and associated with the source endpoint. You can verify this by setting the slotName
extra connection attribute to the name of this logical replication slot. For more information, see Extra Connection Attributes When Using PostgreSQL as a Source for DMS.
sourcepub fn cdc_stop_position(&self) -> Option<&str>
pub fn cdc_stop_position(&self) -> Option<&str>
Indicates when you want a change data capture (CDC) operation to stop. The value can be either server time or commit time.
Server time example: --cdc-stop-position “server_time:2018-02-09T12:12:12”
Commit time example: --cdc-stop-position “commit_time: 2018-02-09T12:12:12“
source§impl StartReplicationTaskInput
impl StartReplicationTaskInput
sourcepub fn builder() -> StartReplicationTaskInputBuilder
pub fn builder() -> StartReplicationTaskInputBuilder
Creates a new builder-style object to manufacture StartReplicationTaskInput
.
Trait Implementations§
source§impl Clone for StartReplicationTaskInput
impl Clone for StartReplicationTaskInput
source§fn clone(&self) -> StartReplicationTaskInput
fn clone(&self) -> StartReplicationTaskInput
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for StartReplicationTaskInput
impl Debug for StartReplicationTaskInput
source§impl PartialEq<StartReplicationTaskInput> for StartReplicationTaskInput
impl PartialEq<StartReplicationTaskInput> for StartReplicationTaskInput
source§fn eq(&self, other: &StartReplicationTaskInput) -> bool
fn eq(&self, other: &StartReplicationTaskInput) -> bool
self
and other
values to be equal, and is used
by ==
.