BetaKäytä HubSpot-tietojasi Microsoft Azure Synapse Analyticsin kautta

Käytä Data Out for Azure Synapse -toimintoa viedäksesi valitut HubSpot CRM -tiedot taulukoihin, jotka sijaitsevat omistamassasi Azure Synapsen omistamassa SQL-poolissa. HubSpot päivittää jokaisen tulostustaulukon valittujen tietojen täydellisen viennin perusteella. Synkronoinnin jälkeen voit tehdä kyselyjä taulukoihin SQL:llä tai haluamillasi BI- ja analytiikkatyökaluilla yhdistääksesi HubSpot-tiedot muihin liiketoimintatietoihin.

Huomaa: jos olet pääkäyttäjä, liitä tilisiData Studio -beetaversioon, jottavoit käyttää tätä ominaisuutta.

Tutustu rajoituksiin ja huomioitaviin seikkoihin

Ennen kuin alat käyttää tätä ominaisuutta, varmista, että ymmärrät täysin, mitkä toimenpiteet on suoritettava etukäteen, sekä ominaisuuden rajoitukset ja sen käytön mahdolliset seuraukset.

• HubSpot päivittää taulukot erikseen. Jos teet kyselyn useista taulukoista synkronoinnin ollessa käynnissä, jotkut taulukot saattavat päivittyä ennen muita.
• Data Out ei tarjoa historiallisten tilannekuvien säilyttämistä. Onnistuneen päivityksen jälkeen kohdetaulukko sisältää viimeisimmän tilannekuvan.
• Jokainen objekti, tapahtumatyyppi tai assosiaatiopari voidaan sisällyttää yhteen toistuvaan Azure Synapse -synkronointiin HubSpot-tiliä kohden. Tämä rajoitus on riippumaton muista Data Out -palveluntarjoajista.
• Objektikohtaisia taulukoita, kuten OBJECTS_CONTACTS, ei vielä tueta.
• Jos kahden taulukon nimet ovat samat HubSpotin normalisoinnin jälkeen, kyseinen vienti epäonnistuu. Lisätietoja saat taulukko- ja sarakkeenimien säännöistä.

Tutustu viedäisiin tietoihin

Voit synkronoida seuraavat tiedot HubSpotista Azure Synapse Analyticsiin:

• Objektit ja tietueet: valitut vakio- ja mukautetut objektit sekä niiden tietueet, kuten yhteyshenkilöt, yritykset, kaupat, tiketit ja tuotteet.
• Ominaisuudet: valitut ominaisuusarvot ja ominaisuushistoria tietueissa.
• Yhteydet: valitut tietueiden väliset suhteet, mukaan lukien yhteysmääritelmät.
• Tapahtumat: valitut HubSpotin vakiotapahtumat ja mukautetut käyttäytymistapahtumat, mukaan lukien valitut tapahtumaominaisuudet.

Eri objektien tiedot yhdistetään objektitaulukoihin. Kun luet objektitaulukkoa, käytä OBJECTTYPEID suodattaaksesi tietyn objektin. Esimerkiksi yhteystiedoille käytetään 0-1. Mukautetuille objekteille annetaan tunnus niiden luomisen yhteydessä, ja ne tunnistetaan muodossa 2-{unique_id}, kuten 2-12345.

Tutustu vientimuotoon

Asennuksen aikana valitset:

• Kohde: Azure Synapsen oma SQL-päätelaite ja tietokanta.
• Synkronoitavat tietolähteet: objektit, tapahtumat, assosiaatiot tai näiden lähteiden yhdistelmä.
• Synkronointiaikataulu.

HubSpot luo väliaikaisen Parquet-vientitiedoston HubSpotin hallinnoimaan tallennustilaan ja kirjoittaa tulokset taulukoihin Azure Synapsen omistettuun SQL-pooliin. Sinun ei tarvitse määrittää tai hallinnoida väliaikaista tallennusbucketia.

Etsi tietosi Azure Synapsesta

HubSpot luo tulostustaulukot HubSpotin hallinnoimaan skeemaan kohteesi mukaan. HubSpot vie objektitiedot kolmeen tässä artikkelissa kuvattuun objektitaulukkoon. HubSpot luo myös yhden taulukon kutakin valittua tapahtumatyyppiä kohti ja, mikäli saatavilla, yhden parikohtaisen taulukon kutakin valittua assosiaatioparia kohti.

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

Tarkka skeeman nimi löytyy synkronoinnin määrityssivulta. Esimerkiksi:

• 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

Taulukko- ja sarakkeen nimet

HubSpot normalisoi viedyt taulukko- ja sarakkeen nimet isoiksi kirjaimiksi, numeroiksi ja alaviivoiksi:

• Välilyönnit ja yhdysviivat muuttuvat alaviivoiksi.
• Muut kuin aakkosnumeeriset merkit poistetaan.
• Yli 128 merkkiä pitkät nimet lyhennetään.
• Ristiriitaiset sarakkeiden nimet saavat jälkiliitteen.
• Ristiriitaiset taulukkotunnukset aiheuttavat kyseisen viennin epäonnistumisen.

Käytä hakusulkeita, kun teet kyselyjä tunnisteista, etenkin jos rakennat kyselyjä dynaamisesti. Tunnisteiden kirjainkoko riippuu Synapse-tietokannan lajittelusäännöstä. Esimerkiksi:

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

Saraketyypit

Saraketyypit noudattavat vietyjä tietoja ja vastaavat Azure Synapse -tyyppejä seuraavasti:

Huomaa: PROPERTIES taulukon OBJECT_WITH_OBJECT_PROPERTIES viedään JSON-muotoisena merkkijonona. Se tallennetaan NVARCHAR(MAX)-tyyppisenä, ei JSON-saraketyyppinä. Kyselyesimerkkejä on usein kysytyissä kysymyksissä.

Tarkista objektitaulukot

Jos valitset objektitietoja, HubSpot vie seuraavat taulukot.

OBJECT_PROPERTIES

Tämä taulukko sisältää yhden rivin kutakin ominaisuusarvoa kohti. Voit lukea tietyn objektin suodattamalla OBJECTTYPEID mukaan.

OBJECT_WITH_OBJECT_PROPERTIES

Tämä taulukko sisältää yhden rivin kutakin tietuetta kohti, ja valitut ominaisuusarvot on ryhmitelty yhteen PROPERTIES -sarakkeeseen. Voit lukea tietyn objektin suodattamalla OBJECTTYPEID mukaan.

OBJECT_PROPERTIES_HISTORY

Tämä taulukko sisältää ominaisuuksien muutoshistorian. Toisin kuin OBJECT_PROPERTIES, joka sisältää vain nykyisen arvon, tässä taulukossa on yksi rivi kutakin ominaisuuden historiallista arvoa kohden. Jos haluat nähdä yksittäisen tietueen ja ominaisuuden koko aikajanan, lajittele tulokset UPDATEDAT mukaan.

Tarkista assosiaatiotaulukot

Jos valitset assosiaatiotiedot, HubSpot vie assosiaatiotietueet ja assosiaatiomääritelmät.

ASSOCIATIONS

Tämä taulukko sisältää yhden rivin kutakin valittua kahden tietueen välistä assosiaatiota kohti.

ASSOCIATION_DEFINITIONS

Tämä taulukko sisältää yhden rivin kutakin valittua assosiaatiomääritelmää kohti.

ASSOCIATIONS_<FROM_OBJECT>_TO_<TO_OBJECT>

Valittujen liitosparien osalta HubSpot voi myös viedä parikohtaisia liitostaulukoita, kuten ASSOCIATIONS_CONTACTS_TO_COMPANIES. Nämä taulukot sisältävät liitostietueet sekä liitosten määritelmien metatiedot.

Tarkista tapahtumataulukot

Jos valitset tapahtumatietoja, HubSpot vie yhden taulukon kutakin tapahtumatyyppiä kohti. Taulukoiden nimet ovat muodossa EVENTS_<EVENT_NAME>, kuten EVENTS_VISITED_PAGE.

Jokainen tapahtumataulukko sisältää vakiotapahtumasarakkeet ja yhden sarakkeen kutakin valittua tapahtumaominaisuutta kohti.

Hallitse synkronointiaikataulua

Määrität synkronointiaikataulun HubSpotin asennuksen yhteydessä. Voit myös käynnistää synkronoinnin manuaalisesti HubSpotista. Jokainen synkronointikierros tuottaa täydellisen tilannekuvan valituista tiedoista. Voit hallita tietomäärää valitsemalla, mitkä objektit, tapahtumat, assosiaatiot ja ominaisuudet sisällytetään synkronointiin.

Huomaa: beetavaiheen aikana käytettävissä olevat synkronointivälejä voivat olla rajoitettuja. Lisää synkronointivälejä saatetaan lisätä tulevissa versioissa.

Synkronointien seuranta ja virheiden käsittely

Voit seurata Azure Synapse -synkronointeja HubSpotissa. Synkronoinnilla voi olla jokin seuraavista tiloista:

Kun synkronointi epäonnistuu:

• HubSpot näyttää tilan Epäonnistui ja tiedot siitä, mitkä taulukot onnistuivat ja mitkä epäonnistuivat.
• Jos taulukkoa ei voida päivittää, aiemmin onnistuneet tiedot pysyvät yleensä käytettävissä.
• Toistuvien synkronointien osalta seuraava ajoitettu synkronointi yrittää automaattisesti suorittaa täyden synkronoinnin uudelleen.
• Voit käynnistää synkronoinnin uudelleen manuaalisesti milloin tahansa HubSpotissa.

Usein kysytyt kysymykset

Miten voin tehdä kyselyjä dataan?

Kysele kohdeskeeman taulukoita SQL:llä. Lue esimerkiksi kaikki yhteystietotiedot:

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

Lue tietty ominaisuus PROPERTIES -JSON-merkkijonosta:

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

Voinko viedä yhtä tietotyyppiä useissa synkronoinneissa?

Jokainen objekti, tapahtumatyyppi tai assosiaatiopari voidaan sisällyttää yhteen toistuvaan Azure Synapse -synkronointiin HubSpot-tiliä kohden. Tämä rajoitus on riippumaton muista Data Out -palveluntarjoajista.

Esimerkiksi, jos yhteystiedot on jo viety toistuvaan Azure Synapse -kohteeseen, et voi lisätä yhteystietoja toiseen toistuvaan Azure Synapse -synkronointiin, ennen kuin olet arkistoinut ensimmäisen synkronoinnin. Voit kuitenkin viedä yhteystietoja samanaikaisesti toiseen tuettuun Data Out -palveluntarjoajaan.

Tuetaanko objektikohtaisia taulukoita?

Ei. Objektikohtaisia taulukoita, kuten OBJECTS_CONTACTS, ei vielä tueta. Käytä OBJECT_WITH_OBJECT_PROPERTIES ja suodata OBJECTTYPEID mukaan saadaksesi tietueet tietystä objektista.

Säilyttääkö HubSpot aiemmat tilannekuvat?

Ei. Data Out ei tarjoa historiallisten tilannekuvien säilyttämistä. Onnistuneen päivityksen jälkeen kohdetaulukko sisältää uusimman tilannekuvan. Jos taulukkoa ei voida päivittää, aiemmat onnistuneet tiedot ovat yleensä edelleen käytettävissä.