Skip to content

Commit 00f29f7

Browse files
committed
initial data from KMcC
1 parent 9334e38 commit 00f29f7

File tree

1 file changed

+35
-2
lines changed

1 file changed

+35
-2
lines changed

docs/guides/integration-snowflake.md

Lines changed: 35 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,11 @@ import Link from '@docusaurus/Link';
1414
[Snowflake](https://www.snowflake.com/) is a cloud data warehousing solution, where you as a partner can store your data and integrate with the UID2 framework. Using Snowflake, UID2 enables you to securely share consumer identifier data without exposing sensitive <Link href="../ref-info/glossary-uid#gl-dii">directly identifying information (DII)</Link>. Even though you have the option to query the Operator Web Services directly for the consumer identifier data, the Snowflake UID2 integration offers a more seamless experience.
1515

1616
:::important
17-
This document is for those using the combined advertiser and data provider Snowflake marketplace listing published in February 2025. If you're using one of the earlier listings, which were separate for advertiser and data provider (that is, you subscribed prior to February 2025), see [Snowflake Integration Guide (Version Prior to February 2025)](integration-snowflake-previous.md). If you're using the earlier implementation, we recommend that you migrate to the newer version to take advantage of the updates and enhancements: for details, see [Changes from Previous Version](#changes-from-previous-version). For migration information, see [Migration Guide](#migration-guide).
17+
This document is for anyone using the combined advertiser and data provider Snowflake marketplace listing published in February 2025. If you're using one of the earlier listings, which were separate for advertiser and data provider (that is, you subscribed prior to February 2025), see [Snowflake Integration Guide (Version Prior to February 2025)](integration-snowflake-previous.md). If you're using the earlier implementation, we recommend that you migrate to the newer version to take advantage of the updates and enhancements: for details, see [Changes from Previous Version](#changes-from-previous-version). For migration information, see [Migration Guide](#migration-guide).
1818
:::
1919

20+
## Snowflake Marketplace Listing
21+
2022
The following listing for UID2 is available on the Snowflake marketplace:
2123
- [Unified ID 2.0: Advertiser and Data Provider Identity Solution](https://app.snowflake.com/marketplace/listing/GZT0ZRYXTN8/unified-id-2-0-unified-id-2-0-advertiser-and-data-provider-identity-solution)
2224

@@ -60,6 +62,38 @@ The following table shows details of the changes to the Snowflake views, from th
6062
| :-- | :-- | :-- |
6163
| `UID2_SALT_BUCKETS` | `SALT_BUCKETS` | For details, see [Monitor for Salt Bucket Rotation and Regenerate Raw UID2s](#monitor-for-salt-bucket-rotation-and-regenerate-raw-uid2s). |
6264

65+
## Summary of Integration Steps
66+
67+
The following list summarizes the integration steps for UID2 mapping in Snowflake:
68+
69+
1. Make sure that the UID2 POC paperwork is signed with your UID2 contact.
70+
71+
1. Request access to the UID2 share through the [Snowflake Marketplace Listing](#snowflake-marketplace-listing). In your request, include the following information:
72+
73+
- Your Snowflake account number
74+
- The region
75+
76+
1. Your UID2 contact will arrange for your Snowflake account to be provisioned with access to the UID2 mapping share.
77+
78+
You can also download suggested workflow scripts to get started with basic mapping and salt bucket rotation concepts. [**GWH_TODO get scripts, figure if we can offer them as a downloadable asset.**]
79+
80+
:::note
81+
If you did any initial testing (see [Testing in the Integration Environment](#testing-in-the-integration-environment)), be sure to update the functions to reflect the production UID2 share, along with your own relevant table names.
82+
:::
83+
84+
**Click here to download suggested workflow scripts to get started with basic mapping and salt bucket rotation concepts.**
85+
86+
## Testing in the Integration Environment
87+
88+
If you'd like to test the mapping shares before signing a UID2 POC, you can ask your UID2 contact for access to the Snowflake share in the integ (integration) environment. This environment is for testing only, and has no production data. Be sure to include your account number and region in the request.
89+
90+
In this scenario, the following steps occur:
91+
92+
1. Your UID2 contact provisions the share listing in the Snowflake Private Marketplace. [**GWH_KM__01 is there some other step, such as, the contact lets the advertiser know? Otherwise how will they know?**]
93+
2. You can then request access to the Private Marketplace listing.
94+
95+
3. Your UID2 contact provisions the integ shares to your account. [**GWH_KM__02 Is it share rather than shares now that we have a combined listing? Or, is it still shares? Not sure.**]
96+
6397
## Workflow Diagram
6498

6599
The following diagram and table illustrate the different parts of the UID2 integration process in Snowflake, and the workflow.
@@ -77,7 +111,6 @@ Access to the UID2 Share is available through the following listing on the [Snow
77111

78112
- [Unified ID 2.0: Advertiser and Data Provider Identity Solution](https://app.snowflake.com/marketplace/listing/GZT0ZRYXTN8/unified-id-2-0-unified-id-2-0-advertiser-and-data-provider-identity-solution)
79113

80-
81114
:::important
82115
To be able to request data, you must use the `ACCOUNTADMIN` role or another role with the `CREATE DATABASE` and `IMPORT SHARE` privileges in your Snowflake account.
83116
:::

0 commit comments

Comments
 (0)