BètaJe HubSpot-gegevens ophalen vanuit Amazon Redshift

Gebruik ‘Data Out for Amazon Redshift’ om geselecteerde HubSpot CRM-gegevens te exporteren naar tabellen in een Amazon Redshift-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 in Redshift.
• HubSpot verwijdert de Parquet-bestanden die het in je S3-bucket opslaat niet. Om ze automatisch te verwijderen, stel je een S3-levenscyclusbeleid in voor de bucket of het prefix.
• Elk object, gebeurtenistype of associatiepaar kan worden opgenomen in één terugkerende Redshift Data Out-synchronisatie per HubSpot-account.
• Gevoelige gegevens worden nog niet ondersteund. Gevoelige eigenschappen kunnen worden uitgesloten van exporten.
• Objectspecifieke tabellen, zoals OBJECTS_CONTACTS, worden nog niet ondersteund.

Weet welke gegevens je kunt exporteren

Je kunt de volgende gegevens van HubSpot naar Amazon Redshift synchroniseren:

• 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 gebeurteniseigenschappen.

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.

Zorg dat je het exportformaat begrijpt

Tijdens de installatie kiest u:

• De Redshift-database en het cluster of de serverloze werkgroep waarin HubSpot tabellen zal aanmaken.
• De S3-bucket die HubSpot gebruikt om gegevens tijdelijk op te slaan voordat deze in Redshift worden geladen.
• De te synchroniseren gegevensbronnen: objecten, gebeurtenissen, koppelingen of een combinatie van deze bronnen.
• Het synchronisatieschema.

HubSpot exporteert de gegevens als Parquet-bestanden, plaatst de bestanden in je S3-bucket en laadt ze in Redshift-tabellen.

Let op: HubSpot verwijdert geen gegevens uit de tussenopslagbucket. Het wordt aanbevolen om een levenscyclusbeleid voor de bucket in te stellen om de bucket automatisch op te schonen.

Je gegevens vinden in Redshift

HubSpot maakt één tabel per gegevensbron aan in een door HubSpot beheerd schema dat is vernoemd naar uw bestemming:

<database>.hubspot_data_out_<destination-id>.<table-name>

Je kunt de schemanaam vinden op de configuratiepagina van je Redshift-synchronisatie. Bijvoorbeeld:

• 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

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

HubSpot plaatst Parquet-bestanden in uw S3-bucket onder een door HubSpot beheerd voorvoegsel en laadt ze vervolgens in Redshift:

s3://<bucket>/<prefix>/hubspot-dataout/<portal-id>/<destination-id>/<run-id>/<table-name>/

Deze tussenbestanden blijven in je bucket staan totdat je ze verwijdert. Om ze automatisch te verwijderen, configureer je een S3-levenscyclusbeleid voor de bucket of het voorvoegsel.

Let op: tabel- en kolomnamen zijn afkomstig uit de geëxporteerde gegevens. Ze kunnen worden ingekort om te voldoen aan de limiet van 127 tekens voor identificatiecodes in Redshift. Kolomtypen volgen de geëxporteerde gegevens.

Objecttabellen controleren

Als u 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 Amazon Redshift-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 wel of niet zijn geladen.
• Een tabel wordt pas bijgewerkt nadat HubSpot alle gegevens heeft geladen, zodat je nooit een gedeeltelijk geladen tabel te zien krijgt.
• Als een tabel mislukt, blijven de eerdere 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 run succesvol waren, worden niet gewijzigd wanneer een latere run mislukt.

Veelgestelde vragen

Hoe kan ik de gegevens opvragen?

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

Lees alle contactrecords:

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

Een specifieke eigenschap uit de JSON-kolom PROPERTIES ophalen:

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

Kan ik één gegevenstype in meerdere Redshift-synchronisaties exporteren?

Elk object, gebeurtenistype of associatiepaar kan per HubSpot-account in één terugkerende Redshift Data Out-synchronisatie worden opgenomen. Als contacten bijvoorbeeld al naar één terugkerende Redshift-bestemming zijn geëxporteerd, kun je geen contacten aan een andere terugkerende Redshift-synchronisatie toevoegen totdat je de eerste synchronisatie hebt gearchiveerd.

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 naar Redshift. Gevoelige eigenschappen kunnen worden uitgesloten van exporten.

Bewaar HubSpot eerdere momentopnames?

Nee. Bij elke synchronisatie wordt de doeltabel vervangen door de nieuwste snapshot, dus eerdere snapshots worden niet bewaard in Redshift. HubSpot verwijdert ook niet de tijdelijke Parquet-bestanden die het in je S3-bucket opslaat. Stel een S3-levenscyclusbeleid in om deze automatisch te laten verlopen.