You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::DatabaseMigrationService::Types::OracleSettings

Inherits:
Struct
  • Object
show all
Defined in:
(unknown)

Overview

Note:

When passing OracleSettings as input to an Aws::Client method, you can use a vanilla Hash:

{
  add_supplemental_logging: false,
  archived_log_dest_id: 1,
  additional_archived_log_dest_id: 1,
  allow_select_nested_tables: false,
  parallel_asm_read_threads: 1,
  read_ahead_blocks: 1,
  access_alternate_directly: false,
  use_alternate_folder_for_online: false,
  oracle_path_prefix: "String",
  use_path_prefix: "String",
  replace_path_prefix: false,
  enable_homogenous_tablespace: false,
  direct_path_no_log: false,
  archived_logs_only: false,
  asm_password: "SecretString",
  asm_server: "String",
  asm_user: "String",
  char_length_semantics: "default", # accepts default, char, byte
  database_name: "String",
  direct_path_parallel_load: false,
  fail_tasks_on_lob_truncation: false,
  number_datatype_scale: 1,
  password: "SecretString",
  port: 1,
  read_table_space_name: false,
  retry_interval: 1,
  security_db_encryption: "SecretString",
  security_db_encryption_name: "String",
  server_name: "String",
  username: "String",
}

Provides information that defines an Oracle endpoint.

Returned by:

See Also:

Instance Attribute Summary collapse

Instance Attribute Details

#access_alternate_directly ⇒ Boolean

Set this attribute to false in order to use the Binary Reader to capture change data for an Amazon RDS for Oracle as the source. This tells the DMS instance to not access redo logs through any specified path prefix replacement using direct file access.

Returns:

  • (Boolean) —

    Set this attribute to false in order to use the Binary Reader to capture change data for an Amazon RDS for Oracle as the source.

#add_supplemental_logging ⇒ Boolean

Set this attribute to set up table-level supplemental logging for the Oracle database. This attribute enables PRIMARY KEY supplemental logging on all tables selected for a migration task.

If you use this option, you still need to enable database-level supplemental logging.

Returns:

  • (Boolean) —

    Set this attribute to set up table-level supplemental logging for the Oracle database.

#additional_archived_log_dest_id ⇒ Integer

Set this attribute with archivedLogDestId in a primary/ standby setup. This attribute is useful in the case of a switchover. In this case, AWS DMS needs to know which destination to get archive redo logs from to read changes. This need arises because the previous primary instance is now a standby instance after switchover.

Returns:

  • (Integer) —

    Set this attribute with archivedLogDestId in a primary/ standby setup.

#allow_select_nested_tables ⇒ Boolean

Set this attribute to true to enable replication of Oracle tables containing columns that are nested tables or defined types.

Returns:

  • (Boolean) —

    Set this attribute to true to enable replication of Oracle tables containing columns that are nested tables or defined types.

#archived_log_dest_id ⇒ Integer

Specifies the destination of the archived redo logs. The value should be the same as the DEST_ID number in the v$archived_log table. When working with multiple log destinations (DEST_ID), we recommend that you to specify an archived redo logs location identifier. Doing this improves performance by ensuring that the correct logs are accessed from the outset.

Returns:

  • (Integer) —

    Specifies the destination of the archived redo logs.

#archived_logs_only ⇒ Boolean

When this field is set to Y, AWS DMS only accesses the archived redo logs. If the archived redo logs are stored on Oracle ASM only, the AWS DMS user account needs to be granted ASM privileges.

Returns:

  • (Boolean) —

    When this field is set to Y, AWS DMS only accesses the archived redo logs.

#asm_password ⇒ String

For an Oracle source endpoint, your Oracle Automatic Storage Management (ASM) password. You can set this value from the asm_user_password value. You set this value as part of the comma-separated value that you set to the Password request parameter when you create the endpoint to access transaction logs using Binary Reader. For more information, see Configuration for change data capture (CDC) on an Oracle source database.

Returns:

  • (String) —

    For an Oracle source endpoint, your Oracle Automatic Storage Management (ASM) password.

#asm_server ⇒ String

For an Oracle source endpoint, your ASM server address. You can set this value from the asm_server value. You set asm_server as part of the extra connection attribute string to access an Oracle server with Binary Reader that uses ASM. For more information, see Configuration for change data capture (CDC) on an Oracle source database.

Returns:

  • (String) —

    For an Oracle source endpoint, your ASM server address.

#asm_user ⇒ String

For an Oracle source endpoint, your ASM user name. You can set this value from the asm_user value. You set asm_user as part of the extra connection attribute string to access an Oracle server with Binary Reader that uses ASM. For more information, see Configuration for change data capture (CDC) on an Oracle source database.

Returns:

  • (String) —

    For an Oracle source endpoint, your ASM user name.

#char_length_semantics ⇒ String

Specifies whether the length of a character column is in bytes or in characters. To indicate that the character column length is in characters, set this attribute to CHAR. Otherwise, the character column length is in bytes.

Example: charLengthSemantics=CHAR;

Possible values:

  • default
  • char
  • byte

Returns:

  • (String) —

    Specifies whether the length of a character column is in bytes or in characters.

#database_name ⇒ String

Database name for the endpoint.

Returns:

  • (String) —

    Database name for the endpoint.

#direct_path_no_log ⇒ Boolean

When set to true, this attribute helps to increase the commit rate on the Oracle target database by writing directly to tables and not writing a trail to database logs.

Returns:

  • (Boolean) —

    When set to true, this attribute helps to increase the commit rate on the Oracle target database by writing directly to tables and not writing a trail to database logs.

#direct_path_parallel_load ⇒ Boolean

When set to true, this attribute specifies a parallel load when useDirectPathFullLoad is set to Y. This attribute also only applies when you use the AWS DMS parallel load feature. Note that the target table cannot have any constraints or indexes.

Returns:

  • (Boolean) —

    When set to true, this attribute specifies a parallel load when useDirectPathFullLoad is set to Y.

#enable_homogenous_tablespace ⇒ Boolean

Set this attribute to enable homogenous tablespace replication and create existing tables or indexes under the same tablespace on the target.

Returns:

  • (Boolean) —

    Set this attribute to enable homogenous tablespace replication and create existing tables or indexes under the same tablespace on the target.

#fail_tasks_on_lob_truncation ⇒ Boolean

When set to true, this attribute causes a task to fail if the actual size of an LOB column is greater than the specified LobMaxSize.

If a task is set to limited LOB mode and this option is set to true, the task fails instead of truncating the LOB data.

Returns:

  • (Boolean) —

    When set to true, this attribute causes a task to fail if the actual size of an LOB column is greater than the specified LobMaxSize.

#number_datatype_scale ⇒ Integer

Specifies the number scale. You can select a scale up to 38, or you can select FLOAT. By default, the NUMBER data type is converted to precision 38, scale 10.

Example: numberDataTypeScale=12

Returns:

  • (Integer) —

    Specifies the number scale.

#oracle_path_prefix ⇒ String

Set this string attribute to the required value in order to use the Binary Reader to capture change data for an Amazon RDS for Oracle as the source. This value specifies the default Oracle root used to access the redo logs.

Returns:

  • (String) —

    Set this string attribute to the required value in order to use the Binary Reader to capture change data for an Amazon RDS for Oracle as the source.

#parallel_asm_read_threads ⇒ Integer

Set this attribute to change the number of threads that DMS configures to perform a Change Data Capture (CDC) load using Oracle Automatic Storage Management (ASM). You can specify an integer value between 2 (the default) and 8 (the maximum). Use this attribute together with the readAheadBlocks attribute.

Returns:

  • (Integer) —

    Set this attribute to change the number of threads that DMS configures to perform a Change Data Capture (CDC) load using Oracle Automatic Storage Management (ASM).

#password ⇒ String

Endpoint connection password.

Returns:

  • (String) —

    Endpoint connection password.

#port ⇒ Integer

Endpoint TCP port.

Returns:

  • (Integer) —

    Endpoint TCP port.

#read_ahead_blocks ⇒ Integer

Set this attribute to change the number of read-ahead blocks that DMS configures to perform a Change Data Capture (CDC) load using Oracle Automatic Storage Management (ASM). You can specify an integer value between 1000 (the default) and 200,000 (the maximum).

Returns:

  • (Integer) —

    Set this attribute to change the number of read-ahead blocks that DMS configures to perform a Change Data Capture (CDC) load using Oracle Automatic Storage Management (ASM).

#read_table_space_name ⇒ Boolean

When set to true, this attribute supports tablespace replication.

Returns:

  • (Boolean) —

    When set to true, this attribute supports tablespace replication.

#replace_path_prefix ⇒ Boolean

Set this attribute to true in order to use the Binary Reader to capture change data for an Amazon RDS for Oracle as the source. This setting tells DMS instance to replace the default Oracle root with the specified usePathPrefix setting to access the redo logs.

Returns:

  • (Boolean) —

    Set this attribute to true in order to use the Binary Reader to capture change data for an Amazon RDS for Oracle as the source.

#retry_interval ⇒ Integer

Specifies the number of seconds that the system waits before resending a query.

Example: retryInterval=6;

Returns:

  • (Integer) —

    Specifies the number of seconds that the system waits before resending a query.

#security_db_encryption ⇒ String

For an Oracle source endpoint, the transparent data encryption (TDE) password required by AWM DMS to access Oracle redo logs encrypted by TDE using Binary Reader. It is also the TDE_Password part of the comma-separated value you set to the Password request parameter when you create the endpoint. The SecurityDbEncryptian setting is related to this SecurityDbEncryptionName setting. For more information, see Supported encryption methods for using Oracle as a source for AWS DMS in the AWS Database Migration Service User Guide.

Returns:

  • (String) —

    For an Oracle source endpoint, the transparent data encryption (TDE) password required by AWM DMS to access Oracle redo logs encrypted by TDE using Binary Reader.

#security_db_encryption_name ⇒ String

For an Oracle source endpoint, the name of a key used for the transparent data encryption (TDE) of the columns and tablespaces in an Oracle source database that is encrypted using TDE. The key value is the value of the SecurityDbEncryption setting. For more information on setting the key name value of SecurityDbEncryptionName, see the information and example for setting the securityDbEncryptionName extra connection attribute in Supported encryption methods for using Oracle as a source for AWS DMS in the AWS Database Migration Service User Guide.

Returns:

  • (String) —

    For an Oracle source endpoint, the name of a key used for the transparent data encryption (TDE) of the columns and tablespaces in an Oracle source database that is encrypted using TDE.

#server_name ⇒ String

Fully qualified domain name of the endpoint.

Returns:

  • (String) —

    Fully qualified domain name of the endpoint.

#use_alternate_folder_for_online ⇒ Boolean

Set this attribute to true in order to use the Binary Reader to capture change data for an Amazon RDS for Oracle as the source. This tells the DMS instance to use any specified prefix replacement to access all online redo logs.

Returns:

  • (Boolean) —

    Set this attribute to true in order to use the Binary Reader to capture change data for an Amazon RDS for Oracle as the source.

#use_path_prefix ⇒ String

Set this string attribute to the required value in order to use the Binary Reader to capture change data for an Amazon RDS for Oracle as the source. This value specifies the path prefix used to replace the default Oracle root to access the redo logs.

Returns:

  • (String) —

    Set this string attribute to the required value in order to use the Binary Reader to capture change data for an Amazon RDS for Oracle as the source.

#username ⇒ String

Endpoint connection user name.

Returns:

  • (String) —

    Endpoint connection user name.