Wersja betaUzyskaj dostęp do danych HubSpot z Amazon Redshift

Skorzystaj z funkcji „Data Out for Amazon Redshift”, aby wyeksportować wybrane dane z HubSpot CRM do tabel w należącej do Ciebie bazie danych Amazon Redshift. 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ę

Zanim zaczniesz korzystać z tej funkcji, 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 w Redshift.
• HubSpot nie usuwa plików Parquet, które umieszcza w Twoim zasobniku S3. Aby usunąć je automatycznie, skonfiguruj politykę cyklu życia S3 dla zasobnika lub prefiksu.
• Każdy obiekt, typ zdarzenia lub para powiązań może zostać uwzględniona w jednej cyklicznej synchronizacji Redshift Data Out na konto HubSpot.
• 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.

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

Z HubSpot do Amazon Redshift 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 i 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 należy użyć 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}, np. 2-12345.

Zapoznaj się z formatem eksportu

Podczas konfiguracji należy wybrać:

• Baza danych Redshift oraz klaster lub grupa robocza typu „Serverless”, w której HubSpot utworzy tabele.
• Zbiornik S3, którego HubSpot używa do tymczasowego przechowywania danych przed załadowaniem ich do Redshift.
• Źródła danych do synchronizacji: obiekty, zdarzenia, powiązania lub kombinacja tych źródeł.
• Harmonogram synchronizacji.

HubSpot eksportuje dane jako pliki Parquet, umieszcza je w Twoim zasobniku S3, a następnie ładuje do tabel Redshift.

Uwaga: HubSpot nie usuwa danych z tymczasowego zasobnika. Zaleca się skonfigurowanie zasad cyklu życia zasobnika, aby automatycznie go czyścić.

Znajdź swoje dane w Redshift

HubSpot tworzy jedną tabelę dla każdego źródła danych w schemacie zarządzanym przez HubSpot, którego nazwa pochodzi od miejsca docelowego:

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

Nazwę schematu można znaleźć na stronie konfiguracji synchronizacji z Redshift. 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

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

HubSpot umieszcza pliki Parquet w Twoim zasobniku S3 pod prefiksem zarządzanym przez HubSpot, a następnie ładuje je do Redshift:

s3://<bucket>/<prefix>/hubspot-dataout/<portal-id>/<destination-id>/<run-id>/<table-name>/

Te pliki przejściowe pozostają w Twoim zasobniku do momentu ich usunięcia. Aby usunąć je automatycznie, skonfiguruj politykę cyklu życia S3 dla zasobnika lub prefiksu.

Uwaga: nazwy tabel i kolumn pochodzą z wyeksportowanych danych. Mogą one zostać skrócone, aby zmieścić się w limicie 127 znaków identyfikatora obowiązującym w Redshift. Typy kolumn są zgodne z danymi wyeksportowanymi.

Przegląd tabel obiektów

W przypadku wybrania danych obiektowych 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, zastosuj 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 Amazon Redshift. Synchronizacja może mieć jeden z następujących stanów:

Gdy synchronizacja zakończy się niepowodzeniem:

• HubSpot wyświetla status „Niepowodzenie” wraz ze szczegółowymi informacjami dla poszczególnych tabel, wskazującymi, które z nich zostały załadowane pomyślnie, 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.
• Podczas następnej zaplanowanej synchronizacji automatycznie zostanie podjęta kolejna próba 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. Na przykład:

Odczyt wszystkich rekordów kontaktów:

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

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

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

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

Każdy obiekt, typ zdarzenia lub para powiązań może zostać uwzględniona w jednej cyklicznej synchronizacji Redshift Data Out na konto HubSpot. Na przykład, jeśli kontakty są już eksportowane do jednego cyklicznego miejsca docelowego Redshift, nie można dodać kontaktów do innej cyklicznej synchronizacji Redshift, dopóki nie zarchiwizujesz pierwszej synchronizacji.

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 to Redshift”. Właściwości wrażliwe 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 w Redshift. HubSpot nie usuwa również tymczasowych plików Parquet, które umieszcza w Twoim zasobniku S3. Skonfiguruj politykę cyklu życia S3, aby automatycznie je wygaszać.