Sie befinden sich hier:
Amazon S3-Ausgabeverbindung
Erstellen Sie mithilfe des Amazon S3-Ausgabe-Konnektors eine Remote-Verbindung, um bei Verwendung der Datenvorbereitung .csv aus CRM Analytics in einen Amazon S3-Bucket zu schreiben.
Funktionsweise von CRM Analytics-Ausgabe-Konnektoren mit Ausgabeknoten
Mit CRM Analytics-Konnektoren können Sie das Ergebnis eines Rezepts zur weiteren Analyse, Geschäftsautomatisierung und Speicherung in ein externes System schreiben. Nachdem Sie mit den in diesem Handbuch beschriebenen Schritten einen Ausgabe-Konnektor für die Datenquelle und einen Ordnerpfad konfiguriert haben, erstellen Sie ein Rezept mithilfe der Datenvorbereitung. Fügen Sie dem Rezept den Knoten "Ausgabe" hinzu und wählen Sie die Ausgabeverbindung aus. Wählen Sie die von Ihnen konfigurierte S3-Verbindung aus und wählen Sie aus, welches S3-Objekt die Ausgabedaten enthält. Wenn das Rezept ausgeführt wird, schreibt CRM Analytics Daten in das angegebene Objekt im Ordnerpfad innerhalb des Verzeichnisses. Wenn Sie beispielsweise den Ordnerpfad ...support/servicedata angegeben und das Objekt APAC ausgewählt haben, wird in den Ordner APAC unter dem Pfad ...support/servicedata/APAC geschrieben. Der Ordner enthält die folgenden Dateien:
- Die CSV-Datei des Ausgabedatensets mit dem Benennungsstandard
folderpath_0.csv. In diesem Beispiel ist die AusgabeAPAC_0.csv. Bei größeren Datensets unterteilt CRM Analytics die Daten automatisch in mehrere CSV-Dateien, wobei an die Namen aufsteigend Nummern angehängt werden. In diesem Beispiel kann es eineAPAC_1.csv, eineAPAC_2.csvund mehr geben, bis alle Daten geschrieben sind. In dieser Datei ist keine Kopfzeile vorhanden. - Die Metadatendatei schema.json mit Informationen zu jeder Spalte einschließlich des Namens, des Datentyps und der Genauigkeit.
- Die Datei _SUCCESS, die generiert wird, wenn die CSV-Datei vollständig gespeichert wurde.
Wenn Sie das Rezept erneut ausführen, werden die zuvor generierten Dateien gelöscht und die neue Version der Dateien wird geschrieben.
Aktivieren und Hinzufügen des Amazon S3-Ausgabe-Konnektors
- Geben Sie unter "Setup" im Feld "Schnellsuche" den Text Analysefunktionen ein, wählen Sie Analysefunktionen und dann Einstellungen aus.
- Wählen Sie Amazon S3-Ausgabeverbindung aktivieren aus und speichern Sie Ihre Änderungen.
- Klicken Sie im Datenmanager auf die Registerkarte Verbindungen.
- Klicken Sie auf Neue Verbindung.
- Klicken Sie auf Ausgabe.
- Klicken Sie auf das Symbol des Konnektors und geben Sie seine Einstellungen ein, wie im Abschnitt "Verbindungseinstellungen" beschrieben.
- Klicken Sie auf Speichern und testen. Mit "Speichern und Testen" werden die Einstellungen validiert, indem versucht wird, eine Verbindung mit der Quelle herzustellen. Wenn die Verbindung fehlschlägt, zeigt CRM Analytics mögliche Gründe an.
Alle Einstellungen erfordern einen Wert, sofern nicht anders angegeben.
| Verbindungseinstellung | Beschreibung |
|---|---|
| Verbindungsname | Identifizieren Sie die Verbindung. Verwenden Sie eine Konvention, mit der Sie leicht zwischen verschiedenen Verbindungen unterscheiden können. |
| Entwicklername | Der API Name für die Verbindung. Der Entwicklername darf keine Leerzeichen enthalten und Sie können ihn nach dem Erstellen der Verbindung nicht mehr ändern. |
| Beschreibung | Beschreibung |
| Authentifizierungstyp | Geben Sie für die Standardauthentifizierung Stamm ein. Geben Sie für die AWS Identity Access Management-Authentifizierung (IAM) IAM ein. Verwenden Sie für den detaillierten Zugriff auf AWS-Daten die IAM-Authentifizierung, indem Sie IAM-Benutzer und -Rollen in AWS einrichten. Weitere Informationen zu AWS IAM finden Sie unter Erste Schritte mit IAM in AWS. |
| Secret Key (Geheimer Schlüssel) | Ihr geheimer Amazon-Zugriffsschlüssel. |
| Region Name (Bereichsname) | Bereich Ihres S3-Service. Die Standardregion ist US East(N. Virginia). Die Liste der Regionsnamen finden Sie in der Dokumentation AWS-Service-Endpunkte. |
| Folder Path (Ordnerpfad) | Pfad zu dem Ordner, mit dem eine Verbindung hergestellt werden soll. Der Pfad muss mit dem Bucket-Namen beginnen und darf nicht den Namen des Unterordners enthalten, dessen Daten Sie synchronisieren möchten. |
| Zugriffsschlüssel | Ihre Zugriffsschlüssel-ID für den Zugriff auf den Amazon S3-Bucket. |
| AWS Role ARN (AWS-Rollen-ARN) | Nur für die IAM-Authentifizierung der ARN der IAM-Rolle. Sie finden sie im IAM Role Setup in AWS. |
Beim Arbeiten mit dem Amazon S3-Ausgabe-Konnektor sollten Sie Folgendes berücksichtigen.
- Eine Ausgabeverbindung kann mehrmals pro Rezept verwendet werden. Für jeden Ausgabeknoten muss jedoch ein anderes Objekt verwendet werden. Jeder Ausgabeknoten kann bis zur Obergrenze des Konnektors pro Lauf unabhängig genutzt werden, unterliegt aber weiterhin der rollierenden Obergrenze von 24 Stunden.
- Ausgabeverbindungen sind nur für Rezepte verfügbar, die mit der Datenvorbereitung erstellt wurden.
- Für jede Ausgabeverbindung wird nur ein Ordnerpfad unterstützt. Erstellen Sie einen zusätzlichen Ordnerpfad, um eine weitere Ausgabeverbindung zu erstellen.
- Wenn die Dateien der vorigen Ausführung als Vorbereitung für die aktuelle Ausführung gelöscht werden, kann auf die Vorgängerversion des Ausgabedatensets nicht mehr zugegriffen werden. Richten Sie einen Prozess ein, um die Ausgabe nach jeder Ausführung zu kopieren oder zu verwenden. Nutzen Sie die Datei _SUCCESS als Hinweis, dass der Schreibvorgang abgeschlossen ist.
- Nullwerte werden als
null-[Token] an AWS ausgegeben, wobei das Token eine Zeichenfolge ist. Beispiel:null-OrJLA4JEfCjToa4DDNodernull-PaKIW3MEfCaQou9WXM. Zum Interpretieren der Nullwerte müssen Sie möglicherweise die Nachverarbeitung mithilfe der AWS CLI oder an dem Ziel implementieren, an dem Daten verbraucht werden.
