Link Search Menu Expand Document

Connect Soda to OracleDB

Last modified on 07-May-25

For Soda to run quality scans on your data, you must configure it to connect to your data source.
To learn how to set up Soda and configure it to connect to your data sources, see Get started.

Compatibility

Soda supports Oracle version 21.3 or greater.

Connection configuration reference

Install package: soda-oracle

data_source my_datasource_name:
  type: oracle
  username: ${USARBIG_USER}
  password: ${USARBIG_PASSWORD}
  connectstring: "${USARBIG_HOST}:${UARBIG_PORT}/USARBIG_SID}"

Alternatively, you can configure a connection without a connectstring.

data_source my_datasource_name:
  type: oracle
  username: simple
  password: simple_pass
  host: host
  service_name: service
Property Required Notes
type required Identify the type of data source for Soda.
username required Consider using system variables to retrieve this value securely.
password required Consider using system variables to retrieve this value securely.
host optional Provide a host identifier. Only used when connectstring is not provided.
port optional Provide a port identifier. Default is 1523. Only used when connectstring is not provided.
service_name optional Provide a service_name. Only used when connectstring is not provided.
connectstring optional Specify connection information for the Oracle database. Must be a semicolon-separated list of attribute name and value pairings. See ConnectionString in Oracle documentation. If you do not specify one, Soda attempts to construct a connectstring using host, port and service_name properties.
dataset_prefix optional Added in 1.10.1. A list of strings to be used for prefixing datasets. Useful for catalog integrations. Example: dataset_prefix: ["my_db", "my_schema"]

Test the data source connection

To confirm that you have correctly configured the connection details for the data source(s) in your configuration YAML file, use the test-connection command. If you wish, add a -V option to the command to returns results in verbose mode in the CLI.

soda test-connection -d my_datasource -c configuration.yml -V

Supported data types

Category Data type
text CHARACTER VARYING, CHARACTER, CHAR, TEXT
number SMALLINT, INTEGER, BIGINT, DECIMAL, NUMERIC, VARIABLE, REAL, DOUBLE PRECISION, SMALLSERIAL, SERIAL, BIGSERIAL
time TIMESTAMP, DATE, TIME, TIMESTAMP WITH TIME ZONE, TIMESTAMP WITHOUT TIME ZONE, TIME WITH TIME ZONE, TIME WITHOUT TIME ZONE



Was this documentation helpful?

What could we do to improve this page?

Documentation always applies to the latest version of Soda products
Last modified on 07-May-25