Skip to main content

Oracle DB

Oracle DB is a relational database management system. In Prophecy, you can connect to Oracle to read from and write to database tables as part of your pipelines. This page explains how to set up the connection, including required parameters, permissions, and how connections are shared within teams.

Feature support

The table below outlines whether the connection supports certain Prophecy features.

FeatureSupported
Read data with a Source gemYes
Write data with a Target gemNo
Browse data in the Environment browserYes

Parameters

To create a connection with Oracle, enter the following parameters:

ParameterDescription
Connection nameA name to identify your connection in Prophecy
ServerHostname of the Oracle database server
PortPort used by the Oracle database (default is 1521)
UsernameUsername for connecting to the Oracle database
DatabaseOracle Service Name or SID of the target database
Password (Secret required)Password for the specified user

Oracle permissions

When you create an Oracle connection in Prophecy, access permissions are tied to the credentials you use. This is because Prophecy uses your credentials to execute all data operations, such as reading from or writing to tables. To fully leverage an Oracle connection in Prophecy, you need read and write access to the tables you use.

Sharing connections within teams

Connections in Prophecy are stored within fabrics, which are assigned to specific teams. Once an Oracle connection is added to a fabric, all team members that have access to the fabric can use the connection in their projects. No additional authentication is required—team members automatically inherit the access and permissions of the original connection.

caution

Be mindful of the access level granted by the stored credentials. Anyone on the team will have the same permissions—including access to sensitive data if allowed.

To manage this securely, consider creating a dedicated fabric and team for high-sensitivity connections. This way, only approved users have access to those credentials.

Fetching data

Prophecy fetches data from Oracle connections in the following ways:

  • When you browse an Oracle connection in the Environment browser, Prophecy fetches data on demand as you expand folders. You can manually refresh the Environment browser to see updated files.

  • When a pipeline runs, Source gems will read the latest available version of the data. If the schema of your data in Oracle changes, Prophecy will automatically use the new schema.