Wersja betaUzyskaj dostęp do danych z HubSpot za pośrednictwem usługi Microsoft Azure Synapse Analytics

Skorzystaj z funkcji „Data Out for Azure Synapse”, aby wyeksportować wybrane dane z HubSpot CRM do tabel w dedykowanej puli SQL usługi Azure Synapse, której jesteś właścicielem. HubSpot aktualizuje każdą tabelę wyjściową na podstawie pełnego eksportu wybranych danych. Po zakończeniu synchronizacji możesz wysyłać zapytania do tabel za pomocą języka SQL lub preferowanych narzędzi do analizy biznesowej i analityki, aby połączyć dane z HubSpot z innymi danymi biznesowymi.

Uwaga: jeśli jesteś superadministratorem, włącz swoje konto dowersji beta usługi 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.

• HubSpot aktualizuje tabele osobno. Jeśli podczas trwania synchronizacji wysyłasz zapytanie obejmujące wiele tabel, niektóre tabele mogą zostać zaktualizowane przed innymi.
• Usługa Data Out nie zapewnia przechowywania historycznych migawek. Po pomyślnym odświeżeniu tabela docelowa zawiera najnowszą migawkę.
• Każdy obiekt, typ zdarzenia lub para powiązań może zostać uwzględniony w jednej cyklicznej synchronizacji z Azure Synapse na konto HubSpot. Limit ten jest niezależny od innych dostawców usługi Data Out.
• Tabele specyficzne dla obiektów, takie jak OBJECTS_CONTACTS, nie są jeszcze obsługiwane.
• Jeśli po normalizacji przez HubSpot wystąpi kolizja nazw dwóch tabel, eksport, którego to dotyczy, zakończy się niepowodzeniem. Aby uzyskać więcej informacji, zapoznaj się z zasadami dotyczącymi nazw tabel i kolumn.

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

Z HubSpot do Azure Synapse Analytics można zsynchronizować następujące dane:

• Obiekty i rekordy: wybrane obiekty standardowe i niestandardowe oraz ich rekordy, takie jak kontakty, firmy, transakcje, zgłoszenia i produkty.
• 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 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 wybierasz:

• Docelowy dedykowany punkt końcowy SQL i baza danych Azure Synapse.
• Źródła danych do synchronizacji: obiekty, zdarzenia, powiązania lub kombinacja tych źródeł.
• Harmonogram synchronizacji.

HubSpot tworzy tymczasowy eksport w formacie Parquet w pamięci masowej zarządzanej przez HubSpot i zapisuje wyniki w tabelach w dedykowanej puli SQL usługi Azure Synapse. Nie musisz udostępniać ani zarządzać zasobnikiem przejściowym.

Znajdź swoje dane w Azure Synapse

HubSpot tworzy tabele wyjściowe w schemacie zarządzanym przez HubSpot dla wybranego miejsca docelowego. HubSpot eksportuje dane obiektów do trzech tabel obiektów opisanych w tym artykule. HubSpot tworzy również jedną tabelę dla każdego wybranego typu zdarzenia oraz, jeśli jest to możliwe, jedną tabelę specyficzną dla każdej wybranej pary powiązań.

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

Dokładną nazwę schematu można znaleźć na stronie konfiguracji synchronizacji. 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

Nazwy tabel i kolumn

HubSpot normalizuje nazwy eksportowanych tabel i kolumn, zamieniając je na wielkie litery, cyfry i znaki podkreślenia:

• Spacje i łączniki są zamieniane na znaki podkreślenia.
• Pozostałe znaki niealfanumeryczne są usuwane.
• Nazwy dłuższe niż 128 znaków są skracane.
• W przypadku kolizji nazw kolumn dodawany jest sufiks.
• W przypadku kolizji nazw tabel eksport kończy się niepowodzeniem.

W zapytaniach dotyczących identyfikatorów należy używać nawiasów kwadratowych, zwłaszcza w przypadku dynamicznego tworzenia zapytań. Wrażliwość identyfikatorów na wielkość liter zależy od kolacji bazy danych Synapse. Na przykład:

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

Typy kolumn

Typy kolumn są zgodne z eksportowanymi danymi i mapowane na typy Azure Synapse 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 NVARCHAR(MAX), a nie jako typ kolumny JSON. Przykłady zapytań można znaleźć w sekcji często zadawanych pytań (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, 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 generuje pełną migawkę wybranych danych. Aby kontrolować objętość danych, należy wybrać obiekty, zdarzenia, powiązania i właściwości, które mają zostać uwzględnione.

Uwaga: w trakcie trwania wersji beta dostępne częstotliwości synchronizacji mogą być ograniczone. Dodatkowe opcje częstotliwości mogą zostać dodane w przyszłych wydaniach.

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

Synchronizacje z Azure Synapse można monitorować w HubSpot. 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 o tym, które tabele zostały pomyślnie wyeksportowane, a które nie.
• Jeśli nie można zaktualizować tabeli, poprzednie dane, których eksport zakończył się powodzeniem, zazwyczaj pozostają dostępne.
• W przypadku synchronizacji cyklicznych następna zaplanowana synchronizacja automatycznie ponowi próbę pełnej synchronizacji.
• W HubSpot można w dowolnym momencie ręcznie uruchomić ponowną synchronizację.

Często zadawane pytania

Jak wyszukiwać dane?

Wysyłaj zapytania do tabel w schemacie docelowym za pomocą języka SQL. Na przykład, aby odczytać wszystkie rekordy kontaktów:

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

Odczytaj konkretną właściwość z ciągu JSON PROPERTIES:

SELECT
  [OBJECTID],
  JSON_VALUE([PROPERTIES], '$.email') AS [email]
FROM [your_database].[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 usługą Azure Synapse na konto HubSpot. Ograniczenie to jest niezależne od innych dostawców usługi Data Out.

Na przykład, jeśli kontakty są już eksportowane do cyklicznej synchronizacji docelowej w Azure Synapse, nie można dodać kontaktów do innej cyklicznej synchronizacji w Azure Synapse, dopóki nie zarchiwizujesz pierwszej synchronizacji. Nadal możesz jednocześnie eksportować kontakty do innego obsługiwanych dostawców Data Out.

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 HubSpot przechowuje poprzednie migawki?

Nie. Usługa Data Out nie zapewnia przechowywania historycznych migawek. Po pomyślnym odświeżeniu tabela docelowa zawiera najnowszą migawkę. Jeśli nie można zaktualizować tabeli, poprzednie pomyślnie przesłane dane zazwyczaj pozostają dostępne.