1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
// Code generated by smithy-go-codegen DO NOT EDIT.
package databasemigrationservice
import (
"context"
"fmt"
awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
"github.com/aws/aws-sdk-go-v2/aws/signer/v4"
"github.com/aws/aws-sdk-go-v2/service/databasemigrationservice/types"
"github.com/aws/smithy-go/middleware"
smithyhttp "github.com/aws/smithy-go/transport/http"
"time"
)
// Starts the replication task. For more information about DMS tasks, see Working
// with Migration Tasks (https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Tasks.html)
// in the Database Migration Service User Guide.
func (c *Client) StartReplicationTask(ctx context.Context, params *StartReplicationTaskInput, optFns ...func(*Options)) (*StartReplicationTaskOutput, error) {
if params == nil {
params = &StartReplicationTaskInput{}
}
result, metadata, err := c.invokeOperation(ctx, "StartReplicationTask", params, optFns, c.addOperationStartReplicationTaskMiddlewares)
if err != nil {
return nil, err
}
out := result.(*StartReplicationTaskOutput)
out.ResultMetadata = metadata
return out, nil
}
type StartReplicationTaskInput struct {
// The Amazon Resource Name (ARN) of the replication task to be started.
//
// This member is required.
ReplicationTaskArn *string
// 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.
//
// This member is required.
StartReplicationTaskType types.StartReplicationTaskTypeValue
// 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 (https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Source.PostgreSQL.html#CHAP_Source.PostgreSQL.ConnectionAttrib)
// .
CdcStartPosition *string
// 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”
CdcStartTime *time.Time
// 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“
CdcStopPosition *string
noSmithyDocumentSerde
}
type StartReplicationTaskOutput struct {
// The replication task started.
ReplicationTask *types.ReplicationTask
// Metadata pertaining to the operation's result.
ResultMetadata middleware.Metadata
noSmithyDocumentSerde
}
func (c *Client) addOperationStartReplicationTaskMiddlewares(stack *middleware.Stack, options Options) (err error) {
if err := stack.Serialize.Add(&setOperationInputMiddleware{}, middleware.After); err != nil {
return err
}
err = stack.Serialize.Add(&awsAwsjson11_serializeOpStartReplicationTask{}, middleware.After)
if err != nil {
return err
}
err = stack.Deserialize.Add(&awsAwsjson11_deserializeOpStartReplicationTask{}, middleware.After)
if err != nil {
return err
}
if err := addProtocolFinalizerMiddlewares(stack, options, "StartReplicationTask"); err != nil {
return fmt.Errorf("add protocol finalizers: %v", err)
}
if err = addlegacyEndpointContextSetter(stack, options); err != nil {
return err
}
if err = addSetLoggerMiddleware(stack, options); err != nil {
return err
}
if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil {
return err
}
if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil {
return err
}
if err = addResolveEndpointMiddleware(stack, options); err != nil {
return err
}
if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil {
return err
}
if err = addRetryMiddlewares(stack, options); err != nil {
return err
}
if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil {
return err
}
if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil {
return err
}
if err = addClientUserAgent(stack, options); err != nil {
return err
}
if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil {
return err
}
if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil {
return err
}
if err = addSetLegacyContextSigningOptionsMiddleware(stack); err != nil {
return err
}
if err = addOpStartReplicationTaskValidationMiddleware(stack); err != nil {
return err
}
if err = stack.Initialize.Add(newServiceMetadataMiddleware_opStartReplicationTask(options.Region), middleware.Before); err != nil {
return err
}
if err = awsmiddleware.AddRecursionDetection(stack); err != nil {
return err
}
if err = addRequestIDRetrieverMiddleware(stack); err != nil {
return err
}
if err = addResponseErrorMiddleware(stack); err != nil {
return err
}
if err = addRequestResponseLogging(stack, options); err != nil {
return err
}
if err = addDisableHTTPSMiddleware(stack, options); err != nil {
return err
}
return nil
}
func newServiceMetadataMiddleware_opStartReplicationTask(region string) *awsmiddleware.RegisterServiceMetadata {
return &awsmiddleware.RegisterServiceMetadata{
Region: region,
ServiceID: ServiceID,
OperationName: "StartReplicationTask",
}
}
|
