Connecting to databases
With the Celonis Platform you can connect to a number of SQL databases via JDBC connectors. When connecting to supported databases, you can either connect directly to the database or use an uplink/on-premise connection:
Direct connection: Use this when you want to allow the Celonis Platform to directly access your database. For more information about direct database connections, see: Connecting to a database
Uplink connection via an on-premise extractor: Use this when you don't want to or can't allow the Celonis Platform to directly access your database. The connection is then established using an on-premise extractor, allowing you to continuously fetch data from your database and send it to the Celonis Platform. For more information about uplink or on-premise database connections, see: Connecting to a database
In many cases, you can connect to these databases just using the extractor provided by Celonis, however there database connection that require you to download the JDBC connector or driver from the database provider. In these cases, consider the following connection types:
Connecting using a custom JDBC string: You can connect to your database using a custom JDBC string, allowing you to extend the settings offered by our extractor builder. This is useful for when you want to configure SSL, add certificates, or use
.jks
files for your database connection.To learn how to connect to your database using a custom JDBC string, see: Using custom JDBC string.
Connecting using a custom JDBC driver: You can connect to your database using a custom JDBC driver, allowing you to extend the settings offered by our extractor builder. This requires you to use an uplink connection (using an on-premise extractor), with the custom driver being supplied by you.
To learn how to connect to your database using a custom JDBC driver, see: Using custom JDBC driver.
Supported database types
When viewing the below table, there are two status indicators:
Status indicator | Status description |
---|---|
![]() | You can connect to this database without supplying a custom JDBC driver, see: Connecting to a database. |
![]() | We recommend that you connect to this database by supplying a custom JDBC driver in combination with using a JDBC connection string. This combination allows you to configure additional properties that aren't configurable using standard templates. For more information: |
The following database extractors are available in the Celonis Platform:
Database type | Direct connection | Uplink/On-premise connection |
---|---|---|
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
Azure SQL | ![]() | ![]() |
Azure Synapse | ![]() | ![]() |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
Note: A custom driver is needed to use Windows Authentication. | ![]() | ![]() |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() |
Database extractor feature matrix
The below matrices highlight the available features for our commonly supported databases connections.
When viewing the below matrices, there are two status indicators:
Status Indicator | Status Description |
---|---|
![]() | This feature is supported and can be used with this database. |
![]() | This feature is not currently supported and can't be used with this database. |
The following authentication types are used when connecting to databases:
Feature | Azure SQL | Azure Synapse | Oracle 11g | Oracle | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Database credentials (username and password) | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Active directory | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
OAuth | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Service account authentication | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Application default credentials | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Personal access token | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Key pair authentication | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
The following connection settings are available for databases:
Feature | Feature Description | Azure SQL | Azure Synapse | Oracle 11g | Oracle | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Pseudonmyzation algorithms | The applied pseudonymization algorithms can be selected in the advanced settings of the extractor builder: Supported Algorithms:
| ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Parallelization of table extractions | The max. number of parallel requests the extractor makes can be customized in the advanced settings when configuring the extractor.
| ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Timeout for database connection | Timeout for all database connections created in this connection (specific to this connection only). | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Live data connection (using the Replication Cockpit) | The ability to establish a live connection to the database using the replication cockpit. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
The following object types are available for databases:
Feature | Azure SQL | Azure Synapse | Oracle 11g | Oracle | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Tables | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Views | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Synonyms | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Analytical views | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
External tables | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Snapshots | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Materialized views | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
The following object configurations are possible for databases:
Feature | Feature Description | Azure SQL | Azure Synapse | Oracle 11g | Oracle | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Table joins | It is possible to join the extracted table on another table during the extraction. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Time filter | Creation date filter: Used to restrict the number of records to be extracted. Change date filter: Used for delta extractions. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Filtering | Filters can be applied on table level based on the supported filtering operators (documented below). | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
The following filters are supported by databases:
Feature | Azure SQL | Azure Synapse | Oracle 11g | Oracle | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
= | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
<; > | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
>=; <= | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
IN | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
NOT IN | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
The following column configuration options are supported by databases:
Feature | Feature Description | Azure SQL | Azure Synapse | Oracle 11g | Oracle | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Rename target table | The name of the table which is created in Celonis can be customized as part of the table configuration. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Column selection | The subset of columns that should be extracted can be selected. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Column pseudonymization | The columns that should be pseudonymized with the chosen algorithm can be selected. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Customize primary key | Additional columns can be added to the default primary key definition. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Casting of data types | The data type with which the extracted columns are inserted to Celonis can be customized. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Column data types | The column data type with which the extracted columns are inserted to Celonis. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Limit total records | The total number of records to be extracted can be limited using this feature. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Binary data type handling | Table column with binary data type can be represented in two ways:
Depending on the value specified here the binary value will be converted. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Maximum string length configuration | Allows the modification of the default length (80 characters) of String-type columns. This is configured using the parameter: MAX_STRING_LENGTH | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Batch size configuration | Allows specifying the batch size (in records) for one extraction request. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
The following metadata resolution options are supported by databases:
Feature | Feature Description | Azure SQL | Azure Synapse | Oracle 11g | Oracle | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DRIVER_METADATA | This metadata source is supported by all source systems and mostly it is the default one. Here the driver internally runs the metadata Query against the source system and fetches the result set. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
SAMPLE_QUERY | This metadata source is supported by all source systems. This also works the same as driver metadata, only the query used is different. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
INFORMATION_SCHEMA | This metadata source is supported mainly by Oracle system. And it's a default metadata source for Oracle 11g. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
PG_CATALOG | This metadata source is supported by Amazon Redshift. And it's a default metadata source. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
The following data processing and resolution options are supported by databases:
Feature | Feature Description | Azure SQL | Azure Synapse | Oracle 11g | Oracle | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Duplicate removal | Duplicate records retrieved within the extraction are removed based on the defined primary key and ordering columns. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Debug | Allows the enablement of a time-limited debug mode in the extraction settings to expose additional log messages. | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
Extraction preview | Filters can be applied for dependent tables | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |