Connecting to Oracle database

Connection type - Direct vs Oracle client

Oracle database supports different connection modes. Dataedo supports two connection types:

• Oracle client - requires Oracle client installed on your machine.
• Direct - no client/provider is required.

Oracle client 32 vs 64 bit

Dataedo is shipped with 2 executables - 32 bit and 64 bit. Connecting to Oracle requires using the same architecture as the Oracle client installed on your machine. It is not determined by the architecture of workstation Windows.

• If you have a 32 bit Oracle client, run Dataedo (32 bit).
• If you have a 64 bit Oracle client, run Dataedo (64 bit).

Connecting to Oracle with Oracle Client

To connect to an Oracle database, create new documentation by clicking Add documentation and choosing Database connection.

On the connection screen, choose Oracle as DBMS.

Provide database connection details:

• Connection type - choose connection type (Direct or Oracle client).
• Host - provide a host name or address where the database is located. E.g., server17, server17.ourdomain.com, or 192.168.0.37.
• Service name - type in the Oracle instance Service name.
• Port - type in the Oracle instance port name.
• User and password - provide your username and password.
• Schema - you can choose schema(s) that you want to import to your documentation.

Here is a comparison with connection details in Oracle SQL Developer.

Finding connection details

If you don't know connection details, you can look into <Oracle client folder>\network\admin\tnsnames.ora file.

Different, multiple schemas

By default, Dataedo reads only objects from the user's schema, but you can choose a different schema or even multiple schemas at once.

Check the Use different schema option and choose the schemas you want to import from the list displayed when clicking the [...] button.

Saving password

You can save the password for later connections by checking the Save password option. Passwords are saved in the repository database.

Importing schema

When the connection is successful, Dataedo will read objects and show a list of objects found. You can choose which objects to import. You can also use advanced filter to narrow down the list of objects.

Confirm the list of objects to import by clicking Next.

The next screen will allow you to change the default name of the documentation under which your schema will be visible in the Dataedo repository.

Click Import to start the import.

When done, close the import window with the Finish button.

Your database schema has been imported to new documentation in the repository.

Importing changes

To sync any changes in the schema in Oracle and reimport any technical metadata, simply choose the Import changes option. You will be asked to connect to Oracle again, and changes will be synced from the source.

Scheduling imports

You can also schedule metadata updates using command line files. To do it, after creating documentation, use the Save update command option. The downloaded file can be run in the command line, which will reimport changes to your documentation.