Extraire des données de la tâche Amazon S3
À propos de l’extraction de données depuis Amazon S3
Amazon Simple Storage Service (également connu sous le nom Amazon S3) est un service où vous pouvez stocker des données. Avec les flux de travail, vous pouvez facilement automatiser l’extraction des données d’Amazon S3 pour les utiliser dans Qualtrics.
Avant de commencer
Avant de commencer à extraire des données d’Amazon S3, tenez compte des considérations suivantes :
- Que voulez-vous faire de vos données ? Consultez les tâches du chargeur disponibles pour obtenir une liste d’options.
- Vos fichiers correspondent-ils à un format cohérent ? Par exemple, les fichiers que vous souhaitez importer dans le même workflow doivent avoir les mêmes en-têtes/colonnes/zones, même si les valeurs diffèrent.
Connexion de Qualtrics à AWS
Autorisation S3 requise pour un rôle IAM
Les rôles IAM doivent disposer des autorisations S3 suivantes pour connecter leur compte AWS. Pour en savoir plus sur la gestion des accès S3, voir la documentation d’AWS.
- s3:DeleteObject
- s3:GetObject
- s3:ListBucket
- s3:PutObject
- s3:AbortMultipartUpload
- s3:ListMultipartUploadParts
Exemple : Vous trouverez ci-dessous un échantillon politique de rôle. Pour l’action “s3:ListBucket”, la ressource associée doit pointer vers une période entière. Il ne peut pas y avoir de barre oblique de fin ni de caractère générique après le nom du compartiment.
{
"Version": "2012-10-17",
"Énoncé": [
{
"Effet": "Permettre
",
"Action": [
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3"
:
:
"Pss3
Object"
: "Dels3":
"Delss3
"
Exemple : vous trouverez ci-dessous un exemple de politique de confiance :
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "allow",
"Action": "sts:AssumeRole",
"Principal": {
"AWS": "604163242721"
},
"Condition": {
"StringEquals": {
"sts:ExternalId": "60ebef7bdali
"
"
RESSOURCES S3 REQUISES POUR UN UTILISATEUR IAM
Les utilisateurs IAM doivent disposer des ressources S3 suivantes pour connecter leur compte AWS. Pour en savoir plus sur la gestion des accès S3, voir la documentation d’AWS.
- arn:aws:s3:::bucket-name/*
- arn:aws:s3:::nom-boucle
Ajout d’un compte AWS
Ces étapes expliquent comment connecter votre compte Qualtrics personnel à un compte Amazon Web Services (AWS).
- Créez un workflow avec une tâche Extraire les données d’Amazon S3.
- Cliquez sur Ajouter un compte utilisateur.
- Ajoutez un nom d’affichage pour le compte. Ce nom sera uniquement utilisé en interne pour faire référence à ce compte.
- Copiez l’ ID compte et l‘ ID externe affichés.
- Dans AWS, configurez un rôle IAM à l’aide de l’ID de compte et de l’ID externe. Consultez cette page d’assistance AWS pour en savoir plus sur les rôles IAM dans AWS.
- Saisissez le nom de ressource Amazon associé au rôle IAM que vous avez créé.
- Saisissez votre région. Consultez cette page d’assistance AWS si vous avez besoin d’aide pour trouver votre région.
- Cliquez sur Connecter un compte.
Astuce Qualtrics : la possibilité de s’authentifier à l’aide d’une clé d’accès et d’une clé secrète est obsolète. Vous pouvez toujours afficher et utiliser les identifiants passés, mais ils ne peuvent plus être modifiés. Tous les nouveaux identifiants doivent être configurés à l’aide d’un rôle IAM AWS comme décrit ci-dessus.
Connexion d’un compte en tant qu’administrateur de l’organisation
En tant qu’Administrateur de la Marque, vous pouvez ajouter un compte AWS à partager avec plusieurs utilisateurs de votre licence. Pour ajouter un compte AWS partagé, accédez à la section Extensions de l’onglet Admin et recherchez l’extension AWS pour laquelle vous souhaitez ajouter un compte.
Une fois que vous avez sélectionné votre extension, suivez les étapes ci-dessus pour ajouter un compte AWS. Vous pouvez également sélectionner les utilisateurs qui ont accès au compte.
Configuration d’une tâche d’extraction de données à partir d’Amazon S3
- Créez un workflow ETL.
- Sélectionnez Source de données (extracteur ETL).
- Sélectionnez Extraire les données d’Amazon S3.
- Sélectionnez le compte Amazon Web Services (AWS) à partir duquel extraire les fichiers. Tous les comptes ajoutés par les Administrateurs de la Marque, ainsi que les comptes que vous avez ajoutés vous-même, seront répertoriés ici.
- Si vous souhaitez ajouter de nouveaux identifiants de compte AWS, cliquez sur Ajouter un compte utilisateur et suivez les étapes de la section Connexion d’un compte AWS.
- Cliquez sur Suivant.
- Saisissez le nom du compartiment S3 à partir duquel vous souhaitez extraire les données.
Attention : les noms de domaines ne peuvent pas inclure de points ( . ). Pour plus d’informations sur l’attribution de noms de bucket, consultez la documentation AWS. - Saisissez un préfixe de nom de fichier. Tous les fichiers avec le préfixe que vous avez indiqué seront traités. Si le rôle s3 autorise uniquement l’accès à un préfixe de compartiment S3 spécifique, vous devez inclure le préfixe ici.
- Sélectionnez un type de fichier à traiter. Vous avez le choix entre les options suivantes :
- CSV (valeurs séparées par des virgules)
- TSV (valeurs séparées par des tabulations)
- Sous Traitement du fichier après l’importation, sélectionnez l’une des options suivantes :
- Supprimer les fichiers traités (par défaut) : supprimez les fichiers d’AWS après leur extraction.
- Déplacer les fichiers traités : Déplacer les fichiers traités dans un autre compartiment. Si vous choisissez cette option, il vous sera demandé de saisir le nom du compartiment S3 dans lequel vous souhaitez que les fichiers traités soient stockés.
- Renommer les fichiers traités : renommez les fichiers après leur traitement. Si vous sélectionnez cette option, vous serez invité à fournir un préfixe que vous souhaitez ajouter aux noms de fichiers après leur traitement.
- Sélectionnez cette option si vous souhaitez Utiliser PGP pour chiffrer vos fichiers.
- Sous Charger un fichier échantillon, ajoutez un fichier échantillon ayant les mêmes en-têtes que les fichiers qui seront traités à chaque exécution du workflow. Cliquez sur Choisir un fichier pour télécharger le fichier depuis votre ordinateur.
Astuce Qualtrics : si vous le souhaitez, vous pouvez télécharger les exemples de fichiers dans la tâche ou télécharger les fichiers dans la section Exemples de fichiers. Le seul format d’encodage de fichier pris en charge est UTF-8. Certains logiciels de feuille de calcul enregistrent des fichiers au format Unicode UTF-8, ce qui est différent de UTF-8 si vous recevez des erreurs inattendues. Assurez-vous que vous exportez au format UTF-8 et non au format Unicode UTF-8. Voir CSV & TSV Upload Issues (Problèmes de téléchargement TSV) pour plus d’étapes de dépannage.
- Vérifiez les champs du fichier. La table affiche les en-têtes de colonne (qui représentent les champs individuels) et leurs valeurs pour les 2 premières lignes de données.
Astuce Qualtrics : si vous souhaitez télécharger un autre fichier sur le serveur ou apporter d’autres modifications, cliquez sur Modifier la configuration. - Lorsque vous avez terminé, cliquez sur Sauvegarder.
- Terminez la création de votre flux de travail ETL. Lorsque vous sélectionnez une tâche du chargeur, vous décidez de la destination des données que vous avez extraites. Consultez les tâches du chargeur disponibles pour obtenir une liste des options.