BetaAccedi ai tuoi dati HubSpot da Amazon Redshift

Utilizza Data Out per Amazon Redshift per esportare i dati selezionati di HubSpot CRM nelle tabelle di un database Amazon Redshift di tua proprietà. Ogni operazione di sincronizzazione crea un’istantanea completa dei dati selezionati e sostituisce quella precedente. Dopo la sincronizzazione, puoi eseguire query sulle tabelle tramite SQL o con i tuoi strumenti di BI e analisi preferiti per combinare i dati di HubSpot con altri dati aziendali.

Nota: se sei un Super Admin, attiva la partecipazione del tuo accountalla versione beta di Data Studio per utilizzare questa funzionalità.

Comprendere i limiti e le considerazioni

Prima di iniziare a utilizzare questa funzionalità, assicurati di aver compreso appieno quali passaggi è necessario compiere in anticipo, nonché le limitazioni della funzionalità e le potenziali conseguenze del suo utilizzo.

• Ogni sincronizzazione sostituisce le tabelle di destinazione con l’istantanea più recente. HubSpot non conserva le istantanee precedenti in Redshift.
• HubSpot non elimina i file Parquet che archivia temporaneamente nel tuo bucket S3. Per rimuoverli automaticamente, configura una politica del ciclo di vita S3 sul bucket o sul prefisso.
• Ogni oggetto, tipo di evento o coppia di associazioni può essere incluso in una sola sincronizzazione ricorrente di Redshift Data Out per ogni account HubSpot.
• I dati sensibili non sono ancora supportati. Le proprietà sensibili possono essere escluse dalle esportazioni.
• Le tabelle specifiche per oggetto, come OBJECTS_CONTACTS, non sono ancora supportate.

Comprendere i dati che è possibile esportare

È possibile sincronizzare i seguenti dati da HubSpot ad Amazon Redshift:

• Oggetti: oggetti standard e personalizzati, come contatti, aziende, trattative, ticket e prodotti.
• Record: singoli record relativi agli oggetti selezionati.
• Proprietà: valori delle proprietà selezionate e cronologia delle proprietà nei record.
• Associazioni: relazioni selezionate tra i record, comprese le definizioni delle associazioni.
• Eventi: eventi HubSpot standard selezionati ed eventi comportamentali personalizzati, comprese le proprietà degli eventi selezionati.

I dati relativi a oggetti diversi vengono combinati nelle tabelle degli oggetti. Quando si legge una tabella degli oggetti, utilizzare OBJECTTYPEID per filtrare un oggetto specifico. Ad esempio, i contatti utilizzano 0-1. Agli oggetti personalizzati viene assegnato un ID al momento della creazione e vengono identificati come 2-{unique_id}, ad esempio 2-12345.

Comprendere il formato di esportazione

Durante la configurazione, è possibile scegliere:

• Il database Redshift e il cluster o il gruppo di lavoro serverless in cui HubSpot creerà le tabelle.
• Il bucket S3 che HubSpot utilizza per preparare i dati prima di caricarli in Redshift.
• Le fonti di dati da sincronizzare: oggetti, eventi, associazioni o una combinazione di queste fonti.
• La pianificazione della sincronizzazione.

HubSpot esporta i dati come file Parquet, li archivia temporaneamente nel tuo bucket S3 e li carica nelle tabelle di Redshift.

Nota: HubSpot non elimina i dati dal bucket di staging. Si consiglia di impostare una politica sul ciclo di vita del bucket per pulirlo automaticamente.

Trovare i dati in Redshift

HubSpot crea una tabella per ogni origine dati in uno schema gestito da HubSpot che prende il nome dalla destinazione:

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

Puoi trovare il nome dello schema nella pagina di configurazione della sincronizzazione con Redshift. Ad esempio:

• 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

Ogni sincronizzazione sostituisce la tabella con l’istantanea più recente. Se una tabella non viene sincronizzata correttamente, i dati precedenti rimangono al loro posto fino alla successiva sincronizzazione riuscita.

HubSpot archivia temporaneamente i file Parquet nel tuo bucket S3 sotto un prefisso gestito da HubSpot, quindi li carica in Redshift:

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

Questi file di staging rimangono nel tuo bucket finché non li rimuovi. Per rimuoverli automaticamente, configura una policy del ciclo di vita S3 sul bucket o sul prefisso.

Nota: i nomi delle tabelle e delle colonne provengono dai dati esportati. Potrebbero essere abbreviati per rispettare il limite di 127 caratteri imposto da Redshift per gli identificatori. I tipi di colonna seguono quelli dei dati esportati.

Esamina le tabelle degli oggetti

Se si selezionano i dati degli oggetti, HubSpot esporta le seguenti tabelle.

OBJECT_PROPERTIES

Questa tabella contiene una riga per ogni valore di proprietà. Per leggere un oggetto specifico, filtra in base a OBJECTTYPEID.

OBJECT_WITH_OBJECT_PROPERTIES

Questa tabella contiene una riga per ogni record, con i valori delle proprietà selezionate raggruppati in un'unica colonna PROPERTIES. Per visualizzare un oggetto specifico, filtra in base a OBJECTTYPEID.

OBJECT_PROPERTIES_HISTORY

Questa tabella contiene la cronologia delle modifiche alle proprietà. A differenza di OBJECT_PROPERTIES, che contiene solo il valore corrente, questa tabella presenta una riga per ogni valore storico di una proprietà. Per visualizzare la cronologia completa di un singolo record e di una singola proprietà, ordinare per UPDATEDAT.

Esamina le tabelle di associazione

Se si selezionano i dati di associazione, HubSpot esporta i record di associazione e le definizioni di associazione.

ASSOCIATIONS

Questa tabella contiene una riga per ogni associazione selezionata tra due record.

ASSOCIATION_DEFINITIONS

Questa tabella contiene una riga per ogni definizione di associazione selezionata.

ASSOCIATIONS_<FROM_OBJECT>_TO_<TO_OBJECT>

Per le coppie di associazioni selezionate, HubSpot può anche esportare tabelle di associazioni specifiche per ciascuna coppia, come ad esempio ASSOCIATIONS_CONTACTS_TO_COMPANIES. Queste tabelle includono i record di associazione insieme ai metadati relativi alle definizioni delle associazioni.

Esamina le tabelle degli eventi

Se selezioni i dati relativi agli eventi, HubSpot esporta una tabella per ogni tipo di evento. I nomi delle tabelle seguono il formato EVENTS_<EVENT_NAME>, ad esempio EVENTS_VISITED_PAGE.

Ogni tabella degli eventi contiene colonne standard relative agli eventi e una colonna per ciascuna proprietà dell’evento selezionata.

Gestire la pianificazione della sincronizzazione

La pianificazione della sincronizzazione va configurata durante la configurazione in HubSpot. È inoltre possibile avviare manualmente una risincronizzazione da HubSpot. Ogni esecuzione della sincronizzazione produce un’istantanea completa dei dati selezionati. Per controllare il volume dei dati, scegli quali oggetti, eventi, associazioni e proprietà includere.

Nota: durante la fase beta, potrebbe essere disponibile solo un numero limitato di frequenze di sincronizzazione, ad esempio una volta, ogni 6 ore, ogni 12 ore, giornalmente, settimanalmente e mensilmente. Ulteriori opzioni di frequenza potrebbero essere aggiunte nelle versioni future.

Monitorare le sincronizzazioni e gestire gli errori

È possibile monitorare le sincronizzazioni con Amazon Redshift in HubSpot. Una sincronizzazione può assumere uno dei seguenti stati:

Quando una sincronizzazione fallisce:

• HubSpot mostra lo stato "Failed " con dettagli per ogni tabella che indicano quali tabelle sono state caricate correttamente e quali no.
• Una tabella viene aggiornata solo dopo che HubSpot ha completato il caricamento di tutti i suoi dati, quindi non vedrai mai una tabella caricata solo parzialmente.
• Se una tabella non viene sincronizzata correttamente, i dati precedenti rimangono invariati fino alla successiva sincronizzazione riuscita.
• La successiva sincronizzazione pianificata riproverà automaticamente a eseguire una sincronizzazione completa.
• È possibile avviare manualmente una risincronizzazione in qualsiasi momento in HubSpot.

Le tabelle che sono state sincronizzate con successo in un'esecuzione precedente non vengono modificate quando un'esecuzione successiva fallisce.

Domande frequenti

Come posso eseguire query sui dati?

Esegui una query sulle tabelle nello schema di destinazione utilizzando SQL. Ad esempio:

Leggere tutti i record dei contatti:

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

Leggere una proprietà specifica dalla colonna 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';

Posso esportare un tipo di dati in più sincronizzazioni Redshift?

Ogni oggetto, tipo di evento o coppia di associazioni può essere incluso in una sola sincronizzazione ricorrente di Redshift Data Out per ogni account HubSpot. Ad esempio, se i contatti sono già stati esportati in una destinazione Redshift ricorrente, non è possibile aggiungere contatti a un'altra sincronizzazione ricorrente di Redshift finché non si archivia la prima sincronizzazione.

Sono supportate le tabelle specifiche per oggetto?

No. Le tabelle specifiche per oggetto, come OBJECTS_CONTACTS, non sono ancora supportate. Utilizza OBJECT_WITH_OBJECT_PROPERTIES e filtra per OBJECTTYPEID per ottenere i record relativi a un oggetto specifico.

I dati sensibili sono supportati?

No. I dati sensibili non sono ancora supportati per Data Out verso Redshift. Le proprietà sensibili possono essere escluse dalle esportazioni.

HubSpot conserva le istantanee precedenti?

No. Ogni sincronizzazione sostituisce la tabella di destinazione con l’istantanea più recente, quindi le istantanee precedenti non vengono conservate in Redshift. Inoltre, HubSpot non elimina i file Parquet temporanei che archivia nel tuo bucket S3. Configura una politica del ciclo di vita S3 per farli scadere automaticamente.