Gedeeltelijke batch ingestie

Gedeeltelijke batch-opname is de mogelijkheid om gegevens met fouten in te voeren, tot een bepaalde drempel. Met deze functie kunnen gebruikers al hun juiste gegevens in Adobe Experience Platform opnemen terwijl al hun onjuiste gegevens afzonderlijk worden opgeslagen, samen met informatie over waarom de gegevens ongeldig zijn.

Dit document bevat een zelfstudie voor het beheren van gedeeltelijke batch-opname.

Aan de slag

Deze zelfstudie vereist een praktische kennis van de verschillende Adobe Experience Platform-services die betrokken zijn bij gedeeltelijke batchopname. Voordat u met deze zelfstudie begint, raadpleegt u de documentatie voor de volgende services:

De volgende secties bevatten aanvullende informatie die u moet weten om aanroepen van Platform API's te kunnen uitvoeren.

API-voorbeeldaanroepen lezen

Deze gids verstrekt voorbeeld API vraag om aan te tonen hoe te om uw verzoeken te formatteren. 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 overeenkomsten die in documentatie voor steekproef API vraag worden gebruikt, zie de sectie op hoe te om voorbeeld API vraagin de Experience Platform het oplossen van problemengids te lezen.

Waarden verzamelen voor vereiste koppen

Om vraag aan Platform APIs te maken, moet u het authentificatieleerprogrammaeerst voltooien. Als u de zelfstudie over verificatie voltooit, krijgt u de waarden voor elk van de vereiste headers in alle API-aanroepen van Experience Platform , zoals hieronder wordt getoond:

Alle bronnen in Experience Platform zijn geïsoleerd naar specifieke virtuele sandboxen. Alle aanvragen naar Platform API's vereisen een header die de naam van de sandbox opgeeft waarin de bewerking plaatsvindt:

Een batch voor gedeeltelijke batch-opname inschakelen in de API enable-api

U kunt een nieuwe partij tot stand brengen met gedeeltelijke toegelaten opname.

Om een nieuwe partij tot stand te brengen, volg de stappen in de handleiding van de partijontwikkelaar. Wanneer u de stap Create batch hebt bereikt, voegt u het volgende veld toe binnen de aanvraaginstantie:

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}

Een batch voor gedeeltelijke batch-opname inschakelen in de gebruikersinterface enable-ui

Om een partij voor gedeeltelijke opname door Platform UI toe te laten, kunt u een nieuwe partij door bronverbindingen tot stand brengen, een nieuwe partij in een bestaande dataset tot stand brengen, of een nieuwe partij tot stand brengen door " Map CSV to XDM flow".

Een nieuwe bronverbinding maken new-source

Om een nieuwe bronverbinding tot stand te brengen, volg de vermelde stappen in het Bronoverzicht. Wanneer u de stap Dataflow detail hebt bereikt, neemt u de velden Partial ingestion en Error diagnostics op.

Met de schakeloptie Partial ingestion kunt u het gebruik van gedeeltelijke batchopname in- of uitschakelen.

De schakeloptie Error diagnostics wordt alleen weergegeven wanneer de schakeloptie Partial ingestion is uitgeschakeld. Met deze functie kan Platform gedetailleerde foutberichten genereren over ingesloten batches. Als de schakeloptie Partial ingestion is ingeschakeld, wordt de uitgebreide foutdiagnose automatisch afgedwongen.

Met Error threshold kunt u het percentage acceptabele fouten instellen voordat de volledige batch mislukt. Deze waarde is standaard ingesteld op 5%.

Een bestaande gegevensset gebruiken existing-dataset

Om een bestaande dataset te gebruiken, begin door een dataset te selecteren. De zijbalk rechts vult informatie over de gegevensset.

Met de schakeloptie Partial ingestion kunt u het gebruik van gedeeltelijke batchopname in- of uitschakelen.

De schakeloptie Error diagnostics wordt alleen weergegeven wanneer de schakeloptie Partial ingestion is uitgeschakeld. Met deze functie kan Platform gedetailleerde foutberichten genereren over ingesloten batches. Als de schakeloptie Partial ingestion is ingeschakeld, wordt de uitgebreide foutdiagnose automatisch afgedwongen.

Met Error threshold kunt u het percentage acceptabele fouten instellen voordat de volledige batch mislukt. Deze waarde is standaard ingesteld op 5%.

Nu, kunt u gegevens uploaden gebruikend gegevens knoop toevoegen, en het zal worden opgenomen gebruikend gedeeltelijke opname.

De "Map CSV to XDM schema"-stroom gebruiken map-flow

Om de "Map CSV to XDM schema"stroom te gebruiken, volg de vermelde stappen in Kaart een CSV- dossierleerprogramma. Wanneer u de stap Add data hebt bereikt, neemt u de velden Partial ingestion en Error diagnostics op.

Met de schakeloptie Partial ingestion kunt u het gebruik van gedeeltelijke batchopname in- of uitschakelen.

De schakeloptie Error diagnostics wordt alleen weergegeven wanneer de schakeloptie Partial ingestion is uitgeschakeld. Met deze functie kan Platform gedetailleerde foutberichten genereren over ingesloten batches. Als de schakeloptie Partial ingestion is ingeschakeld, wordt de uitgebreide foutdiagnose automatisch afgedwongen.

In Error threshold kunt u het percentage acceptabele fouten instellen voordat de volledige batch mislukt. Deze waarde is standaard ingesteld op 5%.

Volgende stappen next-steps

Dit leerprogramma behandelde hoe te om een dataset tot stand te brengen of te wijzigen om gedeeltelijke partijingestie toe te laten. Voor meer informatie over partijingestie, te lezen gelieve de gids van de partijontwikkelaar.

Voor informatie bij het controleren van gedeeltelijke innamefouten, te lezen gelieve de gids van de de foutendiagnostiek van de partijingestie.