Skip to main content

Manage Snowflake

Manage your Snowflake integration to start or stop syncs, update property mapping, and view sync history.

Sophie avatar
Written by Sophie
Updated over a week ago

After the data sync integration is set up using the Connect Snowflake steps, easily manage and configure it to tailor the integration to your specific needs.

Manage your Snowflake data syncs:

Select from the tabs to manage the integration:

Manage the Snowflake Integration

🚨 Managing Snowflake requires the "Modify data integration settings" permission. This includes the Rally default roles Admin, Ops Manager, and Developer/IT.

  1. In the top left corner of Rally, select your workspace name and select Settings.

  2. From the sidebar, select Integrations.

  3. To the right of Snowflake, select Manage.

  4. Select the connection you want to view, edit or manage to open it.

    • You can use Add Connection to set up a second connection (2 max) or Delete All to fully remove all Snowflake account connections.

  5. Learn more about management options in the sections below.

Sync Configuration

Update your sync configuration settings at any time to better fit your needs.

  • Create new records in Snowflake during sync

    • Always selected; if a Rally record isn't found in Snowflake using the person's identifier, a new Snowflake record will be created.

    • Only takes effect if one or more property mappings have sync direction Rally to Snowflake or Two-way.

  • Delete records in Snowflake during sync

    • If selected, any Snowflake records that don't exist / have a match in Rally (based on the person's identifier) will be deleted from Snowflake.

    • If enabled, Create new people in Rally during sync preference is disabled as we would delete external records in Snowflake if it does not exist in Rally.

  • Create new people in Rally during sync

    • If a Snowflake record isn't found in Rally using the person's identifier, a new Rally record will be created.

    • If enabled, select which Population to sync records to.

  • What should Rally do if a record exists in Rally but is missing in Snowflake?

    • When a person record exists in Rally but is missing in Snowflake (record was removed or deleted), you can determine what action Rally takes.

      • Do nothing

      • Opt out missing people in Rally

        • When selected, people missing from Snowflake will be marked as Opted Out in Rally so they cannot be contacted.

      • Delete missing people in Rally

        • When selected, people missing from Snowflake will be completely deleted from Rally, and all their historical data from Rally removed.

  • Trigger sync whenever a CSV is uploaded to Rally

    • When enabled, Rally will automatically trigger a sync any time a .csv file is uploaded to auto-fill missing data from Snowflake, so a researcher uploading a list of participants can be sure they get the latest, most complete participant records without the extra work.

    • Contact Rally to get this feature.

🚨 The preference to automatically "delete people in Rally if deleted in Snowflake" is hidden by default to avoid active or historical participants accidentally being deleted from Rally. Contact Rally to enable.

Property Mapping

Add, update, or remove property mappings between Snowflake and Rally and configure their sync directions and conflict resolution setting.

  1. Within the Snowflake integration, select the Property Mapping tab.

  2. Select + Add property mapping to map a Snowflake field to a Rally property.

    • Select the desired Snowflake Field and the property in Rally to map it to.

    • Set the Sync Direction: Two Way, Snowflake to Rally, or Rally to Snowflake.

    • Set the Conflict Resolution: Prefer Snowflake, Prefer Rally, or Last Updated.

  3. Repeat the steps for any additional fields to map and update as needed.

  4. Select the trash icon if you need to to delete a property mapping.

Rally currently supports mapping the following field types from Snowflake to Rally:

Snowflake Field Type

Rally Field Type

ARRAY

multi-select*

checkbox

number

text; single-select*

TIMESTAMP_NTZ, TIMESTAMP_TZ, TIMESTAMP_LTZ, TIMESTAMP, DATE

date

*We only map up to 100 unique options per single- or multi-select property.

Sync History

View a table of all prior syncs to see how many people had data updated during each sync.

  • The # updated refers only to rows that have changed

  • We update when data in Snowflake is different than what we have stored in Rally

Check the status column to see if daily syncs are successful or not. If syncs are failed or canceled, contact Rally to learn more about why and how to resolve it.

Start or Stop Syncs

Run Manual Sync

Kick off a sync immediately, rather than waiting for the next 24hr interval, by selecting Run Manual Sync.

Pause or Resume Syncs

Pause your data from syncing between Rally and Snowflake until you select Resume.

Delete Connection

Delete Connection will disconnect Rally and Snowflake, prevent any more syncs from occurring, and remove all property mapping configurations.


Reconnect

This option is only visible when the data sync connection is disconnected. This will reinitiate the OAuth flow using the existing configuration, allowing you to update your refresh token and reset the expiry without needing to reconfigure the connection.

If your Snowflake instance is disconnected from Rally due to an expired refresh token, Rally will notify Admins with instructions to restore the connection.


Learn more about using Snowflake

Did this answer your question?