Copier des données de HubSpot à l’aide d’Azure Data Factory ou de Synapse Analytics

S’APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Conseil

Essayez Data Factory dans Microsoft Fabric, une solution d’analyse tout-en-un pour les entreprises. Microsoft Fabric couvre tous les aspects, du déplacement des données à la science des données, en passant par l’analyse en temps réel, la business intelligence et le reporting. Découvrez comment démarrer un nouvel essai gratuitement !

Cet article explique comment utiliser l’activité de copie dans Azure Data Factory ou Synapse Analytics pour copier des données de HubSpot. Il s’appuie sur l’article Vue d’ensemble de l’activité de copie.

Important

Le connecteur HubSpot version 1.0 est à l’étape de suppression. Vous êtes recommandé de mettre à niveau le connecteur HubSpot de la version 1.0 vers la version 2.0.

Fonctionnalités prises en charge

Ce connecteur HubSpot est pris en charge pour les capacités suivantes :

Fonctionnalités prises en charge	IR
Activité de copie (source/-)	(1) (2)
Activité de recherche	(1) (2)

① Runtime d’intégration Azure ② Runtime d’intégration auto-hébergé

Pour obtenir la liste des magasins de données pris en charge en tant que sources et récepteurs, consultez le tableau Magasins de données pris en charge.

La service fournit un pilote intégré qui permet la connexion. Vous n'avez donc pas besoin d'installer manuellement un pilote à l'aide de ce connecteur.

Le connecteur prend en charge les versions Windows de cet article.

Prise en main

Pour effectuer l’activité de copie avec un pipeline, vous pouvez utiliser l’un des outils ou kits sdk suivants :

Créer un service lié à HubSpot à l’aide de l’interface utilisateur

Utilisez les étapes suivantes pour créer un service lié à HubSpot dans l’interface utilisateur du portail Azure.

Accédez à l’onglet Gérer dans votre espace de travail Azure Data Factory ou Synapse, sélectionnez Services liés, puis cliquez sur Nouveau :
- Azure Data Factory.
- Azure Synapse
Recherchez HubSpot et sélectionnez le connecteur HubSpot.
Configurez les informations du service, testez la connexion et créez le nouveau service lié.

Détails de configuration du connecteur

Les sections suivantes fournissent des informations sur les propriétés utilisées pour définir les entités Data Factory spécifiques du connecteur HubSpot.

Propriétés du service lié

Le connecteur HubSpot prend désormais en charge la version 2.0. Reportez-vous à cette section pour mettre à niveau votre version de connecteur HubSpot à partir de la version 1.0. Pour plus d’informations sur la propriété, consultez les sections correspondantes.

Version 2.0
Version 1.0

Version 2.0

Le service lié HubSpot prend en charge les propriétés suivantes lors de l’application de la version 2.0 :

Propriété	Description	Obligatoire
type	La propriété de type doit être définie sur HubSpot	Oui
version	Version que vous spécifiez. La valeur est `2.0`.	Oui
clientId	ID client associé à votre application HubSpot. Découvrez comment créer une application dans HubSpot ici.	Oui
clientSecret	Clé secrète client associée à votre application HubSpot. Marquez ce champ en tant que SecureString afin de le stocker de façon sécurisée, ou référencez un secret stocké dans Azure Key Vault.	Oui
accessToken	Le jeton d’accès obtenu lors de l’authentification initiale de votre intégration OAuth. Découvrez comment obtenir un jeton d’accès avec votre ID client et votre secret ici. Marquez ce champ en tant que SecureString afin de le stocker de façon sécurisée, ou référencez un secret stocké dans Azure Key Vault.	Oui
refreshToken	Le jeton d’actualisation obtenu lors de l’authentification initiale de votre intégration OAuth. Marquez ce champ en tant que SecureString afin de le stocker de façon sécurisée, ou référencez un secret stocké dans Azure Key Vault.	Oui
connectVia	Le runtime d’intégration à utiliser pour se connecter à la banque de données. Si aucune valeur n’est spécifiée, la propriété utilise le runtime d’intégration Azure par défaut.	Non

Exemple :

{
    "name": "HubSpotLinkedService",
    "properties": {
        "type": "Hubspot",
        "version": "2.0",
        "typeProperties": {
            "clientId" : "<clientId>",
            "clientSecret": {
                "type": "SecureString",
                "value": "<clientSecret>"
            },
            "accessToken": {
                "type": "SecureString",
                "value": "<accessToken>"
            },
            "refreshToken": {
                "type": "SecureString",
                "value": "<refreshToken>"
            }
        }
    }
}

Version 1.0

Le service lié HubSpot prend en charge les propriétés suivantes lors de l’application de la version 1.0 :

Propriété	Description	Obligatoire
type	La propriété de type doit être définie sur HubSpot	Oui
clientId	ID client associé à votre application HubSpot. Découvrez comment créer une application dans HubSpot ici.	Oui
clientSecret	Clé secrète client associée à votre application HubSpot. Marquez ce champ en tant que SecureString afin de le stocker de façon sécurisée, ou référencez un secret stocké dans Azure Key Vault.	Oui
accessToken	Le jeton d’accès obtenu lors de l’authentification initiale de votre intégration OAuth. Découvrez comment obtenir un jeton d’accès avec votre ID client et votre secret ici. Marquez ce champ en tant que SecureString afin de le stocker de façon sécurisée, ou référencez un secret stocké dans Azure Key Vault.	Oui
refreshToken	Le jeton d’actualisation obtenu lors de l’authentification initiale de votre intégration OAuth. Marquez ce champ en tant que SecureString afin de le stocker de façon sécurisée, ou référencez un secret stocké dans Azure Key Vault.	Oui
useEncryptedEndpoints	Indique si les points de terminaison de la source de données sont chiffrés suivant le protocole HTTPS. La valeur par défaut est true.	Non
useHostVerification	Indique si le nom d’hôte du certificat du serveur doit correspondre à celui du serveur en cas de connexion TLS. La valeur par défaut est true.	Non
usePeerVerification	Indique s’il faut vérifier l’identité du serveur en cas de connexion TLS. La valeur par défaut est true.	Non
connectVia	Le runtime d’intégration à utiliser pour se connecter à la banque de données. Si aucune valeur n’est spécifiée, la propriété utilise le runtime d’intégration Azure par défaut.	Non

Exemple :

{
    "name": "HubSpotLinkedService",
    "properties": {
        "type": "Hubspot",
        "typeProperties": {
            "clientId" : "<clientId>",
            "clientSecret": {
                "type": "SecureString",
                "value": "<clientSecret>"
            },
            "accessToken": {
                "type": "SecureString",
                "value": "<accessToken>"
            },
            "refreshToken": {
                "type": "SecureString",
                "value": "<refreshToken>"
            }
        }
    }
}

Propriétés du jeu de données

Pour obtenir la liste complète des sections et propriétés disponibles pour la définition de jeux de données, consultez l’article sur les jeux de données. Cette section fournit la liste des propriétés prises en charge par le jeu de données HubSpot.

Pour copier des données depuis HubSpot, définissez la propriété type du jeu de données sur HubspotObject. Les propriétés prises en charge sont les suivantes :

Propriété	Description	Obligatoire
type	La propriété type du jeu de données doit être définie sur : HubspotObject	Oui
tableName	Nom de la table. Pour la version 2.0, le nom de la table est `<HubSpot Category>.<Sub Category>.<Object Name>`, par exemple : `CRM.Commerce.Discounts`.	Oui pour la version 2.0. Non pour la version 1.0 (si « requête » dans la source d’activité est spécifiée)

Exemple

{
    "name": "HubSpotDataset",
    "properties": {
        "type": "HubspotObject",
        "typeProperties": {},
        "schema": [],        
        "linkedServiceName": {
            "referenceName": "<HubSpot linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Le connecteur version 2.0 prend en charge les tables HubSpot suivantes :

Campagnes.Marketing
Marketing.Emails.Marketing_Emails
Marketing.Abonnements
Conversations.Boîte de réception___Messages
CMS.Authors
CMS.Blog_Settings
CMS. Audit_de_Contenu
CMS.Domaines
CMS. Hubdb
CMS.Pages
CMS.Posts
CMS.Site_Search
CMS. Mots-clés
CMS.Url_Redirects
CRM.Commerce.Carts
CRM.Commerce.Discounts
CRM.Commerce.Fees
CRM.Commerce.Invoices
CRM.Commerce.Orders
CRM.Commerce.Quotes
CRM.Commerce.Abonnements
CRM.Commerce.Taxes
CRM.Engagements.Calls
CRM.Engagements.Communications
CRM.Engagements.Emails
CRM.Engagements.Réunions
CRM.Engagements.Notes
CRM.Engagements.Postal_Mail
CRM.Activités.Tâches
CRM.Objects.Companies
CRM.Objects.Contacts
CRM.Objets.Transactions
CRM.Objects.Feedback_Submissions
CRM.Objects.Goal_Targets
CRM.Objects.Leads
CRM.Objects.Line_Items
CRM.Objects.Products
CRM.Objects.Tickets
CRM.Owners

Propriétés de l’activité de copie

Pour obtenir la liste complète des sections et des propriétés disponibles pour la définition des activités, consultez l’article Pipelines. Cette section fournit la liste des propriétés prises en charge par la source HubSpot.

HubspotSource en tant que source

Pour copier des données depuis HubSpot, définissez le type de source dans l’activité de copie sur HubspotSource. Les propriétés prises en charge dans la section source de l’activité de copie sont les suivantes :

Propriété	Description	Obligatoire
type	La propriété type de la source de l’activité de copie doit être définie sur HubspotSource	Oui
query	Utiliser la requête SQL personnalisée pour lire les données. Par exemple : `"SELECT * FROM Companies where Company_Id = xxx"`.	Non (si « tableName » est spécifié dans dataset)

Note

query n’est pas pris en charge dans la version 2.0.

Exemple :

"activities":[
    {
        "name": "CopyFromHubspot",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<HubSpot input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "HubspotSource",
                "query": "SELECT * FROM Companies where Company_Id = xxx"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Mappage de type de données pour HubSpot

Lorsque vous copiez des données à partir de HubSpot, les mappages suivants s’appliquent des types de données hubSpot aux types de données internes utilisés par le service. Pour découvrir comment l’activité de copie mappe le schéma et le type de données la source au récepteur, consultez Mappage de schéma dans l’activité de copie.

Type de données HubSpot	Type de données de service intermédiaire (pour la version 2.0)	Type de données de service intermédiaire (pour la version 1.0)
bool	Booléen	Booléen
boolean	Booléen	Booléen
énumération	Chaîne	Chaîne
ficelle	Chaîne	Chaîne
coordonnées_de_l'objet	Chaîne	Chaîne
phone_number	Chaîne	Chaîne
json	Chaîne	Chaîne
date	Date et heure	Non pris en charge.
datetime	Date et heure	Date et heure
nombre	Decimal	Decimal
entier	Nombre entier	Nombre entier
objet	Chaîne	Non pris en charge.

Propriétés de l’activité Lookup

Pour en savoir plus sur les propriétés, consultez Activité Lookup.

Cycle de vie et mise à niveau du connecteur HubSpot

Le tableau suivant présente l’étape de mise en production et les journaux des modifications pour différentes versions du connecteur HubSpot :

Version	Phase de mise en production	Journal des modifications
Version 1.0	Removed	Non applicable.
Version 2.0	Disponibilité générale	• La `tableName` valeur est `<HubSpot Category>.<Sub Category>.<Object Name>`, par exemple : `CRM.Commerce.Discounts`. • La date est lue en tant que type de données DateTime. • l’objet est lu en tant que type de données String. •`useEncryptedEndpoints`, `useHostVerificationusePeerVerification` ne sont pas pris en charge dans le service lié. • `query` n’est pas pris en charge. • Prendre en charge des tables HubSpot spécifiques. Pour la liste de tables prise en charge, accédez aux propriétés du jeu de données.

Mettre à niveau le connecteur HubSpot de la version 1.0 vers la version 2.0

Dans la page Modifier le service lié , sélectionnez la version 2.0 et configurez le service lié en faisant référence aux propriétés du service lié version 2.0.
Le mappage de type de données pour le service lié HubSpot version 2.0 est différent de celui de la version 1.0. Pour en savoir plus sur le mappage de type de données le plus récent, consultez Mappage de type de données pour HubSpot.
query est uniquement pris en charge dans la version 1.0. Vous devez utiliser tableName au lieu de query dans la version 2.0.
Notez que la version 2.0 prend en charge des tables HubSpot spécifiques. Pour la liste de tables prise en charge, accédez aux propriétés du jeu de données.

Consultez les banques de données prises en charge pour obtenir la liste des banques de données prises en charge en tant que sources et récepteurs par l’activité de copie.

Rétroaction

Cette page a-t-elle été utile ?

Last updated on 2025-11-05

Partager via

Copier des données de HubSpot à l’aide d’Azure Data Factory ou de Synapse Analytics

Fonctionnalités prises en charge

Prise en main

Créer un service lié à HubSpot à l’aide de l’interface utilisateur

Détails de configuration du connecteur

Propriétés du service lié

Version 2.0

Version 1.0

Propriétés du jeu de données

Propriétés de l’activité de copie

HubspotSource en tant que source

Mappage de type de données pour HubSpot

Propriétés de l’activité Lookup

Cycle de vie et mise à niveau du connecteur HubSpot

Mettre à niveau le connecteur HubSpot de la version 1.0 vers la version 2.0

Contenu connexe

Rétroaction

Ressources additionnelles