BetaVie HubSpot-tiedot Microsoft Fabriciin

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

Käytä Data Out -toimintoa viedäksesi valitut HubSpot CRM -tiedot omistamasi Microsoft Fabric Warehouse -tietovaraston natiivitabeleihin. Voit synkronoida objekti-, assosiaatio- ja tapahtumatiedot tietovarastosi taulukoihin ja sitten tehdä kyselyjä näihin tietoihin SQL:llä tai käyttää niitä liiketoimintatiedon hallinta- ja analyysityökaluissasi.

Jokainen synkronointi luo täydellisen tilannekuvan valituista tiedoista. Kun synkronointi onnistuu, se korvaa edellisen tilannekuvan kohdetabeleissa.

Ennen kuin aloitat

Tutustu vaatimuksiin

Tietojen viemiseksi Microsoft Fabric -tietovarastoon tarvitset seuraavaa:

• Microsoft Fabric -työtila, jossa on Fabric Warehouse
• Fabric-työtilaan lisätty Microsoft Entra ID -palvelun pääkäyttäjä, jolla on Contributor-rooli
• Palvelun pääkäyttäjän vuokralais-ID, asiakas-ID ja asiakassalaisuus
• Fabric-tietovarastosi SQL-yhteysmerkkijono (palvelimen osoite ilman porttinumeroa) ja tietovaraston nimi

Microsoft Entra ID -palvelun pääkäyttäjällä on oltava oikeus luoda ja hallita HubSpotin omistamia objekteja kohde-Fabric-tietovarastossa. Yhteyden vahvistuksen ja synkronointien aikana HubSpot luo skeemoja ja taulukoita, lisää tietoja, nimeää väliaikaiset taulukot uudelleen ja poistaa väliaikaisia objekteja. Myönnä palvelun pääkäyttäjälle Contributor-rooli Fabric-työtilassa, jotta HubSpot voi:

• Luo skeemat
• Luo taulukoita
• Lisää rivejä
• Nimeä uudelleen tai muokkaa HubSpotin omistamia taulukoita
• Poista HubSpotin omistamat taulukot ja skeemat

HubSpotin on voitava tavoittaa Fabric Warehouse -tietovaraston SQL-päätelaitteesi TCP-portin 1433 kautta. HubSpot käyttää TLS:ää kaikissa yhteyksissä ja tarkistaa palvelinsertifikaatin.

Jos Fabric-työtilasi rajoittaa verkkoyhteyksiä, lisää tilisi alueen HubSpotin lähtevät IP-osoitteet sallittujen luetteloon.

Tutustu rajoituksiin ja huomioitaviin seikkoihin

• Microsoft Fabric Data Out tukee vain Fabric-varastoja. Lakehouse-varastoja ei tueta.
• Jokainen synkronointi luo täydellisen tilannekuvan valituista tiedoista. Onnistunut synkronointi korvaa edellisen tilannekuvan kohdetabeleissa. HubSpot ei säilytä aiempia tilannekuvia. Jos taulukon synkronointi epäonnistuu, sen aiemmat tiedot pysyvät käytettävissä seuraavaan onnistuneeseen synkronointiin asti.
• Jokainen objektityyppi, tapahtumatyyppi tai assosiaatiopari voidaan sisällyttää yhteen toistuvaan Microsoft Fabric -synkronointiin tiliä kohden.
• Jokainen synkronointi korvaa kohdetabelin. Fabric Warehouseen lisätyt taulukoiden tason käyttöoikeudet tai asetukset eivät säily synkronointien välillä.
• Yhteyden muodostaminen uudelleen eri palvelun pääkäyttäjän kanssa edellyttää, että kyseinen palvelun pääkäyttäjä lisätään Fabric-työtilaan Contributor-roolilla, ennen kuin yhteystesti tai synkronointi voi onnistua.

Yhdistä HubSpot Microsoft Fabric -palveluun

On suositeltavaa pitää HubSpot-tilisi ja Microsoft Fabric -konsolit auki erillisissä välilehdissä.

1. Napsauta HubSpot-tilissäsi Lisää ja siirry sitten kohtaan Tietojenhallinta > Data Studio. Jos Lisää-kohtaa ei näy tilissäsi, siirry suoraan kohtaan Tietojenhallinta > Data Studio.
2. Napsauta oikeassa yläkulmassa kohtaa Yhdistä ulkoinen tietolähde.
3. Etsi tai selaa Lisää tietolähde -paneelissa Microsoft Fabric.
4. Napsauta Asenna ja sitten Seuraava.
5. Syötä palvelun pääkäyttäjän Tenant ID, Client ID ja Client secret.
6. Syötä seuraavat kohdetiedot:
   • SQL-yhteysmerkkijono: Fabric Warehouse -palvelimesi osoite ilman porttinumeroa.
   • Varaston nimi: sen Fabric-varaston nimi, johon vienti tehdään.
7. Napsauta Testaa yhteys. Jos yhteystesti onnistuu, napsauta Seuraava.

Huomaa: varmista Fabric-työtilassasi, että HubSpot-palvelun pääkäyttäjällä on Contributor-rooli, ennen kuin suoritat yhteystestin. Pääsyn määrittämiseen ei tarvita SQL-skriptejä.

Määritä synkronointi

1. Valitse vietävät tietolähteet:
   • Objektit
   • Yhteydet
   • Tapahtumat
2. Valitse mukaan otettavat objektit, ominaisuudet, assosiaatiot tai tapahtumat.
3. Valitse, kuinka usein synkronointi suoritetaan ja milloin se aloitetaan.
4. Napsauta Aloita synkronointi.

Käytettävissä olevat synkronointivälit voivat vaihdella beta-vaiheen aikana. Vaihtoehtoja voivat olla kerran, 6 tunnin välein, 12 tunnin välein, päivittäin, viikoittain tai kuukausittain.

Käytä vietyjä tietojasi

HubSpot luo jokaiselle kohteelle HubSpotin hallinnoiman skeeman. Taulukot noudattavat seuraavaa muotoa:

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

Esimerkki:

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

Tarkka skeeman nimi löytyy synkronoinnin asetussivulta.

Taulukoiden ja sarakkeiden nimet

HubSpot muuntaa viedyt taulukko- ja sarakkeen nimet isojen kirjainten, numeroiden ja alaviivojen muotoon:

• Välilyönnit ja tavuviivat 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.

Saraketyypit

PROPERTIES taulukon OBJECT_WITH_OBJECT_PROPERTIES sarake tallennetaan JSON-muotoisena merkkijonona VARCHAR(MAX)-tyyppisenä, ei natiivina JSON-saraketyyppinä. Katso kyselyesimerkit alla olevista usein kysytyistä kysymyksistä.

Objektitaulukot

Jos valitset objektitietoja, HubSpot vie seuraavat taulukot.

OBJECT_PROPERTIES

Tämä taulukko sisältää yhden rivin jokaiselle objektin ominaisuusarvolle.

OBJECT_WITH_OBJECT_PROPERTIES

Tämä taulukko sisältää yhden rivin jokaisesta objektitietueesta. Valitut ominaisuusarvot on ryhmitelty PROPERTIES -sarakkeeseen.

Eri objektityyppien objektitiedot yhdistetään tässä taulukossa. Suodata OBJECTTYPEID mukaan, jos haluat lukea tietueita tietystä objektityypistä:

• Yhteystiedot: 0–1
• Mukautetut objektit: 2-{unique_id}, esimerkiksi 2-12345

OBJECT_PROPERTIES_HISTORY

Tämä taulukko sisältää ominaisuuksien muutoshistorian. Se sisältää yhden rivin jokaiselle ominaisuuden historialliselle arvolle.

Voit tarkastella tietyn tietueen ja ominaisuuden koko historiaa lajittelemalla tulokset UPDATEDAT mukaan.

Yhdistämistaulukot

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

ASSOCIATIONS

Tämä taulukko sisältää yhden rivin jokaiselle valitulle kahden tietueen väliselle assosiaatiolle.

ASSOCIATION_DEFINITIONS

Tämä taulukko sisältää yhden rivin jokaiselle valitulle assosiaatiomääritelmälle.

Parikohtaiset assosiaatiotaulukot

Valittujen yhdistelmäparien osalta HubSpot voi myös viedä taulukoita seuraavassa muodossa:

ASSOCIATIONS_<FROM_OBJECT_TYPE>_TO_<TO_OBJECT_TYPE>

Esimerkiksi: ASSOCIATIONS_CONTACTS_TO_COMPANIES

Nämä taulukot sisältävät assosiaatiotietueita ja assosiaatiomääritelmien metatietoja.

Tapahtumataulukot

Jos valitset tapahtumatiedot, HubSpot vie yhden taulukon kutakin tapahtumatyyppiä kohti. Tapahtumataulukoiden nimet noudattavat seuraavaa muotoa:

EVENTS_<EVENT_NAME>

Esimerkiksi: EVENTS_VISITED_PAGE

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

Seuraa synkronointia

1. Napsauta HubSpot-tilissäsi Lisää ja siirry sitten kohtaan Tietojenhallinta > Data Studio. Jos Lisää-kohtaa ei näy tilissäsi, siirry suoraan kohtaan Tietojenhallinta > Data Studio.
2. Napsauta vasemmalla puolella kohtaa Sovellusten synkronointi.
3. Etsi tai valitse Microsoft Fabric -synkronointi.

Synkronoinnin tietosivulta voit tarkastella synkronoinnin tilaa, viimeisintä synkronointiaikaa, virheitä, synkronointitoimintaa ja synkronointihistoriaa. Voit myös keskeyttää, arkistoida tai suorittaa synkronoinnin manuaalisesti.

Synkronointitilat

Synkronointiongelmien ratkaiseminen

Kun synkronointi epäonnistuu:

• HubSpotin käyttöliittymässä näkyy tila Epäonnistui sekä taulukotason tiedot, joista käy ilmi, mitkä taulukot onnistuivat ja mitkä epäonnistuivat.
• Taulukko päivitetään vasta, kun HubSpot on ladannut kaikki sen tiedot. Jos taulukon synkronointi epäonnistuu, sen aiemmat tiedot säilyvät ennallaan seuraavaan onnistuneeseen synkronointiin asti.
• Seuraava ajoitettu synkronointi yrittää automaattisesti koko synkronointia uudelleen.
• Voit suorittaa synkronoinnin manuaalisesti synkronoinnin tietosivulta.

Usein kysytyt kysymykset

Miten voin tehdä kyselyjä vietyihin tietoihin?

Kysele kohdeskeeman taulukoita SQL:llä.

-- Read all contact records
SELECT *
FROM [your_database].[hubspot_data_out_456].[OBJECT_WITH_OBJECT_PROPERTIES]
WHERE [OBJECTTYPEID] = '0-1'; -- Read a specific property from the PROPERTIES JSON string
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 objektityyppi, tapahtumatyyppi tai assosiaatiopari voidaan sisällyttää yhteen toistuvaan Microsoft Fabric -synkronointiin HubSpot-tiliä kohden. Tämä on riippumaton muista Data Out -palveluntarjoajista.

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

Tuetaanko objektikohtaisia taulukoita?

Objektikohtaisia taulukoita, kuten OBJECTS_CONTACTS, ei tällä hetkellä tueta. Käytä OBJECT_WITH_OBJECT_PROPERTIES ja suodata OBJECTTYPEID mukaan, kun haluat hakea tietueita tietyn objektityypin osalta.

Tuetaanko arkaluonteisia tietoja?

Herkkiä tietoja ei tällä hetkellä tueta Data Out -toiminnossa. Herkät ominaisuudet voidaan jättää pois viennistä.

Säilyttääkö HubSpot aiemmat tilannekuvat?

Ei. Jokainen onnistunut synkronointi korvaa kohdetaulukon uusimmalla tilannekuvalla. HubSpot ei säilytä aiempia tilannekuvia. Jos taulukon synkronointi epäonnistuu, sen aiemmat tiedot säilyvät paikallaan, kunnes taulukko päivitetään onnistuneesti.

Käyttääkö HubSpot minun hallinnoimaani väliaikaista tallennustilaa?

Ei. HubSpot luo väliaikaisen Parquet-vienti-tiedoston HubSpotin hallinnoimaan tallennustilaan ja tallentaa tulokset Fabric Warehouseen. Sinun ei tarvitse tarjota tai hallinnoida väliaikaista tallennustilaa.

Mitä tapahtuu, jos muodostan yhteyden uudelleen eri palvelun pääkäyttäjällä?

Jos muodostat yhteyden uudelleen eri palvelun pääkäyttäjällä, sinun on lisättävä kyseinen palvelun pääkäyttäjä Fabric-työtilaan Contributor-roolilla, ennen kuin yhteystesti tai synkronointi onnistuu.