PostgreSQLSettings
Provides information that defines a PostgreSQL endpoint.
Contents
- AfterConnectScript
-
For use with change data capture (CDC) only, this attribute has AWS DMS bypass foreign keys and user triggers to reduce the time it takes to bulk load data.
Example:
afterConnectScript=SET session_replication_role='replica'
Type: String
Required: No
- BabelfishDatabaseName
-
The Babelfish for Aurora PostgreSQL database name for the endpoint.
Type: String
Required: No
- CaptureDdls
-
To capture DDL events, AWS DMS creates various artifacts in the PostgreSQL database when the task starts. You can later remove these artifacts.
The default value is
true
.If this value is set to
N
, you don't have to create tables or triggers on the source database.Type: Boolean
Required: No
- DatabaseMode
-
Specifies the default behavior of the replication's handling of PostgreSQL- compatible endpoints that require some additional configuration, such as Babelfish endpoints.
Type: String
Valid Values:
default | babelfish
Required: No
- DatabaseName
-
Database name for the endpoint.
Type: String
Required: No
- DdlArtifactsSchema
-
The schema in which the operational DDL database artifacts are created.
The default value is
public
.Example:
ddlArtifactsSchema=xyzddlschema;
Type: String
Required: No
- ExecuteTimeout
-
Sets the client statement timeout for the PostgreSQL instance, in seconds. The default value is 60 seconds.
Example:
executeTimeout=100;
Type: Integer
Required: No
- FailTasksOnLobTruncation
-
When set to
true
, this value causes a task to fail if the actual size of a LOB column is greater than the specifiedLobMaxSize
.The default value is
false
.If task is set to Limited LOB mode and this option is set to true, the task fails instead of truncating the LOB data.
Type: Boolean
Required: No
- HeartbeatEnable
-
The write-ahead log (WAL) heartbeat feature mimics a dummy transaction. By doing this, it prevents idle logical replication slots from holding onto old WAL logs, which can result in storage full situations on the source. This heartbeat keeps
restart_lsn
moving and prevents storage full scenarios.The default value is
false
.Type: Boolean
Required: No
- HeartbeatFrequency
-
Sets the WAL heartbeat frequency (in minutes).
The default value is 5 minutes.
Type: Integer
Required: No
- HeartbeatSchema
-
Sets the schema in which the heartbeat artifacts are created.
The default value is
public
.Type: String
Required: No
- MapBooleanAsBoolean
-
When true, lets PostgreSQL migrate the boolean type as boolean. By default, PostgreSQL migrates booleans as
varchar(5)
. You must set this setting on both the source and target endpoints for it to take effect.The default value is
false
.Type: Boolean
Required: No
- MapJsonbAsClob
-
When true, AWS DMS migrates JSONB values as CLOB.
The default value is
false
.Type: Boolean
Required: No
- MapLongVarcharAs
-
Sets what datatype to map LONG values as.
The default value is
wstring
.Type: String
Valid Values:
wstring | clob | nclob
Required: No
- MaxFileSize
-
Specifies the maximum size (in KB) of any .csv file used to transfer data to PostgreSQL.
The default value is 32,768 KB (32 MB).
Example:
maxFileSize=512
Type: Integer
Required: No
- Password
-
Endpoint connection password.
Type: String
Required: No
- PluginName
-
Specifies the plugin to use to create a replication slot.
The default value is
pglogical
.Type: String
Valid Values:
no-preference | test-decoding | pglogical
Required: No
- Port
-
Endpoint TCP port. The default is 5432.
Type: Integer
Required: No
- SecretsManagerAccessRoleArn
-
The full Amazon Resource Name (ARN) of the IAM role that specifies AWS DMS as the trusted entity and grants the required permissions to access the value in
SecretsManagerSecret
. The role must allow theiam:PassRole
action.SecretsManagerSecret
has the value of the AWS Secrets Manager secret that allows access to the PostgreSQL endpoint.Note
You can specify one of two sets of values for these permissions. You can specify the values for this setting and
SecretsManagerSecretId
. Or you can specify clear-text values forUserName
,Password
,ServerName
, andPort
. You can't specify both. For more information on creating thisSecretsManagerSecret
and theSecretsManagerAccessRoleArn
andSecretsManagerSecretId
required to access it, see Using secrets to access AWS Database Migration Service resources in the AWS Database Migration Service User Guide.Type: String
Required: No
- SecretsManagerSecretId
-
The full ARN, partial ARN, or friendly name of the
SecretsManagerSecret
that contains the PostgreSQL endpoint connection details.Type: String
Required: No
- ServerName
-
The host name of the endpoint database.
For an Amazon RDS PostgreSQL instance, this is the output of DescribeDBInstances, in the
Endpoint.Address
field.For an Aurora PostgreSQL instance, this is the output of DescribeDBClusters, in the
Endpoint
field.Type: String
Required: No
- SlotName
-
Sets the name of a previously created logical replication slot for a change data capture (CDC) load of the PostgreSQL source instance.
When used with the
CdcStartPosition
request parameter for the AWS DMS API , this attribute also makes it possible to use native CDC start points. DMS verifies that the specified logical replication slot exists before starting the CDC load task. It also verifies that the task was created with a valid setting ofCdcStartPosition
. If the specified slot doesn't exist or the task doesn't have a validCdcStartPosition
setting, DMS raises an error.For more information about setting the
CdcStartPosition
request parameter, see Determining a CDC native start point in the AWS Database Migration Service User Guide. For more information about usingCdcStartPosition
, see CreateReplicationTask, StartReplicationTask, and ModifyReplicationTask.Type: String
Required: No
- TrimSpaceInChar
-
Use the
TrimSpaceInChar
source endpoint setting to trim data on CHAR and NCHAR data types during migration. The default value istrue
.Type: Boolean
Required: No
- Username
-
Endpoint connection user name.
Type: String
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: