A warehouse connection tells Delphina how to reach your data warehouse. Each connection belongs to a workspace and provides read-only access. Supported: Snowflake, BigQuery, Databricks, Redshift, and PostgreSQL.Documentation Index
Fetch the complete documentation index at: https://docs.delphina.ai/llms.txt
Use this file to discover all available pages before exploring further.
Adding a connection
- Go to Org Admin > Warehouse Connections.
- Click Add Connection.
- Choose the workspace, warehouse type, and fill in credentials.
- Click Create.
Supported warehouses
| Warehouse | Authentication | Query history |
|---|---|---|
| Snowflake | Private key, password | Supported |
| BigQuery | Service account JSON, per-user OAuth | Supported |
| Databricks | OAuth (M2M), personal access token, optional per-user OAuth | Supported |
| Redshift | IAM role | Not supported |
| PostgreSQL | Username/password | Not supported |
Managing connections
- Default connection — click the star icon to set which connection the agent uses.
- Edit — click the edit icon. Existing credentials are preserved if not changed. Workspace and name cannot be changed after creation.
- Delete — click the delete icon. The connection is soft-deleted.
Configuring source tables
After creating a connection, configure which tables the agent can use:- Go to Context > Sources > Warehouse.
- Select a connection.
- Tables tab — browse and select tables for knowledge extraction. Use Bulk Edit to paste table names.
- Query Users tab (Snowflake/BigQuery only) — select users whose query patterns inform the agent’s knowledge.
Troubleshooting
| Problem | Fix |
|---|---|
| Agent can’t connect | Verify credentials work from another client, then update |
| ”Browse Tables” empty | Grant USAGE on the database/schema to the role |
| ”Show Top Users” empty | Snowflake/BigQuery only; ensure access to query history views |
| Connection works but agent ignores it | Set as default for the workspace |