Create a New Database Connection
Summary of Content
Requirements
Create a Connection
Connection Credential Terms
Whitelisting IPs
Write Access
Permissions
Query Timeouts
Requirements
- Admin privileges in your Sigma organization. Learn about account types
- A Snowflake, BigQuery, Redshift or Postgres data warehouse.
Create a Connection
- Open your Admin Portal by selecting Administration in the user menu at the top right of your screen.
- Select the Connections page from the left hand panel.
- Click the Create Connection button.
- Name your connection.
- Select your warehouse type.
- Each warehouse type requires different input. Use the following instructions for your warehouse:
- Connect to Snowflake
- Connect to BigQuery
- Connect to Redshift (Use Redshift document to configure Postgres connection.) - [optional] Under Connection Features, you can set a connection timeout and/or enable write access.
- After completing the form, click the Create button in the top right of your screen.
Connection Credential Terms
Term | Definition | Warehouse(s) |
Name | The name of the connection that Sigma will display in the connection list | All |
Account | The account path where your database is located | Snowflake |
Host | The host path where your database is located | Redshift, Postgres |
Port | The port Sigma will use to connect to the host | Redshift, Postgres |
User | The username you use when connecting to the database | Snowflake, Redshift, Postgres |
Warehouse | The name of the warehouse you would like to query using Sigma | Snowflake |
Database | The name of the database you would like to query using Sigma | Redshift, Postgres |
Role | The Snowflake user role to be used for the connection | Snowflake |
Billing Project ID | Your BigQuery Project ID | BigQuery |
Service Account | A JSON key associated with your Service Account | BigQuery |
Whitelisting IPs
In some cases, you may need to whitelist Sigma's IP addresses to successfully connect to your data. This step is required when your warehouse is closed to external connections (ie you have firewalls, security groups, or other IP-based security policies).
Sigma's egress IP addresses are listed on all individual connection pages in your Sigma Admin Portal. To view them, (1) Open your Admin Portal to the Connection page. (2) Select any connection or click Create Connection (3) Look for the IP addresses listed under connection credentials.
Write Access
You may want to enable write access on your connection. Write access is required for materialization, CSV uploads, and Dataset Warehouse Views.
Permissions
After creating a connection, you will likely want to selectively share access with other people in your organization. Learn more about permissions.
Query Timeouts
By default, Sigma sets query timeouts to 120 seconds (2 minutes). When queries hit the timeout limit, Sigma will cancel the query. Under Connection Features, you can set a custom query timeout for your connection.
Related Resources
Connect to Snowflake
Connect to BigQuery
Connect to Redshift (Use Redshift document to configure Postgres connection.)