Kopieren von Daten aus HubSpot mit Azure Data Factory oder Synapse Analytics

GILT FÜR: Azure Data Factory Azure Synapse Analytics

In diesem Artikel wird beschrieben, wie die Kopieraktivität in einer Azure Data Factory- oder Synapse Analytics-Pipeline verwendet wird, um Daten aus HubSpot zu kopieren. Er baut auf dem Artikel zur Übersicht über die Kopieraktivität auf, der eine allgemeine Übersicht über die Kopieraktivität enthält.

Unterstützte Funktionen

Dieser HubSpot-Connector wird für die folgenden Funktionen unterstützt:

① Azure Integration Runtime ② Selbstgehostete Integration Runtime

Eine Liste der Datenspeicher, die als Quellen/Senken unterstützt werden, finden Sie in der Tabelle Unterstützte Datenspeicher.

Der Dienst bietet einen eingebauten Treiber, um die Verbindung zu ermöglichen, so dass Sie keinen Treiber manuell installieren müssen.

Der Connector unterstützt die Windows-Versionen in diesem Artikel.

Erste Schritte

Zum Ausführen der Kopieraktivität mit einer Pipeline können Sie eines der folgenden Tools oder SDKs verwenden:

• Datenkopier-Tool
• Azure-Portal
• .NET SDK
• Python SDK
• Azure PowerShell
• REST-API
• Azure Resource Manager-Vorlage

Erstellen eines verknüpften Diensts für HubSpot mithilfe der Benutzeroberfläche

Verwenden Sie die folgenden Schritte, um einen verknüpften Dienst mit HubSpot auf der Azure-Portal Benutzeroberfläche zu erstellen.

1. Navigieren Sie in Ihrem Azure Data Factory- oder Synapse-Arbeitsbereich zur Registerkarte „Verwalten“, wählen Sie „Verknüpfte Dienste“ aus, und klicken Sie dann auf „Neu“:

   • Azure Data Factory
   • Azure Synapse

   

2. Suchen Sie nach HubSpot und wählen Sie den HubSpot-Connector aus.

   

3. Konfigurieren Sie die Dienstdetails, testen Sie die Verbindung, und erstellen Sie den neuen verknüpften Dienst.

   

Details zur Connectorkonfiguration

Die folgenden Abschnitte enthalten Details zu Eigenschaften, die zum Definieren von Data Factory-Entitäten speziell für den HubSpot-Connector verwendet werden:

Eigenschaften des verknüpften Diensts

Der HubSpot-Connector unterstützt jetzt Version 2.0. In diesem Abschnitt erfahren Sie, wie Sie Ihre HubSpot-Connectorversion von Version 1.0 aktualisieren. Einzelheiten zur Eigenschaft finden Sie in den entsprechenden Abschnitten.

• Version 2.0
• Version 1.0

Version 2.0

Der verknüpfte HubSpot-Dienst unterstützt die folgenden Eigenschaften, wenn Version 2.0 angewendet wird:

Beispiel:

{
    "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

Der verknüpfte HubSpot-Dienst unterstützt die folgenden Eigenschaften bei Version 1.0:

Beispiel:

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

Dataset-Eigenschaften

Eine vollständige Liste mit den Abschnitten und Eigenschaften, die zum Definieren von Datasets zur Verfügung stehen, finden Sie im Artikel zu Datasets. Dieser Abschnitt enthält eine Liste der Eigenschaften, die vom HubSpot-Dataset unterstützt werden.

Legen Sie zum Kopieren von Daten aus HubSpot die „type“-Eigenschaft des Datasets auf HubspotObject fest. Folgende Eigenschaften werden unterstützt:

Beispiel

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

Die Connectorversion 2.0 unterstützt die folgenden HubSpot-Tabellen:

• Marketing.Kampagnen
• Marketing.Emails.Marketing_Emails
• Marketing-Abonnements
• Konversationen.Posteingang___Nachrichten
• CMS.Authors
• CMS.Blog_Settings
• CMS.Content_Audit
• CMS. Domänen
• CMS. Hubdb
• CMS.Seiten
• CMS Beiträge
• CMS.Site_Search
• CMS-Tags
• CMS.Url_Redirects
• CRM.Commerce.Carts
• CRM.Commerce.Discounts
• CRM.Commerce.Fees
• CRM.Commerce.Invoices
• CRM.Commerce.Orders
• CRM.Commerce.Quotes
• CRM.Commerce.Subscriptions
• CRM. Commerce.Steuern
• CRM.Engagements.Calls
• CRM.Engagements.Communications
• CRM.Engagements.Emails
• CRM.Engagements.Meetings
• CRM.Engagements.Notes
• CRM.Engagements.Postal_Mail
• CRM.Engagements.Tasks
• CRM.Objects.Companies
• CRM.Objects.Contacts
• CRM.Objects.Deals
• CRM.Objects.Feedback_Submissions
• CRM.Objects.Goal_Targets
• CRM.Objects.Leads
• CRM.Objects.Line_Items
• CRM.Objects.Produkte
• CRM.Objects.Tickets
• CRM-Verantwortliche

Eigenschaften der Kopieraktivität

Eine vollständige Liste mit den Abschnitten und Eigenschaften zum Definieren von Aktivitäten finden Sie im Artikel Pipelines. Dieser Abschnitt enthält eine Liste der Eigenschaften, die von der HubSpot-Quelle unterstützt werden.

HubspotSource als Quelle

Legen Sie zum Kopieren von Daten aus HubSpot den Quelltyp in der Kopieraktivität auf HubspotSource fest. Folgende Eigenschaften werden im Abschnitt source der Kopieraktivität unterstützt:

Beispiel:

"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>"
            }
        }
    }
]

Datentypzuordnung für HubSpot

Beim Kopieren von Daten aus HubSpot gelten die folgenden Zuordnungen von HubSpot-Datentypen zu den vom Dienst verwendeten internen Datentypen. Informationen dazu, wie die Kopieraktivität das Quellschema und den Datentyp der Spüle zuordnet, finden Sie unter Schema- und Datentypzuordnungen.

Eigenschaften der Lookup-Aktivität

Ausführliche Informationen zu den Eigenschaften finden Sie unter Lookup-Aktivität.

Connectorlebenszyklus und -upgrade für HubSpot

Die folgende Tabelle zeigt die Releasestufe und Änderungsprotokolle für verschiedene Versionen des HubSpot-Connectors:

Aktualisieren des HubSpot-Connectors von Version 1.0 auf Version 2.0

1. Wählen Sie auf der Seite "Verknüpften Dienst bearbeiten" Version 2.0 aus, und konfigurieren Sie den verknüpften Dienst, indem Sie auf verknüpfte Diensteigenschaften Version 2.0 verweisen.

2. Die Datentypzuordnung für den verknüpften HubSpot-Dienst Version 2.0 unterscheidet sich von der für die Version 1.0. Informationen zur neuesten Datentypzuordnung finden Sie unter Datentypzuordnung für HubSpot.

3. query wird nur in Version 1.0 unterstützt. Sie sollten in Version 2.0 tableName anstelle von query verwenden.

4. Beachten Sie, dass Version 2.0 bestimmte HubSpot-Tabellen unterstützt. Wechseln Sie für die liste der unterstützten Tabellen zu "Dataset"-Eigenschaften.

Verwandte Inhalte

Eine Liste der Datenspeicher, die als Quellen und Senken für die Copy-Aktivität unterstützt werden, finden Sie in der Dokumentation zu unterstützten Datenspeichern.