Documentation
Snowflake
Connect TableR to Snowflake over HTTPS with your account host, warehouse, role, connection fields, verifying the connection, and troubleshooting.
Snowflake is a cloud data warehouse reached over HTTPS at your account host. Fill the connection form with your account URL and credentials to start querying.
Overview
TableR connects to Snowflake through its HTTPS endpoint, so the connection is always encrypted. It works with any Snowflake account; queries run on the warehouse you select, and your role controls what you can see.
- Cloud warehouse — reached at account.region.snowflakecomputing.com over HTTPS (port 443).
- Compute — a warehouse must be available; set one when the session has no default.
- Access — the role determines the databases, schemas, and objects you can query.
Before you start
- Your Snowflake account host (account.region.snowflakecomputing.com).
- A username and its password or token.
- A warehouse name, if your user has no default warehouse.
- Optionally, a default role, database, and schema.
Connection fields
These fields match TableR's Snowflake connection form. The connection uses HTTPS, and secrets are written to the operating system keyring, never to plain configuration files.
| Field | Required | Default | Notes |
|---|---|---|---|
| Host | Yes | — | account.region.snowflakecomputing.com. |
| Port | Yes | 443 | HTTPS; the connection is always encrypted. |
| Credential | Yes | — | Your Snowflake password or token; stored in the OS keyring. |
| Warehouse | No | — | Required when the session has no default warehouse. |
| Role | No | — | Optional; the default role is used when empty. |
| Database | No | — | Optional default database. |
| Schema | No | — | Optional default schema. |
Connect with the form
- 1Choose Snowflake
Open the launcher and pick the Snowflake card.
- 2Enter the account host
Use your account URL, account.region.snowflakecomputing.com.
- 3Add your credential
Type the username and password or token; it is saved to the OS keyring.
- 4Set a warehouse (if needed)
Provide a warehouse when your user has no default.
- 5Pick role, database, schema (optional)
Leave these blank to use your account defaults.
- 6Save and connect
Save the profile so it reappears in the launcher, then connect.
Verify the connection
Once connected, open a SQL tab and run a quick check:
SELECT CURRENT_VERSION();
SELECT CURRENT_ACCOUNT(), CURRENT_USER(), CURRENT_WAREHOUSE();If both statements return rows, the connection and credentials are working.
Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| Could not connect to host | Wrong account host or no network access. | Re-check the account URL (account.region.snowflakecomputing.com) and your connection. |
| Authentication failed | Wrong username, password, or token. | Re-check the credential and update the saved secret (it lives in the keyring). |
| No active warehouse selected | The session has no warehouse. | Set the Warehouse field, or assign a default warehouse to the user. |
| Object does not exist or not authorized | The role cannot see the object. | Use a role with access, or set the correct default role. |