com.amazonaws.services.databasemigrationservice.model

Class S3Settings

java.lang.Object

com.amazonaws.services.databasemigrationservice.model.S3Settings

All Implemented Interfaces:

StructuredPojo, Serializable, Cloneable

@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class S3Settings
extends Object
implements Serializable, Cloneable, StructuredPojo

Settings for exporting data to Amazon S3.

See Also:

AWS API Documentation, Serialized Form

Constructor Summary

Constructors

Constructor and Description
S3Settings()

Method Summary

Modifier and Type	Method and Description
S3Settings	clone()
boolean	equals(Object obj)
String	getBucketFolder() An optional parameter to set a folder name in the S3 bucket.
String	getBucketName() The name of the S3 bucket.
Boolean	getCdcInsertsOnly() A value that enables a change data capture (CDC) load to write only INSERT operations to .csv or columnar storage (.parquet) output files.
String	getCompressionType() An optional parameter to use GZIP to compress the target files.
String	getCsvDelimiter() The delimiter used to separate columns in the source files.
String	getCsvRowDelimiter() The delimiter used to separate rows in the source files.
String	getDataFormat() The format of the data that you want to use for output.
Integer	getDataPageSize() The size of one data page in bytes.
Integer	getDictPageSizeLimit() The maximum size of an encoded dictionary page of a column.
Boolean	getEnableStatistics() A value that enables statistics for Parquet pages and row groups.
String	getEncodingType() The type of encoding you are using:
String	getEncryptionMode() The type of server-side encryption that you want to use for your data.
String	getExternalTableDefinition() The external table definition.
Boolean	getIncludeOpForFullLoad() A value that enables a full load to write INSERT operations to the comma-separated value (.csv) output files only to indicate how the rows were added to the source database.
String	getParquetVersion() The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.
Integer	getRowGroupLength() The number of rows in a row group.
String	getServerSideEncryptionKmsKeyId() If you are using SSE_KMS for the EncryptionMode, provide the AWS KMS key ID.
String	getServiceAccessRoleArn() The Amazon Resource Name (ARN) used by the service access IAM role.
String	getTimestampColumnName() A value that includes a timestamp column in the Amazon S3 target endpoint data.
int	hashCode()
Boolean	isCdcInsertsOnly() A value that enables a change data capture (CDC) load to write only INSERT operations to .csv or columnar storage (.parquet) output files.
Boolean	isEnableStatistics() A value that enables statistics for Parquet pages and row groups.
Boolean	isIncludeOpForFullLoad() A value that enables a full load to write INSERT operations to the comma-separated value (.csv) output files only to indicate how the rows were added to the source database.
void	marshall(ProtocolMarshaller protocolMarshaller)
void	setBucketFolder(String bucketFolder) An optional parameter to set a folder name in the S3 bucket.
void	setBucketName(String bucketName) The name of the S3 bucket.
void	setCdcInsertsOnly(Boolean cdcInsertsOnly) A value that enables a change data capture (CDC) load to write only INSERT operations to .csv or columnar storage (.parquet) output files.
void	setCompressionType(CompressionTypeValue compressionType) An optional parameter to use GZIP to compress the target files.
void	setCompressionType(String compressionType) An optional parameter to use GZIP to compress the target files.
void	setCsvDelimiter(String csvDelimiter) The delimiter used to separate columns in the source files.
void	setCsvRowDelimiter(String csvRowDelimiter) The delimiter used to separate rows in the source files.
void	setDataFormat(DataFormatValue dataFormat) The format of the data that you want to use for output.
void	setDataFormat(String dataFormat) The format of the data that you want to use for output.
void	setDataPageSize(Integer dataPageSize) The size of one data page in bytes.
void	setDictPageSizeLimit(Integer dictPageSizeLimit) The maximum size of an encoded dictionary page of a column.
void	setEnableStatistics(Boolean enableStatistics) A value that enables statistics for Parquet pages and row groups.
void	setEncodingType(EncodingTypeValue encodingType) The type of encoding you are using:
void	setEncodingType(String encodingType) The type of encoding you are using:
void	setEncryptionMode(EncryptionModeValue encryptionMode) The type of server-side encryption that you want to use for your data.
void	setEncryptionMode(String encryptionMode) The type of server-side encryption that you want to use for your data.
void	setExternalTableDefinition(String externalTableDefinition) The external table definition.
void	setIncludeOpForFullLoad(Boolean includeOpForFullLoad) A value that enables a full load to write INSERT operations to the comma-separated value (.csv) output files only to indicate how the rows were added to the source database.
void	setParquetVersion(ParquetVersionValue parquetVersion) The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.
void	setParquetVersion(String parquetVersion) The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.
void	setRowGroupLength(Integer rowGroupLength) The number of rows in a row group.
void	setServerSideEncryptionKmsKeyId(String serverSideEncryptionKmsKeyId) If you are using SSE_KMS for the EncryptionMode, provide the AWS KMS key ID.
void	setServiceAccessRoleArn(String serviceAccessRoleArn) The Amazon Resource Name (ARN) used by the service access IAM role.
void	setTimestampColumnName(String timestampColumnName) A value that includes a timestamp column in the Amazon S3 target endpoint data.
String	toString() Returns a string representation of this object.
S3Settings	withBucketFolder(String bucketFolder) An optional parameter to set a folder name in the S3 bucket.
S3Settings	withBucketName(String bucketName) The name of the S3 bucket.
S3Settings	withCdcInsertsOnly(Boolean cdcInsertsOnly) A value that enables a change data capture (CDC) load to write only INSERT operations to .csv or columnar storage (.parquet) output files.
S3Settings	withCompressionType(CompressionTypeValue compressionType) An optional parameter to use GZIP to compress the target files.
S3Settings	withCompressionType(String compressionType) An optional parameter to use GZIP to compress the target files.
S3Settings	withCsvDelimiter(String csvDelimiter) The delimiter used to separate columns in the source files.
S3Settings	withCsvRowDelimiter(String csvRowDelimiter) The delimiter used to separate rows in the source files.
S3Settings	withDataFormat(DataFormatValue dataFormat) The format of the data that you want to use for output.
S3Settings	withDataFormat(String dataFormat) The format of the data that you want to use for output.
S3Settings	withDataPageSize(Integer dataPageSize) The size of one data page in bytes.
S3Settings	withDictPageSizeLimit(Integer dictPageSizeLimit) The maximum size of an encoded dictionary page of a column.
S3Settings	withEnableStatistics(Boolean enableStatistics) A value that enables statistics for Parquet pages and row groups.
S3Settings	withEncodingType(EncodingTypeValue encodingType) The type of encoding you are using:
S3Settings	withEncodingType(String encodingType) The type of encoding you are using:
S3Settings	withEncryptionMode(EncryptionModeValue encryptionMode) The type of server-side encryption that you want to use for your data.
S3Settings	withEncryptionMode(String encryptionMode) The type of server-side encryption that you want to use for your data.
S3Settings	withExternalTableDefinition(String externalTableDefinition) The external table definition.
S3Settings	withIncludeOpForFullLoad(Boolean includeOpForFullLoad) A value that enables a full load to write INSERT operations to the comma-separated value (.csv) output files only to indicate how the rows were added to the source database.
S3Settings	withParquetVersion(ParquetVersionValue parquetVersion) The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.
S3Settings	withParquetVersion(String parquetVersion) The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.
S3Settings	withRowGroupLength(Integer rowGroupLength) The number of rows in a row group.
S3Settings	withServerSideEncryptionKmsKeyId(String serverSideEncryptionKmsKeyId) If you are using SSE_KMS for the EncryptionMode, provide the AWS KMS key ID.
S3Settings	withServiceAccessRoleArn(String serviceAccessRoleArn) The Amazon Resource Name (ARN) used by the service access IAM role.
S3Settings	withTimestampColumnName(String timestampColumnName) A value that includes a timestamp column in the Amazon S3 target endpoint data.

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

S3Settings

public S3Settings()

Method Detail

setServiceAccessRoleArn

public void setServiceAccessRoleArn(String serviceAccessRoleArn)

The Amazon Resource Name (ARN) used by the service access IAM role.

Parameters:

serviceAccessRoleArn - The Amazon Resource Name (ARN) used by the service access IAM role.

getServiceAccessRoleArn

public String getServiceAccessRoleArn()

The Amazon Resource Name (ARN) used by the service access IAM role.

Returns:

The Amazon Resource Name (ARN) used by the service access IAM role.

withServiceAccessRoleArn

public S3Settings withServiceAccessRoleArn(String serviceAccessRoleArn)

The Amazon Resource Name (ARN) used by the service access IAM role.

Parameters:

serviceAccessRoleArn - The Amazon Resource Name (ARN) used by the service access IAM role.

Returns:

Returns a reference to this object so that method calls can be chained together.

setExternalTableDefinition

public void setExternalTableDefinition(String externalTableDefinition)

The external table definition.

Parameters:

externalTableDefinition - The external table definition.

getExternalTableDefinition

public String getExternalTableDefinition()

The external table definition.

Returns:

The external table definition.

withExternalTableDefinition

public S3Settings withExternalTableDefinition(String externalTableDefinition)

The external table definition.

Parameters:

externalTableDefinition - The external table definition.

Returns:

Returns a reference to this object so that method calls can be chained together.

setCsvRowDelimiter

public void setCsvRowDelimiter(String csvRowDelimiter)

The delimiter used to separate rows in the source files. The default is a carriage return (\n).

Parameters:

csvRowDelimiter - The delimiter used to separate rows in the source files. The default is a carriage return (\n ).

getCsvRowDelimiter

public String getCsvRowDelimiter()

The delimiter used to separate rows in the source files. The default is a carriage return (\n).

Returns:

The delimiter used to separate rows in the source files. The default is a carriage return ( \n).

withCsvRowDelimiter

public S3Settings withCsvRowDelimiter(String csvRowDelimiter)

The delimiter used to separate rows in the source files. The default is a carriage return (\n).

Parameters:

csvRowDelimiter - The delimiter used to separate rows in the source files. The default is a carriage return (\n ).

Returns:

Returns a reference to this object so that method calls can be chained together.

setCsvDelimiter

public void setCsvDelimiter(String csvDelimiter)

The delimiter used to separate columns in the source files. The default is a comma.

Parameters:

csvDelimiter - The delimiter used to separate columns in the source files. The default is a comma.

getCsvDelimiter

public String getCsvDelimiter()

The delimiter used to separate columns in the source files. The default is a comma.

Returns:

The delimiter used to separate columns in the source files. The default is a comma.

withCsvDelimiter

public S3Settings withCsvDelimiter(String csvDelimiter)

The delimiter used to separate columns in the source files. The default is a comma.

Parameters:

csvDelimiter - The delimiter used to separate columns in the source files. The default is a comma.

Returns:

Returns a reference to this object so that method calls can be chained together.

setBucketFolder

public void setBucketFolder(String bucketFolder)

An optional parameter to set a folder name in the S3 bucket. If provided, tables are created in the path bucketFolder/schema_name/table_name/. If this parameter is not specified, then the path used is schema_name/table_name/.

Parameters:

bucketFolder - An optional parameter to set a folder name in the S3 bucket. If provided, tables are created in the path bucketFolder/schema_name/table_name/. If this parameter is not specified, then the path used is schema_name/table_name/.

getBucketFolder

public String getBucketFolder()

An optional parameter to set a folder name in the S3 bucket. If provided, tables are created in the path bucketFolder/schema_name/table_name/. If this parameter is not specified, then the path used is schema_name/table_name/.

Returns:

An optional parameter to set a folder name in the S3 bucket. If provided, tables are created in the path bucketFolder/schema_name/table_name/. If this parameter is not specified, then the path used is schema_name/table_name/.

withBucketFolder

public S3Settings withBucketFolder(String bucketFolder)

An optional parameter to set a folder name in the S3 bucket. If provided, tables are created in the path bucketFolder/schema_name/table_name/. If this parameter is not specified, then the path used is schema_name/table_name/.

Parameters:

bucketFolder - An optional parameter to set a folder name in the S3 bucket. If provided, tables are created in the path bucketFolder/schema_name/table_name/. If this parameter is not specified, then the path used is schema_name/table_name/.

Returns:

Returns a reference to this object so that method calls can be chained together.

setBucketName

public void setBucketName(String bucketName)

The name of the S3 bucket.

Parameters:

bucketName - The name of the S3 bucket.

getBucketName

public String getBucketName()

The name of the S3 bucket.

Returns:

The name of the S3 bucket.

withBucketName

public S3Settings withBucketName(String bucketName)

The name of the S3 bucket.

Parameters:

bucketName - The name of the S3 bucket.

Returns:

Returns a reference to this object so that method calls can be chained together.

setCompressionType

public void setCompressionType(String compressionType)

An optional parameter to use GZIP to compress the target files. Set to GZIP to compress the target files. Set to NONE (the default) or do not use to leave the files uncompressed. Applies to both .csv and .parquet file formats.

Parameters:

compressionType - An optional parameter to use GZIP to compress the target files. Set to GZIP to compress the target files. Set to NONE (the default) or do not use to leave the files uncompressed. Applies to both .csv and .parquet file formats.

See Also:

CompressionTypeValue

getCompressionType

public String getCompressionType()

An optional parameter to use GZIP to compress the target files. Set to GZIP to compress the target files. Set to NONE (the default) or do not use to leave the files uncompressed. Applies to both .csv and .parquet file formats.

Returns:

An optional parameter to use GZIP to compress the target files. Set to GZIP to compress the target files. Set to NONE (the default) or do not use to leave the files uncompressed. Applies to both .csv and .parquet file formats.

See Also:

CompressionTypeValue

withCompressionType

public S3Settings withCompressionType(String compressionType)

An optional parameter to use GZIP to compress the target files. Set to GZIP to compress the target files. Set to NONE (the default) or do not use to leave the files uncompressed. Applies to both .csv and .parquet file formats.

Parameters:

compressionType - An optional parameter to use GZIP to compress the target files. Set to GZIP to compress the target files. Set to NONE (the default) or do not use to leave the files uncompressed. Applies to both .csv and .parquet file formats.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

CompressionTypeValue

setCompressionType

public void setCompressionType(CompressionTypeValue compressionType)

An optional parameter to use GZIP to compress the target files. Set to GZIP to compress the target files. Set to NONE (the default) or do not use to leave the files uncompressed. Applies to both .csv and .parquet file formats.

Parameters:

compressionType - An optional parameter to use GZIP to compress the target files. Set to GZIP to compress the target files. Set to NONE (the default) or do not use to leave the files uncompressed. Applies to both .csv and .parquet file formats.

See Also:

CompressionTypeValue

withCompressionType

public S3Settings withCompressionType(CompressionTypeValue compressionType)

An optional parameter to use GZIP to compress the target files. Set to GZIP to compress the target files. Set to NONE (the default) or do not use to leave the files uncompressed. Applies to both .csv and .parquet file formats.

Parameters:

compressionType - An optional parameter to use GZIP to compress the target files. Set to GZIP to compress the target files. Set to NONE (the default) or do not use to leave the files uncompressed. Applies to both .csv and .parquet file formats.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

CompressionTypeValue

setEncryptionMode

public void setEncryptionMode(String encryptionMode)

The type of server-side encryption that you want to use for your data. This encryption type is part of the endpoint settings or the extra connections attributes for Amazon S3. You can choose either SSE_S3 (the default) or SSE_KMS. To use SSE_S3, you need an AWS Identity and Access Management (IAM) role with permission to allow "arn:aws:s3:::dms-*" to use the following actions:

• s3:CreateBucket

• s3:ListBucket

• s3:DeleteBucket

• s3:GetBucketLocation

• s3:GetObject

• s3:PutObject

• s3:DeleteObject

• s3:GetObjectVersion

• s3:GetBucketPolicy

• s3:PutBucketPolicy

• s3:DeleteBucketPolicy

Parameters:

encryptionMode - The type of server-side encryption that you want to use for your data. This encryption type is part of the endpoint settings or the extra connections attributes for Amazon S3. You can choose either SSE_S3 (the default) or SSE_KMS. To use SSE_S3, you need an AWS Identity and Access Management (IAM) role with permission to allow "arn:aws:s3:::dms-*" to use the following actions:

• s3:CreateBucket

• s3:ListBucket

• s3:DeleteBucket

• s3:GetBucketLocation

• s3:GetObject

• s3:PutObject

• s3:DeleteObject

• s3:GetObjectVersion

• s3:GetBucketPolicy

• s3:PutBucketPolicy

• s3:DeleteBucketPolicy

See Also:

EncryptionModeValue

getEncryptionMode

public String getEncryptionMode()

The type of server-side encryption that you want to use for your data. This encryption type is part of the endpoint settings or the extra connections attributes for Amazon S3. You can choose either SSE_S3 (the default) or SSE_KMS. To use SSE_S3, you need an AWS Identity and Access Management (IAM) role with permission to allow "arn:aws:s3:::dms-*" to use the following actions:

• s3:CreateBucket

• s3:ListBucket

• s3:DeleteBucket

• s3:GetBucketLocation

• s3:GetObject

• s3:PutObject

• s3:DeleteObject

• s3:GetObjectVersion

• s3:GetBucketPolicy

• s3:PutBucketPolicy

• s3:DeleteBucketPolicy

Returns:

The type of server-side encryption that you want to use for your data. This encryption type is part of the endpoint settings or the extra connections attributes for Amazon S3. You can choose either SSE_S3 (the default) or SSE_KMS. To use SSE_S3, you need an AWS Identity and Access Management (IAM) role with permission to allow "arn:aws:s3:::dms-*" to use the following actions:

• s3:CreateBucket

• s3:ListBucket

• s3:DeleteBucket

• s3:GetBucketLocation

• s3:GetObject

• s3:PutObject

• s3:DeleteObject

• s3:GetObjectVersion

• s3:GetBucketPolicy

• s3:PutBucketPolicy

• s3:DeleteBucketPolicy

See Also:

EncryptionModeValue

withEncryptionMode

public S3Settings withEncryptionMode(String encryptionMode)

The type of server-side encryption that you want to use for your data. This encryption type is part of the endpoint settings or the extra connections attributes for Amazon S3. You can choose either SSE_S3 (the default) or SSE_KMS. To use SSE_S3, you need an AWS Identity and Access Management (IAM) role with permission to allow "arn:aws:s3:::dms-*" to use the following actions:

• s3:CreateBucket

• s3:ListBucket

• s3:DeleteBucket

• s3:GetBucketLocation

• s3:GetObject

• s3:PutObject

• s3:DeleteObject

• s3:GetObjectVersion

• s3:GetBucketPolicy

• s3:PutBucketPolicy

• s3:DeleteBucketPolicy

Parameters:

encryptionMode - The type of server-side encryption that you want to use for your data. This encryption type is part of the endpoint settings or the extra connections attributes for Amazon S3. You can choose either SSE_S3 (the default) or SSE_KMS. To use SSE_S3, you need an AWS Identity and Access Management (IAM) role with permission to allow "arn:aws:s3:::dms-*" to use the following actions:

• s3:CreateBucket

• s3:ListBucket

• s3:DeleteBucket

• s3:GetBucketLocation

• s3:GetObject

• s3:PutObject

• s3:DeleteObject

• s3:GetObjectVersion

• s3:GetBucketPolicy

• s3:PutBucketPolicy

• s3:DeleteBucketPolicy

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

EncryptionModeValue

setEncryptionMode

public void setEncryptionMode(EncryptionModeValue encryptionMode)

The type of server-side encryption that you want to use for your data. This encryption type is part of the endpoint settings or the extra connections attributes for Amazon S3. You can choose either SSE_S3 (the default) or SSE_KMS. To use SSE_S3, you need an AWS Identity and Access Management (IAM) role with permission to allow "arn:aws:s3:::dms-*" to use the following actions:

• s3:CreateBucket

• s3:ListBucket

• s3:DeleteBucket

• s3:GetBucketLocation

• s3:GetObject

• s3:PutObject

• s3:DeleteObject

• s3:GetObjectVersion

• s3:GetBucketPolicy

• s3:PutBucketPolicy

• s3:DeleteBucketPolicy

Parameters:

encryptionMode - The type of server-side encryption that you want to use for your data. This encryption type is part of the endpoint settings or the extra connections attributes for Amazon S3. You can choose either SSE_S3 (the default) or SSE_KMS. To use SSE_S3, you need an AWS Identity and Access Management (IAM) role with permission to allow "arn:aws:s3:::dms-*" to use the following actions:

• s3:CreateBucket

• s3:ListBucket

• s3:DeleteBucket

• s3:GetBucketLocation

• s3:GetObject

• s3:PutObject

• s3:DeleteObject

• s3:GetObjectVersion

• s3:GetBucketPolicy

• s3:PutBucketPolicy

• s3:DeleteBucketPolicy

See Also:

EncryptionModeValue

withEncryptionMode

public S3Settings withEncryptionMode(EncryptionModeValue encryptionMode)

The type of server-side encryption that you want to use for your data. This encryption type is part of the endpoint settings or the extra connections attributes for Amazon S3. You can choose either SSE_S3 (the default) or SSE_KMS. To use SSE_S3, you need an AWS Identity and Access Management (IAM) role with permission to allow "arn:aws:s3:::dms-*" to use the following actions:

• s3:CreateBucket

• s3:ListBucket

• s3:DeleteBucket

• s3:GetBucketLocation

• s3:GetObject

• s3:PutObject

• s3:DeleteObject

• s3:GetObjectVersion

• s3:GetBucketPolicy

• s3:PutBucketPolicy

• s3:DeleteBucketPolicy

Parameters:

encryptionMode - The type of server-side encryption that you want to use for your data. This encryption type is part of the endpoint settings or the extra connections attributes for Amazon S3. You can choose either SSE_S3 (the default) or SSE_KMS. To use SSE_S3, you need an AWS Identity and Access Management (IAM) role with permission to allow "arn:aws:s3:::dms-*" to use the following actions:

• s3:CreateBucket

• s3:ListBucket

• s3:DeleteBucket

• s3:GetBucketLocation

• s3:GetObject

• s3:PutObject

• s3:DeleteObject

• s3:GetObjectVersion

• s3:GetBucketPolicy

• s3:PutBucketPolicy

• s3:DeleteBucketPolicy

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

EncryptionModeValue

setServerSideEncryptionKmsKeyId

public void setServerSideEncryptionKmsKeyId(String serverSideEncryptionKmsKeyId)

If you are using SSE_KMS for the EncryptionMode, provide the AWS KMS key ID. The key that you use needs an attached policy that enables AWS Identity and Access Management (IAM) user permissions and allows use of the key.

Here is a CLI example: aws dms create-endpoint --endpoint-identifier value --endpoint-type target --engine-name s3 --s3-settings ServiceAccessRoleArn=value,BucketFolder=value,BucketName=value,EncryptionMode=SSE_KMS,ServerSideEncryptionKmsKeyId=value

Parameters:

serverSideEncryptionKmsKeyId - If you are using SSE_KMS for the EncryptionMode, provide the AWS KMS key ID. The key that you use needs an attached policy that enables AWS Identity and Access Management (IAM) user permissions and allows use of the key.

Here is a CLI example: aws dms create-endpoint --endpoint-identifier value --endpoint-type target --engine-name s3 --s3-settings ServiceAccessRoleArn=value,BucketFolder=value,BucketName=value,EncryptionMode=SSE_KMS,ServerSideEncryptionKmsKeyId=value

getServerSideEncryptionKmsKeyId

public String getServerSideEncryptionKmsKeyId()

If you are using SSE_KMS for the EncryptionMode, provide the AWS KMS key ID. The key that you use needs an attached policy that enables AWS Identity and Access Management (IAM) user permissions and allows use of the key.

Here is a CLI example: aws dms create-endpoint --endpoint-identifier value --endpoint-type target --engine-name s3 --s3-settings ServiceAccessRoleArn=value,BucketFolder=value,BucketName=value,EncryptionMode=SSE_KMS,ServerSideEncryptionKmsKeyId=value

Returns:

If you are using SSE_KMS for the EncryptionMode, provide the AWS KMS key ID. The key that you use needs an attached policy that enables AWS Identity and Access Management (IAM) user permissions and allows use of the key.

Here is a CLI example: aws dms create-endpoint --endpoint-identifier value --endpoint-type target --engine-name s3 --s3-settings ServiceAccessRoleArn=value,BucketFolder=value,BucketName=value,EncryptionMode=SSE_KMS,ServerSideEncryptionKmsKeyId=value

withServerSideEncryptionKmsKeyId

public S3Settings withServerSideEncryptionKmsKeyId(String serverSideEncryptionKmsKeyId)

If you are using SSE_KMS for the EncryptionMode, provide the AWS KMS key ID. The key that you use needs an attached policy that enables AWS Identity and Access Management (IAM) user permissions and allows use of the key.

Here is a CLI example: aws dms create-endpoint --endpoint-identifier value --endpoint-type target --engine-name s3 --s3-settings ServiceAccessRoleArn=value,BucketFolder=value,BucketName=value,EncryptionMode=SSE_KMS,ServerSideEncryptionKmsKeyId=value

Parameters:

serverSideEncryptionKmsKeyId - If you are using SSE_KMS for the EncryptionMode, provide the AWS KMS key ID. The key that you use needs an attached policy that enables AWS Identity and Access Management (IAM) user permissions and allows use of the key.

Here is a CLI example: aws dms create-endpoint --endpoint-identifier value --endpoint-type target --engine-name s3 --s3-settings ServiceAccessRoleArn=value,BucketFolder=value,BucketName=value,EncryptionMode=SSE_KMS,ServerSideEncryptionKmsKeyId=value

Returns:

Returns a reference to this object so that method calls can be chained together.

setDataFormat

public void setDataFormat(String dataFormat)

The format of the data that you want to use for output. You can choose one of the following:

• csv : This is a row-based file format with comma-separated values (.csv).

• parquet : Apache Parquet (.parquet) is a columnar storage file format that features efficient compression and provides faster query response.

Parameters:

dataFormat - The format of the data that you want to use for output. You can choose one of the following:

• csv : This is a row-based file format with comma-separated values (.csv).

• parquet : Apache Parquet (.parquet) is a columnar storage file format that features efficient compression and provides faster query response.

See Also:

DataFormatValue

getDataFormat

public String getDataFormat()

The format of the data that you want to use for output. You can choose one of the following:

• csv : This is a row-based file format with comma-separated values (.csv).

• parquet : Apache Parquet (.parquet) is a columnar storage file format that features efficient compression and provides faster query response.

Returns:

The format of the data that you want to use for output. You can choose one of the following:

• csv : This is a row-based file format with comma-separated values (.csv).

• parquet : Apache Parquet (.parquet) is a columnar storage file format that features efficient compression and provides faster query response.

See Also:

DataFormatValue

withDataFormat

public S3Settings withDataFormat(String dataFormat)

The format of the data that you want to use for output. You can choose one of the following:

• csv : This is a row-based file format with comma-separated values (.csv).

• parquet : Apache Parquet (.parquet) is a columnar storage file format that features efficient compression and provides faster query response.

Parameters:

dataFormat - The format of the data that you want to use for output. You can choose one of the following:

• csv : This is a row-based file format with comma-separated values (.csv).

• parquet : Apache Parquet (.parquet) is a columnar storage file format that features efficient compression and provides faster query response.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

DataFormatValue

setDataFormat

public void setDataFormat(DataFormatValue dataFormat)

The format of the data that you want to use for output. You can choose one of the following:

• csv : This is a row-based file format with comma-separated values (.csv).

• parquet : Apache Parquet (.parquet) is a columnar storage file format that features efficient compression and provides faster query response.

Parameters:

dataFormat - The format of the data that you want to use for output. You can choose one of the following:

• csv : This is a row-based file format with comma-separated values (.csv).

• parquet : Apache Parquet (.parquet) is a columnar storage file format that features efficient compression and provides faster query response.

See Also:

DataFormatValue

withDataFormat

public S3Settings withDataFormat(DataFormatValue dataFormat)

The format of the data that you want to use for output. You can choose one of the following:

• csv : This is a row-based file format with comma-separated values (.csv).

• parquet : Apache Parquet (.parquet) is a columnar storage file format that features efficient compression and provides faster query response.

Parameters:

dataFormat - The format of the data that you want to use for output. You can choose one of the following:

• csv : This is a row-based file format with comma-separated values (.csv).

• parquet : Apache Parquet (.parquet) is a columnar storage file format that features efficient compression and provides faster query response.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

DataFormatValue

setEncodingType

public void setEncodingType(String encodingType)

The type of encoding you are using:

• RLE_DICTIONARY uses a combination of bit-packing and run-length encoding to store repeated values more efficiently. This is the default.

• PLAIN doesn't use encoding at all. Values are stored as they are.

• PLAIN_DICTIONARY builds a dictionary of the values encountered in a given column. The dictionary is stored in a dictionary page for each column chunk.

Parameters:

encodingType - The type of encoding you are using:

• RLE_DICTIONARY uses a combination of bit-packing and run-length encoding to store repeated values more efficiently. This is the default.

• PLAIN doesn't use encoding at all. Values are stored as they are.

• PLAIN_DICTIONARY builds a dictionary of the values encountered in a given column. The dictionary is stored in a dictionary page for each column chunk.

See Also:

EncodingTypeValue

getEncodingType

public String getEncodingType()

The type of encoding you are using:

• RLE_DICTIONARY uses a combination of bit-packing and run-length encoding to store repeated values more efficiently. This is the default.

• PLAIN doesn't use encoding at all. Values are stored as they are.

• PLAIN_DICTIONARY builds a dictionary of the values encountered in a given column. The dictionary is stored in a dictionary page for each column chunk.

Returns:

The type of encoding you are using:

• RLE_DICTIONARY uses a combination of bit-packing and run-length encoding to store repeated values more efficiently. This is the default.

• PLAIN doesn't use encoding at all. Values are stored as they are.

• PLAIN_DICTIONARY builds a dictionary of the values encountered in a given column. The dictionary is stored in a dictionary page for each column chunk.

See Also:

EncodingTypeValue

withEncodingType

public S3Settings withEncodingType(String encodingType)

The type of encoding you are using:

• RLE_DICTIONARY uses a combination of bit-packing and run-length encoding to store repeated values more efficiently. This is the default.

• PLAIN doesn't use encoding at all. Values are stored as they are.

• PLAIN_DICTIONARY builds a dictionary of the values encountered in a given column. The dictionary is stored in a dictionary page for each column chunk.

Parameters:

encodingType - The type of encoding you are using:

• RLE_DICTIONARY uses a combination of bit-packing and run-length encoding to store repeated values more efficiently. This is the default.

• PLAIN doesn't use encoding at all. Values are stored as they are.

• PLAIN_DICTIONARY builds a dictionary of the values encountered in a given column. The dictionary is stored in a dictionary page for each column chunk.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

EncodingTypeValue

setEncodingType

public void setEncodingType(EncodingTypeValue encodingType)

The type of encoding you are using:

• RLE_DICTIONARY uses a combination of bit-packing and run-length encoding to store repeated values more efficiently. This is the default.

• PLAIN doesn't use encoding at all. Values are stored as they are.

• PLAIN_DICTIONARY builds a dictionary of the values encountered in a given column. The dictionary is stored in a dictionary page for each column chunk.

Parameters:

encodingType - The type of encoding you are using:

• RLE_DICTIONARY uses a combination of bit-packing and run-length encoding to store repeated values more efficiently. This is the default.

• PLAIN doesn't use encoding at all. Values are stored as they are.

• PLAIN_DICTIONARY builds a dictionary of the values encountered in a given column. The dictionary is stored in a dictionary page for each column chunk.

See Also:

EncodingTypeValue

withEncodingType

public S3Settings withEncodingType(EncodingTypeValue encodingType)

The type of encoding you are using:

• RLE_DICTIONARY uses a combination of bit-packing and run-length encoding to store repeated values more efficiently. This is the default.

• PLAIN doesn't use encoding at all. Values are stored as they are.

• PLAIN_DICTIONARY builds a dictionary of the values encountered in a given column. The dictionary is stored in a dictionary page for each column chunk.

Parameters:

encodingType - The type of encoding you are using:

• RLE_DICTIONARY uses a combination of bit-packing and run-length encoding to store repeated values more efficiently. This is the default.

• PLAIN doesn't use encoding at all. Values are stored as they are.

• PLAIN_DICTIONARY builds a dictionary of the values encountered in a given column. The dictionary is stored in a dictionary page for each column chunk.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

EncodingTypeValue

setDictPageSizeLimit

public void setDictPageSizeLimit(Integer dictPageSizeLimit)

The maximum size of an encoded dictionary page of a column. If the dictionary page exceeds this, this column is stored using an encoding type of PLAIN. This parameter defaults to 1024 * 1024 bytes (1 MiB), the maximum size of a dictionary page before it reverts to PLAIN encoding. This size is used for .parquet file format only.

Parameters:

dictPageSizeLimit - The maximum size of an encoded dictionary page of a column. If the dictionary page exceeds this, this column is stored using an encoding type of PLAIN. This parameter defaults to 1024 * 1024 bytes (1 MiB), the maximum size of a dictionary page before it reverts to PLAIN encoding. This size is used for .parquet file format only.

getDictPageSizeLimit

public Integer getDictPageSizeLimit()

The maximum size of an encoded dictionary page of a column. If the dictionary page exceeds this, this column is stored using an encoding type of PLAIN. This parameter defaults to 1024 * 1024 bytes (1 MiB), the maximum size of a dictionary page before it reverts to PLAIN encoding. This size is used for .parquet file format only.

Returns:

The maximum size of an encoded dictionary page of a column. If the dictionary page exceeds this, this column is stored using an encoding type of PLAIN. This parameter defaults to 1024 * 1024 bytes (1 MiB), the maximum size of a dictionary page before it reverts to PLAIN encoding. This size is used for .parquet file format only.

withDictPageSizeLimit

public S3Settings withDictPageSizeLimit(Integer dictPageSizeLimit)

The maximum size of an encoded dictionary page of a column. If the dictionary page exceeds this, this column is stored using an encoding type of PLAIN. This parameter defaults to 1024 * 1024 bytes (1 MiB), the maximum size of a dictionary page before it reverts to PLAIN encoding. This size is used for .parquet file format only.

Parameters:

dictPageSizeLimit - The maximum size of an encoded dictionary page of a column. If the dictionary page exceeds this, this column is stored using an encoding type of PLAIN. This parameter defaults to 1024 * 1024 bytes (1 MiB), the maximum size of a dictionary page before it reverts to PLAIN encoding. This size is used for .parquet file format only.

Returns:

Returns a reference to this object so that method calls can be chained together.

setRowGroupLength

public void setRowGroupLength(Integer rowGroupLength)

The number of rows in a row group. A smaller row group size provides faster reads. But as the number of row groups grows, the slower writes become. This parameter defaults to 10,000 rows. This number is used for .parquet file format only.

If you choose a value larger than the maximum, RowGroupLength is set to the max row group length in bytes (64 * 1024 * 1024).

Parameters:

rowGroupLength - The number of rows in a row group. A smaller row group size provides faster reads. But as the number of row groups grows, the slower writes become. This parameter defaults to 10,000 rows. This number is used for .parquet file format only.

If you choose a value larger than the maximum, RowGroupLength is set to the max row group length in bytes (64 * 1024 * 1024).

getRowGroupLength

public Integer getRowGroupLength()

The number of rows in a row group. A smaller row group size provides faster reads. But as the number of row groups grows, the slower writes become. This parameter defaults to 10,000 rows. This number is used for .parquet file format only.

If you choose a value larger than the maximum, RowGroupLength is set to the max row group length in bytes (64 * 1024 * 1024).

Returns:

The number of rows in a row group. A smaller row group size provides faster reads. But as the number of row groups grows, the slower writes become. This parameter defaults to 10,000 rows. This number is used for .parquet file format only.

If you choose a value larger than the maximum, RowGroupLength is set to the max row group length in bytes (64 * 1024 * 1024).

withRowGroupLength

public S3Settings withRowGroupLength(Integer rowGroupLength)

The number of rows in a row group. A smaller row group size provides faster reads. But as the number of row groups grows, the slower writes become. This parameter defaults to 10,000 rows. This number is used for .parquet file format only.

If you choose a value larger than the maximum, RowGroupLength is set to the max row group length in bytes (64 * 1024 * 1024).

Parameters:

rowGroupLength - The number of rows in a row group. A smaller row group size provides faster reads. But as the number of row groups grows, the slower writes become. This parameter defaults to 10,000 rows. This number is used for .parquet file format only.

If you choose a value larger than the maximum, RowGroupLength is set to the max row group length in bytes (64 * 1024 * 1024).

Returns:

Returns a reference to this object so that method calls can be chained together.

setDataPageSize

public void setDataPageSize(Integer dataPageSize)

The size of one data page in bytes. This parameter defaults to 1024 * 1024 bytes (1 MiB). This number is used for .parquet file format only.

Parameters:

dataPageSize - The size of one data page in bytes. This parameter defaults to 1024 * 1024 bytes (1 MiB). This number is used for .parquet file format only.

getDataPageSize

public Integer getDataPageSize()

The size of one data page in bytes. This parameter defaults to 1024 * 1024 bytes (1 MiB). This number is used for .parquet file format only.

Returns:

The size of one data page in bytes. This parameter defaults to 1024 * 1024 bytes (1 MiB). This number is used for .parquet file format only.

withDataPageSize

public S3Settings withDataPageSize(Integer dataPageSize)

The size of one data page in bytes. This parameter defaults to 1024 * 1024 bytes (1 MiB). This number is used for .parquet file format only.

Parameters:

dataPageSize - The size of one data page in bytes. This parameter defaults to 1024 * 1024 bytes (1 MiB). This number is used for .parquet file format only.

Returns:

Returns a reference to this object so that method calls can be chained together.

setParquetVersion

public void setParquetVersion(String parquetVersion)

The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.

Parameters:

parquetVersion - The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.

See Also:

ParquetVersionValue

getParquetVersion

public String getParquetVersion()

The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.

Returns:

The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.

See Also:

ParquetVersionValue

withParquetVersion

public S3Settings withParquetVersion(String parquetVersion)

The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.

Parameters:

parquetVersion - The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

ParquetVersionValue

setParquetVersion

public void setParquetVersion(ParquetVersionValue parquetVersion)

The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.

Parameters:

parquetVersion - The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.

See Also:

ParquetVersionValue

withParquetVersion

public S3Settings withParquetVersion(ParquetVersionValue parquetVersion)

The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.

Parameters:

parquetVersion - The version of the Apache Parquet format that you want to use: parquet_1_0 (the default) or parquet_2_0.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

ParquetVersionValue

setEnableStatistics

public void setEnableStatistics(Boolean enableStatistics)

A value that enables statistics for Parquet pages and row groups. Choose true to enable statistics, false to disable. Statistics include NULL, DISTINCT, MAX, and MIN values. This parameter defaults to true. This value is used for .parquet file format only.

Parameters:

enableStatistics - A value that enables statistics for Parquet pages and row groups. Choose true to enable statistics, false to disable. Statistics include NULL, DISTINCT, MAX, and MIN values. This parameter defaults to true. This value is used for .parquet file format only.

getEnableStatistics

public Boolean getEnableStatistics()

A value that enables statistics for Parquet pages and row groups. Choose true to enable statistics, false to disable. Statistics include NULL, DISTINCT, MAX, and MIN values. This parameter defaults to true. This value is used for .parquet file format only.

Returns:

A value that enables statistics for Parquet pages and row groups. Choose true to enable statistics, false to disable. Statistics include NULL, DISTINCT, MAX, and MIN values. This parameter defaults to true. This value is used for .parquet file format only.

withEnableStatistics

public S3Settings withEnableStatistics(Boolean enableStatistics)

A value that enables statistics for Parquet pages and row groups. Choose true to enable statistics, false to disable. Statistics include NULL, DISTINCT, MAX, and MIN values. This parameter defaults to true. This value is used for .parquet file format only.

Parameters:

enableStatistics - A value that enables statistics for Parquet pages and row groups. Choose true to enable statistics, false to disable. Statistics include NULL, DISTINCT, MAX, and MIN values. This parameter defaults to true. This value is used for .parquet file format only.

Returns:

Returns a reference to this object so that method calls can be chained together.

isEnableStatistics

public Boolean isEnableStatistics()

A value that enables statistics for Parquet pages and row groups. Choose true to enable statistics, false to disable. Statistics include NULL, DISTINCT, MAX, and MIN values. This parameter defaults to true. This value is used for .parquet file format only.

Returns:

A value that enables statistics for Parquet pages and row groups. Choose true to enable statistics, false to disable. Statistics include NULL, DISTINCT, MAX, and MIN values. This parameter defaults to true. This value is used for .parquet file format only.

setIncludeOpForFullLoad

public void setIncludeOpForFullLoad(Boolean includeOpForFullLoad)

A value that enables a full load to write INSERT operations to the comma-separated value (.csv) output files only to indicate how the rows were added to the source database.

AWS DMS supports IncludeOpForFullLoad in versions 3.1.4 and later.

For full load, records can only be inserted. By default (the false setting), no information is recorded in these output files for a full load to indicate that the rows were inserted at the source database. If IncludeOpForFullLoad is set to true or y, the INSERT is recorded as an I annotation in the first field of the .csv file. This allows the format of your target records from a full load to be consistent with the target records from a CDC load.

This setting works together with CdcInsertsOnly for output to .csv files only. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

Parameters:

includeOpForFullLoad - A value that enables a full load to write INSERT operations to the comma-separated value (.csv) output files only to indicate how the rows were added to the source database.

AWS DMS supports IncludeOpForFullLoad in versions 3.1.4 and later.

For full load, records can only be inserted. By default (the false setting), no information is recorded in these output files for a full load to indicate that the rows were inserted at the source database. If IncludeOpForFullLoad is set to true or y, the INSERT is recorded as an I annotation in the first field of the .csv file. This allows the format of your target records from a full load to be consistent with the target records from a CDC load.

This setting works together with CdcInsertsOnly for output to .csv files only. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

getIncludeOpForFullLoad

public Boolean getIncludeOpForFullLoad()

A value that enables a full load to write INSERT operations to the comma-separated value (.csv) output files only to indicate how the rows were added to the source database.

AWS DMS supports IncludeOpForFullLoad in versions 3.1.4 and later.

For full load, records can only be inserted. By default (the false setting), no information is recorded in these output files for a full load to indicate that the rows were inserted at the source database. If IncludeOpForFullLoad is set to true or y, the INSERT is recorded as an I annotation in the first field of the .csv file. This allows the format of your target records from a full load to be consistent with the target records from a CDC load.

This setting works together with CdcInsertsOnly for output to .csv files only. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

Returns:

A value that enables a full load to write INSERT operations to the comma-separated value (.csv) output files only to indicate how the rows were added to the source database.

AWS DMS supports IncludeOpForFullLoad in versions 3.1.4 and later.

For full load, records can only be inserted. By default (the false setting), no information is recorded in these output files for a full load to indicate that the rows were inserted at the source database. If IncludeOpForFullLoad is set to true or y, the INSERT is recorded as an I annotation in the first field of the .csv file. This allows the format of your target records from a full load to be consistent with the target records from a CDC load.

This setting works together with CdcInsertsOnly for output to .csv files only. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

withIncludeOpForFullLoad

public S3Settings withIncludeOpForFullLoad(Boolean includeOpForFullLoad)

A value that enables a full load to write INSERT operations to the comma-separated value (.csv) output files only to indicate how the rows were added to the source database.

AWS DMS supports IncludeOpForFullLoad in versions 3.1.4 and later.

For full load, records can only be inserted. By default (the false setting), no information is recorded in these output files for a full load to indicate that the rows were inserted at the source database. If IncludeOpForFullLoad is set to true or y, the INSERT is recorded as an I annotation in the first field of the .csv file. This allows the format of your target records from a full load to be consistent with the target records from a CDC load.

This setting works together with CdcInsertsOnly for output to .csv files only. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

Parameters:

includeOpForFullLoad - A value that enables a full load to write INSERT operations to the comma-separated value (.csv) output files only to indicate how the rows were added to the source database.

AWS DMS supports IncludeOpForFullLoad in versions 3.1.4 and later.

For full load, records can only be inserted. By default (the false setting), no information is recorded in these output files for a full load to indicate that the rows were inserted at the source database. If IncludeOpForFullLoad is set to true or y, the INSERT is recorded as an I annotation in the first field of the .csv file. This allows the format of your target records from a full load to be consistent with the target records from a CDC load.

This setting works together with CdcInsertsOnly for output to .csv files only. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

Returns:

Returns a reference to this object so that method calls can be chained together.

isIncludeOpForFullLoad

public Boolean isIncludeOpForFullLoad()

A value that enables a full load to write INSERT operations to the comma-separated value (.csv) output files only to indicate how the rows were added to the source database.

AWS DMS supports IncludeOpForFullLoad in versions 3.1.4 and later.

For full load, records can only be inserted. By default (the false setting), no information is recorded in these output files for a full load to indicate that the rows were inserted at the source database. If IncludeOpForFullLoad is set to true or y, the INSERT is recorded as an I annotation in the first field of the .csv file. This allows the format of your target records from a full load to be consistent with the target records from a CDC load.

This setting works together with CdcInsertsOnly for output to .csv files only. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

Returns:

A value that enables a full load to write INSERT operations to the comma-separated value (.csv) output files only to indicate how the rows were added to the source database.

AWS DMS supports IncludeOpForFullLoad in versions 3.1.4 and later.

For full load, records can only be inserted. By default (the false setting), no information is recorded in these output files for a full load to indicate that the rows were inserted at the source database. If IncludeOpForFullLoad is set to true or y, the INSERT is recorded as an I annotation in the first field of the .csv file. This allows the format of your target records from a full load to be consistent with the target records from a CDC load.

This setting works together with CdcInsertsOnly for output to .csv files only. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

setCdcInsertsOnly

public void setCdcInsertsOnly(Boolean cdcInsertsOnly)

A value that enables a change data capture (CDC) load to write only INSERT operations to .csv or columnar storage (.parquet) output files. By default (the false setting), the first field in a .csv or .parquet record contains the letter I (INSERT), U (UPDATE), or D (DELETE). These values indicate whether the row was inserted, updated, or deleted at the source database for a CDC load to the target.

If cdcInsertsOnly is set to true or y, only INSERTs from the source database are migrated to the .csv or .parquet file. For .csv format only, how these INSERTs are recorded depends on the value of IncludeOpForFullLoad. If IncludeOpForFullLoad is set to true, the first field of every CDC record is set to I to indicate the INSERT operation at the source. If IncludeOpForFullLoad is set to false, every CDC record is written without a first field to indicate the INSERT operation at the source. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

AWS DMS supports this interaction between CdcInsertsOnly and IncludeOpForFullLoad in versions 3.1.4 and later.

Parameters:

cdcInsertsOnly - A value that enables a change data capture (CDC) load to write only INSERT operations to .csv or columnar storage (.parquet) output files. By default (the false setting), the first field in a .csv or .parquet record contains the letter I (INSERT), U (UPDATE), or D (DELETE). These values indicate whether the row was inserted, updated, or deleted at the source database for a CDC load to the target.

If cdcInsertsOnly is set to true or y, only INSERTs from the source database are migrated to the .csv or .parquet file. For .csv format only, how these INSERTs are recorded depends on the value of IncludeOpForFullLoad. If IncludeOpForFullLoad is set to true, the first field of every CDC record is set to I to indicate the INSERT operation at the source. If IncludeOpForFullLoad is set to false, every CDC record is written without a first field to indicate the INSERT operation at the source. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

AWS DMS supports this interaction between CdcInsertsOnly and IncludeOpForFullLoad in versions 3.1.4 and later.

getCdcInsertsOnly

public Boolean getCdcInsertsOnly()

A value that enables a change data capture (CDC) load to write only INSERT operations to .csv or columnar storage (.parquet) output files. By default (the false setting), the first field in a .csv or .parquet record contains the letter I (INSERT), U (UPDATE), or D (DELETE). These values indicate whether the row was inserted, updated, or deleted at the source database for a CDC load to the target.

If cdcInsertsOnly is set to true or y, only INSERTs from the source database are migrated to the .csv or .parquet file. For .csv format only, how these INSERTs are recorded depends on the value of IncludeOpForFullLoad. If IncludeOpForFullLoad is set to true, the first field of every CDC record is set to I to indicate the INSERT operation at the source. If IncludeOpForFullLoad is set to false, every CDC record is written without a first field to indicate the INSERT operation at the source. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

AWS DMS supports this interaction between CdcInsertsOnly and IncludeOpForFullLoad in versions 3.1.4 and later.

Returns:

A value that enables a change data capture (CDC) load to write only INSERT operations to .csv or columnar storage (.parquet) output files. By default (the false setting), the first field in a .csv or .parquet record contains the letter I (INSERT), U (UPDATE), or D (DELETE). These values indicate whether the row was inserted, updated, or deleted at the source database for a CDC load to the target.

If cdcInsertsOnly is set to true or y, only INSERTs from the source database are migrated to the .csv or .parquet file. For .csv format only, how these INSERTs are recorded depends on the value of IncludeOpForFullLoad. If IncludeOpForFullLoad is set to true, the first field of every CDC record is set to I to indicate the INSERT operation at the source. If IncludeOpForFullLoad is set to false, every CDC record is written without a first field to indicate the INSERT operation at the source. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

AWS DMS supports this interaction between CdcInsertsOnly and IncludeOpForFullLoad in versions 3.1.4 and later.

withCdcInsertsOnly

public S3Settings withCdcInsertsOnly(Boolean cdcInsertsOnly)

A value that enables a change data capture (CDC) load to write only INSERT operations to .csv or columnar storage (.parquet) output files. By default (the false setting), the first field in a .csv or .parquet record contains the letter I (INSERT), U (UPDATE), or D (DELETE). These values indicate whether the row was inserted, updated, or deleted at the source database for a CDC load to the target.

If cdcInsertsOnly is set to true or y, only INSERTs from the source database are migrated to the .csv or .parquet file. For .csv format only, how these INSERTs are recorded depends on the value of IncludeOpForFullLoad. If IncludeOpForFullLoad is set to true, the first field of every CDC record is set to I to indicate the INSERT operation at the source. If IncludeOpForFullLoad is set to false, every CDC record is written without a first field to indicate the INSERT operation at the source. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

AWS DMS supports this interaction between CdcInsertsOnly and IncludeOpForFullLoad in versions 3.1.4 and later.

Parameters:

cdcInsertsOnly - A value that enables a change data capture (CDC) load to write only INSERT operations to .csv or columnar storage (.parquet) output files. By default (the false setting), the first field in a .csv or .parquet record contains the letter I (INSERT), U (UPDATE), or D (DELETE). These values indicate whether the row was inserted, updated, or deleted at the source database for a CDC load to the target.

If cdcInsertsOnly is set to true or y, only INSERTs from the source database are migrated to the .csv or .parquet file. For .csv format only, how these INSERTs are recorded depends on the value of IncludeOpForFullLoad. If IncludeOpForFullLoad is set to true, the first field of every CDC record is set to I to indicate the INSERT operation at the source. If IncludeOpForFullLoad is set to false, every CDC record is written without a first field to indicate the INSERT operation at the source. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

AWS DMS supports this interaction between CdcInsertsOnly and IncludeOpForFullLoad in versions 3.1.4 and later.

Returns:

Returns a reference to this object so that method calls can be chained together.

isCdcInsertsOnly

public Boolean isCdcInsertsOnly()

A value that enables a change data capture (CDC) load to write only INSERT operations to .csv or columnar storage (.parquet) output files. By default (the false setting), the first field in a .csv or .parquet record contains the letter I (INSERT), U (UPDATE), or D (DELETE). These values indicate whether the row was inserted, updated, or deleted at the source database for a CDC load to the target.

If cdcInsertsOnly is set to true or y, only INSERTs from the source database are migrated to the .csv or .parquet file. For .csv format only, how these INSERTs are recorded depends on the value of IncludeOpForFullLoad. If IncludeOpForFullLoad is set to true, the first field of every CDC record is set to I to indicate the INSERT operation at the source. If IncludeOpForFullLoad is set to false, every CDC record is written without a first field to indicate the INSERT operation at the source. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

AWS DMS supports this interaction between CdcInsertsOnly and IncludeOpForFullLoad in versions 3.1.4 and later.

Returns:

A value that enables a change data capture (CDC) load to write only INSERT operations to .csv or columnar storage (.parquet) output files. By default (the false setting), the first field in a .csv or .parquet record contains the letter I (INSERT), U (UPDATE), or D (DELETE). These values indicate whether the row was inserted, updated, or deleted at the source database for a CDC load to the target.

If cdcInsertsOnly is set to true or y, only INSERTs from the source database are migrated to the .csv or .parquet file. For .csv format only, how these INSERTs are recorded depends on the value of IncludeOpForFullLoad. If IncludeOpForFullLoad is set to true, the first field of every CDC record is set to I to indicate the INSERT operation at the source. If IncludeOpForFullLoad is set to false, every CDC record is written without a first field to indicate the INSERT operation at the source. For more information about how these settings work together, see Indicating Source DB Operations in Migrated S3 Data in the AWS Database Migration Service User Guide..

AWS DMS supports this interaction between CdcInsertsOnly and IncludeOpForFullLoad in versions 3.1.4 and later.

setTimestampColumnName

public void setTimestampColumnName(String timestampColumnName)

A value that includes a timestamp column in the Amazon S3 target endpoint data. AWS DMS includes an additional column in the migrated data when you set timestampColumnName to a non-blank value.

AWS DMS supports TimestampColumnName in versions 3.1.4 and later.

For a full load, each row of the timestamp column contains a timestamp for when the data was transferred from the source to the target by DMS. For a CDC load, each row of the timestamp column contains the timestamp for the commit of that row in the source database. The format for the timestamp column value is yyyy-MM-dd HH:mm:ss.SSSSSS. For CDC, the microsecond precision depends on the commit timestamp supported by DMS for the source database. When the AddColumnName setting is set to true , DMS also includes the name for the timestamp column that you set as the nonblank value of timestampColumnName.

Parameters:

timestampColumnName - A value that includes a timestamp column in the Amazon S3 target endpoint data. AWS DMS includes an additional column in the migrated data when you set timestampColumnName to a non-blank value.

AWS DMS supports TimestampColumnName in versions 3.1.4 and later.

For a full load, each row of the timestamp column contains a timestamp for when the data was transferred from the source to the target by DMS. For a CDC load, each row of the timestamp column contains the timestamp for the commit of that row in the source database. The format for the timestamp column value is yyyy-MM-dd HH:mm:ss.SSSSSS. For CDC, the microsecond precision depends on the commit timestamp supported by DMS for the source database. When the AddColumnName setting is set to true, DMS also includes the name for the timestamp column that you set as the nonblank value of timestampColumnName.

getTimestampColumnName

public String getTimestampColumnName()

A value that includes a timestamp column in the Amazon S3 target endpoint data. AWS DMS includes an additional column in the migrated data when you set timestampColumnName to a non-blank value.

AWS DMS supports TimestampColumnName in versions 3.1.4 and later.

For a full load, each row of the timestamp column contains a timestamp for when the data was transferred from the source to the target by DMS. For a CDC load, each row of the timestamp column contains the timestamp for the commit of that row in the source database. The format for the timestamp column value is yyyy-MM-dd HH:mm:ss.SSSSSS. For CDC, the microsecond precision depends on the commit timestamp supported by DMS for the source database. When the AddColumnName setting is set to true , DMS also includes the name for the timestamp column that you set as the nonblank value of timestampColumnName.

Returns:

A value that includes a timestamp column in the Amazon S3 target endpoint data. AWS DMS includes an additional column in the migrated data when you set timestampColumnName to a non-blank value.

AWS DMS supports TimestampColumnName in versions 3.1.4 and later.

For a full load, each row of the timestamp column contains a timestamp for when the data was transferred from the source to the target by DMS. For a CDC load, each row of the timestamp column contains the timestamp for the commit of that row in the source database. The format for the timestamp column value is yyyy-MM-dd HH:mm:ss.SSSSSS. For CDC, the microsecond precision depends on the commit timestamp supported by DMS for the source database. When the AddColumnName setting is set to true, DMS also includes the name for the timestamp column that you set as the nonblank value of timestampColumnName.

withTimestampColumnName

public S3Settings withTimestampColumnName(String timestampColumnName)

A value that includes a timestamp column in the Amazon S3 target endpoint data. AWS DMS includes an additional column in the migrated data when you set timestampColumnName to a non-blank value.

AWS DMS supports TimestampColumnName in versions 3.1.4 and later.

For a full load, each row of the timestamp column contains a timestamp for when the data was transferred from the source to the target by DMS. For a CDC load, each row of the timestamp column contains the timestamp for the commit of that row in the source database. The format for the timestamp column value is yyyy-MM-dd HH:mm:ss.SSSSSS. For CDC, the microsecond precision depends on the commit timestamp supported by DMS for the source database. When the AddColumnName setting is set to true , DMS also includes the name for the timestamp column that you set as the nonblank value of timestampColumnName.

Parameters:

timestampColumnName - A value that includes a timestamp column in the Amazon S3 target endpoint data. AWS DMS includes an additional column in the migrated data when you set timestampColumnName to a non-blank value.

AWS DMS supports TimestampColumnName in versions 3.1.4 and later.

For a full load, each row of the timestamp column contains a timestamp for when the data was transferred from the source to the target by DMS. For a CDC load, each row of the timestamp column contains the timestamp for the commit of that row in the source database. The format for the timestamp column value is yyyy-MM-dd HH:mm:ss.SSSSSS. For CDC, the microsecond precision depends on the commit timestamp supported by DMS for the source database. When the AddColumnName setting is set to true, DMS also includes the name for the timestamp column that you set as the nonblank value of timestampColumnName.

Returns:

Returns a reference to this object so that method calls can be chained together.

toString

public String toString()

Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.

Overrides:

toString in class Object

Returns:

A string representation of this object.

See Also:

Object.toString()

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

clone

public S3Settings clone()

Overrides:

clone in class Object

marshall

public void marshall(ProtocolMarshaller protocolMarshaller)

Specified by:

marshall in interface StructuredPojo