Deze functionaliteit is beschikbaar voor klanten die het Real-Time CDP-pakket Premier en Ultimate, Adobe Journey Optimizer of Customer Journey Analytics hebben aangeschaft. Neem contact op met uw Adobe voor meer informatie.
In dit artikel wordt uitgelegd welke workflow nodig is om de Flow Service API om te exporteren gegevenssets van Adobe Experience Platform naar uw voorkeurslocatie voor cloudopslag, zoals Amazon S3, SFTP-locaties, of Google Cloud Storage.
Beschikbare gegevensbestanden voor exporteren datasets-to-export
De gegevenssets die u kunt exporteren, zijn afhankelijk van de toepassing Experience Platform (Real-Time CDP, Adobe Journey Optimizer), de laag (Premier of Ultimate) en alle invoegtoepassingen die u hebt aangeschaft (bijvoorbeeld Data Distiller).
Momenteel, kunt u datasets naar de bestemmingen van de wolkenopslag uitvoeren die in het schermafbeelding worden benadrukt en hieronder worden vermeld.
Deze handleiding vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:
Experience Platform datasets: Alle gegevens die met succes in Adobe Experience Platform worden ingevoerd, blijven binnen de Data Lake als datasets. Een dataset is een opslag en beheersconstructie voor een inzameling van gegevens, typisch een lijst, die een schema (kolommen) en gebieden (rijen) bevat. Datasets bevatten ook metagegevens die verschillende aspecten van de gegevens beschrijven die ze opslaan.
Sandboxes: Experience Platform biedt virtuele sandboxen die één enkele partitie maken Platform in afzonderlijke virtuele omgevingen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.
De volgende secties verstrekken extra informatie die u moet weten om datasets naar de bestemmingen van de wolkenopslag in Platform uit te voeren.
Vereiste machtigingen permissions
Om datasets uit te voeren, hebt u nodig View Destinations, View Datasets, en Manage and Activate Dataset Destinationstoegangsbeheermachtigingen. Lees de toegangsbeheeroverzicht of neem contact op met de productbeheerder om de vereiste machtigingen te verkrijgen.
Om ervoor te zorgen dat u de noodzakelijke toestemmingen hebt om datasets uit te voeren en dat de bestemming het uitvoeren van datasets steunt, doorblader de bestemmingscatalogus. Als een doel een Activate of een Export datasets controle, dan hebt u de aangewezen toestemmingen.
Deze zelfstudie biedt voorbeeld-API-aanroepen om aan te tonen hoe uw verzoeken moeten worden opgemaakt. Dit zijn paden, vereiste kopteksten en correct opgemaakte ladingen voor aanvragen. Voorbeeld-JSON die wordt geretourneerd in API-reacties, wordt ook verschaft. Voor informatie over de conventies die worden gebruikt in documentatie voor voorbeeld-API-aanroepen raadpleegt u de sectie over voorbeeld-API-aanroepen lezen in de Experience Platform gids voor probleemoplossing.
Waarden verzamelen voor vereiste en optionele koppen gather-values-headers
Om vraag te maken aan Platform API's, moet u eerst de Zelfstudie over verificatie van Experience Platforms. Het voltooien van de zelfstudie over verificatie biedt de waarden voor elk van de vereiste kopteksten in alle Experience Platform API-aanroepen, zoals hieronder wordt getoond:
Toestemming: houder {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
Bronnen in Experience Platform kan worden geïsoleerd naar specifieke virtuele sandboxen. In verzoeken om Platform API's kunt u de naam en id opgeven van de sandbox waarin de bewerking plaatsvindt. Dit zijn optionele parameters.
Lees voor beschrijvingen van de termen die u in deze API-zelfstudie zult tegenkomen de verklarende woordenlijst van de API-naslagdocumentatie.
Verbindingsspecificaties en stroomspecificaties voor uw gewenste doel verzamelen gather-connection-spec-flow-spec
Alvorens de werkschema te beginnen om een dataset uit te voeren, identificeer de verbindingsspecificatie en stroom specificiteit IDs van de bestemming waarnaar u datasets wilt uitvoeren. Gebruik de onderstaande tabel ter referentie.
Bestemming
Verbindingsspecificatie
Stroomspecificatie
Amazon S3
4fce964d-3f37-408f-9778-e597338a21ee
269ba276-16fc-47db-92b0-c1049a3c131f
Azure Blob Storage
6d6b59bf-fb58-4107-9064-4d246c0e5bb2
95bd8965-fc8a-4119-b9c3-944c2c2df6d2
Azure Data Lake Gen 2(ADLS Gen2)
be2c3209-53bc-47e7-ab25-145db8b873e1
17be2013-2549-41ce-96e7-a70363bec293
Data Landing Zone(DLZ)
10440537-2a7b-4583-ac39-ed38d4b848e8
cd2fc47e-e838-4f38-a581-8fff2f99b63a
Google Cloud Storage
c5d93acb-ea8b-4b14-8f53-02138444ae99
585c15c4-6cbf-4126-8f87-e26bff78b657
SFTP
36965a81-b1c6-401b-99f8-22508f1e6a26
354d6aad-4754-46e4-a576-1b384561c440
U hebt deze id's nodig om verschillende Flow Service entiteiten. U moet ook naar delen van het dialoogvenster Connection Spec om bepaalde entiteiten in te stellen zodat u de Connection Spec van Flow Service APIs. Zie de voorbeelden hieronder van het terugwinnen van verbindingsspecificaties voor alle bestemmingen in de lijst:
Voer de onderstaande stappen uit om een gegevenssetgegevensstroom in te stellen naar een opslaglocatie in de cloud. Voor sommige stappen verschillen de verzoeken en antwoorden tussen de verschillende cloudopslagbestemmingen. In die gevallen, gebruik de lusjes op de pagina om de verzoeken en de reacties terug te winnen specifiek voor de bestemming die u wilt verbinden en datasets uitvoeren naar. Zorg ervoor dat u de juiste connection spec en flow spec voor de bestemming u vormt.
Een lijst met gegevenssets ophalen retrieve-list-of-available-datasets
Om een lijst van datasets terug te winnen geschikt voor activering, begin door een API vraag aan het hieronder eindpunt te maken.
recommendation-more-help
Verzoek
In aanmerking komende gegevenssets ophalen - Verzoek
Merk op dat om in aanmerking komende datasets terug te winnen, connection spec Id die wordt gebruikt in de aanvraag-URL, moet de specificatie-id van de gegevensmeerbronverbinding zijn. 23598e46-f560-407b-88d5-ea6207e49db0en de twee queryparameters outputField=datasets en outputType=activationDatasets moet worden gespecificeerd. Alle andere vraagparameters zijn standaarddegenen die door worden gesteund Catalogusservice-API.
Een succesvol antwoord bevat een lijst met gegevenssets die in aanmerking komen voor activering. Deze datasets kunnen worden gebruikt wanneer het construeren van de bronverbinding in de volgende stap.
Na het terugwinnen van de lijst van datasets die u wilt uitvoeren, kunt u een bronverbinding tot stand brengen gebruikend die dataset IDs.
Verzoek
Bronverbinding maken - Verzoek
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Een geslaagde reactie retourneert de id (id) van de nieuwe bronverbinding en een etag. Noteer de bron-verbindings-id zoals u deze later nodig hebt wanneer u de gegevensstroom maakt.
Houd er rekening mee dat:
De bronverbinding die in deze stap wordt gecreeerd moet met een dataflow voor zijn datasets worden verbonden om aan een bestemming te worden geactiveerd. Zie de een gegevensstroom maken voor informatie over hoe te om een bronverbinding aan een dataflow te verbinden.
De dataset IDs van een bronverbinding kan niet na verwezenlijking worden gewijzigd. Als u datasets uit een bronverbinding moet toevoegen of verwijderen, moet u een nieuwe bronverbinding tot stand brengen en identiteitskaart van de nieuwe bronverbinding met dataflow verbinden.
Een basisverbinding (doel) maken create-base-connection
Een basisverbinding slaat veilig de geloofsbrieven aan uw bestemming op. Afhankelijk van het bestemmingstype, kunnen de geloofsbrieven nodig om tegen die bestemming voor authentiek te verklaren variëren. Om deze authentificatieparameters te vinden, wint eerst terug connection spec voor het gewenste doel zoals beschreven in de sectie Verbindingsspecificaties en stroomspecificaties verzamelen en bekijk dan de authSpec van de respons. Verwijs naar de tabbladen hieronder voor de authSpec eigenschappen van alle ondersteunde doelen.
Amazon S3
accordion
Amazon S3 - Connection spec tonen auth spec
De gemarkeerde regel met inline opmerkingen in het dialoogvenster connection spec voorbeeld hieronder, dat extra informatie over verstrekt waar te om de authentificatieparameters in te vinden connection spec.
De gemarkeerde regel met inline opmerkingen in het dialoogvenster connection spec voorbeeld hieronder, dat extra informatie over verstrekt waar te om de authentificatieparameters in te vinden connection spec.
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec tonen auth spec
De gemarkeerde regel met inline opmerkingen in het dialoogvenster connection spec voorbeeld hieronder, dat extra informatie over verstrekt waar te om de authentificatieparameters in te vinden connection spec.
Google Cloud Storage - Connection spec tonen auth spec
De gemarkeerde regel met inline opmerkingen in het dialoogvenster connection spec voorbeeld hieronder, dat extra informatie over verstrekt waar te om de authentificatieparameters in te vinden connection spec.
{
"items": [
{
"id": "c5d93acb-ea8b-4b14-8f53-02138444ae99",
"name": "Google Cloud Storage",
"providerId": "14e34fac-d307-11e9-bb65-2a2ae2dbcce4",
"version": "1.0",
"authSpec": [ // describes the authentication parameters
{
"name": "Google Cloud Storage authentication credentials",
"type": "GoogleCloudStorageAuth",
"spec": {
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "defines auth params required for connecting to google cloud storage connector.",
"type": "object",
"properties": {
"accessKeyId": {
"description": "Access Key Id for the user account",
"type": "string"
},
"secretAccessKey": {
"description": "Secret Access Key for the user account",
"type": "string",
"format": "password"
}
},
"required": [
"accessKeyId",
"secretAccessKey"
]
}
}
],
//...
SFTP
accordion
SFTP - Connection spec tonen auth spec
note note
NOTE
De bestemming SFTP bevat twee afzonderlijke punten in auth spec, omdat deze zowel wachtwoord- als SSH-sleutelverificatie ondersteunt.
De gemarkeerde regel met inline opmerkingen in het dialoogvenster connection spec voorbeeld hieronder, dat extra informatie over verstrekt waar te om de authentificatieparameters in te vinden connection spec.
De eigenschappen gebruiken die in de verificatiespecificatie (d.w.z. authSpec vanuit de reactie) kunt u een basisverbinding maken met de vereiste referenties, specifiek voor elk doeltype, zoals in de volgende voorbeelden wordt getoond:
Amazon S3
Verzoek
accordion
Amazon S3 - Aanvraag voor basisverbinding
note tip
TIP
Voor informatie over hoe te om de vereiste authentificatiegeloofsbrieven te verkrijgen, verwijs naar authenticeren naar doel sectie van de Amazon S3 pagina van de bestemmingsdocumentatie.
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Azure Blob Storage - Aanvraag voor basisverbinding
note tip
TIP
Voor informatie over hoe te om de vereiste authentificatiegeloofsbrieven te verkrijgen, verwijs naar authenticeren naar doel sectie van de Azure Blob Storage-doeldocumentatiepagina.
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Azure Data Lake Gen 2(ADLS Gen2) - Aanvraag voor basisverbinding
note tip
TIP
Voor informatie over hoe te om de vereiste authentificatiegeloofsbrieven te verkrijgen, verwijs naar authenticeren naar doel sectie van de bestemmingsdocumentatiepagina van Azure Data Lake Gen 2 (ADLS Gen2).
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Data Landing Zone(DLZ) - Aanvraag voor basisverbinding
note tip
TIP
Er zijn geen verificatiereferenties vereist voor de bestemming Landing Zone voor gegevens. Raadpleeg voor meer informatie de authenticeren naar doel sectie van de de bestemmingsdocumentatiepagina van de Gebied van Gegevens.
Google Cloud Storage - Aanvraag voor basisverbinding
note tip
TIP
Voor informatie over hoe te om de vereiste authentificatiegeloofsbrieven te verkrijgen, verwijs naar authenticeren naar doel op de pagina met doeldocumentatie voor Google Cloud Storage.
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
SFTP met wachtwoord - de Verzoek van de Verbinding van de basis
note tip
TIP
Voor informatie over hoe te om de vereiste authentificatiegeloofsbrieven te verkrijgen, verwijs naar authenticeren naar doel van de pagina van de de bestemmingsdocumentatie van SFTP.
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
SFTP met SSH-sleutel - Aanvraag voor basisverbinding
note tip
TIP
Voor informatie over hoe te om de vereiste authentificatiegeloofsbrieven te verkrijgen, verwijs naar authenticeren naar doel van de pagina van de de bestemmingsdocumentatie van SFTP.
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Noteer de verbinding-id in het antwoord. Deze id is vereist in de volgende stap bij het maken van de doelverbinding.
Een doelverbinding maken create-target-connection
Daarna, moet u een doelverbinding tot stand brengen die de uitvoerparameters voor uw datasets opslaat. Exportparameters zijn onder andere locatie, bestandsindeling, compressie en andere details. Zie de targetSpec eigenschappen verstrekt in de de verbindingsspecificatie van de bestemming om de gesteunde eigenschappen voor elk bestemmingstype te begrijpen. Verwijs naar de tabbladen hieronder voor de targetSpec eigenschappen van alle ondersteunde doelen.
WARNING
Exporteren naar JSON-bestanden worden alleen in de gecomprimeerde modus ondersteund. Exporteren naar Parquet bestanden worden ondersteund in een gecomprimeerde en niet-gecomprimeerde modus.
Let op de gemarkeerde regels met inline opmerkingen in het dialoogvenster connection spec voorbeeld hieronder, die extra informatie verstrekken over waar te om te vinden target spec parameters in de verbindingsspecificatie. U kunt ook in het voorbeeld zien waaronder doelparameters niet van toepassing op gegevenssetuitvoerbestemmingen.
Let op de gemarkeerde regels met inline opmerkingen in het dialoogvenster connection spec voorbeeld hieronder, die extra informatie verstrekken over waar te om te vinden target spec parameters in de verbindingsspecificatie. U kunt ook in het voorbeeld zien waaronder doelparameters niet van toepassing op gegevenssetuitvoerbestemmingen.
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec doelverbindingsparameters weergeven
Let op de gemarkeerde regels met inline opmerkingen in het dialoogvenster connection spec voorbeeld hieronder, die extra informatie verstrekken over waar te om te vinden target spec parameters in de verbindingsspecificatie. U kunt ook in het voorbeeld zien waaronder doelparameters niet van toepassing op gegevenssetuitvoerbestemmingen.
{
"items": [
{
"id": "be2c3209-53bc-47e7-ab25-145db8b873e1",
"name": "Azure Data Lake Gen2",
"providerId": "14e34fac-d307-11e9-bb65-2a2ae2dbcce4",
"version": "1.0",
"authSpec": [...],
"encryptionSpecs": [...],
"targetSpec": { // describes the target connection parameters
"name": "User based target",
"type": "UserNamespace",
"spec": {
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"path": {
"title": "Folder path",
"description": "Enter the path to your Azure Data Lake Storage folder",
"type": "string"
},
"fileType": {...}, // not applicable to dataset destinations
"datasetFileType": {
"conditional": {
"field": "flowSpec.attributes._workflow",
"operator": "CONTAINS",
"value": "DATASETS"
},
"title": "File Type",
"description": "Select file format",
"type": "string",
"enum": [
"JSON",
"PARQUET"
]
},
"csvOptions":{...}, // not applicable to dataset destinations
"compression": {
"title": "Compression format",
"description": "Select the desired file compression format.",
"type": "string",
"enum": [
"NONE",
"GZIP"
]
}
},
"required": [
"path",
"datasetFileType",
"compression",
"fileType"
]
}
//...
Data Landing Zone (DLZ)
accordion
Data Landing Zone(DLZ) - Connection spec doelverbindingsparameters weergeven
Let op de gemarkeerde regels met inline opmerkingen in het dialoogvenster connection spec voorbeeld hieronder, die extra informatie verstrekken over waar te om te vinden target spec parameters in de verbindingsspecificatie. U kunt ook in het voorbeeld zien waaronder doelparameters niet van toepassing op gegevenssetuitvoerbestemmingen.
Google Cloud Storage - Connection spec doelverbindingsparameters weergeven
Let op de gemarkeerde regels met inline opmerkingen in het dialoogvenster connection spec voorbeeld hieronder, die extra informatie verstrekken over waar te om te vinden target spec parameters in de verbindingsspecificatie. U kunt ook in het voorbeeld zien waaronder doelparameters niet van toepassing op gegevenssetuitvoerbestemmingen.
Let op de gemarkeerde regels met inline opmerkingen in het dialoogvenster connection spec voorbeeld hieronder, die extra informatie verstrekken over waar te om te vinden target spec parameters in de verbindingsspecificatie. U kunt ook in het voorbeeld zien waaronder doelparameters niet van toepassing op gegevenssetuitvoerbestemmingen.
Aan de hand van de bovenstaande specificatie kunt u een aanvraag voor een doelverbinding samenstellen die specifiek is voor uw gewenste bestemming voor cloudopslag, zoals weergegeven in de onderstaande tabbladen.
Amazon S3
Verzoek
accordion
Amazon S3 - Aanvraag voor doelverbinding
note tip
TIP
Voor informatie over hoe te om de vereiste doelparameters te verkrijgen, verwijs naar bestemmingsdetails invullen van de Amazon S3 pagina met doeldocumentatie. Voor andere ondersteunde waarden van datasetFileTypeZie de API-naslagdocumentatie.
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Voor informatie over hoe te om de vereiste doelparameters te verkrijgen, verwijs naar bestemmingsdetails invullen van de Azure Blob Storage pagina met doeldocumentatie. Voor andere ondersteunde waarden van datasetFileTypeZie de API-naslagdocumentatie.
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Voor informatie over hoe te om de vereiste doelparameters te verkrijgen, verwijs naar bestemmingsdetails invullen sectie van de Azure Data Lake Gen 2(ADLS Gen2) pagina met doeldocumentatie. Voor andere ondersteunde waarden van datasetFileTypeZie de API-naslagdocumentatie.
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Voor informatie over hoe te om de vereiste doelparameters te verkrijgen, verwijs naar bestemmingsdetails invullen van de Data Landing Zone pagina met doeldocumentatie. Voor andere ondersteunde waarden van datasetFileTypeZie de API-naslagdocumentatie.
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Google Cloud Storage - Aanvraag voor doelverbinding
note tip
TIP
Voor informatie over hoe te om de vereiste doelparameters te verkrijgen, verwijs naar bestemmingsdetails invullen van de Google Cloud Storage pagina met doeldocumentatie. Voor andere ondersteunde waarden van datasetFileTypeZie de API-naslagdocumentatie.
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Voor informatie over hoe te om de vereiste doelparameters te verkrijgen, verwijs naar bestemmingsdetails invullen van de pagina van de de bestemmingsdocumentatie van SFTP. Voor andere ondersteunde waarden van datasetFileTypeZie de API-naslagdocumentatie.
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Noteer de doel-verbindings-id uit het antwoord. Deze id zal in de volgende stap worden vereist wanneer het creëren van dataflow om datasets uit te voeren.
Een gegevensstroom maken create-dataflow
De definitieve stap in de bestemmingsconfiguratie is aan opstelling een dataflow. Een dataflow verbindt eerder gecreeerd entiteiten samen en verstrekt ook opties om het programma van de datasetuitvoer te vormen. Om de gegevensstroom tot stand te brengen, gebruik hieronder de ladingen, afhankelijk van uw gewenste bestemming van de wolkenopslag, en vervang entiteit IDs van vorige stappen.
Amazon S3
Verzoek
accordion
Gegevensset maken naar Amazon S3 doel - verzoek
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Gegevensset maken naar Azure Blob Storage doel - verzoek
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Gegevensset maken naar Azure Data Lake Gen 2(ADLS Gen2) doel - verzoek
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Gegevensset maken naar Data Landing Zone doel - verzoek
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Gegevensset maken naar Google Cloud Storage doel - verzoek
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Gegevensset maken gegevensstroom naar SFTP-bestemming - Verzoek
Maak een notitie van de gemarkeerde regels met inline opmerkingen in het aanvraagvoorbeeld, die aanvullende informatie bevatten. Verwijder de inline commentaren in het verzoek wanneer het kopiëren-kleeft van het verzoek in uw terminal van keus.
Noteer de Dataflow-id uit het antwoord. Deze id wordt vereist in de volgende stap bij het ophalen van de gegevensstroomuitvoering om de geslaagde export van de gegevensset te valideren.
De gegevensstroomuitvoering ophalen get-dataflow-runs
Om de uitvoering van een gegevensstroom te controleren, gebruik Dataflow loops API:
Verzoek
Dataflow-uitvoering ophalen - Verzoek
In het verzoek om dataflow looppas terug te winnen, voeg als vraagparameter dataflow identiteitskaart toe die u in de vorige stap verwierf, toen het creëren van dataflow.
Bij het exporteren van gegevenssets maakt Experience Platform een .json of .parquet in de opslaglocatie die u hebt opgegeven. Een nieuw bestand dat op uw opslaglocatie moet worden geplaatst, wordt verwacht volgens het exportschema dat u hebt opgegeven toen een gegevensstroom maken.
Experience Platform leidt tot een omslagstructuur in de opslagplaats u specificeerde, waar het de uitgevoerde datasetdossiers bewaart. Voor elke exporttijd wordt een nieuwe map gemaakt volgens het onderstaande patroon:
De standaardbestandsnaam wordt willekeurig gegenereerd en zorgt ervoor dat geëxporteerde bestandsnamen uniek zijn.
Voorbeeldgegevenssetbestanden sample-files
De aanwezigheid van deze bestanden op uw opslaglocatie is een bevestiging van een geslaagde export. Als u wilt weten hoe de geëxporteerde bestanden zijn gestructureerd, kunt u een voorbeeld downloaden .parquet-bestand of .json-bestand.
In de stap naar een doelverbinding maken, kunt u de geëxporteerde gegevenssetbestanden selecteren die u wilt comprimeren.
Houd rekening met het verschil in bestandsindeling tussen de twee bestandstypen bij het comprimeren:
Bij het exporteren van gecomprimeerde JSON-bestanden is de geëxporteerde bestandsindeling json.gz
Bij het exporteren van gecomprimeerde parketbestanden is de geëxporteerde bestandsindeling gz.parquet
API-foutafhandeling api-error-handling
De API-eindpunten in deze zelfstudie volgen de algemene beginselen van het API-foutbericht voor Experience Platforms. Zie API-statuscodes en aanvragen, koptekstfouten in de het oplossen van problemengids van het Platform voor meer informatie over het interpreteren van foutenreacties.
Volgende stappen next-steps
Door deze zelfstudie te volgen, hebt u Platform met succes verbonden met één van uw aangewezen bestemmingen van de de opslagopslag van de partijwolk en opstelling een dataflow aan de respectieve bestemming om datasets uit te voeren. Zie de volgende pagina's voor meer informatie, zoals hoe u bestaande gegevensstromen kunt bewerken met de Flow Service API: