Adatok másolása a HubSpotból az Azure Data Factory vagy a Synapse Analytics használatával

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

Ez a cikk azt ismerteti, hogyan használhatja a másolási tevékenységet egy Azure Data Factory- vagy Synapse Analytics-folyamatban az adatok HubSpotból való másolásához. A másolási tevékenység áttekintési cikkére épül, amely a másolási tevékenység általános áttekintését mutatja be.

Fontos

A HubSpot-összekötő 1.0-s verziója eltávolítási szakaszban van. Javasoljuk, hogy frissítse a HubSpot-összekötőt az 1.0-s verzióról a 2.0-s verzióra.

Támogatott képességek

Ez a HubSpot-összekötő a következő képességeket támogatja:

Támogatott képességek	integrációs modul
Copy tevékenység (forrás/-)	(1) (2)
Keresési tevékenység	(1) (2)

(1) Azure-integrációs modul (2) Saját üzemeltetésű integrációs modul

A forrásként/fogadóként támogatott adattárak listáját a Támogatott adattárak táblában találja.

A szolgáltatás egy beépített illesztőprogramot biztosít a kapcsolat engedélyezéséhez, ezért nem kell manuálisan telepítenie egyetlen illesztőprogramot sem ezzel az összekötővel.

Az összekötő a jelen cikkben szereplő Windows-verziókat támogatja.

Első lépések

A másolási tevékenység végrehajtásához egy folyamattal használhatja az alábbi eszközök vagy SDK-k egyikét:

Társított szolgáltatás létrehozása a HubSpothoz felhasználói felületen

Az alábbi lépésekkel létrehozhat egy társított szolgáltatást a HubSpothoz az Azure Portal felhasználói felületén.

Keresse meg az Azure Data Factory vagy a Synapse-munkaterület Kezelés lapját, és válassza a Társított szolgáltatások lehetőséget, majd kattintson az Új gombra:
- Azure Data Factory
- Azure Synapse
Keresse meg a HubSpotot, és válassza ki a HubSpot-összekötőt.
Konfigurálja a szolgáltatás részleteit, tesztelje a kapcsolatot, és hozza létre az új társított szolgáltatást.

Az összekötő konfigurációjának részletei

A következő szakaszok a HubSpot-összekötőre jellemző Data Factory-entitások meghatározásához használt tulajdonságok részleteit ismertetik.

Társított szolgáltatás tulajdonságai

A HubSpot-összekötő mostantól támogatja a 2.0-s verziót. Ebben a szakaszban a HubSpot-összekötő 1.0-s verziójáról frissíthet. A tulajdonság részleteiért tekintse meg a megfelelő szakaszokat.

2.0-s verzió
1.0-s verzió

2.0-s verzió

A HubSpot társított szolgáltatás a következő tulajdonságokat támogatja a 2.0-s verzió alkalmazásakor:

Tulajdonság	Leírás	Kötelező
típus	A típustulajdonságnak a következőnek kell lennie: Hubspot	Igen
verzió	A megadott verzió. Az érték `2.0`.	Igen
clientId	A HubSpot-alkalmazáshoz társított ügyfélazonosító. Ebből a cikkből megtudhatja, hogyan hozhat létre alkalmazást a HubSpotban.	Igen
clientSecret	A HubSpot-alkalmazáshoz társított ügyfélkód. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
accessToken	Az OAuth-integráció kezdeti hitelesítésekor kapott hozzáférési jogkivonat. Itt megtudhatja, hogyan szerezhet be hozzáférési jogkivonatot az ügyfélazonosítóval és a titkos kóddal. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
refreshToken	Az OAuth-integráció kezdeti hitelesítésekor beszerzett frissítési jogkivonat. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
connectVia	Az adattárhoz való csatlakozáshoz használt futtatókörnyezet. Ha nincs megadva érték, a tulajdonság az alapértelmezett Azure-integrációs modult használja.	Nem

Példa:

{
    "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-s verzió

A HubSpot társított szolgáltatás az 1.0-s verzió alkalmazásakor a következő tulajdonságokat támogatja:

Tulajdonság	Leírás	Kötelező
típus	A típustulajdonságnak a következőnek kell lennie: Hubspot	Igen
clientId	A HubSpot-alkalmazáshoz társított ügyfélazonosító. Ebből a cikkből megtudhatja, hogyan hozhat létre alkalmazást a HubSpotban.	Igen
clientSecret	A HubSpot-alkalmazáshoz társított ügyfélkód. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
accessToken	Az OAuth-integráció kezdeti hitelesítésekor kapott hozzáférési jogkivonat. Itt megtudhatja, hogyan szerezhet be hozzáférési jogkivonatot az ügyfélazonosítóval és a titkos kóddal. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
refreshToken	Az OAuth-integráció kezdeti hitelesítésekor beszerzett frissítési jogkivonat. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
useEncryptedEndpoints	Megadja, hogy az adatforrásvégpontok HTTPS használatával vannak-e titkosítva. Az alapértelmezett érték igaz.	Nem
useHostVerification	Megadja, hogy a kiszolgáló tanúsítványában szereplő gazdagépnévnek meg kell-e egyeznie a kiszolgáló gazdagépnevével, amikor TLS-en keresztül csatlakozik. Az alapértelmezett érték igaz.	Nem
usePeerVerification	Megadja, hogy ellenőrizze-e a kiszolgáló identitását, amikor TLS-en keresztül csatlakozik. Az alapértelmezett érték igaz.	Nem
connectVia	Az adattárhoz való csatlakozáshoz használt futtatókörnyezet. Ha nincs megadva érték, a tulajdonság az alapértelmezett Azure-integrációs modult használja.	Nem

Példa:

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

Adathalmaz tulajdonságai

Az adathalmazok meghatározásához elérhető szakaszok és tulajdonságok teljes listáját az adathalmazokról szóló cikkben találja. Ez a szakasz a HubSpot-adatkészlet által támogatott tulajdonságok listáját tartalmazza.

Ha adatokat szeretne másolni a HubSpotból, állítsa az adathalmaz típustulajdonságát a HubspotObject értékre. A következő tulajdonságok támogatottak:

Tulajdonság	Leírás	Kötelező
típus	Az adathalmaz típustulajdonságának a következőnek kell lennie: HubspotObject	Igen
tableName	A tábla neve. A 2.0-s verzió esetében a tábla `<HubSpot Category>.<Sub Category>.<Object Name>`neve például: `CRM.Commerce.Discounts`.	Igen a 2.0-s verzióhoz. Nem az 1.0-s verzióhoz (ha "lekérdezés" van megadva a tevékenységforrásban)

Példa

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

Az összekötő 2.0-s verziója a következő HubSpot-táblákat támogatja:

Marketing.Kampányok
Marketing.E-mailek.Marketing_Emails
Marketing.Előfizetések
Beszélgetések.Beérkező___Üzenetek
CMS.Szerzők
CMS.Blog_Settings
CMS.Content_Audit
CMS. Tartományok
CMS. Hubdb
CMS Oldalak
CMS. Bejegyzések
CMS.Site_Search
CMS. Címkék
CMS.Url_Redirects
CRM.Commerce.Carts
CRM. Commerce.Discounts
CRM. Commerce.Fees
CRM.Commerce.Számlák
CRM. Commerce.Orders
CRM. Commerce.Quotes
CRM.Commerce.Subscriptions
CRM. Commerce.Taxes
CRM.Engagements.Calls
CRM. Kapcsolatok.Kommunikációk
CRM. Kapcsolatok. E-mailek
CRM, Engagements, Meetingek
CRM.Engagements.Notes
CRM.Engagements.Postai_levél
CRM.Engagementek.Feladatok
CRM.Objects.Companies
CRM.Objects.Contacts
CRM.Objects.Deals
CRM.Objects.Visszajelzési_beküldések
CRM.Objects.Goal_Targets
CRM.Objects.Leads
CRM.Objects.Line_Items
CRM.Objects.Termékek
CRM. Objects.Tickets
CRM.Tulajdonosok

Másolási tevékenység tulajdonságai

A tevékenységek meghatározásához elérhető szakaszok és tulajdonságok teljes listáját a Folyamatok című cikkben találja. Ez a szakasz a HubSpot-forrás által támogatott tulajdonságok listáját tartalmazza.

HubspotSource mint forrás

Ha adatokat szeretne másolni a HubSpotból, állítsa be a másolási tevékenység forrástípusát a HubspotSource-ra. A másolási tevékenység forrás szakaszában a következő tulajdonságok támogatottak:

Tulajdonság	Leírás	Kötelező
típus	A másolási tevékenység forrásának típustulajdonságának a következőnek kell lennie: HubspotSource	Igen
lekérdezés	Az adatok olvasásához használja az egyéni SQL-lekérdezést. Például: `"SELECT * FROM Companies where Company_Id = xxx"`	Nem (ha "tableName" van megadva az adathalmazban)

Megjegyzés:

query a 2.0-s verzió nem támogatja.

Példa:

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

A HubSpot adattípus-leképezése

Amikor adatokat másol a HubSpotból, az alábbi leképezések érvényesek a HubSpot adattípusaiból a szolgáltatás által használt belső adattípusokra. Ha szeretné megtudni, hogyan képezi le a másolási tevékenység a forrássémát és az adattípust a célhelyre, tekintse meg a séma- és adattípus-leképezéseket.

HubSpot-adattípus	Köztes szolgáltatás adattípusa (a 2.0-s verzióhoz)	Köztes szolgáltatás adattípusa (1.0-s verzióhoz)
bool	logikai	logikai
Boolean	logikai	logikai
enumerálás	Lánc	Lánc
karakterlánc	Lánc	Lánc
object_coordinates	Lánc	Lánc
telefonszám	Lánc	Lánc
JSON formátum	Lánc	Lánc
date	DateTime	Nem támogatott.
datetime	DateTime	DateTime
szám	Decimal	Decimal
egész szám	Egész szám	Egész szám
objektum	Lánc	Nem támogatott.

Keresési tevékenység tulajdonságai

A tulajdonságok részleteinek megismeréséhez tekintse meg a keresési tevékenységet.

A HubSpot-összekötő életciklusa és frissítése

Az alábbi táblázat a HubSpot-összekötő különböző verzióinak kiadási fázisát és változásnaplóit mutatja be:

verzió	Kiadási fázis	Változások naplója
1.0-s verzió	Removed	Nem alkalmazható.
2.0-s verzió	Általános elérhetőség	• Az `tableName` érték `<HubSpot Category>.<Sub Category>.<Object Name>`például: `CRM.Commerce.Discounts`. • a dátum dátum/idő típusú adattípusként van beolvasva. • az objektum sztring adattípusként van beolvasva. •`useEncryptedEndpoints`, `useHostVerificationusePeerVerification` a társított szolgáltatás nem támogatja. • `query` nem támogatott. • Adott HubSpot-táblák támogatása. A támogatott táblalistában válassza az Adathalmaz tulajdonságai lehetőséget.

A HubSpot-összekötő frissítése az 1.0-s verzióról a 2.0-s verzióra

A Csatolt szolgáltatás szerkesztése lapon válassza ki a 2.0-s verziót, és konfigurálja a csatolt szolgáltatást a Csatolt szolgáltatás tulajdonságai 2.0-s verziójára hivatkozva.
A HubSpot társított szolgáltatás 2.0-s verziójának adattípus-leképezése eltér az 1.0-s verziótól. A legújabb adattípus-leképezés megismeréséhez tekintse meg a HubSpot adattípus-leképezését.
query csak az 1.0-s verzió támogatja. A tableName helyett a verzió 2.0-ban query-t kell használnia.
Vegye figyelembe, hogy a 2.0-s verzió bizonyos HubSpot-táblákat támogat. A támogatott táblalistában válassza az Adathalmaz tulajdonságai lehetőséget.

A másolási tevékenység által forrásként és fogadóként támogatott adattárak listáját a támogatott adattárakban találja.

Visszacsatolás

Hasznos volt ez az oldal?

Last updated on 2025-11-05

Megosztás:

Adatok másolása a HubSpotból az Azure Data Factory vagy a Synapse Analytics használatával

Támogatott képességek

Első lépések

Társított szolgáltatás létrehozása a HubSpothoz felhasználói felületen

Az összekötő konfigurációjának részletei

Társított szolgáltatás tulajdonságai

2.0-s verzió

1.0-s verzió

Adathalmaz tulajdonságai

Másolási tevékenység tulajdonságai

HubspotSource mint forrás

A HubSpot adattípus-leképezése

Keresési tevékenység tulajdonságai

A HubSpot-összekötő életciklusa és frissítése

A HubSpot-összekötő frissítése az 1.0-s verzióról a 2.0-s verzióra

Kapcsolódó tartalom

Visszacsatolás

További források