Extraire les données de la tâche Snowflake

À propos de la tâche Extraire les données de Snowflake

Snowflake est un logiciel de nuage de données tiers utilisé pour stocker, gérer et partager des données. Vous pouvez importer des données à partir de Snowflake pour les utiliser dans un flux d’opérations Qualtrics.

Intégration avec Snowflake

Pour utiliser cette tâche, vous devez créer une nouvelle intégration dans Snowflake et la connecter à Qualtrics.

Configuration dans Snowflake

1. Connectez-vous à Snowflake.
2. Dans l’onglet Feuilles de calcul, cliquez sur le signe plus (+) et sélectionnez Feuille de calcul SQL.
3. Collez le code suivant dans la feuille de calcul :
   

   
   CREATE SECURITY 
   
   INTEGRATIONQUALTRICS_INTEGRATION_NAME_PUBLICAPI_G1TYPE = OAUTH
   
    OAUTH_CLIENT = CUSTOM
   
    OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
   
    OAUTH_REDIRECT_URI ='https://publicapist3.qualtrics.com/oauth-client-service/redirect'
   
    ENABLED = TRUE
   
    OAUTH_ISSUE_REAUSHSH_TOTHER_TOKTOKITY
   
   

4. Remplacez la ligne QUALTRICS_INTEGRATION_NAME_PUBLICAPI_G1 en gras par un nom pour l’intégration. Utilisez uniquement des lettres, des chiffres et des traits de soulignement pour le nom d’intégration.
   
   Astuce Qualtrics : copiez votre nom d’intégration, car vous en aurez besoin ultérieurement pour terminer la configuration. Snowflake mettra automatiquement en majuscules chaque lettre de votre nom d’intégration. Par exemple, si je nomme mon intégration “Qualtrics_Integration”, elle sera sauvegardée sous le nom “QUALTRICS_INTEGRATION” dans Snowflake. C’est le nom que je devrais sauvegarder pour plus tard.
5. Remplacez le publicapist3 en gras par des informations sur votre marque. Ces informations seront différentes selon que vous souhaitez configurer une connexion individuelle dans le workflow lui-même ou une connexion à l’échelle du compte dans l’onglet Admin.
   • Si vous créez une connexion individuelle, remplacez-la par votre ID de marque.
     Exemple : si mon ID de marque est “dsx”, ma valeur mise à jour est https://dsx.qualtrics.com/oauth-client-service/redirect’
   • Si vous créez une connexion à l’échelle du compte, remplacez-la par votre ID de centre de données.
     Exemple : si mon datacenterID est “iad1”, ma valeur mise à jour est https://iad1.qualtrics.com/oauth-client-service/redirect’
6. Cliquez sur Exécuter.
7. Vous recevrez le message « Nom de l’intégration correctement créée ».
   
   Astuce Qualtrics : si vous recevez une erreur « privilèges insuffisants », vos autorisations Snowflake doivent être mises à jour. Consultez cette page d’assistance Snowflake pour en savoir plus sur les autorisations requises.
8. Dans la même feuille de calcul, saisissez le code suivant :

   ​​​​DESCRIBE SECURITY INTEGRATION NAME_OF_SECURITY_INTEGRATION

9. Remplacez INTEGRATION NAME_OF_SECURITY_INTEGRATION en gras par le nom d’intégration en majuscules de l’étape 4.
10. Cliquez sur Exécuter.
11. Différentes informations sur l’intégration vous seront présentées. Copiez les valeurs des zones suivantes :
    
    • OAUTH_AUTHORIZATION_ENDPOINT
    • OAUTH_TOKEN_ENDPOINT
    • OAUTH_CLIENT_ID
12. Dans la même feuille de calcul, saisissez le code suivant :

    SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS(‘NAME_OF_SECURITY_INTEGRATION’)

13. Remplacez le nom en gras NAME_OF_SECURITY_INTEGRATION par votre nom d’intégration en majuscules de l’étape 4.
14. Cliquez sur Exécuter.
15. Copiez l’une des valeurs secrètes client.

Configuration dans Qualtrics

1. Si vous créez une connexion à l’échelle de la marque (c’est-à-dire un compte Snowflake disponible pour tous les utilisateurs de votre licence Qualtrics), accédez à Extensions section du Administrateur et recherchez Extraire les données de l’intégration Snowflake.
2. Si vous créez une connexion individuelle (c’est-à-dire qu’un compte Snowflake est disponible uniquement pour vous), accédez à Flux de travail et créer un workflow ETL. Lorsque vous sélectionnez votre tâche d’extracteur, sélectionnez la tâche Extraire les données de Snowflake.
3. Cliquez sur Ajouter un compte si dans l’onglet Admin ou sur Ajouter un compte utilisateur si dans la tâche de workflow. Les étapes restantes sont les mêmes, quel que soit l’endroit où vous configurez votre compte.
   
4. Nommez votre compte pour pouvoir l’identifier plus tard.
   
5. Sélectionnez Code d’autorisation pour le type de subvention.
6. Saisissez vos détails d’autorisation :
   • ID client : OAUTH_CLIENT_ID que vous avez copié à l’étape 10 de la configuration dans Snowflake.
   • Clé secrète client : CLIENT_SECRET que vous avez copié à l’étape 14 de Configuration dans Snowflake.
   • Point de terminaison du jeton : OAUTH_TOKEN_ENDPOINT que vous avez copié à l’étape 10 de la configuration dans Snowflake.
   • Point de terminaison d’autorisation : OAUTH_AUTHORIZATION_ENDPOINT que vous avez copié à l’étape 10 de la configuration dans Snowflake.
   • Périmètres (facultatif) : vous pouvez utiliser des périmètres pour limiter le niveau d’accès. Pour la plupart des cas d’utilisation, vous pouvez laisser cette zone vide.
7. Cliquez sur Connecter un compte.
8. Une fenêtre s’ouvrira pour que vous vous connectiez à Snowflake. Saisissez votre nom d’utilisateur Snowflake et votre mot de passe.
9. Cliquez sur Connexion.

Configuration d’une tâche Extraire les données de Snowflake

1. Suivez les instructions liées pour créer un workflow ETL.
2. Pour votre tâche de workflow, sélectionnez la tâche Extraire les données de Snowflake.
3. Sélectionnez le compte Snowflake que vous avez connecté précédemment.
   
4. Cliquez sur Suivant.
5. Saisissez les informations suivantes sur les données que vous voulez importer de Snowflake :
   
   • Modèle de nom de fichier : chaîne de texte utilisée pour identifier les fichiers à importer.
     Astuce Qualtrics : nous vous recommandons d’inclure « Qualtrics » au début de tous les fichiers que vous souhaitez importer. Vous pouvez ensuite saisir « Qualtrics » dans ce champ pour importer tous les fichiers pertinents.
   • Répertoire de récupération : Le répertoire Snowflake qui contient les fichiers.
     Astuce Qualtrics : si le fichier est à l’étape de base, vous pouvez laisser ce champ vide.
   • Identifiant de compte : identifiant de compte Snowflake de la base de données qui contient les fichiers à importer.
   • Identificateur de base de données : identifiant de la base de données Snowflake qui contient les fichiers à importer.
   • Identifiant de schéma : identifiant du schéma Snowflake du schéma qui contient le fichier à importer.
   • Nom de l’étape : nom de l’étape Snowflake qui contient les fichiers à importer.
6. Si vous le souhaitez, activez Ignorer les fichiers incorrects. Lorsque cette option est activée, les fichiers corrompus et les fichiers qui ne correspondent pas à vos en-têtes sont ignorés.
7. Vous devez télécharger un exemple de fichier contenant le format général des données que vous souhaitez importer dans Qualtrics. Cliquez sur Choisir un fichier et sélectionnez le fichier sur votre ordinateur.
   Astuce Qualtrics : si nécessaire, vous pouvez télécharger l’un des exemples de fichiers répertoriés dans la fenêtre de tâche.
8. Cliquez sur Charger.
9. Vérifiez votre fichier échantillon pour vous assurer que tout semble correct.
   Astuce Qualtrics : si vous devez modifier votre fichier, cliquez sur Précédent dans le coin supérieur gauche.
10. Cliquez sur Enregistrer.
11. Sélectionnez votre tâche de chargement, qui détermine où les données sont sauvegardées. Pour plus d’informations sur les options disponibles, voir Tâches du chargeur disponibles.