Connect your data
Start at SeekWell Sources. You can connect a database directly or reuse credentials from a supported source or destination in your Extract account.
Supported databases
| Database | Existing connection reference |
|---|---|
| BigQuery | BigQuery |
| ClickHouse | ClickHouse |
| Databricks | Databricks |
| MySQL | MySQL |
| Postgres | Postgres |
| Redshift | Redshift |
| Snowflake | Snowflake |
These references describe Extract connectors. In SeekWell, complete the fields shown by its connection form; Extract dataset queries, load settings, and sync schedules are not part of SeekWell setup.
An existing Postgres (CDC) source can supply credentials for a SeekWell Postgres connection. SeekWell does not require replication slots, publications, or other CDC configuration.
Before you begin
- Have permission to view sources and destinations. Adding or changing a source also requires permission to manage sources and destinations.
- Prepare credentials that can read the intended tables and discover their metadata. Use a dedicated database identity with only the access your analysis needs.
- Confirm that the database allows network connections from Extract. Check the host, port, network allowlist, and any TLS requirements with your database administrator.
- For warehouses, have the required project, warehouse, catalog, or database details available for the selected connector.
Add a new connection
- In Sources, select Add Source.
- Choose your database from the new connection choices.
- Enter a Source name that your team will recognize, such as
Production analytics. - Complete the connection fields displayed for that database, including authentication details.
- Select Continue to save the settings and test the connection. Review the connection logs if the test fails, correct the settings, and retry.
- After a successful test, choose key tables and select Save source to finish setup.
If you also need an Extract source, select Also add to Extract as a source before continuing. This creates a separate source using a copy of the credentials and is subject to your Extract account’s normal limits. Leave it unchecked when you only need SeekWell.
Reuse an Extract connection
- Select Add Source and find the connection under From your Extract account.
- Select the existing source or destination. Only supported database connections appear.
- Review the copied settings, update them if needed, and select Continue to test access.
- Choose key tables and select Save source.
The copied configuration is independent of the original. If credentials change later, update each configuration that uses them.
Manage a connected source
The Sources list shows connection status and the number of selected key tables. Use Edit Key Tables in the source menu to change the selection. Open in Extract opens the original Extract connector when a link is available; it is disabled for sources without a known original connector.
Remove from SeekWell removes the SeekWell configuration and preserves existing Extract sources and destinations.
Troubleshooting
| What you see | What to check |
|---|---|
| A database or existing connection is missing | Confirm it is supported and belongs to the current account. Ask your administrator to check access. |
| Connection test fails | Review the logs, credentials, host, port, network access, and database permissions, then retry Continue. |
| Requires Reauth | Open the source and reconnect using valid credentials. |
| No tables after a successful connection | Check metadata and table-read permissions, then use Refresh tables on the key-table screen. |
| Optional Extract source creation fails | Correct the reported issue and retry, or uncheck Also add to Extract as a source to continue with SeekWell. |