Documentatie Experience Platform Gids voor Source Connectors

Gegevens vanuit uw Snowflake -database naar Experience Platform streamen met de gebruikersinterface

Laatst bijgewerkt: 24 september 2024

Onderwerpen:

Gemaakt voor:

Ontwikkelaar

Volg deze handleiding om te leren hoe u de gebruikersinterface kunt gebruiken om gegevens vanuit uw Snowflake -database te streamen naar Adobe Experience Platform.

Aan de slag

Deze zelfstudie vereist een goed begrip van de volgende onderdelen van het Experience Platform:

Experience Data Model (XDM) Systeem: Het gestandaardiseerde kader waardoor Experience Platform gegevens van de klantenervaring organiseert.
- Grondbeginselen van schemacompositie: Leer over de basisbouwstenen van schema's XDM, met inbegrip van zeer belangrijke principes en beste praktijken in schemacompositie.
- het leerprogramma van de Redacteur van het Schema: Leer hoe te om douaneschema's tot stand te brengen gebruikend de Redacteur UI van het Schema.
Real-Time Customer Profile: biedt een uniform, real-time consumentenprofiel dat is gebaseerd op geaggregeerde gegevens van meerdere bronnen.

Verificatie

Lees de gids op eerste vereiste opstelling voor Snowflake het stromen gegevensvoor informatie over de stappen die u moet voltooien alvorens u het stromen gegevens van Snowflake aan Experience Platform kunt opnemen.

Gebruik de Snowflake Streaming -bron om Snowflake -gegevens te streamen naar het Experience Platform

Selecteer in de gebruikersinterface van het platform de optie Sources in de linkernavigatie voor toegang tot de werkruimte van Sources . U kunt de juiste categorie selecteren in de catalogus aan de linkerkant van het scherm. U kunt ook de specifieke bron vinden waarmee u wilt werken met de zoekoptie.

Onder de categorie van Gegevensbestanden, selecteer Snowflake Streaming, en selecteer dan Add data.

TIP

Bronnen zonder geverifieerde account in de broncatalogus geven de optie Set up weer. Zodra een geverifieerd account bestaat, verandert deze optie in Add data .

de broncatalogus in het Experience Platform UI, met de Snowflake die bronkaart stroomt geselecteerd.

De pagina Connect Snowflake Streaming account wordt weergegeven. Op deze pagina kunt u nieuwe of bestaande referenties gebruiken.

Als u een nieuwe account wilt maken, selecteert u New account en geeft u een naam, een optionele beschrijving en uw referenties op.

Als u klaar bent, selecteert u Connect to source en laat u de nieuwe verbinding enige tijd tot stand brengen.

de nieuwe interface van de rekeningsverwezenlijking van het bronwerkschema.

Credentials	Beschrijving
Account	De naam van uw Snowflake account. Voor overeenkomsten op rekeningsnamen, lees de Snowflake Streaming authentificatiegids.
Warehouse	De naam van uw Snowflake magazijn. De opslagplaatsen beheren de uitvoering van vragen in Snowflake. Elk Snowflake -pakhuis is onafhankelijk van elkaar en moet afzonderlijk worden benaderd om gegevens naar het Experience Platform te brengen.
Database	De naam van de Snowflake -database. Het gegevensbestand bevat de gegevens die u aan Experience Platform wilt brengen.
Schema	(Optioneel) Het databaseschema dat aan uw Snowflake -account is gekoppeld.
Gebruikersnaam	De gebruikersnaam van uw Snowflake -account.
Wachtwoord	Het wachtwoord voor uw Snowflake -account.
Rol	(Optioneel) Een op maat gedefinieerde rol die voor een bepaalde verbinding aan een gebruiker kan worden gegeven. Als deze waarde niet is opgegeven, wordt deze standaard ingesteld op `public` .

Voor meer informatie over rekeningsverwezenlijking, lees de sectie over het vormen rolmontagesin het Snowflake Streaming overzicht.

Als u een bestaand account wilt gebruiken, selecteert u Existing account en selecteert u het gewenste account in de bestaande accountcatalogus.

Selecteer Next om door te gaan.

de bestaande pagina van de rekeningsselectie van de broncatalogus.

Gegevens selecteren

IMPORTANT

Er moet een tijdstempelkolom in de brontabel staan om een streaminggegevensstroom te kunnen maken. Het Experience Platform moet weten wanneer gegevens worden ingevoerd en wanneer incrementele gegevens worden gestreamd. Dit is de tijdstempel vereist. U kunt met terugwerkende kracht een tijdstempelkolom toevoegen voor een bestaande verbinding en een nieuwe gegevensstroom creëren.
Zorg ervoor dat het hoofdlettergebruik van de gegevensvelden in het bestand met voorbeeldbrongegevens in overeenstemming is met de Snowflake -richtlijnen voor de oplossing van hoofdletters en kleine letters voor id's. Lees het Snowflake document op herkenningsteken casingvoor meer informatie.

De stap Select data wordt weergegeven. In deze stap, moet u de gegevens selecteren u in Experience Platform wilt invoeren, timestamps en timezones vormen, en een dossier van steekproefbrongegevens voor de opname van ruwe gegevens verstrekken.

Gebruik de databasemap links op het scherm en selecteer de tabel die u naar het Experience Platform wilt importeren.

de uitgezochte gegevensinterface met een geselecteerde gegevensbestandlijst.

Selecteer vervolgens het kolomtype voor de tijdstempel van de tabel. U kunt kiezen uit twee typen tijdstempelkolommen: TIMESTAMP_NTZ of TIMESTAMP_LTZ . Als u een kolomtype TIMESTAMP_NTZ selecteert, moet u ook een tijdzone opgeven. De kolommen moeten een beperking hebben die niet null is. Voor meer informatie, lees de sectie over [ beperkingen en vaak gestelde vragen ]

Tijdens deze stap kunt u ook instellingen voor backfill configureren. Met Backfill wordt bepaald welke gegevens in eerste instantie worden ingevoerd. Als backfill is ingeschakeld, worden alle huidige bestanden in het opgegeven pad tijdens de eerste geplande inname opgenomen. Als dat niet het geval is, worden alleen de bestanden opgenomen die tussen de eerste opname en de begintijd worden geladen. Bestanden die vóór de begintijd zijn geladen, worden niet opgenomen.

Selecteer de schakeloptie Backfill om terugvullen in te schakelen.

timestamp, timezone, en backfill configuratiestappen.

Tot slot selecteert u Choose file om een voorbeeldbrongegevens te uploaden om de set toewijzingen te maken. Deze set wordt in een latere stap gebruikt om uw oorspronkelijke gegevens toe te wijzen aan het XDM-model (Experience Data Model).

Als u klaar bent, selecteert u Next om door te gaan.

de voorproef van de bronsteekproefgegevens.

Gegevensset en gegevens over gegevensstroom opgeven

Daarna, moet u informatie over uw dataset en uw gegevensstroom verstrekken.

Gegevens over gegevensset

Een dataset is een opslag en beheersconstructie voor een inzameling van gegevens, typisch een lijst, die een schema (kolommen) en gebieden (rijen) bevat. De gegevens die met succes in Experience Platform worden opgenomen worden voortgeduurd binnen het gegevensmeer als datasets. Tijdens deze stap, kunt u een nieuwe dataset tot stand brengen of een bestaande dataset gebruiken.

Als u een nieuwe gegevensset wilt gebruiken, selecteert u New dataset en geeft u vervolgens een naam en een optionele beschrijving voor de gegevensset op. U moet ook een schema van het Model van de Gegevens van de Ervaring (XDM) selecteren dat uw dataset volgt aan.

de nieuwe interface van de datasetselectie.

Nieuwe gegevens gegevensset	Beschrijving
Naam uitvoergegevensset	De naam van uw nieuwe dataset.
Beschrijving	(Optioneel) Een kort overzicht van de nieuwe gegevensset.
Schema	Een vervolgkeuzelijst met schema's die in uw organisatie bestaan. U kunt ook uw eigen schema vóór het proces van de bronconfiguratie maken. Voor meer informatie, lees de gids op creërend een schema XDM in UI.

Als u al een bestaande dataset hebt, selecteert u Existing dataset en gebruikt u vervolgens de optie Advanced search om een venster weer te geven met alle datasets in uw organisatie, inclusief de respectievelijke details, zoals of deze zijn ingeschakeld voor opname in Real-Time klantprofiel.

de bestaande interface van de datasetselectie.

Selecteer voor stappen om de opname van het Profiel, de diagnostiek van de fout, en gedeeltelijke opname toe te laten.

Als uw dataset voor het Profiel van de Klant in real time wordt toegelaten, dan tijdens deze stap, kunt u Profile dataset van een knevel voorzien om uw gegevens voor Profiel-opname toe te laten. U kunt deze stap ook gebruiken om Error diagnostics en Partial ingestion in te schakelen.

Error diagnostics: Selecteer Error diagnostics om de bron de instructie te geven foutdiagnostiek te produceren waarnaar u later kunt verwijzen bij het controleren van de gegevenssetactiviteit en de status van de gegevensstroom.
Partial ingestion: Gedeeltelijke batch-opname is de mogelijkheid om gegevens met fouten in te voeren tot een bepaalde configureerbare drempel. Met deze functie kunt u al uw nauwkeurige gegevens in het Experience Platform opnemen, terwijl al uw onjuiste gegevens afzonderlijk worden opgeslagen met informatie over waarom deze niet geldig zijn.

Gegevens gegevensstroom

Zodra uw dataset wordt gevormd, moet u details op uw gegevensstroom, met inbegrip van een naam, een facultatieve beschrijving, en waakzame configuraties dan verstrekken.

de stap van de de detailconfiguratie van de gegevensstroom.

Dataflow-configuraties

Beschrijving

Naam gegevensstroom

De naam van de gegevensstroom. Standaard wordt hiervoor de naam gebruikt van het bestand dat wordt geïmporteerd.

Beschrijving

(Optioneel) Een korte beschrijving van uw gegevensstroom.

Waarschuwingen

Experience Platform kan op gebeurtenissen gebaseerde waarschuwingen genereren waarop gebruikers zich kunnen abonneren. Deze opties vereisen een lopende gegevensstroom om hen teweeg te brengen. Voor meer informatie, lees het alarm overzicht

het Begin van de Looppas van Bronnen Dataflow: Selecteer dit alarm om een bericht te ontvangen wanneer uw dataflow looppas begint.
Bronnen Dataflow de Succes van de Looppas: Selecteer dit alarm om een bericht te ontvangen als uw dataflow zonder enige fouten beëindigt.
de Uitval van de Looppas van Gegevensstroom van Bronnen: Selecteer dit alarm om een bericht te ontvangen als uw dataflow looppas met om het even welke fouten beëindigt.

Als u klaar bent, selecteert u Next om door te gaan.

Velden toewijzen aan een XDM-schema

De stap Mapping wordt weergegeven. Gebruik de toewijzingsinterface om uw brongegevens toe te wijzen aan de aangewezen schemagebieden alvorens die gegevens in Experience Platform op te nemen, dan uitgezocht Next. Voor een uitgebreide gids op hoe te om de kaartinterface te gebruiken, lees de gids UI van de Prep van Gegevensvoor meer informatie.

de afbeeldingsinterface van het bronwerkschema.

Controleer uw gegevensstroom

De laatste stap in het proces voor het maken van een gegevensstroom is het controleren van de gegevensstroom voordat deze wordt uitgevoerd. Gebruik de stap Review om de details van de nieuwe gegevensstroom te bekijken voordat deze wordt uitgevoerd. De details worden gegroepeerd in de volgende categorieën:

Verbinding: Toont het brontype, de relevante weg van het gekozen brondossier, en het aantal kolommen binnen dat brondossier.
wijst dataset & kaartgebieden toe: Toont welke dataset de brongegevens in, met inbegrip van het schema worden opgenomen dat de dataset aan vasthoudt.

Nadat u de gegevensstroom hebt gereviseerd, selecteert u Finish en laat u enige tijd over om de gegevensstroom te maken.

de stap van het Overzicht van het bronwerkschema.

Volgende stappen

Aan de hand van deze zelfstudie hebt u een streaminggegevensstroom voor Snowflake -gegevens gemaakt. Lees de onderstaande documentatie voor aanvullende bronnen.

Uw gegevensstroom controleren

Zodra uw gegevensstroom is gecreeerd, kunt u de gegevens controleren die door het worden opgenomen om informatie over innamesnelheden, succes, en fouten te bekijken. Voor meer informatie over hoe te om het stromen dataflows te controleren, bezoek het leerprogramma op het stromen dataflows in UI.

Uw gegevensstroom bijwerken

Om configuraties voor uw dataflows bij te werken die, afbeelding, en algemene informatie plannen, bezoek het leerprogramma op bijwerken brondataflows in UI.

Uw gegevensstroom verwijderen

U kunt gegevensstromen verwijderen die niet meer nodig zijn of die onjuist zijn gemaakt met de functie Delete die beschikbaar is in de Dataflows -werkruimte. Voor meer informatie over hoe te om dataflows te schrappen, bezoek het leerprogramma bij het schrappen van dataflows in UI.

recommendation-more-help