Exportation de données HubSpot vers Amazon Redshift

Récapitulatif

Exportez des objets, des associations et des événements de CRM HubSpot vers Amazon Redshift à l’aide de l’application Amazon Redshift dans HubSpot Marketplace. Vous pouvez choisir les données à exporter, configurer un calendrier de synchronisation et surveiller l’activité de synchronisation depuis HubSpot.

Cet article explique comment installer et connecter l’application, configurer une synchronisation d’export de données, et surveiller ou gérer la synchronisation.

Remarque : Si vous êtes un super administrateur, vous pouvez inscrire votre compte à la version bêta améliorée de l’intégration Amazon Redshift.

Avant de commencer

Compréhension des exigences

Assurez-vous d’avoir les éléments suivants :

• Un rôle AWS Identity and Access Management (IAM) connecté à votre compte HubSpot et configuré pour accéder à votre compte AWS.
• Un cluster provisionné Amazon Redshift ou un groupe de travail sans serveur accessible par HubSpot.
• Un compartiment Amazon S3 pour préparer des fichiers Parquet temporaires. Le compartiment doit se trouver dans la même région AWS que votre cluster Redshift ou votre groupe de travail sans serveur. 
• HubSpot copie les fichiers Parquet temporaires dans le compartiment intermédiaire Amazon S3 configuré et ne les supprime pas. Pour supprimer les fichiers plus anciens et gérer les coûts de stockage, créez une règle de cycle de vie S3 dans votre compte AWS.
• Un administrateur Redshift qui peut exécuter une subvention SQL unique sur la base de données de destination.
• Accès aux consoles HubSpot et AWS. Il est recommandé de les ouvrir dans des onglets distincts.

Comprendre les limites et les considérations

• Chaque synchronisation produit un aperçu complet des données sélectionnées.
• Chaque synchronisation remplace le tableau de destination. Tous les octroiements ou paramètres au niveau de la table ajoutés dans Redshift ne sont pas conservés entre les synchronisations.
• Vous contrôlez la quantité de données exportées en sélectionnant les objets, les associations et les événements à inclure.
• Si une synchronisation échoue, la prochaine synchronisation planifiée retentera automatiquement la synchronisation complète.

Installer et connecter l’application Amazon Redshift

1. Dans le marketplace des applications HubSpot, ouvrez le listing d’applications Amazon Redshift.
2. Sélectionnez le rôle AWS connecté à votre compte HubSpot.
3. Cliquez sur Installer.
4. Cliquez sur Suivant.
5. Créez un rôle AWS IAM connecté à votre compte HubSpot et configuré pour accéder à votre compte AWS.
6. Saisissez l’Amazon Resource Name (ARN) du rôle.
7. Cliquez sur Se connecter à Amazon Redshift.

Configurer votre rôle AWS

HubSpot utilise le rôle AWS connecté pour écrire des fichiers Parquet temporaires dans votre compartiment intermédiaire S3 et charger les fichiers dans Redshift.

1. Dans le champ URL du compartiment S3 , saisissez l’URL du compartiment S3 que HubSpot utilisera pour préparer des fichiers Parquet temporaires.

Vous pouvez inclure un préfixe dans l’URL pour limiter l’accès à un chemin spécifique dans le compartiment. Le compartiment doit se trouver dans la même région AWS que votre cluster Redshift ou votre groupe de travail sans serveur.

Remarque : HubSpot copie les fichiers Parquet dans le compartiment de préparation S3 configuré par défaut et ne les supprime pas. Créez une règle de cycle de vie S3 dans AWS pour supprimer automatiquement les anciens fichiers.

2. Sélectionnez votre type de déploiement Redshift dans le menu déroulant :
   • Redshift sans serveur
   • Cluster approvisionné
3. Mettez à jour le rôle AWS connecté avec la stratégie d’autorisations pour votre type de déploiement :
   • Redshift sans serveur : saisissez l’ARN de votre groupe de travail. HubSpot générera une politique contenant l’ARN. Copiez la stratégie et attachez-la au rôle AWS connecté.
   • Cluster provisionné : copiez le modèle de stratégie. Remplacez YOUR_REGION, YOUR_ACCOUNT_ID, YOUR_CLUSTER_IDet YOUR_DATABASE par les valeurs de votre compte AWS, puis attachez la stratégie au rôle AWS connecté.
4. Dans AWS IAM, ouvrez le rôle connecté à HubSpot.
5. Attachez la stratégie d’autorisations générée au rôle ou créez une stratégie en ligne avec le contenu de la politique.

6. Dans le même rôle AWS IAM, mettez à jour la stratégie d’approbation avec l’instruction générée par HubSpot.

HubSpot génère une déclaration de politique d’approbation différente en fonction du type de déploiement Redshift que vous avez sélectionné.

Associer le rôle AWS à Redshift

Dans Amazon Redshift, associez le même rôle AWS que celui que vous avez mis à jour dans la section précédente à votre configuration Redshift.

• Redshift Serverless : ouvre la page de configuration de l’espace de noms pour l’espace de noms que vous utilisez avec HubSpot. Dans l’onglet Sécurité et chiffrement , cliquez sur Gérer les rôles IAM, puis sélectionnez Associer des rôles IAM.
• Groupe provisionné : ouvrez votre cluster, cliquez sur Actions et sélectionnez Gérer les rôles > IAM Associer des rôles IAM.

Accorder des autorisations Redshift

1. Dans HubSpot, sélectionnez la base de données de destination.
2. Demandez à un administrateur Redshift d’exécuter le script SQL dans la base de données sélectionnée.

HubSpot utilise cette autorisation pour créer un schéma pour la destination pendant la synchronisation.

3. Cliquez sur Tester la connexion.
4. Si le test de connexion est concluant, cliquez sur Suivant.

Configurer la synchronisation de l’export de données

1. Sélectionnez les sources de données à exporter.
2. Sélectionnez les tableaux d’objets, d’associations et d’événements à inclure.
3. Configurez la fréquence et l’heure de début de la synchronisation.
4. Cliquez sur Commencer la synchronisation.

Chaque exécution de synchronisation exporte un instantané complet des données sélectionnées vers Amazon Redshift.

Suivre et gérer la synchronisation

À partir de la page des détails de la synchronisation, vous pouvez consulter les informations suivantes :

• Statut de synchronisation.
• Heure de la dernière synchronisation.
• Erreurs.
• Synchronisation de l’activité.
• Synchronisation de l’historique.

Pour ouvrir la page des détails de la synchronisation :

1. Depuis votre compte HubSpot, accédez à Gestion des > données, Intégration des données.
2. Dans l’onglet Synchronisations d’applications , recherchez les synchronisations d’applications Amazon Redshift.
3. Cliquez sur la synchronisation Amazon Redshift que vous souhaitez vérifier.

À partir de la page des détails de la synchronisation, vous pouvez également effectuer les actions suivantes :

• Cliquez sur Pause pour suspendre la synchronisation.
• Cliquez sur Archiver pour archiver la synchronisation.
• Cliquez sur Synchroniser maintenant pour lancer manuellement une synchronisation.

Synchroniser les statuts

Résoudre les échecs de synchronisation

Lorsqu’une synchronisation échoue :

• La synchronisation affiche un statut Échec dans HubSpot.
• Les détails par tableau indiquent les tables qui ont réussi ou échoué.
• La prochaine synchronisation planifiée retentera automatiquement la synchronisation complète.
• Vous pouvez cliquer sur Synchroniser maintenant pour lancer manuellement une autre synchronisation.