2.6 Using the Resources Navigator

The resources navigator, or the global resource library lists all the available resources such as:

  • Database: All the available databases.

  • Views: Create new views.

  • Global Mapping Group: Global mapping groups can be assigned to any replication path of any solution across all projects. Mapping groups created for a solution in the Projects Navigator can be copied to the global mapping groups or created directly from the Resources Navigator.

  • Oracle GoldenGate Instance: The available Oracle GoldenGate instances.

The Resources Navigator looks like:

Figure 2-3 Resources Navigator

Resources Navigator

There are three ways to add a new global resource. If any type of resource is not added then you can add it by selecting the New button in the Resources Navigator toolbar, select the New button in the Oracle GoldenGate Studio toolbar, or select New under File menu, and then select the resource type you want to add. If a resource type has already been added, you right-click the resource category and select New Resource Type. You can add a Global Mapping Group by right-clicking a mapping group in the Projects Navigator and selecting Copy to Global Resource Library.

Figure 2-4 Adding New Resources through Resources Navigator

Adding New Resources through Resources Navigator

You can change the properties of existing resources by using the Properties context menu. You can also use the keyboard shortcut Ctrl+Tab to navigate to Resources Navigator, use the Tab and arrow keys to select the particular resource, and use Shift + F10 to view the context menu.

2.6.1 Add a New Data Server Connection

New data server connections are used only for table metadata to facilitate table mapping and are not used to define connections used by capture and apply processes. Capture and apply connections are defined in the Properties Inspector in the Deployment Profile.

A new data server connection wizard looks as follows:

Figure 2-5 New Data Server Connection

New Data Server Connection

  1. Select the Database resource type in the Resources Navigator window and right-click to select New Database Connection.

  2. In the New Data Server Connection window, add the following:

    1. Connection Name: The name of the new connection. The resource is listed in the Resources Navigator with the name mentioned here.

    2. Connection Type: Connection types are Oracle(JDBC), MySQL, and SQLServer.

    3. The User name and Password to connect to the database. If you uncheck Save Password check box during connection creation and if you want to expand the Database node after re-connecting to repository, Database node expansion will ask you to enter the password to show all the nodes under database connection.

    4. The role as SYSDBA or SYSOPER. This can be left blank when the user is not SYS. Else, you have to select the role.

    5. The Oracle JDBC settings.

      By default, Oracle GoldenGate Studio provides drivers for Oracle, MySql, and SQLServer. Data direct drivers are provided for Informix, DB2, and Sybase but you can use any JDBC driver. Database driver can be configured by using Tools menu, then Preferences , Database, and finally JDBC Driver Options. Once a data server connection is created, you can browse objects under the database in the Resources Navigator and the information from the database navigator can be used for the mapping the tasks. Currently Oracle, MySQL, and SQLServer drivers are certified.

  3. Click OK to create a new Database resource.

    You can also test the connection using Test Connection button before creating the new resource.

2.6.2 Create a New View

You can create a new view using the Create New View wizard. It looks as follows:

Figure 2-6 Create New View

Create New View

To create a new View:

  1. Click the + sign for the database icon and select Views.
  2. Right click to display the context menu and select New View....
  3. Select the schema name from the Schema drop-down list.
  4. Enter the name of the view.
  5. You can enter the SQL code for the query part of the view definition, using the SELECT and FROM keywords.
  6. Click the Revert button to cancel any edits you have made since opening this dialog, and display the contents of the box before these edits.
  7. Click the Test button to open the Test Query window where you can:
    • Verify the SQL statement
    • View the results of running the query
    • See the explain plan for the query
  8. Click the DDL tab to view the SQL query that forms or defines the database object.
  9. Select the Advanced check box (only in Create dialog) to come out of declarative mode for this dialog and display the SQL Query page where you can enter the SQL query directly.
  10. Click the Check Syntax button to check the statement in SQL Query for any SQL syntax errors. Possible results are:
    • No errors found in SQL.
    • Error(s) parsing SQL, location of the first error.
    • The SQL syntax is valid, however the query is invalid or uses functionality not supported.
  11. Click OK to complete or Cancel to quit the wizard.

2.6.3 Add a New Global Mapping Group

The New Global Mapping Group wizard defines a container for table mappings but does not guide you through the table mapping process. To learn more about defining table mapping see Understanding Mapping Groups

A new Global Mapping Group wizard looks as follows:

Figure 2-7 New Global Mapping Group

New Global Mapping Group

To add a new Global Mapping Group:

  1. Click the New button on the Resources Navigator window or right click on the database icon and select New Global Mapping Group Connection.
  2. Enter the name of the new connection.
  3. Enter a short description to identify the resource.
  4. Click OK.

2.6.4 Add a New Oracle GoldenGate Instance

The Add a New Oracle GoldenGate Instance dialog defines a connection to an existing GoldenGate installation. That installation must already have the GoldenGate manager and jAgent processes running

A new Oracle GoldenGate Instance dialog looks as follows:

Figure 2-8 New Oracle GoldenGate Instance Connection

New Oracle GoldenGate Instance Connection

To add a new Oracle GoldenGate Connection:

  1. Click the New button on the Resources Navigator window or right click on the database icon and select New Oracle GoldenGate Instance Connection.
  2. Under General section enter the name and description for the new connection.
  3. Under Host Information enter Host Name. It is the DNS name of the server where Oracle GoldenGate is installed.
  4. Under Oracle GoldenGate Information enter the following:

    • GoldenGate Version: This gets automatically updated when Test Connection is clicked. You can also select the version from the drop down list while working offline. Test Connection only works if there is an active connection to database. You can also work in offline mode and provide all the required information. If there is an active connection and incorrect version is entered, the correct database information is fetched from the database to overwrite the incorrect version.

    • GoldenGate Database Type: The database type for which the connection is created. It gets automatically updated when Test Connection is clicked. You can also select the version from the drop down list while working offline.

    • GoldenGate Port: The port number for the Oracle GoldenGate manager process.

    • Agent Username: The JAgent name as specified by the jAgent.username property in the config.properties file of the jAgent at the time of installation.

    • Agent Password: The password for the corresponding username.

    • Agent Port: The jAgent port as specified by the jagent.jmx.port property in the config.properties file of the jAgent. If the agent mode is OEM, then you have to use jagent.rmi.port, if the agent mode is OGGMON then you have to use jagent.jmx.port.

  5. Click Test Connection to GoldenGate to verify if the connection is working. The version and database type is automatically updated on successful connection.