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
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.
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
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 \
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.
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.
Click Import to start the import.
When done close import window with 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 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: