BetaAccedi ai tuoi dati HubSpot da PostgreSQL o MySQL

Utilizza Data Out per PostgreSQL e MySQL per esportare i dati selezionati di HubSpot CRM nelle tabelle di un database 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.
• Ogni oggetto, tipo di evento o coppia di associazioni può essere incluso in una sincronizzazione ricorrente PostgreSQL e in una sincronizzazione ricorrente MySQL per ogni account HubSpot. Queste sincronizzazioni sono indipendenti l’una dall’altra e dagli altri provider Data Out.
• 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.
• I nomi delle tabelle e delle colonne distinguono tra maiuscole e minuscole in PostgreSQL e potrebbero distinguerle anche in MySQL. Verifica la sintassi delle query prima di scriverle.

Comprendere i dati che è possibile esportare

È possibile sincronizzare i seguenti dati da HubSpot a PostgreSQL o MySQL:

• Oggetti: oggetti standard e personalizzati, come contatti, aziende, opportunità, 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 alcune proprietà degli eventi.

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 di destinazione. Questo vale solo per PostgreSQL. Per MySQL, HubSpot crea il database.
• 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 e li carica direttamente nelle tabelle del database. PostgreSQL e MySQL non utilizzano un bucket di staging di proprietà del cliente. HubSpot gestisce lo staging internamente.

Individuare i dati nel database

HubSpot crea una tabella per ogni origine dati in uno schema gestito da HubSpot che prende il nome dalla tua destinazione. Puoi trovare il nome esatto dello schema nella pagina di configurazione della tua sincronizzazione.

• PostgreSQL: <database>.hubspot_data_out_<destination-id>.<table-name>
• MySQL: hubspot_data_out_<destination-id>.<table-name>. In MySQL, schema e database sono lo stesso concetto e vengono creati da HubSpot. Non è necessario selezionare un livello di database separato.

Ad esempio, in PostgreSQL:

• 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

Ad esempio, in MySQL:

• hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• hubspot_data_out_456.EVENTS_VISITED_PAGE
• hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

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

Nomi di tabelle e colonne

I nomi delle tabelle e delle colonne provengono dai dati esportati. Gli identificatori PostgreSQL sono limitati a 63 caratteri, mentre quelli MySQL a 64 caratteri. HubSpot abbrevia i nomi più lunghi per adattarli a tali limiti.

Maiuscole e minuscole negli identificatori

Le maiuscole e le minuscole negli identificatori sono importanti. HubSpot crea tutte le tabelle e le colonne con nomi racchiusi tra virgolette, mantenendo le maiuscole e le minuscole, in modo che corrispondano alle tabelle riportate in questo articolo.

• PostgreSQL: racchiudi i nomi tra virgolette doppie esattamente come mostrato. PostgreSQL converte i nomi non racchiusi tra virgolette in minuscolo, quindi non corrisponderanno.
• MySQL: utilizzare i backtick e rispettare le maiuscole e le minuscole indicate. La distinzione tra maiuscole e minuscole nei nomi delle tabelle dipende dalla configurazione del server.

Esempio PostgreSQL:

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

Esempio MySQL:

SELECT * FROM `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 PostgreSQL e MySQL come segue:

Nota: la colonna PROPERTIES in OBJECT_WITH_OBJECT_PROPERTIES viene esportata come stringa in formato JSON. Viene memorizzata come TEXT in PostgreSQL o LONGTEXT in MySQL, 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 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 di PostgreSQL e MySQL 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 hanno avuto esito positivo o negativo.
• 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 suoi 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.

PostgreSQL

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 colonna JSON PROPERTIES. Converti prima la colonna in JSON, poiché è memorizzata come testo:

SELECT "OBJECTID", json_extract_path_text("PROPERTIES"::json, 'email') AS email FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES" WHERE "OBJECTTYPEID" = '0-1';

MySQL

Leggi tutti i record dei contatti:

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

Leggere una proprietà specifica dalla colonna JSON PROPERTIES:

SELECT `OBJECTID`, JSON_EXTRACT(`PROPERTIES`, '$.email') AS email FROM `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 sincronizzazione ricorrente PostgreSQL e in una sincronizzazione ricorrente MySQL per ogni account HubSpot. Queste sincronizzazioni sono indipendenti l’una dall’altra e dagli altri provider Data Out. Ad esempio, se i contatti sono già stati esportati in una destinazione PostgreSQL ricorrente, non è possibile aggiungere contatti a un’altra sincronizzazione ricorrente PostgreSQL finché non si archivia la prima sincronizzazione. È comunque possibile esportare i contatti in una sincronizzazione ricorrente MySQL 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.

I dati sensibili sono supportati?

No. I dati sensibili non sono ancora supportati per Data Out. 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.