Kopiowanie danych z usługi HubSpot przy użyciu usługi Azure Data Factory lub Synapse Analytics

DOTYCZY: Azure Data Factory Azure Synapse Analytics

W tym artykule opisano sposób użycia działania kopiowania w potoku usługi Azure Data Factory lub Synapse Analytics w celu skopiowania danych z usługi HubSpot. Jest on oparty na artykule omówienie działania kopiowania, który przedstawia ogólne omówienie działania kopiowania.

Obsługiwane możliwości

Ten łącznik HubSpot jest obsługiwany w następujących funkcjach:

(1) Środowisko Azure Integration Runtime (2) Self-hosted Integration Runtime

Aby uzyskać listę magazynów danych obsługiwanych jako źródła/ujścia, zobacz tabelę Obsługiwane magazyny danych.

Usługa udostępnia wbudowany sterownik umożliwiający łączność, dlatego nie trzeba ręcznie instalować żadnego sterownika przy użyciu tego łącznika.

Łącznik obsługuje wersje systemu Windows w tym artykule.

Wprowadzenie

Aby wykonać działanie kopiowania za pomocą potoku, możesz użyć jednego z następujących narzędzi lub zestawów SDK:

• Narzędzie do kopiowania danych
• Portal Azure
• zestawu SDK platformy .NET
• Zestaw SDK dla języka Python
• Azure PowerShell
• API REST
• Szablon usługi Azure Resource Manager

Tworzenie połączonej usługi z usługą HubSpot przy użyciu interfejsu użytkownika

Wykonaj następujące kroki, aby utworzyć połączoną usługę z usługą HubSpot w interfejsie użytkownika witryny Azure Portal.

1. Przejdź do karty Zarządzanie w obszarze roboczym usługi Azure Data Factory lub Synapse i wybierz pozycję Połączone usługi, a następnie kliknij pozycję Nowy:

   • Azure Data Factory
   • Azure Synapse

   

2. Wyszukaj pozycję HubSpot i wybierz łącznik HubSpot.

   

3. Skonfiguruj szczegóły usługi, przetestuj połączenie i utwórz nową połączoną usługę.

   

Szczegóły konfiguracji łącznika

Poniższe sekcje zawierają szczegółowe informacje o właściwościach używanych do definiowania jednostek usługi Data Factory specyficznych dla łącznika HubSpot.

Właściwości połączonej usługi

Łącznik HubSpot obsługuje teraz wersję 2.0. Zapoznaj się z tą sekcją , aby uaktualnić wersję łącznika HubSpot z wersji 1.0. Aby uzyskać informacje szczegółowe dotyczące nieruchomości, zobacz odpowiednie sekcje.

• Wersja 2.0
• w wersji 1.0

Wersja 2.0

Połączona usługa HubSpot obsługuje następujące właściwości w przypadku zastosowania wersji 2.0:

Przykład:

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

Wersja 1.0

Połączona usługa HubSpot obsługuje następujące właściwości w przypadku zastosowania wersji 1.0:

Przykład:

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

Właściwości zestawu danych

Pełna lista sekcji i właściwości dostępnych do definiowania zestawów danych znajduje się w artykule dotyczącym zestawów danych. Ta sekcja zawiera listę właściwości obsługiwanych przez zestaw danych HubSpot.

Aby skopiować dane z usługi HubSpot, ustaw właściwość type zestawu danych na HubspotObject. Obsługiwane są następujące właściwości:

Przykład

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

Łącznik w wersji 2.0 obsługuje następujące tabele HubSpot:

• Marketing.Campaigns
• Marketing.E-maile.Marketingowe_E-maile
• Marketing.Subskrypcje
• Conversations.SkrzynkaOdbiorcza___Wiadomości
• CMS.Autorzy
• CMS.Blog_Settings
• CMS.Content_Audit
• CMS.Domeny
• CMS. Baza danych Hubdb
• CMS.Stron
• CMS.Posty
• CMS.Site_Search
• CMS tagi
• CMS.Url_Redirects
• CRM.Commerce.Carts
• CRM. Commerce.Discounts
• CRM. Commerce.Fees
• CRM.Commerce.Faktury
• CRM. Commerce.Orders
• CRM. Commerce.Quotes
• CRM.Commerce.Subscriptions
• CRM. Commerce.Taxes
• CRM. Zaangażowania. Rozmowy
• CRM. Engagements.Communications
• CRM.Zaangażowania.E-maile
• CRM.Zaangażowania.Spotkania
• CRM.Engagements.Notes
• CRM.Engagements.Poczta_Tradycyjna
• CRM.Zaangażowania.Zadania
• CRM.Objects.Companies
• CRM.Objects.Contacts
• CRM.Obiekty.Transakcje
• CRM. Objects.Feedback_Submissions
• CRM.Objects.Goal_Targets
• CRM.Objects.Leads
• CRM.Objects.Line_Items
• CRM.Objects.Products
• CRM. Objects.Tickets
• CRM.Właścicieli

Właściwości działania kopiowania

Aby uzyskać pełną listę sekcji i właściwości dostępnych do definiowania działań, zobacz artykuł Pipelines (Potoki ). Ta sekcja zawiera listę właściwości obsługiwanych przez źródło usługi HubSpot.

HubspotSource jako źródło

Aby skopiować dane z usługi HubSpot, ustaw typ źródła w działaniu kopiowania na wartość HubspotSource. Następujące właściwości są obsługiwane w sekcji źródło działania kopiowania:

Przykład:

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

Mapowanie typów danych dla usługi HubSpot

Podczas kopiowania danych z usługi HubSpot następujące mapowania są stosowane z typów danych usługi HubSpot do wewnętrznych typów danych używanych przez usługę. Aby dowiedzieć się, jak działanie kopiowania mapuje schemat źródłowy i typ danych na docelowy, zobacz Mapowanie schematu i typu danych.

Właściwości działania wyszukiwania

Aby dowiedzieć się więcej o właściwościach, sprawdź działanie Wyszukiwania.

Cykl życia i uaktualnianie łącznika HubSpot

W poniższej tabeli przedstawiono etap wydania i dzienniki zmian dla różnych wersji łącznika HubSpot:

Uaktualnianie łącznika HubSpot z wersji 1.0 do wersji 2.0

1. Na stronie Edytowanie połączonej usługi wybierz wersję 2.0 i skonfiguruj połączoną usługę, odwołując się do właściwości połączonej usługi w wersji 2.0.

2. Mapowanie typu danych dla połączonej usługi HubSpot w wersji 2.0 różni się od tego dla wersji 1.0. Aby dowiedzieć się więcej na temat najnowszego mapowania typów danych, zobacz Mapowanie typów danych dla usługi HubSpot.

3. query program jest obsługiwany tylko w wersji 1.0. Należy użyć elementu tableName zamiast query w wersji 2.0.

4. Należy pamiętać, że wersja 2.0 obsługuje określone tabele HubSpot. Aby uzyskać listę obsługiwanych tabel, przejdź do pozycji Właściwości zestawu danych.

Powiązana zawartość

Aby uzyskać listę magazynów danych obsługiwanych jako źródła i ujścia działania kopiowania, zobacz obsługiwane magazyny danych.