Wersja betaEksportuj dane z HubSpot do Microsoft Fabric

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

Skorzystaj z funkcji Data Out, aby wyeksportować wybrane dane z HubSpot CRM do natywnych tabel w należącej do Ciebie hurtowni danych Microsoft Fabric. Możesz zsynchronizować dane obiektów, powiązań i zdarzeń z tabelami w swojej hurtowni, 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

Aby wyeksportować dane do Microsoft Fabric, potrzebujesz:

• Obszar roboczy Microsoft Fabric z magazynem Fabric
• Podmiot usługi Microsoft Entra ID dodany do obszaru roboczego Fabric z rolą „Contributor”
• Identyfikator dzierżawcy, identyfikator klienta i sekret klienta podmiotu usługowego
• Twój ciąg połączenia SQL do magazynu Fabric (adres serwera bez numeru portu) oraz nazwa magazynu

Podmiot usługi Microsoft Entra ID musi posiadać uprawnienia do tworzenia obiektów należących do HubSpot oraz zarządzania nimi w docelowym magazynie danych Fabric. Podczas weryfikacji połączenia i synchronizacji HubSpot tworzy schematy i tabele, wstawia dane, zmienia nazwy tabel przejściowych oraz usuwa obiekty tymczasowe. Należy przyznać podmiotowi usługi rolę „Contributor” w obszarze roboczym Fabric, aby umożliwić HubSpot:

• Utwórz schematy
• Tworzenie tabel
• Wstawianie wierszy
• Zmiana nazw lub modyfikacja tabel należących do HubSpot
• Usuń tabele i schematy należące do HubSpot

Twój punkt końcowy SQL w magazynie Fabric musi być dostępny dla HubSpot na porcie TCP 1433. HubSpot używa protokołu TLS dla wszystkich połączeń i weryfikuje certyfikat serwera.

Jeśli obszar roboczy Fabric ogranicza dostęp do sieci, dodaj adresy IP wychodzące HubSpot dla regionu Twojego konta do listy dozwolonych.

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

• Microsoft Fabric Data Out obsługuje wyłącznie magazyny Fabric. Magazyny typu lakehouse nie są obsługiwane.
• Każde uruchomienie synchronizacji tworzy pełną migawkę wybranych danych. Pomyślna synchronizacja zastępuje poprzednią migawkę 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 momentu następnej pomyślnej synchronizacji.
• Każdy typ obiektu, typ zdarzenia lub para powiązań może zostać uwzględniony w jednej cyklicznej synchronizacji Microsoft Fabric na konto.
• Każda synchronizacja zastępuje zawartość tabeli docelowej. Uprawnienia na poziomie tabeli lub ustawienia dodane w magazynie danych Fabric nie są zachowywane między synchronizacjami.
• Ponowne nawiązanie połączenia z innym podmiotem usługowym wymaga dodania tego podmiotu do obszaru roboczego Fabric z rolą „Contributor”, zanim test połączenia lub synchronizacja zakończą się powodzeniem.

Podłącz HubSpot do Microsoft Fabric

Zaleca się, aby konsole konta HubSpot i Microsoft Fabric były otwarte w osobnych kartach.

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 lub przejdź do pozycji „Microsoft Fabric”.
4. Kliknij opcję „Zainstaluj”, a następnie „Dalej”.
5. Wprowadź identyfikator dzierżawcy (Tenant ID), identyfikator klienta (Client ID) oraz sekret klienta (Client secret) swojego podmiotu usługi.
6. Wprowadź następujące dane miejsca docelowego:
   • Ciąg połączenia SQL: adres serwera magazynu Fabric Warehouse bez numeru portu.
   • Nazwa magazynu: nazwa magazynu Fabric Warehouse, do którego ma nastąpić eksport.
7. Kliknij przycisk „Testuj połączenie”. Jeśli test połączenia zakończy się powodzeniem, kliknij przycisk „Dalej”.

Uwaga: w środowisku pracy Fabric przed uruchomieniem testu połączenia upewnij się, że podmiot usługi HubSpot ma rolę „Contributor”. Do skonfigurowania dostępu nie są wymagane żadne skrypty SQL.

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 czas jej rozpoczęcia.
4. Kliknij Rozpocznij synchronizację.

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

Uzyskaj dostęp do wyeksportowanych danych

HubSpot tworzy schemat zarządzany przez HubSpot dla każdego miejsca docelowego. Tabele 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

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

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 zamieniają się na znaki podkreślenia.
• Pozostałe znaki niealfanumeryczne zostaną usunięte.
• Nazwy dłuższe niż 128 znaków zostaną skrócone.
• Nazwy kolumn powodujące kolizję otrzymują sufiks.
• W przypadku kolidujących nazw tabel eksport nie powiedzie się.

Typy kolumn

Kolumna PROPERTIES w OBJECT_WITH_OBJECT_PROPERTIES jest przechowywana jako ciąg znaków w formacie JSON w kolumnie VARCHAR(MAX), a nie jako natywny typ kolumny JSON. Zobacz przykłady zapytań w sekcji FAQ poniżej.

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ą pogrupowane 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-{unikalny_identyfikator}, 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 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 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. Po lewej stronie kliknij opcję „Synchronizacja aplikacji”.
3. Wyszukaj lub wybierz synchronizację z Microsoft Fabric.

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ą

Gdy synchronizacja zakończy się niepowodzeniem:

• 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 jest aktualizowana 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.
• Podczas następnej zaplanowanej synchronizacji automatycznie zostanie podjęta kolejna próba pełnej synchronizacji.
• Synchronizację można uruchomić ręcznie ze strony szczegółów synchronizacji.

Często zadawane pytania

Jak wyszukiwać dane wyeksportowane?

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

-- 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';

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

Każdy typ obiektu, typ zdarzenia lub para powiązań może zostać uwzględniona w jednej cyklicznej synchronizacji Microsoft Fabric na konto HubSpot. Nie ma to związku z innymi dostawcami usługi Data Out.

Na przykład, jeśli kontakty zostały już wyeksportowane do cyklicznej lokalizacji docelowej Fabric, nie można dodać kontaktów do innej cyklicznej konfiguracji Fabric, dopóki nie zarchiwizujesz pierwszej konfiguracji. Nadal możesz jednocześnie eksportować kontakty do innego obsługiwanych dostawców Data Out.

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 usłudze 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 tworzy tymczasowy eksport w formacie Parquet w pamięci masowej zarządzanej przez HubSpot i zapisuje wyniki w Twoim Fabric Warehouse. Nie musisz udostępniać ani zarządzać zasobnikiem przejściowym.

Co się stanie, jeśli ponownie połączę się przy użyciu innego podmiotu usługi?

Jeśli ponownie nawiążesz połączenie przy użyciu innego podmiotu usługowego, musisz dodać ten podmiot do obszaru roboczego Fabric z rolą „Contributor”, zanim test połączenia lub synchronizacja zakończą się powodzeniem.