Snowflake

Overview

You can create a Snowflake Destination Connector to write to a table within your Snowflake, using Snowflake's key pair authentication.

To set up this Destination Connector, you will need to configure key pair authentication for your Snowflake account and provide the private key. To learn more about configuring key pair authentication within Snowflake, visit: https://docs.snowflake.com/en/user-guide/key-pair-auth.html

The schema for this Destination Connector is defined by the Snowflake table schema.

Prerequisites

Required information:

• Private Key

• Account Name

• User Name (with appropriate privileges)

• Warehouse

Creating a Snowflake Destination Connector

Step 1: After selecting + New Connector, under the System prompt, click Snowflake.

Step 2: Enter a Connector Name.‌

Step 3: Select Destination Connector.

Authentication

Step 4: Provide a private key for your Snowflake environment in PEM format as shown below:

Note: We do not currently support encrypted keys

To learn more about configuring key pair authentication for your Snowflake account, visit: https://docs.snowflake.com/en/user-guide/key-pair-auth.html

Account & Database Information

Step 5: Provide your Snowflake account locator in this format <account_locator>.<region_id>.<cloud>

Note: You can find the account_locator, region_id and cloud info in your account URL. Please see a screenshot below to find your account URL:

Note: Your full account name may include segments that identify the region and cloud platform where your account is hosted. Include those additional segments when providing your account name.

To learn more about Snowflake account names, visit: https://docs.snowflake.com/en/user-guide/admin-account-identifier.html#non-vps-account-locator-formats-by-cloud-platform-and-region

Step 6: Provide your User Name.

This User Name must be associated with an account that has the required permissions enabled in order to successfully build a connector. To learn more about Snowflake access controlprivledges, visit: https://docs.snowflake.com/en/user-guide/security-access-control.html

Step 7: Provide the name of the Warehouse that will execute the query you provide below.

Step 8: Provide the name of the Database that contains the table you want to write to.

Step 9: Provide the name of the Schema that contains the table you want to write to.

Step 10: Provide the name of the Table you want to write to.

Note: the schema for this Destination Connector is defined by the Snowflake table schema.

Advanced Options

Validation Webhook

We support the use of Validation Webhooks to prevent bad data from being written to your systems, adding another layer of protection to the built-in validations that Osmos provides. The Webhook URL can be posted here.

For more information on Validation Webhook configuration, see Server Side Validation Webhooks

Connector Options

The connector can be deleted, edited and duplicated.

Duplication

To save time, the connector can be duplicated. This new connector needs to be named and can be edited, as needed.