BetaAccedi ai tuoi dati HubSpot da Microsoft Azure Synapse Analytics

Utilizza Data Out per Azure Synapse per esportare i dati selezionati di HubSpot CRM in tabelle all’interno di un pool SQL dedicato di Azure Synapse di tua proprietà. HubSpot aggiorna ogni tabella di output sulla base di un’esportazione completa dei dati selezionati. 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 le limitazioni e le considerazioni

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

• HubSpot aggiorna le tabelle separatamente. Se si esegue una query su più tabelle mentre è in corso una sincronizzazione, alcune tabelle potrebbero aggiornarsi prima di altre.
• Data Out non prevede la conservazione di istantanee storiche. Dopo un aggiornamento riuscito, la tabella di destinazione contiene l’istantanea più recente.
• Ogni oggetto, tipo di evento o coppia di associazioni può essere incluso in una sincronizzazione ricorrente di Azure Synapse per ogni account HubSpot. Questo limite è indipendente dagli altri provider di Data Out.
• Le tabelle specifiche per oggetto, come OBJECTS_CONTACTS, non sono ancora supportate.
• Se due nomi di tabella entrano in conflitto dopo che HubSpot li ha normalizzati, l’esportazione interessata fallisce. Per ulteriori informazioni, consulta le regole relative ai nomi delle tabelle e delle colonne.

Comprendere i dati che è possibile esportare

È possibile sincronizzare i seguenti dati da HubSpot ad Azure Synapse Analytics:

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

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:

• L'endpoint SQL dedicato di Azure Synapse e il database di destinazione.
• Le origini dati da sincronizzare: oggetti, eventi, associazioni o una combinazione di queste origini.
• La pianificazione della sincronizzazione.

HubSpot crea un’esportazione Parquet temporanea nell’archivio gestito da HubSpot e scrive i risultati nelle tabelle del tuo pool SQL dedicato di Azure Synapse. Non è necessario fornire o gestire un bucket di staging.

Trova i tuoi dati in Azure Synapse

HubSpot crea tabelle di output in uno schema gestito da HubSpot per la tua destinazione. HubSpot esporta i dati degli oggetti nelle tre tabelle di oggetti descritte in questo articolo. HubSpot crea inoltre una tabella per ogni tipo di evento selezionato e, quando disponibile, una tabella specifica per ogni coppia di associazioni selezionata.

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

Puoi trovare il nome esatto dello schema nella pagina di configurazione della tua sincronizzazione. 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

Nomi delle tabelle e delle colonne

HubSpot normalizza i nomi delle tabelle e delle colonne esportate utilizzando lettere maiuscole, numeri e trattini bassi:

• Gli spazi e i trattini vengono sostituiti da trattini bassi.
• Gli altri caratteri non alfanumerici vengono rimossi.
• I nomi più lunghi di 128 caratteri vengono abbreviati.
• Ai nomi delle colonne in conflitto viene aggiunto un suffisso.
• I nomi delle tabelle in conflitto causano il fallimento dell'esportazione interessata.

Utilizza le parentesi quadre quando esegui query sugli identificatori, specialmente se costruisci le query in modo dinamico. La distinzione tra maiuscole e minuscole negli identificatori dipende dal collation del tuo database Synapse. Ad esempio:

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

Tipi di colonna

I tipi di colonna seguono i dati esportati e vengono mappati ai tipi di Azure Synapse come segue:

Nota: la colonna PROPERTIES in OBJECT_WITH_OBJECT_PROPERTIES viene esportata come stringa in formato JSON. Viene memorizzata come NVARCHAR(MAX), non come tipo di colonna JSON. Per esempi di query, consulta le Domande frequenti.

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 nuova sincronizzazione 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, le frequenze di sincronizzazione disponibili potrebbero essere limitate. Ulteriori opzioni di frequenza potrebbero essere aggiunte nelle versioni future.

Monitorare le sincronizzazioni e gestire gli errori

È possibile monitorare le sincronizzazioni di Azure Synapse in HubSpot. Una sincronizzazione può presentare uno dei seguenti stati:

Quando una sincronizzazione non va a buon fine:

• HubSpot mostra lo stato " Failed " con i dettagli relativi alle tabelle che hanno avuto esito positivo o negativo.
• Se una tabella non può essere aggiornata, i dati precedenti, che erano stati importati correttamente, rimangono solitamente disponibili.
• Per le sincronizzazioni ricorrenti, la successiva sincronizzazione pianificata riprova automaticamente a eseguire una sincronizzazione completa.
• È possibile avviare manualmente una nuova sincronizzazione in qualsiasi momento in HubSpot.

Domande frequenti

Come posso eseguire query sui dati?

Eseguire una query sulle tabelle nello schema di destinazione utilizzando SQL. Ad esempio, per leggere tutti i record dei contatti:

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

Leggi una proprietà specifica dalla stringa 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';

È possibile esportare un tipo di dati in più sincronizzazioni?

Ogni oggetto, tipo di evento o coppia di associazioni può essere incluso in una sola sincronizzazione ricorrente di Azure Synapse per ogni account HubSpot. Questo limite è indipendente dagli altri provider Data Out.

Ad esempio, se i contatti sono già stati esportati in una destinazione Azure Synapse ricorrente, non è possibile aggiungere contatti a un’altra sincronizzazione ricorrente di Azure Synapse finché non si archivia la prima sincronizzazione. È comunque possibile esportare i contatti verso un altro provider Data Out supportato contemporaneamente.

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 in base a OBJECTTYPEID per ottenere i record relativi a un oggetto specifico.

HubSpot conserva le istantanee precedenti?

No. Data Out non prevede la conservazione storica delle istantanee. Dopo un aggiornamento riuscito, la tabella di destinazione contiene l’istantanea più recente. Se una tabella non può essere aggiornata, i dati precedenti aggiornati con successo rimangono solitamente disponibili.