[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.
Snowflake är en molnbaserad datalagerplattform som är utformad för att organisationer ska kunna lagra, bearbeta och analysera stora datavolymer effektivt. Snowflake har skapats för att utnyttja molnets skalbarhet och flexibilitet och stöder dataintegrering, avancerad analys och sömlös delning mellan team. Som en helt hanterad tjänst eliminerar Snowflake underhållsproblem som är gemensamma för traditionella databaser, vilket gör att du kan fokusera på att få insikter och värde från dina data.
Du kan använda källan Snowflake för att ansluta och hämta data från Snowflake till Adobe Experience Platform. Läs dokumentationen nedan för att lära dig hur du konfigurerar din Snowflake-källa och ansluter till Experience Platform.
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: myorg-myaccount.snowflakecomputing.com. 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: myorg-myaccount.snowflakecomputing.com. 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: http://myorg-myaccount.snowflakecomputing.com/. 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 använder den för att autentisera din Snowflake-instans på Experience Platform.
Så här hämtar du din kontoidentifierare:
- Använd Snowflake programmets gränssnitt för att komma åt ditt konto.
- I den vänstra navigeringen väljer du Accounts och sedan Active Accounts i sidhuvudet.
- Välj sedan informationsikonen och markera och kopiera domännamnet för den aktuella URL:en.
Generera RSA-nyckelpar
Använd OpenSSL i kommandoradsgränssnittet för att generera ett 2 048-bitars RSA-nyckelpar i PKCS#8-format. Det är bäst att skapa en krypterad privat nyckel för säkerhet, som kräver en lösenfras.
Kör följande kommando på terminalen för att generera din krypterade privata nyckel Snowflake:
| code language-bash |
|---|
|
Om du vill generera din okrypterade privata Snowflake-nyckel kör du följande kommando på terminalen:
| code language-bash |
|---|
|
Generera en offentlig nyckel från din privata nyckel
Kör sedan följande kommando i kommandoradsgränssnittet för att skapa en offentlig nyckel baserad på din privata nyckel.
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub# You will be prompted to enter the passphrase if the private key is encrypted.
Tilldela den offentliga nyckeln till användaren Snowflake
Du måste använda en Snowflake-administratörsroll (till exempel SECURITYADMIN) för att associera den genererade offentliga nyckeln med den Snowflake-tjänstanvändare som Experience Platform ska använda. Om du vill hämta innehållet i den offentliga nyckeln öppnar du filen rsa_key.pub och kopierar hela innehållet, exklusive -----BEGIN PUBLIC KEY----- and -----END PUBLIC KEY----- rader. Kör sedan följande SQL i Snowflake:
ALTER USER {YOUR_SNOWFLAKE_USERNAME}>SET RSA_PUBLIC_KEY='{PUBLIC_KEY_CONTENT}';
Koda den privata nyckeln i Base64
Experience Platform kräver att den privata nyckeln är Base64-kodad och tillhandahålls som en sträng under anslutningskonfigurationen. Använd ett lämpligt verktyg eller skript för att koda innehållet i filen rsa_key.p8 till en enda Base64-sträng.
(-----BEGIN ENCRYPTED PRIVATE KEY----- and -----END ENCRYPTED PRIVATE KEY-----), före eller efter kodningsprocessen, eftersom detta kan orsaka autentiseringsfel.Verifiera konfigurationer
Innan du skapar Snowflake-källanslutningen i Experience Platform måste du se till att användarens Default Role och Default Warehouse matchar de värden som du anger i Experience Platform. Du kan verifiera de här inställningarna i användargränssnittet för Snowflake med hjälp av SQL-kommandot DESCRIBE USER {USERNAME}.
Du kan även följa stegen nedan för att verifiera dina inställningar:
- 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ästa steg
När konfigurationen är klar kan du nu ansluta ditt Snowflake-konto till Experience Platform. Mer information finns i följande dokumentation: