Create a New Database Connection
Summary of Content
- 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 or Postgres
- [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
|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|
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.
After creating a connection, you will likely want to selectively share access with other people in your organization. Learn more about permissions.
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.