Wersja betaUzyskaj dostęp do danych HubSpot z bazy PostgreSQL lub MySQL

Skorzystaj z funkcji „Data Out” dla PostgreSQL i MySQL, aby wyeksportować wybrane dane z HubSpot CRM do tabel w bazie danych, której jesteś właścicielem. Każda synchronizacja zapisuje pełną kopię wybranych danych i zastępuje poprzednią kopię. Po zakończeniu synchronizacji możesz wysyłać zapytania do tabel za pomocą języka SQL lub preferowanych narzędzi BI i analitycznych, aby połączyć dane z HubSpot z innymi danymi biznesowymi.

Uwaga: jeśli jesteś superadministratorem, włącz swoje konto dowersji beta Data Studio, aby korzystać z tej funkcji.

Zapoznaj się z ograniczeniami i kwestiami, które należy wziąć pod uwagę

Przed rozpoczęciem pracy z tą funkcją upewnij się, że w pełni rozumiesz, jakie kroki należy podjąć z wyprzedzeniem, a także jakie są ograniczenia tej funkcji i potencjalne konsekwencje jej użycia.

• Każda synchronizacja zastępuje tabele docelowe najnowszą migawką. HubSpot nie przechowuje poprzednich migawek.
• Każdy obiekt, typ zdarzenia lub para powiązań może zostać uwzględniony w jednej cyklicznej synchronizacji PostgreSQL i jednej cyklicznej synchronizacji MySQL na konto HubSpot. Synchronizacje te są niezależne od siebie oraz od innych dostawców usługi Data Out.
• Dane wrażliwe nie są jeszcze obsługiwane. Właściwości wrażliwe można wykluczyć z eksportów.
• Tabele specyficzne dla obiektów, takie jak OBJECTS_CONTACTS, nie są jeszcze obsługiwane.
• W PostgreSQL w nazwach tabel i kolumn rozróżniana jest wielkość liter, a w MySQL może być tak samo. Przed napisaniem zapytań zapoznaj się ze składnią zapytań.

Zapoznaj się z danymi, które można eksportować

Z HubSpot do PostgreSQL lub MySQL można zsynchronizować następujące dane:

• Obiekty: obiekty standardowe i niestandardowe, takie jak kontakty, firmy, transakcje, zgłoszenia i produkty.
• Rekordy: poszczególne rekordy dla wybranych obiektów.
• Właściwości: wybrane wartości właściwości oraz historia właściwości w rekordach.
• Powiązania: wybrane relacje między rekordami, w tym definicje powiązań.
• Zdarzenia: wybrane standardowe zdarzenia HubSpot oraz niestandardowe zdarzenia behawioralne, w tym wybrane właściwości zdarzeń.

Dane dotyczące różnych obiektów są połączone w tabelach obiektów. Podczas odczytywania tabeli obiektów użyj OBJECTTYPEID, aby filtrować dane według konkretnego obiektu. Na przykład kontakty mają 0-1. Obiektom niestandardowym przypisywany jest identyfikator podczas ich tworzenia i są one oznaczone jako 2-{unique_id}, na przykład 2-12345.

Zapoznaj się z formatem eksportu

Podczas konfiguracji należy wybrać:

• Baza danych docelowa. Dotyczy to wyłącznie PostgreSQL. W przypadku MySQL HubSpot tworzy bazę danych.
• Źródła danych do synchronizacji: obiekty, zdarzenia, powiązania lub kombinacja tych źródeł.
• Harmonogram synchronizacji.

HubSpot eksportuje dane jako pliki Parquet i ładuje je bezpośrednio do tabel w Twojej bazie danych. PostgreSQL i MySQL nie korzystają z należącego do klienta zasobnika przejściowego. HubSpot zarządza zasobnikiem przejściowym wewnętrznie.

Znajdź swoje dane w bazie danych

HubSpot tworzy jedną tabelę na źródło danych w schemacie zarządzanym przez HubSpot, którego nazwa pochodzi od miejsca docelowego. Dokładną nazwę schematu można znaleźć na stronie konfiguracji synchronizacji.

• PostgreSQL: <database>.hubspot_data_out_<destination-id>.<table-name>
• MySQL: hubspot_data_out_<destination-id>.<table-name>. W MySQL schemat i baza danych to to samo pojęcie, a HubSpot je tworzy. Nie ma osobnego poziomu bazy danych do wyboru.

Na przykład w PostgreSQL:

• 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

Na przykład w MySQL:

• hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• hubspot_data_out_456.EVENTS_VISITED_PAGE
• hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Każda synchronizacja zastępuje tabelę najnowszą kopią. HubSpot nie przechowuje poprzednich kopii. Jeśli podczas synchronizacji wystąpi błąd w tabeli, jej poprzednie dane pozostają na miejscu do czasu kolejnej udanej synchronizacji.

Nazwy tabel i kolumn

Nazwy tabel i kolumn pochodzą z eksportowanych danych. Identyfikatory w PostgreSQL są ograniczone do 63 znaków, a w MySQL do 64 znaków. HubSpot skraca dłuższe nazwy, aby zmieściły się w tych limitach.

Wielkość liter w identyfikatorach

Wielkość liter w identyfikatorach ma znaczenie. HubSpot tworzy wszystkie tabele i kolumny z nazwami w cudzysłowie, zachowując wielkość liter, tak jak w tabelach przedstawionych w tym artykule.

• PostgreSQL: umieść nazwy w cudzysłowach dokładnie tak, jak pokazano. PostgreSQL zamienia nazwy bez cudzysłowów na małe litery, więc nie będą one pasować.
• MySQL: użyj znaków backtick i zachowaj wielkość liter zgodną z podaną. Wrażliwość na wielkość liter w nazwach tabel zależy od konfiguracji serwera.

Przykład PostgreSQL:

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

Przykład z MySQL:

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

Typy kolumn

Typy kolumn są zgodne z eksportowanymi danymi i są mapowane na typy PostgreSQL i MySQL w następujący sposób:

Uwaga: kolumna PROPERTIES w OBJECT_WITH_OBJECT_PROPERTIES jest eksportowana jako ciąg znaków w formacie JSON. Jest ona przechowywana jako TEXT w PostgreSQL lub LONGTEXT w MySQL, a nie jako typ kolumny JSON. Przykłady zapytań można znaleźć w sekcji FAQ.

Przegląd tabel obiektów

W przypadku wybrania danych obiektów HubSpot eksportuje następujące tabele.

OBJECT_PROPERTIES

Ta tabela zawiera jeden wiersz na każdą wartość właściwości. Aby odczytać konkretny obiekt, należy zastosować filtr według OBJECTTYPEID.

OBJECT_WITH_OBJECT_PROPERTIES

Ta tabela zawiera jeden wiersz na każdy rekord, a wybrane wartości właściwości są zgrupowane w jednej kolumnie PROPERTIES. Aby odczytać konkretny obiekt, zastosuj filtr według OBJECTTYPEID.

OBJECT_PROPERTIES_HISTORY

Ta tabela zawiera historię zmian właściwości. W przeciwieństwie do OBJECT_PROPERTIES, która przechowuje tylko bieżącą wartość, ta tabela zawiera jeden wiersz dla każdej historycznej wartości właściwości. Aby wyświetlić pełną oś czasu dla pojedynczego rekordu i właściwości, należy posortować według UPDATEDAT.

Przegląd tabel powiązań

W przypadku wybrania danych powiązań HubSpot eksportuje rekordy powiązań oraz definicje powiązań.

ASSOCIATIONS

Ta tabela zawiera jeden wiersz dla każdego wybranego powiązania między dwoma rekordami.

ASSOCIATION_DEFINITIONS

Ta tabela zawiera jeden wiersz na każdą wybraną definicję powiązania.

ASSOCIATIONS_<FROM_OBJECT>_TO_<TO_OBJECT>

W przypadku wybranych par powiązań HubSpot może również eksportować tabele powiązań specyficzne dla danej pary, takie jak ASSOCIATIONS_CONTACTS_TO_COMPANIES. Tabele te zawierają rekordy powiązań wraz z metadanymi definicji powiązań.

Przegląd tabel zdarzeń

W przypadku wybrania danych dotyczących zdarzeń HubSpot eksportuje jedną tabelę dla każdego typu zdarzenia. Nazwy tabel mają format EVENTS_<EVENT_NAME>, np. EVENTS_VISITED_PAGE.

Każda tabela zdarzeń zawiera standardowe kolumny zdarzeń oraz jedną kolumnę dla każdej wybranej właściwości zdarzenia.

Zarządzanie harmonogramem synchronizacji

Harmonogram synchronizacji konfiguruje się podczas konfiguracji w HubSpot. Można również ręcznie uruchomić ponowną synchronizację z poziomu HubSpot. Każde uruchomienie synchronizacji tworzy pełną migawkę wybranych danych. Aby kontrolować objętość danych, wybierz, które obiekty, zdarzenia, powiązania i właściwości mają zostać uwzględnione.

Uwaga: w fazie beta dostępny może być tylko ograniczony zestaw częstotliwości synchronizacji, np. raz, co 6 godzin, co 12 godzin, codziennie, co tydzień i co miesiąc. Dodatkowe opcje częstotliwości mogą zostać dodane w przyszłych wersjach.

Monitorowanie synchronizacji i obsługa błędów

W HubSpot możesz monitorować synchronizacje z bazami PostgreSQL i MySQL. Synchronizacja może mieć jeden z następujących stanów:

Gdy synchronizacja zakończy się niepowodzeniem:

• HubSpot wyświetla status „Nieudane” wraz ze szczegółami dla poszczególnych tabel, wskazującymi, które tabele zakończyły się powodzeniem, a które nie.
• Tabela jest aktualizowana dopiero po zakończeniu przez HubSpot ładowania wszystkich jej danych, więc nigdy nie zobaczysz częściowo załadowanej tabeli.
• Jeśli synchronizacja tabeli zakończy się niepowodzeniem, jej poprzednie dane pozostają na miejscu do czasu następnej udanej synchronizacji.
• Następna zaplanowana synchronizacja automatycznie ponowi próbę pełnej synchronizacji.
• W HubSpot możesz w dowolnym momencie ręcznie uruchomić ponowną synchronizację.

Tabele, których synchronizacja zakończyła się powodzeniem podczas poprzedniego uruchomienia, nie są modyfikowane, gdy późniejsze uruchomienie kończy się niepowodzeniem.

Często zadawane pytania

Jak wyszukiwać dane?

Wysyłaj zapytania do tabel w schemacie docelowym za pomocą języka SQL.

PostgreSQL

Odczytanie wszystkich rekordów kontaktów:

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

Odczytaj konkretną właściwość z kolumny JSON PROPERTIES. Najpierw przekonwertuj kolumnę na format JSON, ponieważ jest ona przechowywana jako tekst:

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

Odczytaj wszystkie rekordy kontaktów:

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

Odczytanie określonej właściwości z kolumny JSON o nazwie PROPERTIES:

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

Czy mogę eksportować jeden typ danych w ramach wielu synchronizacji?

Każdy obiekt, typ zdarzenia lub para powiązań może zostać uwzględniona w jednej cyklicznej synchronizacji z PostgreSQL i jednej cyklicznej synchronizacji z MySQL na każde konto HubSpot. Synchronizacje te są niezależne od siebie oraz od innych dostawców usługi Data Out. Na przykład, jeśli kontakty są już eksportowane do cyklicznego miejsca docelowego PostgreSQL, nie można dodać kontaktów do innej cyklicznej synchronizacji z PostgreSQL, dopóki nie zarchiwizujesz pierwszej synchronizacji. Nadal możesz jednocześnie eksportować kontakty do cyklicznej synchronizacji z MySQL.

Czy obsługiwane są tabele specyficzne dla obiektów?

Nie. Tabele specyficzne dla obiektów, takie jak OBJECTS_CONTACTS, nie są jeszcze obsługiwane. Aby uzyskać rekordy dla konkretnego obiektu, należy użyć OBJECT_WITH_OBJECT_PROPERTIES i filtrować według OBJECTTYPEID.

Czy obsługiwane są dane wrażliwe?

Nie. Dane wrażliwe nie są jeszcze obsługiwane w funkcji Data Out. Wrażliwe właściwości można wykluczyć z eksportów.

Czy HubSpot przechowuje poprzednie migawki?

Nie. Każda synchronizacja zastępuje tabelę docelową najnowszą migawką, więc poprzednie migawki nie są przechowywane.