BètaKrijg toegang tot je HubSpot-gegevens vanuit PostgreSQL of MySQL

Gebruik ‘Data Out’ voor PostgreSQL en MySQL om geselecteerde HubSpot CRM-gegevens te exporteren naar tabellen in een database waarvan u de eigenaar bent. Bij elke synchronisatie wordt een volledige momentopname van de geselecteerde gegevens opgeslagen, waarmee de vorige momentopname wordt vervangen. Na de synchronisatie kunt u de tabellen doorzoeken met SQL of met uw favoriete BI- en analysetools om HubSpot-gegevens te combineren met andere bedrijfsgegevens.

Let op: als je een superbeheerder bent, moet je je account aanmelden voorde bètaversie van Data Studio om deze functie te kunnen gebruiken.

Beperkingen en aandachtspunten

Zorg ervoor dat je, voordat je met deze functie aan de slag gaat, volledig begrijpt welke stappen je van tevoren moet nemen, evenals de beperkingen van de functie en de mogelijke gevolgen van het gebruik ervan.

• Bij elke synchronisatie worden de doeltabellen vervangen door de meest recente momentopname. HubSpot bewaart geen eerdere momentopnames.
• Elk object, gebeurtenistype of koppelingspaar kan worden opgenomen in één terugkerende PostgreSQL-synchronisatie en één terugkerende MySQL-synchronisatie per HubSpot-account. Deze synchronisaties staan los van elkaar en van andere Data Out-providers.
• Gevoelige gegevens worden nog niet ondersteund. Gevoelige eigenschappen kunnen worden uitgesloten van exporten.
• Objectspecifieke tabellen, zoals OBJECTS_CONTACTS, worden nog niet ondersteund.
• Tabel- en kolomnamen zijn hoofdlettergevoelig in PostgreSQL en kunnen hoofdlettergevoelig zijn in MySQL. Controleer de query-syntaxis voordat u query's schrijft.

Weet welke gegevens je kunt exporteren

Je kunt de volgende gegevens van HubSpot synchroniseren met PostgreSQL of MySQL:

• Objecten: standaard- en aangepaste objecten, zoals contactpersonen, bedrijven, deals, tickets en producten.
• Records: afzonderlijke records voor de geselecteerde objecten.
• Eigenschappen: geselecteerde eigenschapswaarden en de eigenschapsgeschiedenis van records.
• Koppelingen: geselecteerde relaties tussen records, inclusief koppelingsdefinities.
• Gebeurtenissen: geselecteerde standaard HubSpot-gebeurtenissen en aangepaste gedragsgebeurtenissen, inclusief geselecteerde gebeurteniskenmerken.

Gegevens voor verschillende objecten worden gecombineerd in de objecttabellen. Wanneer je een objecttabel leest, gebruik je OBJECTTYPEID om op een specifiek object te filteren. Contacten gebruiken bijvoorbeeld 0-1. Aangepaste objecten krijgen bij het aanmaken een ID toegewezen en worden aangeduid als 2-{unique_id}, bijvoorbeeld 2-12345.

Begrijp het exportformaat

Tijdens de installatie kiest u:

• De doeldatabase. Dit geldt alleen voor PostgreSQL. Voor MySQL maakt HubSpot de database aan.
• De te synchroniseren gegevensbronnen: objecten, gebeurtenissen, koppelingen of een combinatie van deze bronnen.
• Het synchronisatieschema.

HubSpot exporteert de gegevens als Parquet-bestanden en laadt deze rechtstreeks in tabellen in je database. PostgreSQL en MySQL maken geen gebruik van een staging-bucket die eigendom is van de klant. HubSpot beheert de staging intern.

Vind je gegevens in je database

HubSpot maakt één tabel per gegevensbron aan in een door HubSpot beheerd schema dat is vernoemd naar je bestemming. Je kunt de exacte schemanaam vinden op de configuratiepagina van je synchronisatie.

• PostgreSQL: <database>.hubspot_data_out_<destination-id>.<table-name>
• MySQL: hubspot_data_out_<destination-id>.<table-name>. In MySQL zijn schema en database hetzelfde concept, en HubSpot maakt deze aan. Er is geen apart databaseniveau om te kiezen.

Bijvoorbeeld in PostgreSQL:

• your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• your_database.hubspot_data_out_456.EVENTS_VISITED_PAGE
• your_database.hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Bijvoorbeeld in MySQL:

• hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• hubspot_data_out_456.EVENTS_VISITED_PAGE
• hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Bij elke synchronisatie wordt de tabel vervangen door de meest recente snapshot. HubSpot bewaart geen eerdere snapshots. Als een tabel tijdens een synchronisatie mislukt, blijven de eerdere gegevens op hun plaats staan tot de volgende succesvolle synchronisatie.

Tabel- en kolomnamen

Tabel- en kolomnamen zijn afkomstig uit de geëxporteerde gegevens. PostgreSQL-identificatoren zijn beperkt tot 63 tekens en MySQL-identificatoren tot 64 tekens. HubSpot verkort langere namen zodat ze binnen de limiet passen.

Hoofdletters en kleine letters in identificatiecodes

Hoofdletters en kleine letters in identificatiecodes zijn van belang. HubSpot maakt alle tabellen en kolommen aan met namen tussen aanhalingstekens, waarbij de hoofdletters en kleine letters behouden blijven, in overeenstemming met de tabellen in dit artikel.

• PostgreSQL: zet namen precies zoals weergegeven tussen dubbele aanhalingstekens. PostgreSQL zet namen zonder aanhalingstekens om naar kleine letters, waardoor ze niet overeenkomen.
• MySQL: gebruik backticks en houd u aan de weergegeven hoofdlettergebruik. Of er bij tabelnamen onderscheid wordt gemaakt tussen hoofdletters en kleine letters, hangt af van uw serverconfiguratie.

PostgreSQL-voorbeeld:

SELECT * FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES" WHERE "OBJECTTYPEID" = '0-1';

MySQL-voorbeeld:

SELECT * FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES` WHERE `OBJECTTYPEID` = '0-1';

Kolomtypen

Kolomtypen volgen de geëxporteerde gegevens en worden als volgt toegewezen aan PostgreSQL- en MySQL-typen:

Let op: de kolom PROPERTIES in OBJECT_WITH_OBJECT_PROPERTIES wordt geëxporteerd als een tekenreeks in JSON-formaat. Deze wordt opgeslagen als TEXT in PostgreSQL of als LONGTEXT in MySQL, niet als een JSON-kolomtype. Zie de veelgestelde vragen voor voorbeelden van query's.

Objecttabellen bekijken

Als je objectgegevens selecteert, exporteert HubSpot de volgende tabellen.

OBJECT_PROPERTIES

Deze tabel bevat één rij per eigenschapswaarde. Om een specifiek object te lezen, filter je op OBJECTTYPEID.

OBJECT_WITH_OBJECT_PROPERTIES

Deze tabel bevat één rij per record, waarbij de geselecteerde eigenschapswaarden zijn gegroepeerd in één kolom PROPERTIES. Om een specifiek object te bekijken, filter je op OBJECTTYPEID.

OBJECT_PROPERTIES_HISTORY

Deze tabel bevat de wijzigingsgeschiedenis van eigenschappen. In tegenstelling tot OBJECT_PROPERTIES, die alleen de huidige waarde bevat, heeft deze tabel één rij voor elke historische waarde van een eigenschap. Om de volledige tijdlijn voor één record en eigenschap te bekijken, sorteer je op UPDATEDAT.

Koppelings tabellen bekijken

Als je associatiegegevens selecteert, exporteert HubSpot zowel associatierecords als associatiedefinities.

ASSOCIATIONS

Deze tabel bevat één rij per geselecteerde koppeling tussen twee records.

ASSOCIATION_DEFINITIONS

Deze tabel bevat één rij per geselecteerde koppelingsdefinitie.

ASSOCIATIONS_<FROM_OBJECT>_TO_<TO_OBJECT>

Voor geselecteerde koppelingsparen kan HubSpot ook paarspecifieke koppelingstabellen exporteren, zoals ASSOCIATIONS_CONTACTS_TO_COMPANIES. Deze tabellen bevatten koppelingsrecords samen met metadata van de koppelingsdefinitie.

Gebeurtenistabellen bekijken

Als je gebeurtenisgegevens selecteert, exporteert HubSpot één tabel per gebeurtenistype. Tabelnamen hebben de indeling EVENTS_<EVENT_NAME>, zoals EVENTS_VISITED_PAGE.

Elke gebeurtenistabel bevat standaardgebeurteniskolommen en één kolom voor elke geselecteerde gebeurteniseigenschap.

Het synchronisatieschema beheren

Je configureert het synchronisatieschema tijdens de installatie in HubSpot. Je kunt ook handmatig een nieuwe synchronisatie starten vanuit HubSpot. Elke synchronisatie levert een volledige momentopname van de geselecteerde gegevens op. Om het gegevensvolume te beperken, kies je welke objecten, gebeurtenissen, koppelingen en eigenschappen je wilt opnemen.

Let op: tijdens de bètaperiode is mogelijk slechts een beperkt aantal synchronisatiefrequenties beschikbaar, zoals eenmalig, om de 6 uur, om de 12 uur, dagelijks, wekelijks en maandelijks. In toekomstige releases kunnen er mogelijk extra frequentieopties worden toegevoegd.

Synchronisaties monitoren en fouten afhandelen

Je kunt PostgreSQL- en MySQL-synchronisaties in HubSpot controleren. Een synchronisatie kan een van de volgende statussen hebben:

Wanneer een synchronisatie mislukt:

• HubSpot geeft de status ‘Mislukt’ weer, met per tabel details die aangeven welke tabellen zijn geslaagd of mislukt.
• Een tabel wordt pas bijgewerkt nadat HubSpot alle gegevens ervan heeft geladen, dus je ziet nooit een gedeeltelijk geladen tabel.
• Als een tabel mislukt, blijven de vorige gegevens behouden tot de volgende succesvolle synchronisatie.
• Bij de volgende geplande synchronisatie wordt automatisch opnieuw geprobeerd om een volledige synchronisatie uit te voeren.
• Je kunt op elk moment in HubSpot handmatig een nieuwe synchronisatie starten.

Tabellen die bij een eerdere synchronisatie succesvol waren, worden niet gewijzigd wanneer een latere synchronisatie mislukt.

Veelgestelde vragen

Hoe kan ik de gegevens opvragen?

Voer met SQL query's uit op de tabellen in je doelschema.

PostgreSQL

Lees alle contactrecords:

SELECT * FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES" WHERE "OBJECTTYPEID" = '0-1';

Lees een specifieke eigenschap uit de JSON-kolom PROPERTIES. Converteer de kolom eerst naar JSON, omdat deze als tekst is opgeslagen:

SELECT "OBJECTID", json_extract_path_text("PROPERTIES"::json, 'email') AS email FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES" WHERE "OBJECTTYPEID" = '0-1';

MySQL

Lees alle contactrecords:

SELECT * FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES` WHERE `OBJECTTYPEID` = '0-1';

Een specifieke eigenschap uit de JSON-kolom PROPERTIES lezen:

SELECT `OBJECTID`, JSON_EXTRACT(`PROPERTIES`, '$.email') AS email FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES` WHERE `OBJECTTYPEID` = '0-1';

Kan ik één gegevenstype in meerdere synchronisaties exporteren?

Elk object, gebeurtenistype of associatiepaar kan per HubSpot-account worden opgenomen in één terugkerende PostgreSQL-synchronisatie en één terugkerende MySQL-synchronisatie. Deze synchronisaties staan los van elkaar en van andere Data Out-providers. Als contacten bijvoorbeeld al zijn geëxporteerd naar een terugkerende PostgreSQL-bestemming, kun je geen contacten toevoegen aan een andere terugkerende PostgreSQL-synchronisatie totdat je de eerste synchronisatie hebt gearchiveerd. Je kunt tegelijkertijd nog steeds contacten exporteren naar een terugkerende MySQL-synchronisatie.

Worden objectspecifieke tabellen ondersteund?

Nee. Objectspecifieke tabellen, zoals OBJECTS_CONTACTS, worden nog niet ondersteund. Gebruik OBJECT_WITH_OBJECT_PROPERTIES en filter op OBJECTTYPEID om records voor een specifiek object op te halen.

Worden gevoelige gegevens ondersteund?

Nee. Gevoelige gegevens worden nog niet ondersteund voor Data Out. Gevoelige eigenschappen kunnen worden uitgesloten van exporten.

Bewaar HubSpot eerdere momentopnames?

Nee. Bij elke synchronisatie wordt de doeltabel vervangen door de nieuwste momentopname, dus eerdere momentopnames worden niet bewaard.