Table of Contents

Search

  1. Preface
  2. Data Replication Overview
  3. Understanding Data Replication
  4. Sources - Preparation and Replication Considerations
  5. Targets - Preparation and Replication Considerations
  6. Starting the Server Manager
  7. Getting Started with the Data Replication Console
  8. Defining and Managing Server Manager Main Servers and Subservers
  9. Creating and Managing User Accounts
  10. Creating and Managing Connections
  11. Creating Replication Configurations
  12. Materializing Targets with InitialSync
  13. Scheduling and Running Replication Tasks
  14. Implementing Advanced Replication Topologies
  15. Monitoring Data Replication
  16. Managing Replication Configurations
  17. Handling Replication Environment Changes and Failures
  18. Troubleshooting
  19. Data Replication Files and Subdirectories
  20. Data Replication Runtime Parameters
  21. Command Line Parameters for Data Replication Components
  22. Updating Configurations in the Replication Configuration CLI
  23. DDL Statements for Manually Creating Recovery Tables
  24. Sample Scripts for Enabling or Disabling SQL Server Change Data Capture
  25. Glossary

Defining the Target Database

For Data Replication to connect to the target database and apply data, you must define a connection. You can select a connection that is already defined or create a new connection. You can create a connection from scratch, based on the source database connection, or based on another connection that you select.
  1. Click the
    Target Database
    tab.
    The following image shows this tab:
     Target Database tab on the Data Replication Console
  2. To use a predefined connection, select the connection from the
    Database Connection
    list.
    All of the listed connections are also listed on the
    Server Manager
    tab >
    Connections
    view. If you connected to the Server Manager as the idradmin user, you can use any predefined connection. If you are not the idradmin user, you must use a connection for which you are designated as the owner.
    The connection details are displayed in read only mode.
  3. To use the source connection settings when the target tables are on the source system, click the
    From SourceDB
    button.
    The connection details are displayed in read only mode.
  4. To create a new target connection, perform the following steps:
    1. Click
      New connection
      . If you want to create a connection based on an existing connection, select a connection in the
      Database Connection
      list before you click
      New connection
      .
      The
      New
      dialog box >
      Database
      tab appears.
       New dialog box > Database tab view for creating a new target connection.
    2. To define the target connection, enter connection information on the
      Database
      tab. The following table describes the fields on this tab:
      Field
      Target Types
      Description
      Usage
      Name
      All
      A name for the target connection.
      Connection names can contain the digits 0-9, Latin letters A-Z and a-z, and the underscore (_) character. The Data Replication Console truncates connection names that are longer than 120 characters.
      Owner
      All
      The Data Replication user who is designated as the owner of the connection.
      Required.
      The idradmin user can use any predefined connection.
      Type
      All
      Select the target database type. Options are:
      • Amazon Redshift
      • Apache Kafka
      • Cloudera
      • DB2 for LUW
      • Flat File
      • Greenplum
      • Hortonworks
      • MemSQL
      • Microsoft SQL Server
      • MySQL
      • Netezza
      • Oracle
      • PostgreSQL
      • Teradata
      • Vertica
      Required.
      After you save the configuration, do not change the target database type by editing the connection information from the
      Server Manager
      Connections
      view or by editing configuration properties and switching to a connection for another database type from the
      Server Manager
      Configs
      view. If you change the database type, replication processing will fail.
      Version
      • Cloudera
      • Hortonworks
      The version of the selected target type.
      Required.
      Host
      All, except for
      Apache Kafka
      and
      Flat File
      Host name or IP address of the machine where the target database runs.
      Required.
      Port
      All, except for
      Apache Kafka
      and
      Flat File
      Port number that Data Replication uses to connect to the target database. Valid values are integers from 1 through 65535.
      Required.
      User
      All, except for
      Apache Kafka
      and
      Flat File
      A user name that has the authority to write to the target database.
      Required.
      Password
      All, except for
      Apache Kafka
      and
      Flat File
      A valid password for the specified user.
      Required.
      Path
      • Cloudera
      • Hortonworks
      The HDFS directory for the data files that Data Replication generates for the target.
      Required.
      The user ID that you specified for connecting to HDFS must have write permissions on this directory.
      To browse HDFS, the Data Replication Console requires Java Runtime Environment (JRE) 1.7 or 1.8.
      Instance/DB
      • Amazon Redshift
      • DB2 for LUW
      • Greenplum
      • Netezza
      • Oracle
      • PostgreSQL
      • Vertica
      An Oracle instance name or a database name.
      Required if this field is displayed for the selected database type.
      Use Custom URL
      All, except for
      Apache Kafka,
      Cloudera and Hortonworks
      Select this check box to provide custom connection strings for the JDBC or ODBC drivers. Use custom connection strings in the following situations:
      • You use a Data Source Name (DSN) with an ODBC driver to connect to the target database.
      • You use a user name for connecting to the target database from the Data Replication Console that is different from the user name under which the replication job runs.
        The user that connects to the target from the Data Replication Console must have privileges to read metadata. The user that connects to the target when the replication job runs must have privileges to write DML changes to the target.
      • Multiple ODBC driver versions are installed on one Windows system. In this case, specify the name of the driver that you want to use in the
        Custom connection string
        field.
      After you select this check box, the
      JDBC custom URL
      and
      Custom Connection String
      fields become available.
      JDBC custom URL
      All, except for
      Apache Kafka,
      Cloudera and Hortonworks
      A connection URL for the JDBC driver that the Data Replication Console uses. This URL has the following format:
      jdbc:
      <subprotocol>
      :
      <subname>
      This field is available only if you selected
      Use Custom URL
      .
      JDBC custom connection strings always use the values that are specified in the
      User
      and
      Password
      fields. Ensure that any JDBC custom connection string that you enter does not include a user name and password.
      The Data Replication Console does not validate JDBC custom connection strings. Ensure that any JDBC custom connection string that you enter is valid for the current database connection.
      Custom Connection String
      All, except for
      Apache Kafka,
      Cloudera and Hortonworks
      A connection string for the ODBC driver that the Applier uses to access the database.
      If you use an ODBC Data Source Name (DSN) to connect to the target, provide the DSN connection string.
      This field is available only if you selected
      Use Custom URL
      .
      Ensure that any custom connection string that you specify includes a user name that has the authority to write to the target database. A custom connection string can include the password for this user, or you can specify the password in the
      Password
      field. If you specify the password in both the custom connection string and
      Password
      field, Data Replication uses the password in the custom connection string.
      For Microsoft SQL Server Cluster targets, provide the connection string in the following format:
      DRIVER=
      SQL_Server_ODBC_driver
      ;Server=
      virtual_IP
      ;Network=DBMSSOCN;Trusted_Connection=Yes;Port=
      port
      ;Address=
      virtual_IP,port
      ;
      For Oracle targets, if the Applier fails to connect to the target by using the custom connection string, the Applier tries to connect to the target again. For the second connection attempt, the Applier builds the connection string based on the database connection or the connection information that you manually enter. To disable connection retries, set the
      global.fallback_connection
      runtime parameter to 0.
      For Teradata targets, if you use a version of the Teradata ODBC driver that is earlier than 15.00.00.04 and include special characters in the user name or password for connecting to the target, you must specify a custom connection string. In the connection string, enclose the user ID or password that contains the special characters with double quotation marks.
      The Data Replication Console does not validate ODBC custom connection strings. Ensure that any ODBC custom connection string that you enter is valid for the current database connection.
      Connect directly
      Oracle
      Reserved for future use.
      -
      Force log switch
      Oracle
      Select this check box if you capture data only from Oracle archived redo logs in a RAC environment.
      Required for Oracle RACs. The Extractor issues the command to archive online redo logs prior to capturing the change data.
      Use SID instead of SERVICE_NAME
      Oracle
      Select this check box to use the Oracle SID instead of the SERVICE_NAME to build the connection string.
      Optional for Oracle targets.
      Use SSL
      • Amazon Redshift
      • Greenplum
      Select this check box to use an HTTPS connection that is secured by the Secure Sockets Layer (SSL) to safely send SQL requests to Amazon Redshift or Greenplum targets.
      If you clear this check box, Data Replication uses a connection that is not secured by SSL. Transmission of SQL requests to Amazon Redshift or Greenplum targets is insecure.
      Data Replication always uses a secure HTTPS connection to load source data to the Amazon Simple Storage Service (Amazon S3).
      If the target is in an Oracle RAC, you can enter connection information for any running Oracle instance in the RAC.
    3. If the target is an Oracle ASM instance, navigate to the
      ASM Settings
      tab and follow the steps in Configuring a Connection to an Oracle ASM Instance
    4. Click
      Test Connection
      to verify the connection details.
    5. Click
      OK
      .
  5. If you have not already done so, click
    Test Connection
    to verify the connection details. Then click
    OK
    .
  6. Click
    Connect
    to connect to the target.
    If you connect to the target successfully, the
    Map Tables
    tab opens. Otherwise, Data Replication reports an error.

0 COMMENTS

We’d like to hear from you!