U bent hier:
Amazon S3 Output-verbinding
Maak een externe verbinding met behulp van de Amazon S3-uitvoerconnector om .csv vanuit CRM Analytics naar een Amazon S3-bucket te schrijven wanneer u Gegevensvoorbereiding gebruikt.
Hoe CRM Analytics-uitvoerconnectoren met uitvoerknooppunten werken
Met CRM Analytics-connectoren kunt u de uitkomst van een recept naar een extern systeem schrijven voor verdere analyse, bedrijfsautomatisering en opslag. Nadat u een uitvoerconnector hebt geconfigureerd naar de gegevensbron en het mappad met behulp van de stappen in deze handleiding, kunt u een recept maken met Gegevensvoorbereiding. Voeg een uitvoerknooppunt aan het recept toe en selecteer schrijven naar de uitvoerverbinding. Selecteer de S3-verbinding die u hebt geconfigureerd en kies welk S3-object de uitvoergegevens gaat bevatten. Wanneer het recept wordt uitgevoerd, schrijft CRM Analytics gegevens naar het opgegeven object in het mappad binnen de directory. Als u bijvoorbeeld het mappad ...support/servicedata hebt opgegeven en het object APAC hebt gekozen, schrijven we naar de map APAC op het pad ...support/servicedata/APAC. De map bevat de volgende bestanden:
- Het .csv-bestand voor de uitvoergegevensset, met de naamgevingsstandaard
folderpath_0.csv. In ons voorbeeld is de uitvoerAPAC_0.csv. Voor grotere gegevenssets partitioneert CRM Analytics de gegevens automatisch in .csv-bestanden met oplopende nummers die worden toegevoegd aan de naam. In ons voorbeeld kan er eenAPAC_1.csv, eenAPAC_2.csven meer zijn totdat alle gegevens zijn geschreven. Het bestand heeft geen koptekstrij. - Het metagegevensbestand schema.json, met informatie over elke kolom, inclusief de naam, het gegevenstype en de precisie.
- Het bestand _SUCCESS, dat wordt gegenereerd op het moment dat het .csv-bestand volledig is.
Wanneer u het recept opnieuw uitvoert, worden de eerder gegenereerde bestanden verwijderd en wordt een nieuwe versie van de bestanden geschreven.
De Amazon S3-uitvoerconnector inschakelen en toevoegen
- Geef vanuit Set-up Analytics op in het vak Snel zoeken, selecteer Analytics en selecteer vervolgens Instellingen.
- Selecteer Amazon S3-uitvoerverbinding inschakelen en sla uw wijzigingen op.
- Klik in Gegevensbeheer op het tabblad Verbindingen.
- Klik op Nieuwe verbinding.
- Klik op Uitvoer.
- Klik op het pictogram van de connector en geef de instellingen ervan op, zoals beschreven in de sectie Verbindingsinstellingen.
- Klik op Opslaan en testen. Opslaan en testen valideert uw instellingen door te proberen te verbinden met de bron. Als de verbinding mislukt, toont CRM Analytics mogelijke redenen.
Alle instellingen vereisen een waarde, tenzij anders is aangegeven.
| Verbindingsinstelling | Beschrijving |
|---|---|
| Verbindingsnaam | Identificeert de verbinding. Gebruik een conventie waarmee u gemakkelijk de verschillende verbindingen van elkaar kunt onderscheiden. |
| Naam ontwikkelaar | API-naam voor de verbinding. De naam van de ontwikkelaar mag geen spaties bevatten en kan na het maken van de verbinding niet meer worden gewijzigd. |
| Beschrijving | Beschrijving |
| Authenticatietype | Geef voor standaardauthenticatie Root op. Geef IAM op voor AWS Identity Access Management-authenticatie (IAM). Gebruik voor fijnmazige toegang tot AWS-gegevens IAM-authenticatie, waarbij u IAM-gebruikers en -rollen instelt in AWS. Zie Aan de slag met AWS voor meer informatie over AWS IAM. |
| Geheime sleutel | Uw Amazon-sleutel voor geheime toegang. |
| Regionaam | Regio van uw S3-service. De standaardregio is US East (N. Virginia). Zie voor de lijst met regionamen de documentatie AWS service endpoints (Eindpunten van de AWS-service). |
| Mappad | Pad naar de map waarmee u wilt verbinden. Het pad moet beginnen met de bucketnaam en mag de naam bevatten van de submap wiens gegevens u wilt synchroniseren. |
| Toegangssleutel | De ID van de toegangssleutel voor uw Amazon S3-bucket. |
| AWS-rol-ARN | Alleen voor IAM-authenticatie, de ARN van de IAM-rol. U vindt deze in de set-up van IAM-rollen in AWS. |
Houd rekening met het volgende wanneer u met de Amazon S3-uitvoerconnector werkt.
- U kunt een uitvoerverbinding meer dan eenmaal per recept gebruiken, maar elk uitvoerknooppunt moet een ander object gebruiken. Elk uitvoerknooppunt kan onafhankelijk maximaal de limiet per uitvoering van de connector gebruiken, maar blijft onderworpen aan de continue 24-uurs limiet.
- Uitvoerverbindingen zijn alleen beschikbaar voor recepten die zijn gemaakt met Gegevensvoorbereiding.
- Voor elke uitvoerverbinding kan maximaal één mappad worden opgegeven. Als u uitvoer wilt schrijven naar een ander mappad, moet u een andere uitvoerverbinding maken.
- Wanneer de bestanden van de vorige uitvoering worden verwijderd ter voorbereiding op de huidige uitvoering, is de eerdere versie van een uitvoergegevensset niet toegankelijk. Stel een proces in om de uitvoer na elke uitvoering te kopiëren of gebruiken, en gebruik het bestand _SUCCESS om aan te geven dat het schrijven is voltooid.
- Null-waarden worden naar AWS uitgevoerd als
null-[token], waarbij het token een tekenreeks is. Bijvoorbeeldnull-OrJLA4JEfCjToa4DDNofnull-PaKIW3MEfCaQou9WXM. Voor het interpreteren van de null-waarden moet u mogelijk naverwerking implementeren met behulp van AWS CLI of op het doel waar gegevens worden verbruikt.
