This documentation is available to agents as Markdown at https://docs.synthesized.io/tdk/latest/user_guide/010_get_started/jdbc_url.md. For the complete documentation index, see llms.txt.

JDBC URL Examples

Use these formats in the JDBC URL field when you connect a data source. Replace the parts in angle brackets with your own values.

JDBC URL quick reference

Find your data source, copy the example and replace the host, port and names with your own. Each row links to the full format and the vendor’s documentation.

Data source Starts with Example

PostgreSQL

jdbc:postgresql://

jdbc:postgresql://localhost:5432/postgres

SQL Server

jdbc:sqlserver://

jdbc:sqlserver://localhost:1433;encrypt=false;databaseName=master

MySQL

jdbc:mysql://

jdbc:mysql://localhost:3306/sakila

Oracle

jdbc:oracle:thin:@

jdbc:oracle:thin:@//localhost:1521/DB

Db2

jdbc:db2://

jdbc:db2://localhost:50000/testdb

SQLite

jdbc:sqlite:

jdbc:sqlite:/var/data/test.db

SAP HANA

jdbc:sap://

jdbc:sap://saphana.example.com:39015/?databaseName=TENANT01

Snowflake

jdbc:snowflake://

jdbc:snowflake://xy12345.eu-central-1.snowflakecomputing.com/?db=MYDB&warehouse=TDK_WAREHOUSE&schema=PUBLIC&role=TDK_ROLE

CSV file

s3://

s3://s3.amazonaws.com/my-bucket/my-input-dir/

XML/XSD file

xml:s3://

xml:s3://s3.amazonaws.com/my-bucket/my-input-dir/CCR001.xsd

PostgreSQL

jdbc:postgresql://<host>:<port>/<database>

Example:

jdbc:postgresql://localhost:5432/postgres

SQL Server

jdbc:sqlserver://<host>:<port>[;<property>=<value>]

Example, connecting to the master database without encryption:

jdbc:sqlserver://localhost:1433;encrypt=false;databaseName=master

MySQL

jdbc:mysql://<host>:<port>[/<database>][?properties]

Example:

jdbc:mysql://localhost:3306/sakila
LOAD DATA LOCAL INFILE needs the MySQL server (or managed instance) to allow local infile operations (local_infile=1). The platform turns on the JDBC-side property when USE_FILE_BATCH_INSERT is set, but the server configuration must permit it.

Oracle

The URL format depends on how you connect.

Service Name Connection

jdbc:oracle:thin:@//<host>:<port>/<serviceName>

Example:

jdbc:oracle:thin:@//localhost:1521/DB

TNS URL Format

You can put a tnsnames.ora entry in the URL:

jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=<host>)(PORT=<port>))(CONNECT_DATA=(SERVICE_NAME=<service>)))

Example:

jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=DB)))

Db2

Type 4 connectivity:

jdbc:db2://<host>:<port>/<database>

Example:

jdbc:db2://localhost:50000/testdb

SQLite

jdbc:sqlite:<path_to_sqlite_file>

Example, with an absolute path to the database file test.db:

jdbc:sqlite:/var/data/test.db

See this SQLite JDBC guide.

SAP HANA

jdbc:sap://<host>:<port>/?databaseName=<tenant>

Example:

jdbc:sap://saphana.example.com:39015/?databaseName=TENANT01

For SAP workflows, see SAP HANA connection.

Snowflake

jdbc:snowflake://<account_identifier>.snowflakecomputing.com/?db=<database>&warehouse=<warehouse>&schema=<schema>

Example:

jdbc:snowflake://xy12345.eu-central-1.snowflakecomputing.com/?db=MYDB&warehouse=TDK_WAREHOUSE&schema=PUBLIC&role=TDK_ROLE
Use your Snowflake programmatic access token (API token) as the password of the data source.

CSV File

CSV files are read from and written to S3-compatible storage. The location is the folder that holds the files:

s3://<file storage>:<port>/<bucket>/<directory>

Example:

s3://s3.amazonaws.com/my-bucket/my-input-dir/
In the Quick Start demo, local S3-compatible storage comes from the Versity gateway, which is off by default. Start it with COMPOSE_PROFILES=versity ./start.sh. Inside the Compose network its endpoint is http://versity:7070, so <file storage>:<port> is versity:7070. From your machine, it’s at http://localhost:10000.

XML/XSD File

The location is the XSD schema file in S3-compatible storage:

xml:s3://<file storage>:<port>/<bucket>/<directory>/<file.xsd>

Example:

xml:s3://s3.amazonaws.com/my-bucket/my-input-dir/CCR001.xsd