Oracle Database

Connect Foundry to Oracle Database to read and sync data between Oracle databases and Foundry.

If your external data source uses a version of the Oracle database that is older than 12.1 (which was released in 2013), you should use the general JDBC connector, and upload your own driver. The Oracle Database connector described below implements the Oracle JDBC 21.x driver. Learn more about the JDBC driver interoperability matrix for Oracle database versions in the official Oracle documentation ↗.

The Oracle Database connector is a Palantir-provided driver connector. Review the official documentation for this driver ↗.

Supported capabilities

CapabilityStatus
Exploration🟢 Generally available
Batch syncs🟢 Generally available
Incremental🟢 Generally available
Change data capture syncs🟢 Generally available
Table exports🟡 Beta

Setup

  1. Open the Data Connection application and select + New Source in the upper right corner of the screen.
  2. Select Oracle from the available connector types.
  3. Choose to use a direct connection over the Internet or to connect through an agent runtime.
  4. Follow the additional configuration prompts to continue the setup of your connector using the information in the sections below.

Learn more about setting up a connector in Foundry.

Authentication

The Oracle Database connector supports authentication using a username and password. We recommend using service credentials rather than individual user credentials.

Networking

If using an agent connection, the agent must be allowed to connect to the Oracle database. This means that the agent must be able to reach the destination IP address, and the destination system must be configured to allow connections from the agent.

If using a direct connection, be sure to add the appropriate egress policies to the connector:

Domain/HostRequired
Oracle host/IPAlways

The default port for Oracle database connections is 1521, but your specific configuration may use a different port.

Connection details

OptionRequired?Description
Host typeYesThe type of host identifier being provided. Can be either hostname or ipv4.
HostnameYesThe hostname or IP address of your Oracle database server.
PortYesThe port number of your Oracle database (default is 1521).
Service identifier typeYesThe type of service identifier to use. Can be either SID or Service name.
TLSNoEnable TLS encryption ↗ for the connection. When enabled (default), the connection will use TLS to encrypt all communication with the Oracle database.
UsernameYesThe username to authenticate with the Oracle database.
PasswordYesThe password to authenticate with the Oracle database.
Client certificates & private keyNoClient certificates and private keys may or may not be required by your source to secure the connection.
Server certificatesNoServer certificates may or may not be required by your source to secure the connection.

Virtual tables

This section provides additional details around using virtual tables from an Oracle Database source. This section is not applicable when syncing to Foundry datasets.

Virtual tables capabilityStatus
Manual registration🟢 Generally available
Automatic registration🔴 Not available
Pushdown compute🔴 Not available

When using virtual tables, remember the following source configuration requirements:

  • You must set up the source as a direct connection. Virtual tables do not support the use of intermediary agents.
  • Ensure that bi-directional connectivity and allowlisting is established as described in the Networking section above.
  • If using virtual tables in Code Repositories, refer to the related documentation for details about additional required source configurations.
  • When setting up the source credentials, you must use username/password.