Azure Data Factory または Synapse Analytics を使用して HubSpot からデータをコピーする

適用対象: Azure Data Factory Azure Synapse Analytics

この記事では、Azure Data Factory または Synapse Analytics パイプラインでコピー アクティビティを使用して、HubSpot からデータをコピーする方法について説明します。 この記事は、コピー アクティビティの概要を示しているコピー アクティビティの概要に関する記事に基づいています。

サポートされる機能

この HubSpot コネクタでは、次の機能がサポートされています。

① Azure 統合ランタイム ② セルフホステッド統合ランタイム

ソースおよびシンクとしてサポートされているデータ ストアの一覧については、「サポートされているデータ ストア」の表を参照してください。

このサービスでは接続を有効にする組み込みのドライバーが提供されるので、このコネクタを使用してドライバーを手動でインストールする必要はありません。

コネクタは、この記事の Windows バージョンをサポートしています。

作業の開始

パイプラインでコピー アクティビティを実行するには、次のいずれかのツールまたは SDK を使用できます。

• データのコピー ツール
• Azure Portal
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• Azure Resource Manager テンプレート

UI を使用して HubSpot にリンク サービスを作成する

次の手順を使用して、Azure portal の UI で HubSpot にリンク サービスを作成します。

1. Azure Data Factory または Synapse ワークスペースの [管理] タブに移動し、[リンク サービス] を選択して、[新規] をクリックします。

   • Azureデータファクトリー
   • Azure Synapse

   

2. HubSpot を検索し、HubSpot コネクタを選択します。

   

3. サービスの詳細を構成し、接続をテストして、新しいリンク サービスを作成します。

   

コネクタの構成の詳細

次のセクションでは、HubSpot コネクタに固有の Data Factory エンティティの定義に使用されるプロパティについて詳しく説明します。

リンクされたサービスのプロパティ

HubSpot コネクタでバージョン 2.0 がサポートされるようになりました。 HubSpot コネクタのバージョンをバージョン 1.0 からアップグレードするには、この セクション を参照してください。 プロパティの詳細については、対応するセクションを参照してください。

• バージョン 2.0
• バージョン 1.0

バージョン 2.0

HubSpot のリンクされたサービスでは、バージョン 2.0 の適用時に次のプロパティがサポートされます。

例:

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

バージョン 1.0

HubSpot のリンクされたサービスでは、バージョン 1.0 の適用時に次のプロパティがサポートされます。

例:

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

データセットのプロパティ

データセットを定義するために使用できるセクションとプロパティの完全な一覧については、データセットに関する記事をご覧ください。 このセクションでは、HubSpot データセットでサポートされるプロパティの一覧を示します。

HubSpot からデータをコピーするには、データセットの type プロパティを HubspotObject に設定します。 次のプロパティがサポートされています。

例

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

コネクタ バージョン 2.0 では、次の HubSpot テーブルがサポートされています。

• マーケティングキャンペーン
• Marketing.Emails.Marketing_Emails
• マーケティング.サブスクリプションズ
• 会話.受信トレイ___メッセージ
• CMS・著者
• CMS.Blog_Settings
• CMS。Content_Audit
• CMS。ドメイン
• CMS。Hubdb
• CMS。ページ
• CMS投稿
• CMS.Site_Search
• CMS。タグ
• 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.Taxes
• CRM.Engagements.Calls
• CRM.Engagements.Communications
• CRM.Engagements.Emails
• CRM・エンゲージメント・ミーティング (CRM・エンゲージメント・ミーティング)
• CRM.Engagements.Notes
• CRM.エンゲージメント.郵便メール
• 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.Products
• CRM.Objects.Tickets
• CRMの所有者

コピー アクティビティのプロパティ

アクティビティの定義に利用できるセクションとプロパティの完全な一覧については、パイプラインに関する記事を参照してください。 このセクションでは、HubSpot ソースでサポートされるプロパティの一覧を示します。

ソースとしての HubspotSource

HubSpot からデータをコピーするは、コピー アクティビティのソースの種類を HubSpotSource に設定します。 コピー アクティビティの source セクションでは、次のプロパティがサポートされます。

例:

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

HubSpot のデータ型マッピング

HubSpot からデータをコピーする場合、次のマッピングが HubSpot のデータ型からサービスで使用される内部データ型に適用されます。 コピー アクティビティでソースのスキーマとデータ型がシンクにマッピングされるしくみについては、スキーマとデータ型のマッピングに関する記事を参照してください。

Lookup アクティビティのプロパティ

プロパティの詳細については、Lookup アクティビティに関するページを参照してください。

HubSpot コネクタのライフサイクルとアップグレード

次の表は、HubSpot コネクタのさまざまなバージョンのリリース ステージと変更ログを示しています。

HubSpot コネクタをバージョン 1.0 からバージョン 2.0 にアップグレードする

1. [ リンクされたサービスの編集] ページで、バージョン 2.0 を選択し、リンクされたサービス プロパティバージョン 2.0 を参照してリンクされたサービスを構成します。

2. HubSpot のリンクされたサービス バージョン 2.0 のデータ型マッピングは、バージョン 1.0 とは異なります。 最新のデータ型マッピングについては、 HubSpot のデータ型マッピングに関するページを参照してください。

3. query はバージョン 1.0 でのみサポートされています。 バージョン 2.0 では、tableNameの代わりにqueryを使用する必要があります。

4. バージョン 2.0 では、特定の HubSpot テーブルがサポートされていることに注意してください。 サポートされているテーブルの一覧については、「 データセットのプロパティ」を参照してください。

関連コンテンツ

Copy アクティビティでソースおよびシンクとしてサポートされるデータ ストアの一覧については、サポートされるデータ ストアに関するセクションを参照してください。