Eksportuj dane z HubSpot do Amazon Redshift

Podsumowanie

Eksportuj obiekty, powiązania i zdarzenia z HubSpot CRM do Amazon Redshift za pomocą aplikacji Amazon Redshift dostępnej w HubSpot Marketplace. Możesz wybrać dane do eksportu, skonfigurować harmonogram synchronizacji oraz monitorować aktywność synchronizacji z poziomu HubSpot.

W tym artykule opisano, jak zainstalować i podłączyć aplikację, skonfigurować synchronizację eksportu danych oraz monitorować synchronizację i zarządzać nią.

Uwaga: jeśli jesteś superadministratorem, możesz włączyć swoje konto do wersji beta ulepszonej integracji z Amazon Redshift.

Zanim zaczniesz

Zapoznaj się z wymaganiami

Upewnij się, że spełniasz następujące wymagania:

• Rola AWS Identity and Access Management (IAM) powiązana z Twoim kontem HubSpot i skonfigurowana tak, aby umożliwiała dostęp do Twojego konta AWS.
• Klaster Amazon Redshift lub bezserwerowa grupa robocza, do której HubSpot ma dostęp.
• Bucket Amazon S3 do przechowywania tymczasowych plików Parquet. Bucket musi znajdować się w tym samym regionie AWS, co klaster Redshift lub bezserwerowa grupa robocza.
• HubSpot kopiuje tymczasowe pliki Parquet do skonfigurowanego zasobnika Amazon S3 służącego do przechowywania tymczasowego i nie usuwa ich. Aby usunąć starsze pliki i zarządzać kosztami przechowywania, utwórz regułę cyklu życia S3 na swoim koncie AWS.
• Administrator Redshift, który może wykonać jednorazowe przyznanie uprawnień SQL w docelowej bazie danych.
• Dostęp do konsoli HubSpot i AWS. Zaleca się otwarcie ich w osobnych kartach.

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

• Każda synchronizacja tworzy pełną kopię wybranych danych.
• Każda synchronizacja zastępuje tabelę docelową. Wszelkie uprawnienia na poziomie tabeli lub ustawienia dodane w Redshift nie są zachowywane między synchronizacjami.
• Możesz kontrolować ilość eksportowanych danych, wybierając obiekty, powiązania i zdarzenia, które mają zostać uwzględnione.
• Jeśli synchronizacja zakończy się niepowodzeniem, następna zaplanowana synchronizacja automatycznie ponowi próbę pełnej synchronizacji.

Zainstaluj i połącz aplikację Amazon Redshift

1. W HubSpot App Marketplace otwórz stronę aplikacji Amazon Redshift.
2. Wybierz rolę AWS powiązaną z Twoim kontem HubSpot.
3. Kliknij „Zainstaluj”.
4. Kliknij „Dalej”.
5. Utwórz rolę AWS IAM powiązaną z kontem HubSpot i skonfigurowaną tak, aby miała dostęp do konta AWS.
6. Wprowadź nazwę zasobu Amazon (ARN) tej roli.
7. Kliknij „Połącz z Amazon Redshift”.

Skonfiguruj swoją rolę AWS

HubSpot wykorzystuje połączoną rolę AWS do zapisywania tymczasowych plików Parquet w Twoim tymczasowym zasobniku S3 oraz do ładowania tych plików do Redshift.

1. W polu „Adres URL zasobnika S3 ” wprowadź adres URL zasobnika S3, którego HubSpot będzie używać do przechowywania tymczasowych plików Parquet.

W adresie URL można dodać prefiks, aby ograniczyć dostęp do określonej ścieżki w ramach zasobnika. Zasobnik musi znajdować się w tym samym regionie AWS, co klaster Redshift lub bezserwerowa grupa robocza.

Uwaga: zgodnie z założeniami HubSpot kopiuje pliki Parquet do skonfigurowanego zasobnika przejściowego S3 i nie usuwa ich. Utwórz regułę cyklu życia S3 w AWS, aby automatycznie usuwać starsze pliki.

2. Wybierz typ wdrożenia Redshift z menu rozwijanego:
   • Redshift bezserwerowy
   • Klaster przydzielony
3. Zaktualizuj połączoną rolę AWS, dodając politykę uprawnień odpowiednią dla danego typu wdrożenia:
   • Redshift Serverless: wprowadź identyfikator ARN swojej grupy roboczej. HubSpot wygeneruje politykę zawierającą ten identyfikator. Skopiuj politykę i dołącz ją do połączonej roli AWS.
   • Klaster przydzielony: skopiuj szablon polityki. Zastąp YOUR_REGION, YOUR_ACCOUNT_ID, YOUR_CLUSTER_ID i YOUR_DATABASE wartościami z Twojego konta AWS, a następnie dołącz politykę do podłączonej roli AWS.
4. W AWS IAM otwórz rolę powiązaną z HubSpot.
5. Przypisz wygenerowaną politykę uprawnień do tej roli lub utwórz politykę wbudowaną, wykorzystując treść tej polityki.

6. W tej samej roli AWS IAM zaktualizuj politykę zaufania, dodając oświadczenie wygenerowane przez HubSpot.

HubSpot generuje różne oświadczenia polityki zaufania w zależności od wybranego typu wdrożenia Redshift.

Powiąż rolę AWS z usługą Redshift

W usłudze Amazon Redshift powiąż tę samą rolę AWS, którą zaktualizowałeś w poprzedniej sekcji, ze swoją konfiguracją Redshift.

• Redshift Serverless: otwórz stronę konfiguracji przestrzeni nazw dla przestrzeni nazw, której używasz z HubSpot. Na karcie „Zabezpieczenia i szyfrowanie ” kliknij opcję „Zarządzaj rolami IAM”, a następnie wybierz opcję „Powiąż role IAM”.
• Klaster przydzielony: otwórz swój klaster, kliknij „Działania” i wybierz „Zarządzaj rolami IAM ” > „Powiąż role IAM”.

Przyznaj uprawnienia Redshift

1. W HubSpot wybierz docelową bazę danych.
2. Poproś administratora Redshift o uruchomienie skryptu SQL w wybranej bazie danych.

HubSpot wykorzystuje to uprawnienie do utworzenia schematu dla miejsca docelowego podczas synchronizacji.

3. Kliknij „Testuj połączenie”.
4. Jeśli test połączenia zakończy się powodzeniem, kliknij „Dalej”.

Skonfiguruj synchronizację eksportu danych

1. Wybierz źródła danych do eksportu.
2. Wybierz tabele obiektów, powiązań i zdarzeń, które chcesz uwzględnić.
3. Skonfiguruj częstotliwość synchronizacji i czas rozpoczęcia.
4. Kliknij „Rozpocznij synchronizację”.

Każde uruchomienie synchronizacji powoduje wyeksportowanie pełnej migawki wybranych danych do Amazon Redshift.

Monitorowanie i zarządzanie synchronizacją

Na stronie szczegółów synchronizacji można sprawdzić następujące informacje:

• Stan synchronizacji.
• Czas ostatniej synchronizacji.
• Błędy.
• Aktywność synchronizacji.
• Historia synchronizacji.

Aby otworzyć stronę ze szczegółami synchronizacji:

1. Na koncie HubSpot przejdź do sekcji Zarządzanie danymi > Integracja danych.
2. W zakładce „Synchronizacje aplikacji ” wyszukaj synchronizacje aplikacji Amazon Redshift.
3. Kliknij synchronizację z Amazon Redshift, którą chcesz przejrzeć.

Na stronie szczegółów synchronizacji możesz również wykonać następujące czynności:

• Kliknij „Wstrzymaj”, aby wstrzymać synchronizację.
• Kliknij opcję „Archiwizuj”, aby zarchiwizować synchronizację.
• Kliknij opcję „Synchronizuj teraz ”, aby ręcznie uruchomić synchronizację.

Stany synchronizacji

Rozwiązywanie problemów z synchronizacją

Gdy synchronizacja zakończy się niepowodzeniem:

• W HubSpot synchronizacja wyświetla status „Nieudana ”.
• Szczegóły dla poszczególnych tabel pokazują, które z nich zakończyły się powodzeniem, a które zakończyły się niepowodzeniem.
• Następna zaplanowana synchronizacja automatycznie ponowi próbę pełnej synchronizacji.
• Możesz kliknąć „Synchronizuj teraz ”, aby ręcznie uruchomić kolejną synchronizację.