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:
- Inname in batch: De methode die Platform Hiermee worden gegevens uit gegevensbestanden, zoals CSV en Parquet, ingepakt en opgeslagen.
- Experience Data Model (XDM): Het gestandaardiseerde kader waardoor Platform organiseert de gegevens van de klantenervaring.
De volgende secties verstrekken extra informatie die u zult moeten weten om met succes vraag aan te maken Platform API's.
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 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 koppen
Om vraag te maken aan Platform API's, moet u eerst de verificatiezelfstudie. 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:
- Autorisatie: Drager
{ACCESS_TOKEN}
- x-api-key:
{API_KEY}
- x-gw-ims-org-id:
{ORG_ID}
Alle bronnen in Experience Platform zijn geïsoleerd naar specifieke virtuele sandboxen. Alle verzoeken aan Platform API's vereisen een header die de naam aangeeft van de sandbox waarin de bewerking plaatsvindt:
- x-sandbox-name:
{SANDBOX_NAME}
Een batch voor gedeeltelijke batch-opname inschakelen in de API enable-api
U kunt een nieuwe partij tot stand brengen met gedeeltelijke toegelaten opname.
Voer de stappen in het dialoogvenster handleiding voor het ontwikkelen van batch-inhoud. Wanneer u de Create batch Voeg in de stap het volgende veld toe in de aanvraaginstantie:
{
"enableErrorDiagnostics": true,
"partialIngestionPercent": 5
}
enableErrorDiagnostics
partialIngestionPercent
Een batch voor gedeeltelijke batch-opname inschakelen in de gebruikersinterface enable-ui
Om een partij voor gedeeltelijke inname door te laten Platform UI, 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
Als u een nieuwe bronverbinding wilt maken, voert u de volgende stappen uit in het dialoogvenster Overzicht van bronnen. Wanneer u de Dataflow detail neem nota van de Partial ingestion en Error diagnostics velden.
De Partial ingestion met deze optie kunt u het gebruik van gedeeltelijke batchopname in- of uitschakelen.
De Error diagnostics wordt alleen weergegeven wanneer de Partial ingestion schakeloptie uit. Met deze functie is Platform om gedetailleerde foutberichten te genereren over de batches die u hebt ingevoerd. Als de Partial ingestion Schakel deze optie in, uitgebreide foutdiagnostiek wordt automatisch afgedwongen.
De Error threshold Hiermee kunt u het percentage acceptabele fouten instellen voordat de gehele 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.
De Partial ingestion met deze optie kunt u het gebruik van gedeeltelijke batchopname in- of uitschakelen.
De Error diagnostics wordt alleen weergegeven wanneer de Partial ingestion schakeloptie uit. Met deze functie is Platform om gedetailleerde foutberichten te genereren over de batches die u hebt ingevoerd. Als de Partial ingestion Schakel deze optie in, uitgebreide foutdiagnostiek wordt automatisch afgedwongen.
De Error threshold Hiermee kunt u het percentage acceptabele fouten instellen voordat de gehele batch mislukt. Deze waarde is standaard ingesteld op 5%.
U kunt nu gegevens uploaden met de Gegevens toevoegen en wordt het gedeeltelijk ingeslikt.
Gebruik de "Map CSV to XDM schema""flow map-flow
Als u "Map CSV to XDM schema", voert u de vermelde stappen uit in de Zelfstudie Een CSV-bestand toewijzen. Wanneer u de Add data neem nota van de Partial ingestion en Error diagnostics velden.
De Partial ingestion met deze optie kunt u het gebruik van gedeeltelijke batchopname in- of uitschakelen.
De Error diagnostics wordt alleen weergegeven wanneer de Partial ingestion schakeloptie uit. Met deze functie is Platform om gedetailleerde foutberichten te genereren over de batches die u hebt ingevoerd. Als de Partial ingestion Schakel deze optie in, uitgebreide foutdiagnostiek wordt automatisch afgedwongen.
Error threshold Hiermee kunt u het percentage acceptabele fouten instellen voordat de gehele 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. Lees voor meer informatie over het gebruik van batch handleiding voor het ontwikkelen van batch-inhoud.
Voor informatie over het controleren van fouten bij gedeeltelijke inname, lees de diagnostische handleiding voor foutmeldingen bij batch.