[Ultimate]{class="badge positive"}

Snowflake-källa

IMPORTANT
  • 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 null som en tom sträng. Kontakta din Adobe-representant för att kontrollera att dina null-värden är korrekt skrivna som null i 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.

Autentisering av kontonyckel (Azure)

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}.
Autentisering med nyckelpar (Azure)

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.

Grundläggande autentisering (AWS)

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.
Autentisering med nyckelpar (AWS)

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.

Snowflake UI-instrumentpanel med domännamnet markerat.

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.

Skapa en krypterad privat nyckel

Kör följande kommando på terminalen för att generera din krypterade privata nyckel Snowflake:

code language-shell
openssl genrsa 2048 | openssl pkcs8 -topk8 -v2 des3 -inform PEM -out rsa_key.p8

Om det lyckas bör du få din privata nyckel i PEM-format.

code language-shell
-----BEGIN ENCRYPTED PRIVATE KEY-----
MIIE6T...
-----END ENCRYPTED PRIVATE KEY-----
Skapa en okrypterad privat nyckel

Om du vill generera din okrypterade privata Snowflake-nyckel kör du följande kommando på terminalen:

code language-shell
openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt

Om det lyckas bör du få din privata nyckel i PEM-format.

code language-shell
-----BEGIN PRIVATE KEY-----
MIIE6T...
-----END PRIVATE KEY-----

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.

Användargränssnittet i Snowflake där du kan verifiera din roll och ditt lager.

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:

Anslut Snowflake till Experience Platform med API:er

Anslut Snowflake till Experience Platform med användargränssnittet

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089