Oracle database support

Applies to: Dataedo 23.x (current) versions, Article available also for: 10.x

Catalog and documentation

Data Dictionary

Dataedo imports tables, views, materialized views and columns.

Procedures, packages, functions and triggers

Procedures, packages, functions and triggers will be imported with their code.

Descriptions, aliases and custom fields

When technical metadata is imported users will be able to edit descriptions of each object and element, provide meaningful aliases (titles) and document everyting with additional custom fields.

Import and export comments

When importing metadata from Oracle, Dataedo reads table, view and column comments.

Business Glossary

Users will be able to link a Business Glossary term to any Oracle object.

Table relationships and keys

Dataedo imports table relationships (foreign keys), primary and unique keys with their columns.

ER Diagrams

Using imported and manually created foreign keys Dataedo allows you to create your own ER diagrams (ERDs) manually.

Data Profiling

Users will be able to run data profiling for a table, view or materialized view, then save selected data in the repository. This data will be available from Desktop and Web.

Lookups / Reference data

Users will be able to build Lookups for columns in Oracle tables and views and feed them with distinct values from a column.

Data Classification

Users will be able to run classification on Snowflake database in the repository in serach of columns containing potentially sensitive data. All built in functions are supported.

Importing changes and schema change tracking

Changes to descriptions in Dataedo Desktop and Web Catalog are tracked and saved in the repository.

Description changes

Changes to descriptions in Dataedo Desktop and Web Catalog are tracked and saved in the repository. Users are able to manually edit object description.

Share in Web Catalog or export to HTML, PDF or Excel

Documentations can be exported by sharing it in web catalog or generating HTML, PDF or Excel.

Subject areas

Users can mannually create multiple ERDs in subject areas, as a diagram of whole database or only part of it.

Connection requirements

Connection type - Direct vs Oracle client

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

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

Connection to Oracle

Oracle client 32 vs 64 bit

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

Connecting to Oracle

Connecting to Oracle with Oracle Client

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

Add documentation

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 a database is on. E.g. server17, server17.ourdomain.com or 192.168.0.37.
  • Service name - type in Oracle instance Service name
  • Port - type in 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

Connection to Oracle

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

Connection to Oracle

Connection to Oracle

Connection to Oracle

Finding connection details

If you don't know connection details you can look into \\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 Use different schema option and choose the schemas you want to import from through the the list displayed when clicking the [...] button.

Saving password

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

Importing schema

When connection was 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 list of objects.

Objects to import

Confirm list of objects to import by clicking Next. Next screen with allow you to change default name of the documentation under with your schema will be visible in Dataedo repository.

Change title

Click Import to start the import.

Importing documentation

When done close import window with Finish button.

Import succeeded

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

Imported database schema

Importing changes

To sync any changes in the schema in Oracle and reimport any technical metadata simply choose 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 Save update command option. Downloaded file can be run in command line, what will reimport changes to your documentation.

Specification

Supported versions

Oracle 9i R1, 9i R2, 10g R1, 10g R2, 11g R1, 11g R2, 12c R1, 12c R2, 18c, 19c, 21c, 23c.

Supported editions

Express, Standard and Enterprise.

Imported metadata

Imported Editable
Tables
  Columns
   Data types
   Nullability
   Column comments
  Table comments
  Foreign keys
  Primary keys
  Unique keys
  Triggers
Views, Materialized Views
  Script
  Columns
    Data types
    Column comments
  View comments
Procedures, Cubes
  Script
  Parameters
User-defined Functions
  Script
  Input arguments
  Output results
  Function comments

Supported features

Feature Imported
Import comments
Write comments back
Data profiling
Reference data (import lookups)
Importing from DDL
Generating DDL
FK relationship tester
Writing back comments

Comments

Dataedo reads comments from following Oracle objects:

Object Read Write back
Table comments
  Column comments
View comments
  Columns
Procedures and Cubes comments
Function comments

Data profiling

Datedo supports following data profiling in Oracle:

Profile Support
Table row count
Table sample data
Column distribution (unique, non-unique, null, empty values)
Min, max values
Average
Variance
Standard deviation
Min-max span
Number of distinct values
Top 10/100/1000 values
10 random values

Read more about profiling in a Data Profliling documentation.

Data Lineage

Source Method Version
Views - object level From dependencies
Views - object level From SQL parsing
Views - column level From SQL parsing

Required access level

Importing database objects requires certain access level in documented database. User specified in "Import objects from database" window should at least have "Connect" role, and "Create session" system privilege.

Importing objects definition from different schema requires either SELECT_ANY_DICTIONARY (recommended) or SELECT permission on any table and view and EXECUTE permission on any procedure and function that are to be documented.

No data is altered in source database during a synchronization process.

Following objects are accessed during schema import process:

  • all_constraints
  • all_cons_columns
  • all_objects
  • all_tab_columns
  • all_tab_comments
  • ALL_ARGUMENTS
  • ALL_CONSTRAINTS
  • ALL_CONS_COLUMNS
  • ALL_INDEXES
  • ALL_IND_COLUMNS
  • ALL_SOURCE
  • ALL_TRIGGERS
  • dual

Under development

  • Import Sequences
  • Import Jobs

Known issues and limitations

Following schema elements currently are not supported:

  • Check constraints (vote)
  • Non unique indexes (vote
Found issue with this article? Comment below
Comments are only visible when the visitor has consented to statistics cookies. To see and add comments please accept statistics cookies.
0
There are no comments. Click here to write the first comment.