Interrogare i dati di HubSpot in Snowflake

Dopo aver collegato Snowflake al vostro account HubSpot, potete usare Data Share di Snowflake per interrogare i dati di HubSpot dal vostro account Snowflake.

Data lag e regione dell'account Snowflake

Avrete accesso allo schema V2_LIVE, aggiornato ogni 15 minuti, e allo schema V2_DAILY, aggiornato ogni giorno.

Nota bene: le seguenti viste nello schema V2_LIVE sono aggiornate solo quotidianamente: association_definitions, owners, pipeline e pipeline_stages.

Configurare l'ambiente Snowflake

Per interrogare i dati di HubSpot in Snowflake, è necessario selezionare il magazzino, il database e lo schema da cui si desidera eseguire la query. È possibile impostarli a livello di foglio di lavoro per includerli automaticamente nelle query, oppure aggiungerli manualmente.

Per selezionare il magazzino, il database e lo schema a livello di foglio di lavoro:

• Nella riga superiore del foglio di lavoro, fate clic sulla barra delle azioni del foglio di lavoro.
  
  
• Nella finestra a comparsa:
  • Fare clic sul menu a discesa Magazzino, quindi selezionare il magazzino.
  • Fare clic sul menu a discesa Database, quindi selezionare il database HubSpot.
  • Fare clic sul menu a discesa Schema e selezionare lo schema che si desidera utilizzare:
    • V2_DAILY: lo schema giornaliero per interrogare i dati in base alle tabelle. I dati in questo schema vengono aggiornati una volta al giorno. L'uso di questo schema consente di ottenere query più veloci ed è consigliato per le query direttamente in Snowflake.
    • V2_LIVE: lo schema live basato su Secure Views dei dati di HubSpot. I dati in questo schema vengono aggiornati ogni 15 minuti. Se si sta interrogando un grande insieme di dati, le query potrebbero essere lente. In questo caso, si consiglia di copiare i dati nella propria tabella con un processo di ETL e di interrogare la tabella.
    
    
    

Una volta configurato l'ambiente, è possibile eseguire query sui dati di HubSpot senza dover aggiungere manualmente il tipo di database o di schema alle query.

Per aggiungere manualmente il database e il tipo di schema alle query, aggiungere il nome del database seguito dallo schema all'inizio del campo FROM. Ad esempio:

Schema dati

Le query sono costruite con SQL e possono essere utilizzate per recuperare dati di HubSpot come:

• Oggetti: oggetti standard e personalizzati, come contatti, aziende, prodotti.
• Record: singoli record, come un singolo contatto o un'azienda.
• Associazioni: tutti i tipi di associazione disponibili e i record attualmente associati.
• Eventi: dati relativi agli eventi standard di HubSpot, come le aperture delle e-mail, e agli eventi comportamentali personalizzati.
• Segmenti: Segmenti di contatti e aziende di HubSpot.
• Proprietari: utenti dell'account HubSpot, in relazione ai record di cui sono impostati come proprietari.
• Pipeline: pipeline di deal e ticket, comprese le fasi della pipeline.
• Proprietà: proprietà e relativi valori dei record CRM, compresa la cronologia delle proprietà.

Per saperne di più sul modello di dati CRM di HubSpot.

Nota bene: con l'evoluzione della condivisione dei dati, verranno introdotte modifiche, alcune delle quali di natura sostanziale. Si consiglia vivamente di iscriversi al registro delle modifiche degli sviluppatori di HubSpot. Queste modifiche saranno sempre pubblicate nel change log prima di qualsiasi aggiornamento.

Limitare e ordinare i dati restituiti

Quando si costruiscono le query, è possibile controllare la quantità di dati restituiti e l'ordine in cui vengono restituiti, includendo LIMIT e ORDER BY nella query. Ad esempio, per interrogare tutti i contatti con le loro proprietà, ma restituendo solo tre risultati e ordinandoli in base all'ID del contatto, si può costruire la query come segue:

Tipi di dati delle colonne

Quando si interrogano i dati in Snowflake, le colonne che vengono restituite dipendono dai dati che si stanno interrogando. È possibile visualizzare le colonne disponibili per una determinata tabella o vista in Snowflake selezionando la vista nella barra laterale sinistra.

Nota:per il resto di questo documento, useremo il termine oggetto del database quando il contesto si applica sia alle tabelle che alle viste.

Per restituire una colonna specifica, includere tale colonna nel campo SELECT della query. Ad esempio, la seguente query restituisce solo le colonne OBJECTID e UpdatedAt:


SELECTobjectId, updatedAt
FROM objects_contacts



Di seguito sono riportate le definizioni generali delle colonne che una query può restituire. Per altre definizioni non incluse di seguito, vedere le definizioni delle singole viste nell'articolo precedente.

• OBJECTTYPEID: un valore VARCHAR che rappresenta il tipo di oggetto. Ad esempio, 0-1 rappresenta l'oggetto Contatti, 0-2 rappresenta l'oggetto Aziende e 2-1232 potrebbe rappresentare un oggetto personalizzato nell'account. Nei segmenti, si riferisce al tipo di segmento (ad esempio, contatto o azienda). È possibile interrogare tutti gli ID degli oggetti e degli eventi nel proprio account utilizzando la vista object_and_event_type_definitions.
• OBJECTID: un numero BIGINT che rappresenta un singolo record di un determinato tipo di oggetto nell'account HubSpot. Per identificare un record, è necessario utilizzare sia l'ID del tipo di oggetto che l'ID dell'oggetto.
• INGESTEDAT: il timestamp di quando una riga di dati è stata aggiunta a Snowflake, rappresentato da un valore TIMESTAMP_NTZ. Non è correlato al timestamp logico di un'operazione di creazione o aggiornamento in HubSpot.
  • A causa dell'elaborazione interna di HubSpot, il timestamp di ingestione di una riga può essere aggiornato anche se nessun'altra colonna della riga è cambiata.
  • Quando si creano processi ETL che copiano dati modificati di recente, si consiglia di basare le query sul timestamp di ingestione. Inoltre, se il flusso copia i dati quotidianamente, si consiglia di copiare i dati dei due giorni precedenti per tenere conto dei ritardi.
• CREATEDAT e UPDATEDAT: il timestamp logico di quando i dati sono stati creati o aggiornati in HubSpot, rappresentato da un valore TIMESTAMP_NTZ . Questi timestamp corrispondono ai timestamp di HubSpot. Ad esempio, l'ora visualizzata in HubSpot per la data di creazione di un record sarà la stessa del timestamp nella colonna CREATEDAT di Snowflake. Queste proprietà non sono direttamente collegate al timestamp di ingestione e non è consigliabile basare i processi ETL su di esse.
• COMBINEDASSOCIATIONTYPE: un valore VARCHAR che identifica in modo univoco una definizione di associazione.

Trasformazione dei tipi di dati

A volte, i dati restituiti da una query con colonne VARCHAR sono di tipo diverso. In questi casi, si consiglia di convertire il tipo di dati VARCHAR nei tipi desiderati usando le funzioni di Snowflake. Ad esempio, le proprietà di un record di un oggetto sono memorizzate come tipi di dati VARCHAR nella maggior parte degli oggetti del database, ma a volte contengono valori numerici e datetime. Funzioni come:
try_to_number, try_to_timestamp_ntz possono essere utilizzate per convertire questi dati VARCHAR rispettivamente nei tipi NUMBER e DATETIME:


SELECT objectid, value AS amount_str, try_to_number(value) AS amount
FROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1



Interrogazione di oggetti

Di seguito, scopriremo come interrogare i dati di specifici oggetti e record di HubSpot, insieme ai dati che vengono restituiti.

I dati degli oggetti di diverso tipo sono organizzati e disponibili in due modi:

• Individuale: Ogni tipo di oggetto è memorizzato nella propria vista e contiene solo record dello stesso tipo di oggetto, ad esempio oggetti_contatti contiene solo record di contatti. Questo elimina la necessità di specificare un objecttypeid durante l'interrogazione. Queste viste sono più facili da interrogare, poiché non è necessario conoscere gli ID degli oggetti. Inoltre, restituiscono i dati in un formato più fruibile, con ogni riga corrispondente a un oggetto e alla versione corrente delle sue proprietà. Se non si verificano query lente, è consigliabile utilizzare queste viste per recuperare i dati degli oggetti. Per saperne di più, vedere le viste Objects_X qui sotto.
• Combinato: Tutti i record di tutti i tipi di oggetto sono combinati in un unico oggetto del database. Pertanto, quando si esegue una query, è necessario specificare un filtro come "WHERE objectTypeId='0-1'". Ad esempio, è possibile utilizzare i seguenti tipi di oggetto per l'interrogazione:

Aglioggetti personalizzati viene assegnato un ID al momento della creazione, identificato come 2-unique_ID. Ad esempio, 2-12345. Per saperne di più sulle definizioni di tipo di oggetto e di tipo di evento.

Questi oggetti di database sono generalmente adatti se si vogliono ottenere prestazioni di query migliori di quelle ottenibili con le viste objects_x. Maggiori dettagli in object_with_object_properties, object_properties, objects e object_properties_history.

viste objects_x

In questo oggetto del database, ogni tipo di oggetto disponibile, compresi gli oggetti personalizzati, ha la sua vista specifica e ogni vista contiene solo i record degli oggetti di quel determinato tipo di oggetto. Queste viste sono denominate secondo il formato OGGETTI_<nome del tipo di oggetto>, dove <nome del tipo di oggetto> è l'etichetta della forma plurale del tipo di oggetto(si noti che se il tipo di oggetto non ha una forma plurale, allora <nome del tipo di oggetto> sarà semplicemente l'etichetta della forma singolare del nome del tipo di oggetto concatenata con "S").

Le interrogazioni a questa vista restituiscono una riga per ogni record di un oggetto, con ogni proprietà dell'oggetto disponibile come colonna separata.

Di seguito è riportato l'elenco completo dei tipi di oggetto HubSpot (cioè non personalizzati), una breve descrizione dei dati che rappresentano e le viste corrispondenti:

Ogni oggetto del database restituisce le seguenti colonne:

Esempio 1

Recuperare il nome, il cognome e la fase del ciclo di vita di tutti i contatti.

Query:


SELECT objectId, property_firstname AS firstname, property_lastname AS lastname,property_lifecyclestage AS lifecyclestage
FROM objects_contact



Restituisce:

Esempio 2

Recupera il nome e la fase dell'operazione per un massimo di tre operazioni.

Query:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

Restituisce:

Esempio 3

Recupera il nome dell'operazione e la fase delle prime tre operazioni per importo.

Query:

Poiché i dati relativi all'importo dell'affare sono disponibili come tipo di dato numero, possono essere utilizzati per l'ordinamento senza dover effettuare conversioni o casting.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3




Restituzione:

oggetto_con_proprietà_di_oggetto

Questo oggetto database contiene i dati dei record di HubSpot. Le interrogazioni a questo oggetto di database restituiscono una riga per ogni record all'interno di un tipo di oggetto (ad esempio, tutti i record dei contatti nel tipo di oggetto Contatti). Tutte le proprietà sono memorizzate nella colonna Proprietà, che è una colonna Snowflake Variant / JSON.

Questa vista può restituire le seguenti colonne:

Nota bene: il 25 gennaio 2022, la colonna timestamp nella tabella e nella vista object_with_object_properties, che rappresenta la data e l'ora dell'ultimo aggiornamento del record dell'oggetto in HubSpot, sarà updatedat. Questo per allinearsi al modo in cui i dati datetime sono rappresentati nel resto della condivisione dei dati.

Poiché si tratta di una modifica di rottura, la nuova colonna updatedat è stata aggiunta alla tabella e alla vista. Per i prossimi 90 giorni, queste due nuove colonne coesisteranno con timestamp, le colonne che intendono sostituire. Ciò consente di passare all'uso delle nuove colonne.

Dopo 90 giorni, il 25 gennaio 2022, la colonna timestamp verrà rimossa dalla tabella e dalla vista. Dopo questa data, qualsiasi tentativo di interrogare la tabella o la vista object_with_object_properties utilizzando le colonne timestamp fallirà.

Esempio 1

Recuperare tutti i contatti e le loro proprietà.

Interrogazione:

Restituisce:

Esempio 2

Recupera il nome dell'operazione e la fase di un massimo di tre operazioni.

Query:

Restituisce:

oggetti

Questo oggetto di database è un sottoinsieme dei dati dell'oggetto di database object_with_object_properties. Ogni riga restituita riporta l'ID dell'oggetto per ogni record. Questo oggetto di database restituisce solo i record esistenti. Quando un record viene eliminato in HubSpot, viene rimosso da questo oggetto database. Questo oggetto database è un sottoinsieme dei dati della tabella object_with_object_properties. Ogni riga restituita riporta l'ID dell'oggetto per ogni record. Questa vista restituisce solo i record esistenti. Quando un record viene eliminato in HubSpot, viene rimosso da questa vista.

Questo oggetto di database può essere utile se l'account dispone di una grande quantità di dati, per cui le viste object_with_object_properties e objects_x funzionano lentamente. L'uso di questo oggetto database con l'oggetto database object_properties consente di replicare i dati in object_with_object_properties, mantenendo il controllo su quali proprietà vengono restituite.

Questo oggetto database può restituire le seguenti colonne:

Esempio 1

Recuperare tutti i record dei contatti.

Query:

Restituisce:

oggetto_proprietà

Questo oggetto di database è un sottoinsieme dell'oggetto di database object_with_object_properties. Ogni riga contiene il valore corrente della proprietà impostata su un determinato record. Ad esempio, un contatto avrà una riga per la proprietà Nome e una riga per la proprietà Cognome. Se un record non ha un valore per una proprietà, la riga apparirà con una stringa vuota o non apparirà affatto.

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recuperare le proprietà Nome, Cognome e Città per tutti i contatti.

Query:

Restituisce:

Esempio 2

Recupera il nome, il cognome e la fase del ciclo di vita di tutti i contatti e li combina in una riga per ogni contatto. Questo esempio utilizza la sintassi SQL PIVOT.

Query:

Restituisce:

oggetto_proprietà_storia

Questo oggetto del database contiene i valori storici delle proprietà. Per i contatti, contiene i 45 valori più recenti. Per tutti gli altri oggetti, contiene i 20 valori più recenti. Visualizza una riga per ogni valore storico della proprietà. Il valore attuale di una proprietà è determinato dal timestamp UPDATEDAT più recente nella cronologia della proprietà.

Questo oggetto del database può restituire le seguenti colonne:

Esempio 1

Recuperare la cronologia di una singola proprietà per un singolo contatto.

Query:

Restituisce:

Esempio 2

Recuperare il nome attuale di tutti i contatti che hanno avuto una fase del ciclo di vita di Abbonato.

Interrogazione:

Restituisce:

Query sulle associazioni

Come i dati degli oggetti, i dati delle associazioni sono organizzati in due modi:

• Individuale: Ogni tipo di associazione è memorizzato nella propria vista e contiene solo i record di quel tipo. Ad esempio, associazioni_contatti_a_contratti contiene solo i record di associazione tra gli oggetti contatto e contratto. Questo elimina la necessità di specificare un associationtypeid durante l'interrogazione. Queste viste sono abbastanza facili da interrogare, poiché non richiedono familiarità con il modello di dati del CRM per essere utilizzate. Inoltre, restituiscono una descrizione arricchita del record di associazione tra due oggetti, che può essere facilmente utilizzata nei join con le viste objects_x. Se non si verificano query lente, è consigliabile utilizzare queste viste per recuperare i dati delle associazioni. Per saperne di più, vedere le viste associations_x_to_y di seguito.
• Combinato: Tutti i record di tutti i tipi di associazione sono combinati in un unico oggetto del database. Pertanto, quando si esegue una query, è necessario specificare un filtro del tipo "WHERE combinedassociationtypeid='0-32' ". Per saperne di più, vedere le associazioni e le definizioni_di_associazione qui di seguito.

viste associazioni_x_a_y

Ogni tipo di associazione ha una propria vista, etichettata come associazioni_<nome del tipo di associazione>, ad esempio associazioni_contatti_a_commerciali. Ogni vista è un sottoinsieme dei dati dell'oggetto database associazioni e contiene solo i record di uno specifico tipo di associazione combinato.

Ogni oggetto database restituirà le seguenti colonne:

Esempio 1

Recuperare tutti gli accordi associati a un contatto specifico.

Query:

Restituisce:

Esempio 2

Recupera tutti i contatti con sede nel fuso orario di Bogotà e le relative offerte.

Esempio 3

Recupera tutti i contatti e la somma totale degli affari conclusi per ciascun contatto.

Restituisce:

definizioni_di_associazione

Questo oggetto database contiene informazioni su tutti i tipi di associazione disponibili tra gli oggetti HubSpot, con una riga per tipo di associazione. È possibile unire questo oggetto database con l'oggetto database associations per ottenere informazioni sulle associazioni specifiche del record.

Possono esistere più tipi di associazione tra gli stessi oggetti. Il tipo di associazione principale, che è quello visualizzato in HubSpot quando i record sono associati, utilizza l'associazione dove ISMAINASSOCIATIONDEFINITION è true.

Questo oggetto del database può restituire le seguenti colonne:

Esempio 1

Recuperare i tipi di associazione disponibili nell'account.

Query:

Restituisce:

Esempio 2

Recupera i tipi di associazione disponibili tra le transazioni e le aziende.

Query:

Restituisce:

associazioni

Questo oggetto del database contiene informazioni sulle associazioni tra record specifici. Ogni riga rappresenta un'associazione tra un oggetto e un altro oggetto. Le righe possono essere presenti in questo oggetto database anche se i record di riferimento sono stati cancellati. È possibile verificare l'esistenza di record mediante un'associazione con la tabella degli oggetti.

Questo oggetto di database può essere utile se il conto ha una grande quantità di dati e le viste associations_x_to_y funzionano lentamente.

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recuperare tutti gli affari e i contatti associati.

Query:

Restituisce:

Esempio 2

Recuperare tutti i biglietti associati a un contatto specifico (ID contatto: 3005).

Query:

Restituisce:

Esempio 3

Recupera tutte le offerte associate a un contatto specifico (ID contatto: 4464). Invece di codificare in modo rigido combinedAssociationTypeId, questo esempio si unisce con association_definitions.

Query:

Restituisce:

Query sui proprietari

proprietari

Questo oggetto del database contiene informazioni sugli utenti dell'account HubSpot. Gli utenti possono essere impostati come proprietari di record e conterranno sia un ID utente che un ID proprietario, a seconda del contesto. Entrambi gli ID possono essere utilizzati per identificare lo stesso utente.

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recupera tutti gli utenti. Il filtro WHERE archived = false rimuove gli utenti eliminati dai dati restituiti.

Query:

Restituisce:

Esempio 2

Recuperare un proprietario specifico in base al suo ID proprietario.

Interrogazione:

Restituisce:

Esempio 3

Recupera tutti i contatti e i loro proprietari. Questa query unisce i record ai proprietari con object_with_object_properties e la proprietà del contatto hubspot_owner_id.

Restituisce:

Query di team

team

I team in HubSpot consentono di organizzare gli utenti in gruppi per scopi organizzativi e di reporting. È possibile avere un team principale e altri team.

Questo oggetto database contiene informazioni sui team dell'account HubSpot.

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recuperare tutti i team.

Query:

Restituisce:

proprietario_team

Questo oggetto di database contiene informazioni su quali proprietari corrispondono a quali team nell'account HubSpot.

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recuperare tutti i proprietari per un determinato team.

Query:

SELECT teamId, ownerId, isTeamPrimary
FROM teams
WHERE teamId = 29584574

Restituisce

Query sulle pipeline

Di seguito, si spiega come interrogare i dati delle pipeline di deal e ticket, come le pipeline disponibili nel proprio account e le loro fasi.

È possibile unire questi dati con quelli degli oggetti per ottenere una visione completa delle pipeline. Ad esempio, è possibile interrogare le transazioni e le relative pipeline unendo i dati object_deals_view o object_with_object_properties con i dati delle pipeline.

pipeline

Questo oggetto di database contiene informazioni sulle pipeline dei deal e dei ticket presenti nell'account. Ogni riga restituita rappresenta una singola pipeline.

Questa tabella può restituire le seguenti colonne:

Esempio 1

Recuperare tutte le pipeline di deal disponibili, ordinate in base al loro ordine in HubSpot.

Query:

Restituisce:

Esempio 2

Recupera i deal all'interno di una pipeline specifica. Unisce object_with_object_properties e pipeline.

Interrogazione:

Restituisce:

Esempio 3

Come nell'esempio 2, recuperare le offerte all'interno di una pipeline specifica. Ma, invece di usare objects_deals nei join, usare object_with_object_properties.

Restituisce:

pipeline_stages

Questa vista contiene informazioni sulle singole fasi di una pipeline. Identifica gli stadi combinando l'ID del tipo di oggetto, l'ID della pipeline e l'ID dello stadio. Quando ci si unisce con le pipeline, utilizzare l'ID del tipo di oggetto e l'ID della pipeline.

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recuperare le fasi della pipeline per una pipeline di transazioni denominata Pipeline vendite.

Query:

Restituisce:

Esempio 2

Recupera tutte le trattative e le rispettive fasi della pipeline.

Query:

Restituisce:

Query di proprietà

definizioni_di_proprietà

Questo oggetto del database contiene informazioni sulle proprietà degli oggetti e sugli eventi dell'account HubSpot. Le proprietà degli eventi includono eventi standard, come le aperture e i clic delle e-mail, e proprietà di eventi comportamentali personalizzati. Queste informazioni possono essere utili per definire i valori presenti nei dati object_properties ed events.

È possibile identificare proprietà specifiche combinando l'ID del tipo di oggetto e il nome. È possibile recuperare informazioni simili utilizzando l'API delle proprietà.

Questo oggetto del database può restituire le seguenti colonne:

Esempio 1

Recuperare i nomi e le descrizioni di tutte le proprietà dei contatti.

Query:

Restituisce:

Query di eventi

Gli eventi comprendono eventi standard di HubSpot ed eventi comportamentali personalizzati. Ogni evento ha un proprio oggetto di database, etichettato come events_eventname.

È possibile identificare gli eventi combinando l'ID del tipo di evento e l'ID. Le colonne che vengono restituite dipendono dall'evento, con una colonna per ogni proprietà dell'evento. Tutti gli eventi restituiranno le seguenti colonne:

Esempio 1

Recuperare i 50 eventi più recenti di clic sulle e-mail.

Query:

Restituisce:

Esempio 2

Recupera tutti gli eventi di clic delle e-mail in base ai contatti che hanno fatto clic. Questa query ottiene i dati dei contatti unendoli con object_with_object_properties.

Query:

Restituisce:

Query_di_tipo_di_oggetto_e_di_evento

definizioni_di_oggetto_e_tipo_evento

Questo oggetto di database contiene le definizioni di tutti gli oggetti e gli eventi disponibili nell'account HubSpot.

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recuperare tutti gli oggetti e gli eventi disponibili nell'account HubSpot.

Query:

Restituisce:

Query dei segmenti

Di seguito, si spiega come interrogare i segmenti, ad esempio i segmenti dei contatti e delle aziende disponibili e i record inclusi in tali segmenti.

Segmenti

Questo oggetto di database contiene informazioni sui segmenti dei contatti e delle aziende di HubSpot. Restituisce una riga per ogni segmento e le colonne includono i dettagli del segmento, come il nome del segmento, la dimensione e il tipo di oggetto dei record che contiene. Non contiene informazioni sui singoli record di ciascun segmento (vedere segment_membership).

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recuperare tutti i segmenti di contatto.

Query:

Restituisce:

Esempio 2

Recuperare un segmento di contatti specifico denominato Top subscribers 2021.

Query:

Restituisce:

segmento_membri

Questo oggetto di database contiene informazioni su quali record sono membri di quali segmenti, con una riga per ogni record del segmento. Ad esempio, se si dispone di un segmento Blog subscribers con 500 contatti, l'oggetto database restituirà 500 righe.

Contiene solo gli ID dei segmenti e gli ID degli oggetti. Per ulteriori informazioni, unirsi all'oggetto database Segmenti.

Questo oggetto database può restituire le seguenti colonne:

Esempio 1

Recuperare gli ID di tutti i contatti del segmento Top subscribers 2021.

Query:

Restituisce:

Esempio 2

Recuperare i nomi e i cognomi dei contatti nel segmento Top subscribers 2021.

Query:

Restituisce:

Domande frequenti

Voglio generare dati simili a quelli di un report dell'app Hubspot, come posso fare?

In generale, è opportuno esaminare le colonne presenti nel report con cui si effettua il confronto. Se la visualizzazione del report non è tabellare, la conversione in tabella mostrerà le colonne contenute nel report. Queste colonne sono solitamente proprietà di un tipo di oggetto o di un tipo di evento. Il passo successivo è capire a quale proprietà del tipo di oggetto corrisponde una colonna. È possibile farlo interrogando property_definitions:

Non sempre c'è una corrispondenza esatta, perché alcuni nomi di proprietà vengono solitamente risolti con un nome più descrittivo nell'applicazione. In questi casi, può essere utile fare una ricerca confusa usando l'operatore LIKE sulla colonna label (o anche description) in property_definitions.

Dopo aver determinato a quale tipo di oggetto appartiene la colonna, è banale determinare cosa interrogare. Si può semplicemente cercare la vista object_x che corrisponde al tipo.

Come posso collegare questo tipo di dati a un altro, ad esempio come recuperare i moduli per una campagna?

Se è necessario collegare due o più record diversi tra loro, si può ricorrere alle associazioni. Le associazioni rappresentano le relazioni tra gli oggetti in HubSpot CRM. Tutte le diverse associazioni possibili tra due tipi sono elencate in association_definitions. Nell'esempio precedente, per conoscere tutti i moduli a cui è collegata una campagna, è necessario interrogare ASSOCIATIONS_CAMPAIGNS_TO_FORMS:

Come posso conoscere lo stato dell'integrazione HubSpot-Snowflake?

Per ricevere aggiornamenti in tempo reale sullo stato delle interruzioni e dei problemi dell'integrazione HubSpot-Snowflake, interrogate la vista data_share_status:

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

I risultati saranno visualizzati come:

Questa vista fornisce aggiornamenti sullo stato dell'integrazione in ordine cronologico inverso. L'integrazione dei risultati di questa query in un dashboard consente di monitorare le prestazioni dell'integrazione e di individuare eventuali tempi di inattività o interruzioni.