Wersja betaEksportuj dane z HubSpot do PostgreSQL lub MySQL

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

Podsumowanie

Skorzystaj z funkcji Data Out, aby wyeksportować wybrane dane z HubSpot CRM do zarządzanej przez Ciebie bazy danych PostgreSQL lub MySQL. Możesz zsynchronizować dane obiektów, powiązań i zdarzeń z tabelami w swojej bazie danych, a następnie wyszukiwać te dane za pomocą języka SQL lub wykorzystywać je w narzędziach do analizy biznesowej i analityki.

Każda synchronizacja tworzy pełną migawkę wybranych danych. Po pomyślnym zakończeniu synchronizacji zastępuje ona poprzednią migawkę w tabelach docelowych.

Zanim zaczniesz

Zapoznaj się z wymaganiami

• Baza danych PostgreSQL lub MySQL musi być dostępna z zakresów adresów IP HubSpot dla regionu Twojego konta.
• Serwer bazy danych musi obsługiwać połączenia SSL.
• Musisz posiadać użytkownika bazy danych z wymaganymi uprawnieniami:
  • PostgreSQL: uprawnienie CREATE oraz dostęp do zapisu w schemacie docelowym.
  • MySQL: uprawnienie CREATE do bazy danych oraz dostęp do zapisu.
• Upewnij się, że użytkownik bazy danych może tworzyć tabele i zapisywać dane.
• Konto HubSpot i konsole baz danych powinny być otwarte w osobnych kartach.

Zezwól na adresy IP HubSpot

Dodaj zakres adresów IP HubSpot dla regionu swojego konta do listy dozwolonych adresów serwera bazy danych.

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

• Każda synchronizacja tworzy pełną kopię wybranych danych.
• Pomyślnie zakończona synchronizacja zastępuje poprzednią kopię w tabelach docelowych.
• HubSpot nie przechowuje poprzednich migawek.
• Jeśli podczas synchronizacji wystąpi błąd w tabeli, jej poprzednie dane pozostają dostępne do czasu następnej pomyślnej synchronizacji.
• Każdy typ obiektu, typ zdarzenia lub para powiązań może zostać uwzględniony w jednej cyklicznej synchronizacji PostgreSQL i jednej cyklicznej synchronizacji MySQL na konto.
• Każda synchronizacja zastępuje tabelę docelową. Uprawnienia na poziomie tabeli lub ustawienia dodane u dostawcy bazy danych nie są zachowywane między synchronizacjami.
• Jeśli ponownie nawiążesz połączenie przy użyciu innego użytkownika bazy danych, musisz przyznać temu użytkownikowi dostęp do istniejących schematów, baz danych lub tabel zarządzanych przez HubSpot.

Połącz HubSpot z PostgreSQL lub MySQL

1. Na koncie HubSpot kliknij opcję Więcej, a następnie przejdź do Zarządzanie danymi > Studio danych. Jeśli opcja Więcej się nie pojawia, przejdź bezpośrednio do sekcji Zarządzanie danymi > Studio danych.
2. W prawym górnym rogu kliknij opcję „Połącz zewnętrzne źródło danych”.
3. W panelu „Dodaj źródło danych ” wyszukaj dostawcę bazy danych lub przejdź do niego.
4. Kliknij „PostgreSQL ” lub „MySQL”.
5. Wprowadź dane połączenia z bazą danych:
   • Host
   • Port
   • SSL
   • Nazwa użytkownika
   • Hasło
6. W przypadku PostgreSQL wprowadź nazwę bazy danych, w której HubSpot ma utworzyć schemat.
7. Kliknij „Połącz z PostgreSQL ” lub „Połącz z MySQL”.

HubSpot wykorzystuje połączonego użytkownika bazy danych do tworzenia tabel i wczytywania danych do bazy danych.

Skonfiguruj synchronizację

1. Wybierz źródła danych do eksportu:
   • Obiekty
   • Powiązania
   • Zdarzenia
2. Wybierz obiekty, właściwości, powiązania lub zdarzenia, które chcesz uwzględnić.
3. Wybierz częstotliwość synchronizacji oraz moment jej rozpoczęcia.
4. Kliknij przycisk Rozpocznij synchronizację.

Dostępne częstotliwości synchronizacji mogą się różnić w trakcie trwania wersji beta. Opcje mogą obejmować: raz, co 6 godzin, co 12 godzin, codziennie, co tydzień lub co miesiąc.

Uzyskaj dostęp do wyeksportowanych danych

HubSpot tworzy schemat lub bazę danych zarządzaną przez HubSpot dla każdego miejsca docelowego.

PostgreSQL

Tabele PostgreSQL mają następujący format:

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

Na przykład:

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

Tabele MySQL mają następujący format:

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

Na przykład:

hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
hubspot_data_out_456.EVENTS_VISITED_PAGE
hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Dokładną nazwę schematu lub bazy danych można znaleźć na stronie konfiguracji synchronizacji.

Nazwy tabel i kolumn

Nazwy tabel i kolumn są oparte na wyeksportowanych danych. Identyfikatory PostgreSQL mogą zawierać do 63 znaków. Identyfikatory MySQL mogą zawierać do 64 znaków. Dłuższe nazwy są skracane, aby zmieścić się w obowiązującym limicie.

HubSpot tworzy tabele i kolumny PostgreSQL z nazwami w cudzysłowach, z zachowaniem wielkości liter. Podczas wysyłania zapytań do PostgreSQL należy używać podwójnych cudzysłowów i zachować wielkość liter zgodną z nazwą tabeli i kolumny.

W przypadku MySQL należy używać znaków backtick i zachować wielkość liter zgodną z podaną. Wrażliwość na wielkość liter w nazwach tabel może się różnić w zależności od konfiguracji serwera MySQL.

Typy kolumn

Kolumna PROPERTIES w tabeli OBJECT_WITH_OBJECT_PROPERTIES jest przechowywana jako ciąg znaków w formacie JSON. W PostgreSQL jest przechowywana jako TEXT, a w MySQL jako LONGTEXT, a nie jako natywny typ kolumny JSON.

Tabele obiektów

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

OBJECT_PROPERTIES

Ta tabela zawiera jeden wiersz dla każdej wartości właściwości obiektu.

OBJECT_WITH_OBJECT_PROPERTIES

Ta tabela zawiera jeden wiersz dla każdego rekordu obiektu. Wybrane wartości właściwości są zgrupowane w kolumnie PROPERTIES.

W tej tabeli połączono dane obiektów różnych typów. Aby wyświetlić rekordy dla konkretnego typu obiektu, zastosuj filtr według OBJECTTYPEID.

• Kontakty: 0-1
• Obiekty niestandardowe: 2-{unique_id}, np. 2-12345

OBJECT_PROPERTIES_HISTORY

Ta tabela zawiera historię zmian właściwości. Zawiera jeden wiersz dla każdej historycznej wartości właściwości.

Aby wyświetlić pełną historię dla konkretnego rekordu i właściwości, należy posortować wyniki według kolumny UPDATEDAT.

Tabele 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 dla każdej wybranej definicji powiązania.

Tabele powiązań dla konkretnych par

Dla wybranych par powiązań HubSpot może również eksportować tabele w następującym formacie:

ASSOCIATIONS_<FROM_OBJECT_TYPE>_TO_<TO_OBJECT_TYPE>

Na przykład:

ASSOCIATIONS_CONTACTS_TO_COMPANIES

Tabele te zawierają rekordy powiązań oraz metadane definicji powiązań.

Tabele zdarzeń

W przypadku wybrania danych dotyczących zdarzeń HubSpot eksportuje jedną tabelę dla każdego typu zdarzenia. Nazwy tabel zdarzeń mają następujący format:

EVENTS_<EVENT_NAME>

Na przykład:

EVENTS_VISITED_PAGE

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

Monitorowanie synchronizacji

1. Na koncie HubSpot kliknij Więcej, a następnie przejdź do Zarządzanie danymi > Integracja danych. Jeśli opcja Więcej się nie pojawia, przejdź bezpośrednio do sekcji Zarządzanie danymi > Integracja danych.
2. Po lewej stronie kliknij opcję „Synchronizacja aplikacji”.
3. Wyszukaj lub wybierz synchronizację PostgreSQL lub MySQL.

Na stronie szczegółów synchronizacji możesz sprawdzić status synchronizacji, czas ostatniej synchronizacji, błędy, aktywność synchronizacji oraz historię synchronizacji. Możesz również wstrzymać, zarchiwizować lub ręcznie uruchomić synchronizację.

Stany synchronizacji

Rozwiązywanie problemów z synchronizacją

W przypadku niepowodzenia synchronizacji:

• Interfejs użytkownika HubSpot wyświetla status „Nieudane” oraz szczegóły na poziomie tabel wskazujące, które tabele zakończyły się powodzeniem, a które nie.
• Tabela zostanie zaktualizowana dopiero po zakończeniu ładowania przez HubSpot wszystkich jej danych.
• 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.
• Synchronizację można uruchomić ręcznie ze strony szczegółów synchronizacji.

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

Często zadawane pytania

Jak wyszukiwać wyeksportowane dane?

Wysyłaj zapytania do tabel w schemacie docelowym lub bazie danych za pomocą języka 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';

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

Każdy typ obiektu, typ zdarzenia lub para powiązań może zostać uwzględniony w jednej cyklicznej synchronizacji z PostgreSQL i jednej cyklicznej synchronizacji z MySQL na każde konto HubSpot.

Na przykład, jeśli kontakty są już eksportowane do cyklicznej synchronizacji PostgreSQL, nie można dodać kontaktów do innej cyklicznej konfiguracji PostgreSQL, dopóki nie zarchiwizujesz pierwszej konfiguracji. Nadal możesz jednocześnie eksportować kontakty do cyklicznej konfiguracji MySQL.

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

Tabele specyficzne dla obiektów, takie jak OBJECTS_CONTACTS, nie są obecnie obsługiwane. Aby pobrać rekordy dla określonego typu obiektu, należy użyć OBJECT_WITH_OBJECT_PROPERTIES i filtrować według OBJECTTYPEID.

Czy obsługiwane są dane wrażliwe?

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

Czy HubSpot przechowuje poprzednie migawki?

Nie. Każda pomyślna synchronizacja zastępuje tabelę docelową najnowszą kopią. HubSpot nie przechowuje poprzednich kopii.

Jeśli podczas synchronizacji wystąpi błąd w tabeli, jej poprzednie dane pozostają na miejscu do momentu pomyślnej aktualizacji tej tabeli.

Czy HubSpot korzysta z kontenera przejściowego, którym zarządzam?

Nie. HubSpot eksportuje dane w formacie Parquet i zarządza buforem przejściowym wewnętrznie. Nie musisz udostępniać należącego do klienta zasobnika bufora przejściowego dla PostgreSQL lub MySQL.

Co się stanie, jeśli zmienię użytkownika bazy danych?

Jeśli ponownie nawiążesz połączenie przy użyciu innego użytkownika bazy danych, musisz przyznać nowemu użytkownikowi dostęp do istniejących schematów, baz danych lub tabel zarządzanych przez HubSpot.