Book a Demo

Please note : This help page is not for the latest version of Enterprise Architect. The latest help can be found here.

Prev Next

Create a Project in an Oracle Database

To create a project in a repository on Oracle 9i, 10g, 11g or 12c, you work through these stages:

  • Stage 1: Create a new Oracle database user to own the Enterprise Architect tables
  • Stage 2: Connect to the Oracle repository; Sparx Systems recommends using Oracle Provider for OLE DB - connecting with either Microsoft OLE DB Provider for ODBC or Microsoft OLE DB Provider for Oracle could cause unexpected behavior or performance issues due to known limitations of those drivers
  • Stage 3: Set up initial model data


  • A machine with Oracle 9i, 10g, 11 g or 12c installed and running
  • Oracle Client installed on the client machine, please ensure that the OLE/DB drivers are installed (you can download the drivers from the Oracle Technology Network web site, as part of the Oracle Data Access Components (ODAC) package; see Learn more)

1. Create Database Repository



See also


Create a new Oracle database user to own the Enterprise Architect tables.

Create an Oracle Repository


Open your SQL management console of choice (such as Oracle SQL Developer) and connect to the newly create Enterprise Architect repository.


Load the EASchema_1220_Oracle.sql file from the Sparx Systems website.


Run the script to create the required database schema.

2. Set up Oracle connection


In order for an OLE/DB connection to connect to an Oracle based Enterprise Architect repository, an entry in each user's local TNSNAMES.ORA needs to be defined, stating the server name, Port and other details of the Oracle server.

3. Set up Initial Data

Enterprise Architect repositories require a basic amount of reference data to function correctly.

You can set up this initial data in one of two different ways:

  • Transfer the entire contents of an existing model into the new database, or
  • Load initial data using a SQL Script

3.1 Load Initial Data - Transfer existing model

If you choose to set up your new database with the contents of an existing model then Sparx Systems recommend that a Project Integrity check is performed on the existing model to ensure it is 'clean' and free from data-related errors before being copied into the new database.

The Enterprise Architect installation provides a model called EABase.eap, which is copied into the installation folder specifically for the purpose of providing basic data for a new model. However, if you have customized the various drop-down lists in another model then you might prefer to use that. Regardless of what model you choose to use, the process is the same and is outlined here.



See also


In Enterprise Architect, open the existing repository and select 'Configure > Model > Integrity > Project Integrity' in the ribbon.


Ensure that the 'Action' panel is set to 'Report Only' and that all items in 'Checks to Run' are enabled, then click on the Go button.


If Enterprise Architect detects that the existing model contains integrity issues, they will be listed in the main panel at the bottom of the dialog. These issues should be resolved before continuing with the project transfer.


With Enterprise Architect open, ensure that it there is no project loaded, by selecting 'Close Project' from the  Project list button.


Select the 'Configure > Model > Transfer > Project Transfer' ribbon option.

The 'Project Transfer' dialog displays.


In the 'Transfer Type' panel, select 'File to DBMS'.


At the right of the 'Source Project' field, click on the Browse. button and browse for the name of the project file to copy to Oracle.

If the .EAP file has Replication enabled, this must be removed before performing the transfer.

Remove Replication


At the right of the 'Target Project' field, click on the Browse. button.

The 'Datalink Properties' dialog displays.


Select 'Oracle Provider for OLE DB' from the list.

Click on the Next button.


On the 'Connection' page of the 'Datalink Properties' dialog, enter the Oracle service name in the 'Data Source' field, and the user name and password as required.

Click on the OK button. The 'Project Transfer' dialog redisplays.


If required, select the 'Logfile' checkbox and type a path and filename for the data transfer log file.


Click on the Transfer button to begin the data transfer process.


When the process is complete, you have created a project on an Oracle database and can now connect to it and open it from Enterprise Architect.

Connect to an Oracle Repository (OLE DB)

3.2. Load Initial Data - SQL Script


Open your SQL management console of choice (such as SQL Developer) and log in as the owner of the newly created Enterprise Architect repository.


Load the EABase_1220_Oracle.sql file from the Sparx Systems website.


Run EABase_1220_Oracle.sql  to create the required database schema.


  • When transferring a project to Oracle you must have access rights to execute the CREATE SEQUENCE command

Learn more