Daten aus Amazon-S3-Aufgabe extrahieren
Informationen zum Extrahieren von Daten aus Amazon S3
Amazon Simple Storage Service (auch bekannt als Amazon S3) ist ein Dienst, in dem Sie Daten speichern können. Mit Workflows können Sie die Extraktion von Daten aus Amazon S3 zur Verwendung in Qualtrics einfach automatisieren.
Bevor Sie anfangen
Bevor Sie mit der Extraktion von Daten aus Amazon S3 beginnen, beachten Sie die folgenden Überlegungen:
- Was möchten Sie mit Ihren Daten tun? Eine Liste der Optionen finden Sie in den verfügbaren Loader-Aufgaben.
- Passen Ihre Dateien zu einem konsistenten Format? Beispielsweise sollten Dateien, die Sie in denselben Workflow importieren möchten, dieselben Überschriften, Spalten oder Felder haben, auch wenn die Werte unterschiedlich sind.
Qualtrics mit AWS verbinden
S3-Berechtigung für eine IAM-Rolle erforderlich
IAM-Rollen müssen über die folgenden S3-Berechtigungen verfügen, um ihr AWS-Konto zu verbinden. Weitere Informationen zur S3-Zugriffsverwaltung finden Sie in der AWS-Dokumentation.
- s3:DeleteObject
- s3:GetObject
- s3:ListBucket
- s3:PutObject
- s3:AbortMultipartUpload
- s3:ListMultipartUploadParts
Beispiel: Nachstehend finden Sie ein Beispiel für eine Rollenpolitik. Für die Aktion “s3:ListBucket” sollte die zugehörige Ressource auf einen ganzen Bucket verweisen. Nach dem Eimernamen darf weder ein Schrägstrich noch ein Platzhalter stehen.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action":
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::s3bucketname"
vervollständigen",
},
{
"Effect": "Allow":Putbugs:aws:
"
Delets3:
"
[Precks3:
]
Beispiel: Im Folgenden finden Sie ein Beispiel für eine Vertrauensrichtlinie:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "sts:AssumeRole",
"Principal": {
"AWS": "604163242721"
},
"Condition": {
"StringEquals": {
"sts:ExternalId": "60ebef7b
}
"
"
S3 RESSOURCEN FÜR EINEN IAM-BENUTZER ERFORDERLICH
IAM-Benutzer müssen über die folgenden S3-Ressourcen verfügen, um ihr AWS-Konto zu verbinden. Weitere Informationen zur S3-Zugriffsverwaltung finden Sie in der AWS-Dokumentation.
- arn:aws:s3:::bucket-name/*
- arn:aws:s3:::bucket-name
AWS-Konto hinzufügen
In diesen Schritten wird erläutert, wie Sie Ihr persönliches Qualtrics-Konto mit einem Amazon-Web-Services-Konto (AWS-Konto) verbinden.
- Legen Sie einen Workflow mit der Aufgabe Daten aus Amazon S3 extrahieren an.
- Klicken Sie auf Benutzerkonto hinzufügen.
- Fügen Sie einen Anzeigenamen für das Konto hinzu. Dieser Name wird nur intern verwendet, um auf dieses Konto zu verweisen.
- Kopieren Sie die angezeigte Kundennummer und die Externe ID.
- Konfigurieren Sie in AWS eine IAM-Rolle mithilfe der Konto-ID und der externen ID. Weitere Informationen zu IAM-Rollen in AWS finden Sie auf dieser AWS-Supportseite.
- Geben Sie den Amazon-Ressourcennamen ein, der mit der IAM-Rolle verknüpft ist, die Sie angelegt haben.
- Geben Sie Ihre Region ein. Auf dieser AWS-Supportseite erfahren Sie, ob Sie Hilfe bei der Suche nach Ihrer Region benötigen.
- Klicken Sie auf Konto verbinden.
Tipp: Die Möglichkeit, sich mit einem Zugriffsschlüssel und einem geheimen Schlüssel zu authentifizieren, ist veraltet. Sie können vergangene Anmeldeinformationen weiterhin anzeigen und verwenden, aber sie können nicht mehr bearbeitet werden. Alle neuen Anmeldeinformationen müssen mit einer AWS-IAM-Rolle wie oben beschrieben eingerichtet werden.
Verbinden eines Kontos als Administrator
Als Administrator können Sie ein AWS-Konto hinzufügen, um es mit mehreren Benutzern in Ihrer Lizenz zu teilen. Um ein freigegebenes AWS-Konto hinzuzufügen, wechseln Sie zum Abschnitt Erweiterungen der Registerkarte Admin, und suchen Sie nach der AWS-Erweiterung, für die Sie ein Konto hinzufügen möchten.
Nachdem Sie Ihre Erweiterung ausgewählt haben, führen Sie die oben genannten Schritte aus, um ein AWS-Konto hinzuzufügen. Sie können auch auswählen, welche Benutzer Zugriff auf das Konto haben.
Einrichten einer Aufgabe zum Extrahieren von Daten aus Amazon S3
- Legen Sie einen ETL-Workflow an.
- Wählen Sie Datenquelle (ETL-Extraktor).
- Wählen Sie Daten aus Amazon S3 extrahieren.
- Wählen Sie das Amazon-Web-Services-Konto (AWS-Konto), aus dem Dateien extrahiert werden sollen. Hier werden alle Konten aufgeführt, die von Administratoren hinzugefügt wurden, sowie alle Konten, die Sie selbst hinzugefügt haben.
- Wenn Sie neue AWS-Kontoanmeldedaten hinzufügen möchten, klicken Sie auf Benutzerkonto hinzufügen, und führen Sie die Schritte im Abschnitt zum Verbinden eines AWS-Kontos aus.
- Klicken Sie auf Weiter.
- Geben Sie den Namen des S3-Buckets ein, aus dem Sie Daten abrufen möchten.
Achtung: Bucket-Namen dürfen keine Perioden ( . ) enthalten. Weitere Richtlinien für die Bucket-Benennung finden Sie in der AWS-Dokumentation. - Geben Sie ein Dateinamenspräfix ein. Alle Dateien mit dem von Ihnen angegebenen Präfix werden verarbeitet. Wenn die s3-Rolle nur den Zugriff auf ein bestimmtes S3-Bucket-Präfix zulässt, müssen Sie das Präfix hier einfügen.
- Wählen Sie einen zu verarbeitenden Dateityp aus. Sie können zwischen folgenden Optionen wählen:
- CSV (durch Kommas getrennte Werte)
- TSV (durch Tabulator getrennte Werte)
- Wählen Sie unter Dateiverarbeitung nach Import zwischen folgenden Optionen:
- Löschen Sie die verarbeiteten Dateien (Standard): Löschen Sie Dateien aus AWS, nachdem sie extrahiert wurden.
- Verarbeitete Dateien verschieben: Verschieben Sie die verarbeiteten Dateien in einen anderen Bucket. Wenn Sie diese Option wählen, werden Sie aufgefordert, den Namen des S3-Buckets einzugeben, in dem verarbeitete Dateien gespeichert werden sollen.
- Benennen Sie die verarbeiteten Dateien um: Benennen Sie Dateien um, nachdem sie verarbeitet wurden. Wenn Sie diese Option auswählen, werden Sie aufgefordert, ein Präfix anzugeben, das Sie Dateinamen hinzufügen möchten, nachdem sie verarbeitet wurden.
- Wählen Sie diese Option, wenn Sie PGP zum Verschlüsseln der Dateien verwenden.
- Fügen Sie unter Beispieldatei hochladen eine Beispieldatei mit denselben Kopfzeilen wie die Dateien hinzu, die verarbeitet werden, wenn der Workflow ausgeführt wird. Klicken Sie auf Datei auswählen, um die Datei von Ihrem Computer hochzuladen.
Tipp: Wenn Sie möchten, können Sie die Beispieldateien in der Aufgabe oder die Dateien im Abschnitt Beispieldateien herunterladen. Das einzige unterstützte Dateikodierungsformat ist UTF-8. Einige Tabellenkalkulationssoftware sichern Dateien als Unicode UTF-8, was sich von UTF-8 unterscheidet, wenn unerwartete Fehler auftreten. Stellen Sie sicher, dass Sie im UTF-8-Format und nicht im Unicode-UTF-8-Format exportieren. Weitere Schritte zur Fehlerbehebung finden Sie unter CSV & TSV Upload Issues.
- Überprüfen Sie die Felder in der Datei. Die Tabelle zeigt die Spaltenüberschriften (die die einzelnen Felder darstellen) und ihre Werte für die ersten zwei Datenzeilen an.
Tipp: Wenn Sie eine andere Datei hochladen oder andere Änderungen vornehmen möchten, klicken Sie auf Setup bearbeiten. - Wenn Sie fertig sind, klicken Sie auf Speichern.
- Schließen Sie die Erstellung Ihres ETL-Workflows ab. Wenn Sie eine Loader-Aufgabe auswählen, legen Sie das Ziel der von Ihnen extrahierten Daten fest. Eine Liste der Optionen finden Sie in den verfügbaren Loader-Aufgaben.