Strömma data från din Snowflake-databas till Experience Platform med användargränssnittet
Läs den här vägledningen när du vill lära dig hur du direktuppspelar data från din Snowflake-databas till Experience Platform med hjälp av källarbetsytan i användargränssnittet.
Kom igång
Den här självstudiekursen kräver en fungerande förståelse av följande komponenter i Experience Platform:
-
Experience Data Model (XDM) System: Det standardiserade ramverk som Experience Platform organiserar kundupplevelsedata med.
- Grundläggande om schemakomposition: Lär dig mer om grundstenarna i XDM-scheman, inklusive nyckelprinciper och bästa metoder för schemakomposition.
- Schemaredigeraren, självstudiekurs: Lär dig hur du skapar anpassade scheman med hjälp av gränssnittet för Schemaredigeraren.
-
Real-Time Customer Profile: Tillhandahåller en enhetlig konsumentprofil i realtid baserad på aggregerade data från flera källor.
Autentisering
Läs guiden om nödvändig konfiguration för Snowflake direktuppspelningsdata om du vill ha information om hur du måste slutföra innan du kan importera direktuppspelningsdata från Snowflake till Experience Platform.
Använd Snowflake Streaming-källan för att strömma Snowflake-data till Experience Platform
I Experience Platform-gränssnittet väljer du Sources i den vänstra navigeringen för att komma åt arbetsytan i Sources. Du kan välja lämplig kategori i katalogen till vänster på skärmen. Du kan också hitta den källa du vill arbeta med med med sökalternativet.
Under kategorin Databaser väljer du Snowflake Streaming och sedan Set up.
Sidan Connect Snowflake Streaming account visas. På den här sidan kan du antingen använda nya eller befintliga autentiseringsuppgifter.
Skapa ett nytt konto
Om du vill skapa ett nytt konto väljer du New account och anger ett namn och en valfri beskrivning för ditt konto.
Om du vill använda Basic authentication väljer du Basic Authentication for Snowflake och anger autentiseringsuppgifter för ditt Snowflake-konto. När du är klar väljer du Connect to source och tillåt en stund så att anslutningen kan upprättas.
Läs översikten Snowflake Streaming om du vill ha mer information om hur du samlar in nödvändiga inloggningsuppgifter.
Om du vill använda KeyPair authentication väljer du KeyPair Authentication for Snowflake och anger autentiseringsuppgifter för ditt Snowflake-konto. När du är klar väljer du Connect to source och tillåt en stund så att anslutningen kan upprättas.
Läs översikten Snowflake Streaming om du vill ha mer information om hur du samlar in nödvändiga inloggningsuppgifter.
Om du vill använda ett befintligt konto väljer du Existing account, markerar ditt konto i listan och väljer Next.
Markera data select-data
-
Det måste finnas en tidsstämpelkolumn i källtabellen för att ett direktuppspelat dataflöde ska kunna skapas. Tidsstämpeln krävs för att Experience Platform ska veta när data kommer att importeras och när inkrementella data kommer att direktuppspelas. Du kan lägga till en tidsstämpelkolumn retroaktivt för en befintlig anslutning och skapa ett nytt dataflöde.
-
Se till att datafälten i exempelkälldatafilen är i enlighet med Snowflakes riktlinjer för fallupplösning för identifierare. Mer information finns i Snowflake dokumentet om ID-casing.
Select data-steget visas. I det här steget måste du markera de data som du vill importera till Experience Platform, konfigurera tidsstämplar och tidszoner och tillhandahålla en exempelkälldatafil för inmatning av rådata.
Använd databaskatalogen till vänster på skärmen och markera den tabell som du vill importera till Experience Platform.
Välj sedan kolumntypen för tidsstämpling för tabellen. Du kan välja mellan två typer av tidsstämpelkolumner: TIMESTAMP_NTZ eller TIMESTAMP_LTZ. Om du väljer kolumntypen TIMESTAMP_NTZ måste du också ange en tidszon. Kolumnerna ska ha en begränsning som inte är null. Mer information finns i avsnittet Begränsningar och vanliga frågor.
Du kan också konfigurera inställningar för bakgrundsfyllning under det här steget. Backfill avgör vilka data som hämtas från början. Om bakåtfyllning är aktiverad, kommer alla aktuella filer i den angivna sökvägen att importeras under det första schemalagda intaget. Om så inte är fallet importeras endast de filer som läses in mellan den första importkörningen och starttiden. Filer som lästs in före starttiden importeras inte.
Markera växlingsknappen Backfill om du vill aktivera bakåtfyllning.
Välj slutligen Choose file om du vill överföra exempelkälldata för att skapa mappningsuppsättningen, som används i ett senare steg för att mappa originaldata till Experience Data Model (XDM).
När du är klar väljer du Next för att fortsätta.
Ange information om datauppsättning och dataflöde provide-dataset-and-dataflow-details
Därefter måste du ange information om datauppsättningen och dataflödet.
Information om datauppsättning dataset-details
En datauppsättning är en lagrings- och hanteringskonstruktion för en datamängd, vanligtvis en tabell, som innehåller ett schema (kolumner) och fält (rader). Data som har inhämtats till Experience Platform lagras i datasjön som datauppsättningar. Under det här steget kan du skapa en ny datauppsättning eller använda en befintlig datauppsättning.
Om du har en befintlig datauppsättning väljer du Existing dataset och använder sedan alternativet Advanced search för att visa ett fönster med alla datauppsättningar i organisationen, inklusive deras respektive information, t.ex. om de har aktiverats för inmatning i kundprofilen i realtid.
Om du vill använda en ny datauppsättning väljer du New dataset och anger sedan ett namn och en valfri beskrivning för datauppsättningen. Du måste också välja ett XDM-schema (Experience Data Model) som datauppsättningen följer.
Information om dataflöde dataflow-details
När datauppsättningen har konfigurerats måste du ange information om dataflödet, inklusive ett namn, en valfri beskrivning och aviseringskonfigurationer.
Experience Platform kan skapa händelsebaserade aviseringar som användare kan prenumerera på. Dessa alternativ kräver ett öppet dataflöde för att utlösa dem. Mer information finns i varningsöversikten
- Källdataflödeskörning Start: Välj den här aviseringen för att få ett meddelande när dataflödeskörningen börjar.
- Källdataflödet har körts: Välj den här aviseringen om du vill få ett meddelande om dataflödet slutar utan fel.
- Körningsfel för källdataflöde: Välj den här aviseringen för att få ett meddelande om dataflödet avslutas med fel.
När du är klar väljer du Next för att fortsätta.
Mappa fält till ett XDM-schema mapping
Mapping-steget visas. Använd mappningsgränssnittet för att mappa källdata till rätt schemafält innan du importerar dessa data till Experience Platform och välj sedan Next. En utförlig guide om hur du använder mappningsgränssnittet finns i Användargränssnittshandboken för dataförberedelser för mer information.
Granska ditt dataflöde review
Det sista steget i processen för att skapa dataflöde är att granska dataflödet innan det körs. Använd steget Review om du vill granska informationen om det nya dataflödet innan det körs. Detaljerna är grupperade i följande kategorier:
- Anslutning: Visar källtypen, den relevanta sökvägen för den valda källfilen och antalet kolumner i källfilen.
- Tilldela datauppsättnings- och mappningsfält: Visar vilka datauppsättningar som källdata importeras till, inklusive det schema som datauppsättningen följer.
När du har granskat dataflödet väljer du Finish och tillåt en tid innan dataflödet skapas.
Nästa steg
Genom att följa den här självstudiekursen har du skapat ett dataflöde för direktuppspelning för Snowflake data. Mer information finns i dokumentationen nedan.
Övervaka dataflödet
När dataflödet har skapats kan du övervaka de data som hämtas genom det för att visa information om hur mycket data som har importerats, hur bra de är och vilka fel som har uppstått. Mer information om hur du övervakar direktuppspelade dataflöden finns i självstudiekursen Övervaka direktuppspelade dataflöden i användargränssnittet.
Uppdatera ditt dataflöde
Om du vill uppdatera konfigurationer för schemaläggning, mappning och allmän information för dina dataflöden går du till självstudiekursen Uppdatera källornas dataflöden i användargränssnittet.
Ta bort ditt dataflöde
Du kan ta bort dataflöden som inte längre är nödvändiga eller som har skapats felaktigt med funktionen Delete som finns på arbetsytan i Dataflows. Mer information om hur du tar bort dataflöden finns i självstudiekursen Ta bort dataflöden i användargränssnittet.