[Ultimate]{class="badge positive"}
Snowflake-källa
- Källan Snowflake är tillgänglig i källkatalogen för användare som har köpt Real-Time Customer Data Platform Ultimate.
- Som standard tolkar Snowflake-källan
nullsom en tom sträng. Kontakta din Adobe-representant för att kontrollera att dinanull-värden är korrekt skrivna somnulli Adobe Experience Platform. - För att Experience Platform ska kunna importera data måste tidszoner för alla tabellbaserade batchkällor konfigureras till UTC. Den enda tidsstämpeln som stöds för källan Snowflake är TIMESTAMP_NTZ med UTC-tid.
Med Adobe Experience Platform kan data hämtas från externa källor samtidigt som du kan strukturera, etikettera och förbättra inkommande data med hjälp av Experience Platform tjänster. Du kan importera data från en mängd olika källor, till exempel Adobe-program, molnbaserad lagring, databaser och många andra.
Experience Platform har stöd för inmatning av data från en tredjepartsdatabas. Experience Platform kan ansluta till olika typer av databaser, till exempel relationsdatabaser, NoSQL-databaser eller datalager. Stöd för databasproviders är Snowflake.
Förhandskrav prerequisites
I det här avsnittet beskrivs de konfigurationsåtgärder som du måste slutföra innan du kan ansluta Snowflake-källan till Experience Platform.
IP-adress tillåtelselista
Du måste lägga till regionspecifika IP-adresser i tillåtelselista innan du kan ansluta dina källor till Experience Platform. Mer information finns i guiden om att tillåtslista IP-adresser för att ansluta till Experience Platform.
Samla in nödvändiga inloggningsuppgifter
Du måste ange värden för följande autentiseringsegenskaper för att autentisera Snowflake-källan.
Ange värden för följande autentiseringsuppgifter för att ansluta Snowflake till Experience Platform på Azure med kontonyckelautentisering.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 | |
|---|---|
| Autentiseringsuppgifter | Beskrivning |
account |
Ett kontonamn identifierar unikt ett konto inom organisationen. I det här fallet måste du unikt identifiera ett konto i olika Snowflake-organisationer. Om du vill göra det måste du lägga till ditt organisationsnamn i kontonamnet. Till exempel: orgname-account_name. Mer information finns i avsnittet Hämta din Snowflake kontoidentifierare. Mer information finns i Snowflake dokumentationen. |
warehouse |
Lagerstället Snowflake hanterar frågekörningsprocessen för programmet. Varje Snowflake-lagerställe är oberoende av varandra och måste nås individuellt när data överförs till Experience Platform. |
database |
Databasen Snowflake innehåller de data som du vill hämta Experience Platform. |
username |
Användarnamnet för kontot Snowflake. |
password |
Lösenordet för användarkontot Snowflake. |
role |
Standardrollen för åtkomstkontroll som ska användas i sessionen Snowflake. Rollen ska vara en befintlig roll som redan har tilldelats den angivna användaren. Standardrollen är PUBLIC. |
connectionString |
Anslutningssträngen som används för att ansluta till din Snowflake-instans. Anslutningssträngsmönstret för Snowflake är jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE}. |
Generera först ett 2 048-bitars RSA-nyckelpar om du vill använda nyckelpars-autentisering. Ange sedan värden för följande autentiseringsuppgifter för att ansluta till Experience Platform på Azure med nyckelparautentisering.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 | |
|---|---|
| Autentiseringsuppgifter | Beskrivning |
account |
Ett kontonamn identifierar unikt ett konto inom organisationen. I det här fallet måste du unikt identifiera ett konto i olika Snowflake-organisationer. Om du vill göra det måste du lägga till ditt organisationsnamn i kontonamnet. Till exempel: orgname-account_name. Mer information finns i avsnittet Hämta din Snowflake kontoidentifierare. Mer information finns i Snowflake dokumentationen. |
username |
Användarnamnet för ditt Snowflake-konto. |
privateKey |
Den Base64-kodade privata nyckeln för ditt Snowflake-konto. Du kan generera antingen krypterade eller okrypterade privata nycklar. Om du använder en krypterad privat nyckel måste du även ange en lösenfras för den privata nyckeln vid autentisering mot Experience Platform. Mer information finns i avsnittet Hämta din privata nyckel. |
privateKeyPassphrase |
Lösenfrasen för den privata nyckeln är ett extra säkerhetslager som du måste använda när du autentiserar med en krypterad privat nyckel. Du behöver inte ange lösenfrasen om du använder en okrypterad privat nyckel. |
port |
Portnumret som används av Snowflake vid anslutning till en server via Internet. |
database |
Databasen Snowflake som innehåller de data som du vill importera till Experience Platform. |
warehouse |
Lagerstället Snowflake hanterar frågekörningsprocessen för programmet. Varje Snowflake-lagerställe är oberoende av varandra och måste nås individuellt när data överförs till Experience Platform. |
Mer information om dessa värden finns i Snowflake autentiseringsguiden för nyckelpar.
Ange värden för följande autentiseringsuppgifter för att ansluta Snowflake till Experience Platform på AWS med grundläggande autentisering.
| note warning |
|---|
| WARNING |
| Grundläggande autentisering (eller kontonyckelautentisering) för källan Snowflake kommer att bli inaktuell i november 2025. Du måste gå över till nyckelparsbaserad autentisering för att kunna fortsätta använda källan och hämta data från din databas till Experience Platform. Mer information om borttagningen finns i Snowflake metodguiden om bästa praxis för att minska riskerna för kreditvärdighetsförluster. |
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 | |
|---|---|
| Autentiseringsuppgifter | Beskrivning |
host |
Den värd-URL som ditt Snowflake-konto ansluter till. |
port |
Portnumret som används av Snowflake vid anslutning till en server via Internet. |
username |
Användarnamnet som är associerat med ditt Snowflake-konto. |
password |
Lösenordet som är kopplat till ditt Snowflake-konto. |
database |
Databasen Snowflake från vilken data hämtas. |
schema |
Namnet på schemat som är associerat med din Snowflake-databas. Du måste se till att användaren som du vill ge databasåtkomst till också har åtkomst till det här schemat. |
warehouse |
Det Snowflake-lagerställe som du använder. |
Generera först ett 2 048-bitars RSA-nyckelpar om du vill använda nyckelpars-autentisering. Ange sedan värden för följande autentiseringsuppgifter för att ansluta till Experience Platform på AWS med nyckelpars-autentisering.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 | |
|---|---|
| Autentiseringsuppgifter | Beskrivning |
account |
Ett kontonamn identifierar unikt ett konto inom organisationen. I det här fallet måste du unikt identifiera ett konto i olika Snowflake-organisationer. Om du vill göra det måste du lägga till ditt organisationsnamn i kontonamnet. Till exempel: orgname-account_name. Läs guiden om att hämta din Snowflake kontoidentifierare om du vill ha mer information. Mer information finns i Snowflake dokumentationen. |
username |
Användarnamnet för ditt Snowflake-konto. |
privateKey |
Den privata nyckeln för användaren Snowflake, base64-kodad som en enda rad utan rubriker eller radbrytningar. Om du vill förbereda den kopierar du innehållet i PEM-filen, tar bort BEGIN/END-raderna och alla radbrytningar och kodar sedan resultatet med base64. Mer information finns i avsnittet Hämta din privata nyckel. Obs! Krypterade privata nycklar stöds för närvarande inte för en AWS-anslutning. |
port |
Portnumret som används av Snowflake vid anslutning till en server via Internet. |
database |
Databasen Snowflake som innehåller de data som du vill importera till Experience Platform. |
warehouse |
Lagerstället Snowflake hanterar frågekörningsprocessen för programmet. Varje Snowflake-lagerställe är oberoende av varandra och måste nås individuellt när data överförs till Experience Platform. |
Mer information om dessa värden finns i Snowflake autentiseringsguiden för nyckelpar.
Hämta din kontoidentifierare retrieve-your-account-identifier
Du måste hämta din kontoidentifierare från Snowflake-gränssnittspanelen eftersom du kommer att använda kontoidentifieraren för att autentisera din Snowflake-instans på Experience Platform.
Så här hämtar du din kontoidentifierare:
- Navigera till ditt konto på Snowflake programmets gränssnittspanel.
- I den vänstra navigeringen väljer du Accounts följt av Active Accounts i sidhuvudet.
- Välj sedan informationsikonen och markera och kopiera domännamnet för den aktuella URL:en.
Hämta din privata nyckel retrieve-your-private-key
Om du använder nyckelparautentisering för din Snowflake-anslutning måste du också generera din privata nyckel innan du ansluter till Experience Platform.
Kör följande kommando på terminalen för att generera din krypterade privata nyckel Snowflake:
| code language-shell |
|---|
|
Om det lyckas bör du få din privata nyckel i PEM-format.
| code language-shell |
|---|
|
Om du vill generera din okrypterade privata Snowflake-nyckel kör du följande kommando på terminalen:
| code language-shell |
|---|
|
Om det lyckas bör du få din privata nyckel i PEM-format.
| code language-shell |
|---|
|
Ta sedan din privata nyckel och koda den i Base64. Se till att du inte gör några omformningar eller formatkonverteringar på din privata nyckel för Snowflake. Dessutom måste du se till att det inte finns några efterföljande radmatningstecken i slutet av den privata nyckeln innan du kodar den i Base64.
Verifiera konfigurationer
Innan du kan skapa en källanslutning för dina Snowflake-data måste du också se till att följande konfigurationer uppfylls:
- Det standardlagerställe som tilldelats en viss användare måste vara samma som det lagerställe som du angav vid autentisering till Experience Platform.
- Den standardroll som tilldelats en viss användare måste ha tillgång till samma databas som du anger när du autentiserar dig för Experience Platform.
Så här verifierar du din roll och ditt lager:
- Välj Admin till vänster och välj sedan Users & Roles.
- Välj lämplig användare och markera sedan ellipserna (
...) i det övre högra hörnet. - Navigera till Edit user i fönstret Default Role som visas för att visa rollen som är associerad med den angivna användaren.
- I samma fönster går du till Default Warehouse för att visa det lagerställe som är associerat med den angivna användaren.
När kodningen är klar kan du sedan använda den Base64-kodade privata nyckeln på Experience Platform för att autentisera ditt Snowflake-konto.
Dokumentationen nedan innehåller information om hur du ansluter Snowflake till Experience Platform med API:er eller användargränssnittet: