Paramétrez Openflow Connector for HubSpot¶

Conditions préalables¶

1. Assurez-vous d’avoir consulté À propos de Openflow Connector for HubSpot.

2. Assurez-vous d’avoir Configuration d’Openflow - BYOC ou de Configurer Openflow - Déploiements Snowflake.

3. Si vous utilisez Openflow - Snowflake Deployments, assurez-vous d’avoir examiné la configuration des domaines requis et d’avoir accordé l’accès aux domaines requis pour le connecteur Hubspot.

Obtenir les identifiants de connexion¶

En tant qu’administrateur de HubSpot, générez un jeton d’application privée HubSpot ou créez-en un dans votre compte HubSpot. Cela vous permet d’authentifier vos requêtes auprès de l’API HubSpot.

1. Connectez-vous à votre compte HubSpot.

2. Accédez à Settings en sélectionnant l’icône de l’engrenage dans la barre de navigation supérieure.

3. Dans la navigation de gauche, accédez à Integrations » Private Apps.

4. Sélectionnez Create a private app.

   1. Saisissez un nom pour votre application.

   2. Accédez à l’onglet Scopes.

   3. Sélectionnez les champs d’application requis pour les requêtes d’API que vous avez l’intention d’effectuer. Pour trouver les champs d’application nécessaires aux requêtes d’API, voir Champs d’application.

   4. Sélectionnez Create app.

   5. Paramétrez les champs d’application requis pour les requêtes d’API que vous avez l’intention d’effectuer pour chaque point de terminaison.

5. Sélectionnez View access token pour voir le jeton d’accès. Collez le jeton dans les paramètres du connecteur ou sauvegardez-le en toute sécurité.

Paramétrage du compte Snowflake¶

En tant qu’administrateur de compte Snowflake, effectuez les tâches suivantes :

1. Créez un nouveau rôle ou utilisez un rôle existant et accordez les Privilèges de base de données et les Affichage des privilèges.

2. Créez un nouvel utilisateur du service Snowflake avec le type SERVICE.

3. Autorisez l’utilisateur du service Snowflake le rôle que vous avez créé dans les étapes précédentes.

4. Configurez avec l’authentification par paire de clés pour l’utilisateur de Snowflake SERVICE de l’étape 2.

5. Snowflake recommande vivement cette étape. Configurez un gestionnaire de secrets pris en charge par Openflow, par exemple AWS, Azure et Hashicorp, et stockez les clés publiques et privées dans le magasin de secrets.

   Note

   Si, pour une raison quelconque, vous ne souhaitez pas utiliser un gestionnaire de secrets, il vous incombe de protéger les fichiers de clés publiques et privées utilisés pour l’authentification par paires de clés conformément aux politiques de sécurité de votre organisation.

   1. Une fois le gestionnaire de secrets configuré, déterminez comment vous vous y authentifierez. Sur AWS, il est recommandé d’utiliser le rôle de l’instance EC2 associée à Openflow, car de cette manière, aucun autre secret ne doit être conservé.

   2. Dans Openflow, configurez un fournisseur de paramètres associé à ce gestionnaire de secrets, à partir du menu hamburger en haut à droite. Naviguez jusqu’à Controller Settings » Parameter Provider, puis récupérez vos valeurs de paramètres.

   3. À ce stade, tous les identifiants peuvent être référencés avec les chemins de paramètres associés et aucune valeur sensible ne doit être conservée dans Openflow.

6. Si d’autres utilisateurs de Snowflake ont besoin d’accéder aux documents bruts ingérés et aux tables ingérées par le connecteur (par exemple, pour un traitement personnalisé dans Snowflake), accordez à ces utilisateurs le rôle créé à l’étape 1.

7. Créez une base de données et un schéma dans Snowflake pour que le connecteur puisse stocker les données ingérées. Autorisez Privilèges de base de données pour le rôle créé à la première étape.

   CopyExpand

   CREATE DATABASE hubspot_destination_db;
   CREATE SCHEMA hubspot_destination_db.hubspot_destination_schema;
   GRANT USAGE ON DATABASE hubspot_destination_db TO ROLE <hubspot_connector_role>;
   GRANT USAGE ON SCHEMA hubspot_destination_db.hubspot_destination_schema TO ROLE <hubspot_connector_role>;
   GRANT CREATE TABLE, CREATE VIEW ON SCHEMA hubspot_destination_db.hubspot_destination_schema TO ROLE <hubspot_connector_role>;
   

   Show lessSee more

   Scroll to top

8. Créez un entrepôt qui sera utilisé par le connecteur ou utilisez un entrepôt existant. Commencez par la taille d’entrepôt la plus petite, puis faites des essais en fonction du nombre de tables répliquées et de la quantité de données transférées. Les tables de grande taille s’adaptent généralement mieux aux entrepôts multi-clusters, plutôt qu’aux entrepôts de grande taille.

9. Assurez-vous que l’utilisateur dont le rôle est utilisé par le connecteur dispose des privilèges requis pour utiliser l’entrepôt. Si ce n’est pas le cas, accordez les privilèges requis au rôle.

   CopyExpand

   CREATE WAREHOUSE hubspot_connector_warehouse WITH WAREHOUSE_SIZE = 'X-Small';
   GRANT USAGE ON WAREHOUSE hubspot_connector_warehouse TO ROLE <hubspot_connector_role>;
   

   Show lessSee more

   Scroll to top

Définir le connecteur¶

En tant qu’ingénieur des données, effectuez les tâches suivantes pour installer et configurer le connecteur :

Exécutez le flux¶

1. Cliquez avec le bouton droit de la souris sur l’avion et sélectionnez Enable all Controller Services.

2. Cliquez avec le bouton droit de la souris sur le groupe de processus importé et sélectionnez Start. Le connecteur démarre l’ingestion des données.

Structure des données et vues¶

Le connecteur stocke les données dans les deux formats suivants dans votre base de données Snowflake :