Skip to content

Databases and warehouses

Where: Sources in the sidebar → New source → Connect database → pick the database under Connector.

Follow Connect a database, application or cloud source and pick the database under Connector. Most databases share one form:

FieldRequiredNotes
HostYesA hostname or IP address, for example db.example.com.
PortYesFilled in with the engine’s default; change it if yours differs.
DatabaseYesThe database to read.
SchemaDepends on the engineSee the table below.
UserYesUse an account that can read the tables you want to load.
PasswordYes

Teramot only reads from your database. A read-only user with access to the tables you want is enough: Prepare your sources has the script to create one on each engine.

ConnectorDefault portSchemaConnection methods
PostgreSQL5432OptionalDirect, IP Whitelisting, SSH Tunnel, Private Connection
MySQL3306—Direct, IP Whitelisting, SSH Tunnel, Private Connection
MariaDB3306—Direct, IP Whitelisting
SQL Server1433RequiredDirect, IP Whitelisting, SSH Tunnel, Private Connection
Azure SQL1433RequiredDirect, IP Whitelisting
Amazon Redshift5439OptionalDirect, IP Whitelisting
ClickHouse8123OptionalDirect, IP Whitelisting
Oracle DB1521OptionalDirect, IP Whitelisting, SSH Tunnel, Private Connection
SAP Hana30015OptionalDirect, IP Whitelisting
Databricks—OptionalDirect, IP Whitelisting
Snowflake—OptionalDirect, IP Whitelisting
Teradata1025OptionalDirect, IP Whitelisting

The connection methods are explained in How Teramot reaches a database. MongoDB is covered in Applications and cloud sources.

Oracle DB

  • Service name replaces Database and is required.
  • Oracle SID is optional.
  • Table owner replaces Schema. It is optional; enter it in upper case.

Snowflake

  • Account identifier replaces Host: your account identifier, not a full URL.
  • There is no port.
  • Warehouse is required.
  • Role is optional; without it, the user’s default role is used.

Databricks

  • Server hostname: without https://.
  • HTTP path: required, starts with /.
  • Catalog replaces Database.
  • Access token replaces User and Password: a Databricks personal access token.