Esportare i dati di HubSpot su Amazon Redshift

Riepilogo

Esporta oggetti, associazioni ed eventi di HubSpot CRM su Amazon Redshift utilizzando l'app Amazon Redshift disponibile su HubSpot Marketplace. Puoi scegliere i dati da esportare, configurare una pianificazione di sincronizzazione e monitorare l'attività di sincronizzazione direttamente da HubSpot.

Questo articolo spiega come installare e collegare l’app, configurare una sincronizzazione per l’esportazione dei dati e monitorare o gestire la sincronizzazione.

Nota: se sei un superamministratore, puoi attivare la partecipazione del tuo account alla versione beta dell’integrazione migliorata con Amazon Redshift.

Prima di iniziare

Verifica i requisiti

Assicurati di disporre di quanto segue:

• Un ruolo AWS Identity and Access Management (IAM) collegato al tuo account HubSpot e configurato per accedere al tuo account AWS.
• Un cluster Amazon Redshift provisionato o un gruppo di lavoro serverless raggiungibile da HubSpot.
• Un bucket Amazon S3 per l’archiviazione temporanea dei file Parquet. Il bucket deve trovarsi nella stessa regione AWS del cluster Redshift o del gruppo di lavoro serverless.
• HubSpot copia i file Parquet temporanei nel bucket di staging Amazon S3 configurato e non li elimina. Per rimuovere i file più vecchi e gestire i costi di archiviazione, crea una regola del ciclo di vita S3 nel tuo account AWS.
• Un amministratore Redshift in grado di eseguire un’autorizzazione SQL una tantum sul database di destinazione.
• Accesso alle console di HubSpot e AWS. Si consiglia di aprirle in schede separate.

Comprendere le limitazioni e le considerazioni

• Ogni sincronizzazione produce uno snapshot completo dei dati selezionati.
• Ogni sincronizzazione sostituisce la tabella di destinazione. Eventuali autorizzazioni o impostazioni a livello di tabella aggiunte in Redshift non vengono conservate tra una sincronizzazione e l’altra.
• Puoi controllare la quantità di dati esportati selezionando quali oggetti, associazioni ed eventi includere.
• Se una sincronizzazione fallisce, la successiva sincronizzazione pianificata riproverà automaticamente a eseguire la sincronizzazione completa.

Installa e collega l’app Amazon Redshift

1. Nell’App Marketplace di HubSpot, apri la scheda dell’app Amazon Redshift.
2. Seleziona il ruolo AWS collegato al tuo account HubSpot.
3. Fai clic su Installa.
4. Fai clic su Avanti.
5. Crea un ruolo IAM di AWS collegato al tuo account HubSpot e configurato per accedere al tuo account AWS.
6. Inserisci il nome della risorsa Amazon (ARN) del ruolo.
7. Fai clic su Connetti ad Amazon Redshift.

Configura il tuo ruolo AWS

HubSpot utilizza il ruolo AWS collegato per scrivere file Parquet temporanei nel tuo bucket di staging S3 e caricare i file in Redshift.

1. Nel campo "URL del bucket S3 ", inserisci l’URL del bucket S3 che HubSpot utilizzerà per archiviare i file Parquet temporanei.

È possibile includere un prefisso nell’URL per limitare l’accesso a un percorso specifico all’interno del bucket. Il bucket deve trovarsi nella stessa regione AWS del cluster Redshift o del gruppo di lavoro serverless.

Nota: per impostazione predefinita, HubSpot copia i file Parquet nel bucket S3 di staging configurato e non li elimina. Crea una regola del ciclo di vita S3 in AWS per rimuovere automaticamente i file più vecchi.

2. Seleziona il tipo di distribuzione Redshift dal menu a discesa:
   • Redshift Serverless
   • Cluster provisionato
3. Aggiorna il ruolo AWS collegato con la policy di autorizzazioni relativa al tuo tipo di distribuzione:
   • Redshift Serverless: inserisci l’ARN del tuo gruppo di lavoro. HubSpot genererà una politica contenente l’ARN. Copia la politica e allegala al ruolo AWS collegato.
   • Cluster provisionato: copia il modello di policy. Sostituisci YOUR_REGION, YOUR_ACCOUNT_ID, YOUR_CLUSTER_ID e YOUR_DATABASE con i valori del tuo account AWS, quindi associa la policy al ruolo AWS collegato.
4. In AWS IAM, apri il ruolo collegato a HubSpot.
5. Associa la policy delle autorizzazioni generata al ruolo oppure crea una policy inline con il contenuto della policy.

6. Nello stesso ruolo AWS IAM, aggiorna la policy di fiducia con l’istruzione generata da HubSpot.

HubSpot genera una dichiarazione di policy di fiducia diversa in base al tipo di distribuzione di Redshift selezionato.

Associa il ruolo AWS a Redshift

In Amazon Redshift, associa lo stesso ruolo AWS che hai aggiornato nella sezione precedente alla tua configurazione di Redshift.

• Redshift Serverless: apri la pagina di configurazione dello spazio dei nomi che utilizzi con HubSpot. Nella scheda " Sicurezza e crittografia ", fai clic su "Gestisci ruoli IAM", quindi seleziona "Associa ruoli IAM".
• Cluster provisionato: apri il tuo cluster, fai clic su Azioni e seleziona Gestisci ruoli IAM > Associa ruoli IAM.

Concedi le autorizzazioni a Redshift

1. In HubSpot, seleziona il database di destinazione.
2. Chiedi a un amministratore di Redshift di eseguire lo script SQL nel database selezionato.

HubSpot utilizza questa autorizzazione per creare uno schema per la destinazione durante la sincronizzazione.

3. Fai clic su Verifica connessione.
4. Se il test di connessione ha esito positivo, clicca su Avanti.

Configura la sincronizzazione dell’esportazione dei dati

1. Seleziona le origini dati da esportare.
2. Seleziona le tabelle degli oggetti, delle associazioni e degli eventi da includere.
3. Configurare la frequenza di sincronizzazione e l'ora di inizio.
4. Fare clic su Avvia sincronizzazione.

Ogni esecuzione della sincronizzazione esporta un'istantanea completa dei dati selezionati su Amazon Redshift.

Monitorare e gestire la sincronizzazione

Dalla pagina dei dettagli della sincronizzazione è possibile visualizzare le seguenti informazioni:

• Stato della sincronizzazione.
• Ora dell’ultima sincronizzazione.
• Errori.
• Attività di sincronizzazione.
• Cronologia della sincronizzazione.

Per aprire la pagina dei dettagli della sincronizzazione:

1. Nel tuo account HubSpot, vai su Gestione dati > Integrazione dati.
2. Nella scheda Sincronizzazioni app, cerca le sincronizzazioni dell’app Amazon Redshift.
3. Fai clic sulla sincronizzazione di Amazon Redshift che desideri esaminare.

Dalla pagina dei dettagli della sincronizzazione, puoi anche eseguire le seguenti azioni:

• Fai clic su Sospendi per sospendere la sincronizzazione.
• Fai clic su Archivia per archiviare la sincronizzazione.
• Fare clic su " Sincronizza ora " per avviare manualmente una sincronizzazione.

Stati della sincronizzazione

Risolvere gli errori di sincronizzazione

Quando una sincronizzazione non va a buon fine:

• La sincronizzazione mostra lo stato " Fallita " in HubSpot.
• I dettagli per tabella mostrano quali tabelle hanno avuto esito positivo o negativo.
• La successiva sincronizzazione pianificata tenterà automaticamente di eseguire nuovamente la sincronizzazione completa.
• È possibile fare clic su " Sincronizza ora " per avviare manualmente un'altra sincronizzazione.