BètaHubSpot-gegevens exporteren naar PostgreSQL of MySQL

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

Samenvatting

Gebruik Data Out om geselecteerde HubSpot CRM-gegevens te exporteren naar een PostgreSQL- of MySQL-database die u beheert. U kunt object-, koppelings- en gebeurtenisgegevens synchroniseren met tabellen in uw database, waarna u de gegevens kunt opvragen met SQL of kunt gebruiken met uw business intelligence- en analysetools.

Elke synchronisatie maakt een volledige momentopname van de geselecteerde gegevens. Wanneer een synchronisatie slaagt, vervangt deze de vorige momentopname in de doeltabellen.

Voordat je aan de slag gaat

Zorg dat je de vereisten begrijpt

• Je PostgreSQL- of MySQL-database moet bereikbaar zijn vanuit de HubSpot-IP-bereiken voor de regio van je account.
• Je databaseserver moet SSL-verbindingen ondersteunen.
• Je moet beschikken over een databasegebruiker met de vereiste rechten:
  • PostgreSQL: CREATE -machtiging en schrijftoegang tot het doelschema.
  • MySQL: CREATE -toestemming voor de database en schrijftoegang.
• Zorg ervoor dat je databasegebruiker tabellen kan aanmaken en gegevens kan schrijven.
• Houd je HubSpot-account en databaseconsoles in aparte tabbladen geopend.

HubSpot-IP-adressen toestaan

Voeg het IP-bereik van HubSpot voor de regio van je account toe aan de toelatingslijst van je databaseserver.

Zorg dat u op de hoogte bent van de beperkingen en aandachtspunten

• Bij elke synchronisatie wordt een volledige momentopname van de geselecteerde gegevens gemaakt.
• Een succesvolle synchronisatie vervangt de vorige momentopname in de doeltabellen.
• HubSpot bewaart geen eerdere momentopnames.
• Als een tabel tijdens een synchronisatie mislukt, blijven de vorige gegevens beschikbaar tot de volgende succesvolle synchronisatie.
• Elk objecttype, gebeurtenistype of associatiepaar kan worden opgenomen in één terugkerende PostgreSQL-synchronisatie en één terugkerende MySQL-synchronisatie per account.
• Elke synchronisatie vervangt de doeltabel. Toegangsrechten of instellingen op tabelniveau die in je databaseprovider zijn toegevoegd, blijven niet behouden tussen synchronisaties.
• Als je opnieuw verbinding maakt met een andere databasegebruiker, moet je die gebruiker toegang verlenen tot bestaande, door HubSpot beheerde schema’s, databases of tabellen.

HubSpot koppelen aan PostgreSQL of MySQL

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Gegevensbeheer > Data Studio. Als Meer niet in je account verschijnt, navigeer dan direct naar Gegevensbeheer > Data Studio.
2. Klik rechtsboven op Externe gegevensbron verbinden.
3. Zoek in het paneel 'Een gegevensbron toevoegen' naar de databaseprovider of blader ernaar.
4. Klik op PostgreSQL of MySQL.
5. Voer de gegevens voor de databaseverbinding in:
   • Host
   • Poort
   • SSL
   • Gebruikersnaam
   • Wachtwoord
6. Voer voor PostgreSQL de naam in van de database waarin HubSpot het schema moet aanmaken.
7. Klik op 'Verbinden met PostgreSQL ' of 'Verbinden met MySQL'.

HubSpot gebruikt de gekoppelde databasegebruiker om tabellen aan te maken en gegevens in uw database te laden.

De synchronisatie configureren

1. Selecteer de gegevensbronnen die je wilt exporteren:
   • Objecten
   • Koppelingen
   • Gebeurtenissen
2. Selecteer de objecten, eigenschappen, koppelingen of gebeurtenissen die u wilt opnemen.
3. Kies hoe vaak de synchronisatie moet worden uitgevoerd en wanneer deze moet starten.
4. Klik op 'Synchronisatie starten'.

De beschikbare synchronisatiefrequenties kunnen tijdens de bètaperiode variëren. Mogelijke opties zijn: eenmalig, om de 6 uur, om de 12 uur, dagelijks, wekelijks of maandelijks.

Toegang tot uw geëxporteerde gegevens

HubSpot maakt voor elke bestemming een door HubSpot beheerd schema of een database aan.

PostgreSQL

PostgreSQL-tabellen gebruiken de volgende indeling:

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

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"

MySQL

MySQL-tabellen hebben de volgende indeling:

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

Bijvoorbeeld:

hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
hubspot_data_out_456.EVENTS_VISITED_PAGE
hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

U kunt de exacte schema- of databasenaam vinden op de synchronisatieconfiguratiepagina.

Tabel- en kolomnamen

Tabel- en kolomnamen zijn gebaseerd op de geëxporteerde gegevens. PostgreSQL-identificatoren mogen maximaal 63 tekens bevatten. MySQL-identificatoren mogen maximaal 64 tekens bevatten. Langere namen worden ingekort om binnen de geldende limiet te blijven.

HubSpot maakt PostgreSQL-tabellen en -kolommen aan met namen tussen aanhalingstekens, waarbij de hoofdlettergebruik behouden blijft. Gebruik bij het uitvoeren van query's in PostgreSQL dubbele aanhalingstekens en houd u aan het hoofdlettergebruik dat in de tabel- en kolomnaam wordt weergegeven.

Gebruik voor MySQL backticks en houd je aan de weergegeven hoofdlettergebruik. Of er bij tabelnamen onderscheid wordt gemaakt tussen hoofdletters en kleine letters, kan variëren afhankelijk van de configuratie van je MySQL-server.

Kolomtypen

De kolom PROPERTIES in de tabel OBJECT_WITH_OBJECT_PROPERTIES wordt opgeslagen als een tekenreeks in JSON-formaat. Deze wordt opgeslagen als TEXT in PostgreSQL en als LONGTEXT in MySQL, niet als een native JSON-kolomtype.

Objecttabellen

Als u objectgegevens selecteert, exporteert HubSpot de volgende tabellen.

OBJECT_PROPERTIES

Deze tabel bevat één rij voor elke waarde van een objecteigenschap.

OBJECT_WITH_OBJECT_PROPERTIES

Deze tabel bevat één rij voor elk objectrecord. Geselecteerde eigenschapswaarden worden gegroepeerd in de kolom PROPERTIES.

Objectgegevens voor verschillende objecttypen worden in deze tabel samengevoegd. Filter op OBJECTTYPEID om records voor een specifiek objecttype te bekijken.

• Contacten: 0-1
• Aangepaste objecten: 2-{unique_id}, bijvoorbeeld 2-12345

OBJECT_PROPERTIES_HISTORY

Deze tabel bevat de wijzigingsgeschiedenis van eigenschappen. Er is één rij voor elke historische waarde van een eigenschap.

Om de volledige geschiedenis voor een specifiek record en een specifieke eigenschap te bekijken, sorteert u de resultaten op UPDATEDAT.

Koppelingstabellen

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

ASSOCIATIONS

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

ASSOCIATION_DEFINITIONS

Deze tabel bevat één rij voor elke geselecteerde associatiedefinitie.

Koppelingsspecifieke tabellen

Voor geselecteerde koppelingsparen kan HubSpot ook tabellen exporteren in de volgende indeling:

ASSOCIATIONS_<FROM_OBJECT_TYPE>_TO_<TO_OBJECT_TYPE>

Bijvoorbeeld:

ASSOCIATIONS_CONTACTS_TO_COMPANIES

Deze tabellen bevatten associatierecords en metadata van associatiedefinities.

Gebeurtenistabellen

Als je gebeurtenisgegevens selecteert, exporteert HubSpot één tabel voor elk type gebeurtenis. De namen van gebeurtenistabellen hebben de volgende indeling:

EVENTS_<EVENT_NAME>

Bijvoorbeeld:

EVENTS_VISITED_PAGE

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

Uw synchronisatie controleren

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Gegevensbeheer > Gegevensintegratie. Als Meer niet in je account verschijnt, navigeer dan direct naar Gegevensbeheer > Gegevensintegratie.
2. Klik links op 'App-synchronisaties'.
3. Zoek de PostgreSQL- of MySQL-synchronisatie of selecteer deze.

Op de pagina met synchronisatiegegevens kunt u de synchronisatiestatus, het tijdstip van de laatste synchronisatie, fouten, synchronisatieactiviteit en de synchronisatiegeschiedenis bekijken. U kunt de synchronisatie ook pauzeren, archiveren of handmatig uitvoeren.

Synchronisatiestatus

Synchronisatiefouten oplossen

Wanneer een synchronisatie mislukt:

• De HubSpot-gebruikersinterface toont de status 'Mislukt' en details op tabelniveau die aangeven welke tabellen zijn geslaagd of mislukt.
• Een tabel wordt pas bijgewerkt nadat HubSpot alle gegevens ervan heeft geladen.
• Als een tabel mislukt, blijven de vorige gegevens behouden tot de volgende succesvolle synchronisatie.
• Bij de volgende geplande synchronisatie wordt automatisch opnieuw geprobeerd de volledige synchronisatie uit te voeren.
• Je kunt handmatig een synchronisatie uitvoeren vanaf de pagina met synchronisatiegegevens.

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

Veelgestelde vragen

Hoe kan ik de geëxporteerde gegevens opvragen?

Voer een query uit op de tabellen in het doelschema of de doeldatabase met SQL.

PostgreSQL

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

-- Read a property from the PROPERTIES column
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

-- Read all contact records
SELECT *
FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES`
WHERE `OBJECTTYPEID` = '0-1';

-- Read a property from the PROPERTIES column
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 objecttype, gebeurtenistype of associatiepaar kan per HubSpot-account in één terugkerende PostgreSQL-synchronisatie en één terugkerende MySQL-synchronisatie worden opgenomen.

Als contacten bijvoorbeeld al zijn geëxporteerd naar een terugkerende PostgreSQL-bestemming, kun je geen contacten toevoegen aan een andere terugkerende PostgreSQL-configuratie totdat je de eerste configuratie hebt gearchiveerd. Je kunt tegelijkertijd nog steeds contacten exporteren naar een terugkerende MySQL-configuratie.

Worden objectspecifieke tabellen ondersteund?

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

Wordt ‘Sensitive Data’ ondersteund?

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

Bewaar HubSpot eerdere momentopnames?

Nee. Bij elke succesvolle synchronisatie wordt de doeltabel vervangen door de nieuwste momentopname. HubSpot bewaart geen eerdere momentopnames.

Als een tabel tijdens een synchronisatie mislukt, blijven de eerdere gegevens behouden totdat die tabel met succes is bijgewerkt.

Gebruikt HubSpot een staging-bucket die ik beheer?

Nee. HubSpot exporteert de gegevens als Parquet en beheert de staging intern. U hoeft geen staging-bucket van de klant aan te leveren voor PostgreSQL of MySQL.

Wat gebeurt er als ik de databasegebruiker wijzig?

Als je opnieuw verbinding maakt met een andere databasegebruiker, moet je de nieuwe gebruiker toegang verlenen tot bestaande, door HubSpot beheerde schema's, databases of tabellen.