I betaEksporter HubSpot-data til PostgreSQL eller MySQL

Bemærk: Hvis du er superadministrator,skal du tilmelde din konto tilData Studio-betaversionen for at kunne bruge denne funktion.

Oversigt

Brug Data Out til at eksportere udvalgte HubSpot CRM-data til en PostgreSQL- eller MySQL-database, som du administrerer. Du kan synkronisere objekt-, tilknytnings- og begivenhedsdata til tabeller i din database og derefter forespørge dataene med SQL eller bruge dem med dine business intelligence- og analyseværktøjer.

Hver synkronisering opretter et fuldstændigt øjebliksbillede af de valgte data. Når en synkronisering lykkes, erstatter den det forrige øjebliksbillede i måltabellerne.

Før du går i gang

Forstå kravene

• Din PostgreSQL- eller MySQL-database skal være tilgængelig fra de HubSpot-IP-intervaller, der gælder for din kontoregion.
• Din databaseserver skal understøtte SSL-forbindelser.
• Du skal have en databasebruger med de nødvendige tilladelser:
  • PostgreSQL: CREATE -tilladelse og skriveadgang til målskemaet.
  • MySQL: CREATE -tilladelse til databasen og skriveadgang.
• Sørg for, at din databasebruger kan oprette tabeller og skrive data.
• Hold din HubSpot-konto og databasekonsollerne åbne i separate faner.

Tillad HubSpot-IP-adresser

Føj HubSpots IP-interval for din kontoregion til din databaseservers tilladelsesliste.

Forstå begrænsninger og overvejelser

• Hver synkronisering opretter et fuldstændigt øjebliksbillede af de valgte data.
• En vellykket synkronisering erstatter det forrige øjebliksbillede i måltabellerne.
• HubSpot gemmer ikke tidligere øjebliksbilleder.
• Hvis en tabel fejler under en synkronisering, forbliver de tidligere data tilgængelige indtil den næste vellykkede synkronisering.
• Hver objekttype, begivenhedstype eller tilknytningspar kan inkluderes i én tilbagevendende PostgreSQL-synkronisering og én tilbagevendende MySQL-synkronisering pr. konto.
• Hver synkronisering erstatter destinationstabellen. Tilladelser eller indstillinger på tabelniveau, der er tilføjet i din databaseudbyder, bevares ikke mellem synkroniseringerne.
• Hvis du opretter forbindelse igen med en anden databasebruger, skal du give denne bruger adgang til eksisterende HubSpot-administrerede skemaer, databaser eller tabeller.

Forbind HubSpot til PostgreSQL eller MySQL

1. Klik på Mere på din HubSpot-konto, og navigér derefter til Datastyring > Data Studio. Hvis Mere ikke vises på din konto, skal du navigere direkte til Datastyring > Data Studio.
2. Klik på Tilslut ekstern datakilde øverst til højre.
3. I panelet Tilføj en datakilde skal du søge efter eller navigere til databaseudbyderen.
4. Klik på PostgreSQL eller MySQL.
5. Indtast oplysningerne om databaseforbindelsen:
   • Vært
   • Port
   • SSL
   • Brugernavn
   • Adgangskode
6. For PostgreSQL skal du indtaste navnet på den database, hvor HubSpot skal oprette skemaet.
7. Klik på Opret forbindelse til PostgreSQL eller Opret forbindelse til MySQL.

HubSpot bruger den tilknyttede databasebruger til at oprette tabeller og indlæse data i din database.

Konfigurer synkroniseringen

1. Vælg de datakilder, der skal eksporteres:
   • Objekter
   • Forbindelser
   • Begivenheder
2. Vælg de objekter, egenskaber, tilknytninger eller begivenheder, der skal medtages.
3. Vælg, hvor ofte synkroniseringen skal køre, og hvornår den skal startes.
4. Klik på Start synkronisering.

De tilgængelige synkroniseringsfrekvenser kan variere under betafasen. Valgmulighederne kan omfatte én gang, hver 6. time, hver 12. time, dagligt, ugentligt eller månedligt.

Få adgang til dine eksporterede data

HubSpot opretter et HubSpot-administreret skema eller en database for hver destination.

PostgreSQL

PostgreSQL-tabeller bruger følgende format:

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

For eksempel:

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-tabeller bruger følgende format:

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

For eksempel:

hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
hubspot_data_out_456.EVENTS_VISITED_PAGE
hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Du kan finde det nøjagtige skema eller databasenavnet på siden med synkroniseringsindstillinger.

Tabel- og kolonnenavne

Tabel- og kolonnenavne er baseret på de eksporterede data. PostgreSQL-identifikatorer kan indeholde op til 63 tegn. MySQL-identifikatorer kan indeholde op til 64 tegn. Længere navne forkortes, så de passer til den gældende grænse.

HubSpot opretter PostgreSQL-tabeller og -kolonner med navne i anførselstegn, hvor store og små bogstaver bevares. Når du forespørger PostgreSQL, skal du bruge dobbelte anførselstegn og overholde den store og små bogstaver, der vises i tabellens og kolonnens navn.

For MySQL skal du bruge backticks og overholde den viste brug af store og små bogstaver. Om der skelnes mellem store og små bogstaver i tabelnavne, kan variere afhængigt af din MySQL-serverkonfiguration.

Kolonnetyper

Kolonnen PROPERTIES i tabellen OBJECT_WITH_OBJECT_PROPERTIES gemmes som en streng i JSON-format. Den gemmes som TEXT i PostgreSQL og LONGTEXT i MySQL, ikke som en indbygget JSON-kolonnetype.

Objekttabeller

Hvis du vælger objektdata, eksporterer HubSpot følgende tabeller.

OBJECT_PROPERTIES

Denne tabel indeholder én række for hver objekt-egenskabsværdi.

OBJECT_WITH_OBJECT_PROPERTIES

Denne tabel indeholder én række for hver objektpost. De valgte egenskabsværdier er grupperet i kolonnen PROPERTIES.

Objektdata for forskellige objekttyper samles i denne tabel. Filtrer efter OBJECTTYPEID for at se poster for en bestemt objekttype.

• Kontakter: 0-1
• Brugerdefinerede objekter: 2-{unique_id}, f.eks. 2-12345

OBJECT_PROPERTIES_HISTORY

Denne tabel indeholder historikken over ændringer i egenskaber. Den indeholder én række for hver historisk værdi af en egenskab.

For at se den fulde historik for en bestemt post og egenskab skal du sortere resultaterne efter UPDATEDAT.

Associeringstabeller

Hvis du vælger tilknytningsdata, eksporterer HubSpot tilknytningsposter og tilknytningsdefinitioner.

ASSOCIATIONS

Denne tabel indeholder én række for hver valgt tilknytning mellem to poster.

ASSOCIATION_DEFINITIONS

Denne tabel indeholder én række for hver valgt tilknytningsdefinition.

Par-specifikke tilknytningstabeller

For udvalgte forbindelsespare kan HubSpot også eksportere tabeller i følgende format:

ASSOCIATIONS_<FROM_OBJECT_TYPE>_TO_<TO_OBJECT_TYPE>

For eksempel:

ASSOCIATIONS_CONTACTS_TO_COMPANIES

Disse tabeller indeholder associeringsposter og metadata om associeringsdefinitioner.

Begivenhedstabeller

Hvis du vælger begivenhedsdata, eksporterer HubSpot én tabel for hver begivenhedstype. Navnene på begivenhedstabellerne følger dette format:

EVENTS_<EVENT_NAME>

For eksempel:

EVENTS_VISITED_PAGE

Hver begivenhedstabel indeholder standardbegivenhedskolonner og én kolonne for hver valgt begivenhedsegenskab.

Overvåg din synkronisering

1. Klik på Mere på din HubSpot-konto, og navigér derefter til Datastyring > Dataintegration. Hvis Mere ikke vises på din konto, skal du navigere direkte til Datastyring > Dataintegration.
2. Klik på App-synkroniseringer til venstre.
3. Søg efter eller vælg PostgreSQL- eller MySQL-synkroniseringen.

Fra siden med synkroniseringsoplysninger kan du se synkroniseringsstatus, tidspunkt for sidste synkronisering, fejl, synkroniseringsaktivitet og synkroniseringshistorik. Du kan også sætte synkroniseringen på pause, arkivere den eller køre den manuelt.

Synkroniseringsstatusser

Løs synkroniseringsfejl

Når en synkronisering mislykkes:

• HubSpot-brugergrænsefladen viser statusen " Mislykket " samt detaljer på tabelniveau, der angiver, hvilke tabeller der lykkedes eller mislykkedes.
• En tabel opdateres først, når HubSpot er færdig med at indlæse alle dens data.
• Hvis en tabel mislykkes, forbliver de tidligere data på plads indtil den næste vellykkede synkronisering.
• Den næste planlagte synkronisering forsøger automatisk at udføre den fulde synkronisering igen.
• Du kan køre en synkronisering manuelt fra siden med synkroniseringsdetaljer.

Tabeller, der blev synkroniseret korrekt under en tidligere kørsel, ændres ikke, når en senere kørsel mislykkes.

Ofte stillede spørgsmål

Hvordan forespørger jeg de eksporterede data?

Forespørg tabellerne i destinationsskemaet eller -databasen med 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 jeg eksportere én datatype i flere synkroniseringer?

Hver objekttype, begivenhedstype eller associeringspar kan inkluderes i én tilbagevendende PostgreSQL-synkronisering og én tilbagevendende MySQL-synkronisering pr. HubSpot-konto.

Hvis kontakter f.eks. allerede er eksporteret til en tilbagevendende PostgreSQL-destination, kan du ikke tilføje kontakter til en anden tilbagevendende PostgreSQL-konfiguration, før du arkiverer den første konfiguration. Du kan stadig eksportere kontakter til en tilbagevendende MySQL-konfiguration på samme tid.

Understøttes objektspecifikke tabeller?

Objektspecifikke tabeller, såsom OBJECTS_CONTACTS, understøttes ikke i øjeblikket. Brug OBJECT_WITH_OBJECT_PROPERTIES og filtrer efter OBJECTTYPEID for at hente poster for en bestemt objekttype.

Understøttes følsomme data?

Følsomme data understøttes i øjeblikket ikke til Data Out. Følsomme egenskaber kan udelades fra eksport.

Gemmer HubSpot tidligere snapshots?

Nej. Hver vellykket synkronisering erstatter destinationstabellen med det seneste øjebliksbillede. HubSpot gemmer ikke tidligere øjebliksbilleder.

Hvis en tabel fejler under en synkronisering, forbliver de tidligere data på plads, indtil tabellen er blevet opdateret korrekt.

Bruger HubSpot en staging-bucket, som jeg administrerer?

Nej. HubSpot eksporterer dataene som Parquet og administrerer mellemopbevaringen internt. Du behøver ikke at stille en kundejet mellemopbevaringsbucket til rådighed for PostgreSQL eller MySQL.

Hvad sker der, hvis jeg skifter databasebruger?

Hvis du opretter forbindelse igen med en anden databasebruger, skal du give den nye bruger adgang til eksisterende HubSpot-administrerede skemaer, databaser eller tabeller.