Interrogare i dati di HubSpot in Snowflake

Dopo aver collegato Snowflake al tuo account HubSpot, puoi utilizzare Data Share di Snowflake per interrogare i dati HubSpot dal tuo account Snowflake.

Ritardo dei dati e regione del tuo account Snowflake

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

Nota: le seguenti viste nello schema V2_LIVE vengono aggiornate solo quotidianamente: association_definitions, owners, pipelines e pipeline_stages.

Configura il tuo ambiente Snowflake

Per interrogare i tuoi dati HubSpot in Snowflake, dovrai selezionare il magazzino, il database e lo schema da cui desideri eseguire la query. Puoi impostarli a livello di foglio di lavoro per includerli automaticamente nelle tue query oppure aggiungerli manualmente.

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

1. Nella riga superiore del foglio di lavoro, fai clic sulla barradelle azioni del foglio di lavoro.
   
   
   
2. Nella finestra pop-up:
   • Fai clic sul menu a discesaMagazzino, quindi selezionail tuomagazzino.
   • Fai clic sul menu a discesaDatabase, quindi seleziona il tuo database HubSpot.
   • Fai clic sul menu a discesaSchema, quindi seleziona lo schema che desideri 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'utilizzo di questo schema consentirà di velocizzare le query ed è consigliato per le query dirette in Snowflake.
     • V2_LIVE: lo schema live basato su Secure Views dei dati HubSpot. I dati in questo schema vengono aggiornati ogni 15 minuti. Se stai interrogando un set di dati di grandi dimensioni, le query potrebbero essere lente. In questo caso, si consiglia di copiare prima i dati nella propria tabella con un processo ETL, quindi interrogare quella tabella.
     
     
     
     

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

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

Panoramica dei dati

Le query sono costruite utilizzando SQL e possono essere utilizzate per recuperare dati HubSpot quali:

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

Ulteriori informazioni su modello di dati CRM di HubSpot. 

Nota: Man mano che evolviamo la condivisione dei dati, introdurremo delle modifiche, alcune delle quali potrebbero essere significative. Si consiglia vivamente di iscriversi al registro delle modifiche degli sviluppatori di HubSpot. Queste modifiche saranno sempre pubblicate nel registro delle modifiche prima di qualsiasi aggiornamento.

Limitazione e ordinamento dei dati restituiti

Quando si creano query, è possibile controllare la quantità di dati restituiti e l'ordine in cui vengono restituiti includendoLIMIT e ORDER BY nella query. Ad esempio, per interrogare tutti i contatti con le loro proprietà, ma restituire solo tre risultati e ordinarli in base all'ID del contatto, è possibile creare la query come segue:

Tipi di dati delle colonne

Quando si eseguono query sui dati in Snowflake, le colonne restituite dipendono dai dati oggetto della query. È possibile visualizzare le colonne disponibili per una determinata tabella o vista in Snowflake selezionando la vista nella barra laterale sinistra.

Nota:nel resto di questo documento, utilizziamo il termine oggetto 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 query seguente restituirà solo le colonne OBJECTID e UpdatedAt:


SELECTobjectId, updatedAt
FROM oggetti_contatti



Di seguito sono riportate le definizioni generali delle colonne che una query potrebbe restituire. Per altre definizioni non incluse di seguito, consultare le singole definizioni delle viste nell'articolo sopra riportato.

• OBJECTTYPEID: un valore VARCHAR che rappresenta il tipo di un oggetto. Ad esempio, 0-1 rappresenta l'oggetto contatti, 0-2 rappresenta l'oggetto aziende e 2-1232 potrebbe rappresentare un oggetto personalizzato nel tuo account. Nei segmenti, questo si riferisce al tipo di segmento (ad esempio, contatto o azienda). È possibile interrogare tutti gli ID oggetto ed evento 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 nel tuo account HubSpot. Per identificare un record, è necessario utilizzare sia l'ID del tipo di oggetto che l'ID dell'oggetto.
• INGESTEDAT: il timestamp del momento in cui 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 acquisizione di una riga può essere aggiornato anche se nessun'altra colonna della riga è stata modificata.
  • Quando si creano processi ETL che copiano i dati modificati di recente, si consiglia di basare le query sul timestamp di acquisizione. 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 della data di creazione o aggiornamento dei dati in HubSpot, rappresentato da un valore TIMESTAMP_NTZ . Questi timestamp corrisponderanno ai timestamp in HubSpot. Ad esempio, l'ora visualizzata in HubSpot per la data di creazione di un record sarà la stessa del timestamp nella colonna CREATEDAT in Snowflake. Questi non sono direttamente correlati al timestamp di acquisizione e non è consigliabile basare i processi ETL su queste proprietà.
• COMBINEDASSOCIATIONTYPE: un valore VARCHAR che identifica in modo univoco una definizione di associazione.

Trasformazione dei tipi di dati

A volte, i dati vengono restituiti da una query con colonne VARCHAR quando sarebbe preferibile averli in un tipo diverso. In casi come questo, si consiglia di convertire il tipo di dati VARCHAR nei tipi desiderati utilizzando le funzioni Snowflake. Ad esempio, le proprietà di un record 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



Query sugli oggetti

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

I dati oggetto di diversi tipi 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 objects_contacts contiene solo record di contatti. Ciò elimina la necessità di specificare un objecttypeid durante l'interrogazione. Queste viste sono più facili da interrogare poiché non è necessario conoscere gli ObjectTypeId. Inoltre, restituiscono i dati in un formato più utilizzabile, con ogni riga corrispondente a un oggetto e alla versione corrente delle sue proprietà. Se non si riscontrano rallentamenti nelle query, è consigliabile utilizzare queste viste per recuperare i dati degli oggetti. Per ulteriori informazioni, vedere le viste Objects_X di seguito. 
• Combinate: tutti i record per tutti i tipi di oggetto sono combinati in un unico oggetto del database. Pertanto, durante l'interrogazione, è necessario specificare un filtro come "WHERE objectTypeId='0-1'". Ad esempio, è possibile utilizzare i seguenti objecttypeid durante l'interrogazione:

Agli oggetti personalizzati verrà assegnato un ID al momento della creazione e saranno identificati come2-unique_ID. Ad esempio,2-12345. Scopri di più su object_and_event_type_definitions.

Questi oggetti del database sono generalmente adatti se desideri prestazioni di query migliori rispetto a quelle ottenibili dalle viste objects_x. Per ulteriori dettagli, consulta object_with_object_properties, object_properties, objects e object_properties_history di seguito.

Viste objects_x

In questo oggetto del database, ogni tipo di oggetto disponibile, inclusi gli oggetti personalizzati, ha una propria vista specifica, ciascuna delle quali contiene solo i record relativi agli oggetti di quel tipo specifico. Queste viste sono denominate secondo il formato OBJECTS_<nome tipo di oggetto>, dove <nome tipo di oggetto> è l'etichetta plurale del tipo di oggetto. (Si noti che se il tipo di oggetto non ha una forma plurale, <nome tipo di oggetto> sarà semplicemente l'etichetta singolare del nome del tipo di oggetto concatenata con "S").

Le query su questa vista restituiscono una riga per ogni record all'interno di un oggetto, con ogni proprietà dell'oggetto disponibile come colonna separata.

Di seguito è riportato l'elenco completo dei tipi di oggetti HubSpot disponibili (ovvero non personalizzati), una breve descrizione dei dati che rappresentano e le relative viste:

Ogni oggetto del database restituirà le seguenti colonne:

Esempio 1

Recupera 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 oggetti_contatto



Risultato:

Esempio 2

Recupera il nome e lo stato di massimo tre transazioni.

Query:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM oggetti_transazioni

LIMIT 3

Restituisce:

Esempio 3

Recupera il nome e lo stato delle tre trattative principali in base all'importo.

Query:

Poiché i dati relativi all'importo dell'affare sono disponibili come tipo di dati numerico, è possibile utilizzarli per l'ordinamento senza necessità di conversione o casting.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM oggetti_transazioni
ORDER BY property_amount DESC
LIMIT 3




Restituisce:

oggetto_con_proprietà_oggetto

Questo oggetto database contiene dati provenienti dai tuoi record HubSpot. Le query su questo oggetto database restituiscono una riga per ogni record all'interno di un tipo di oggetto (ad esempio, tutti i record di contatto 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: 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, verrà aggiornata. Ciò al fine di allinearsi con la modalità di rappresentazione dei dati datetime nel resto della condivisione dei dati.

Trattandosi di una modifica significativa, 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ò ti darà la possibilità di passare all'utilizzo 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 avrà esito negativo.

Esempio 1

Recupera tutti i contatti e le loro proprietà.

Query:

Risultato:

Esempio 2

Recupera il nome e lo stato di un massimo di tre transazioni.

Query:

Risultati:

oggetti

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

Questo oggetto database può essere utile se il tuo account contiene una grande quantità di dati, causando un rallentamento delle viste object_with_object_properties e objects_x. L'utilizzo di questo oggetto database con l'oggetto database object_properties consente di replicare i dati in object_with_object_properties, mantenendo il controllo sulle proprietà restituite.

Questo oggetto database può restituire le seguenti colonne:

Esempio 1

Recupera tutti i record dei contatti.

Query:

Restituisce:

object_properties

Questo oggetto database è un sottoinsieme dell'oggetto database object_with_object_properties. Ogni riga contiene il valore corrente della proprietà impostato 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 database può restituire le seguenti colonne:

Esempio 1

Recupera 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 per tutti i contatti e li combina in una riga per contatto. Questo esempio utilizza la sintassi SQL PIVOT.

Query:

Risultati:

object_properties_history

Questo oggetto 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 corrente di una proprietà è determinato dal timestamp UPDATEDATpiù recente nella cronologia della proprietà.

Questo oggetto database può restituire le seguenti colonne:

Esempio 1

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

Query:

 
Risultati:

Esempio 2

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

Query:

Risultati:

Query di associazione

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

• Individuale: ogni tipo di associazione è memorizzato nella propria vista e contiene solo record di quel tipo. Ad esempio, associations_contacts_to_deals contiene solo record di associazione tra oggetti contatto e transazione. Ciò elimina la necessità di specificare un associationtypeid durante l'interrogazione. Queste viste sono piuttosto facili da interrogare poiché non richiedono familiarità con il modello di dati CRM per poterle utilizzare. 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 riscontrano query lente, è consigliabile utilizzare queste viste per recuperare i dati di associazione. Per ulteriori informazioni, vedere le viste associations_x_to_y di seguito. 
• Combinate: tutti i record per tutti i tipi di associazione sono combinati in un unico oggetto database. Pertanto, durante l'interrogazione, è necessario specificare un filtro come "WHERE combinedassociationtypeid='0-32' ". Per ulteriori informazioni, vedere le associazioni e le definizioni di associazione di seguito.

visualizzazioni associations_x_to_y

Ogni tipo di associazione ha una propria vista, denominata associations_<nome del tipo di associazione>, ad esempio associations_contacts_to_deals. Ogni vista è un sottoinsieme dei dati presenti nell'oggetto database delle associazioni e contiene solo i record di uno specifico combinedassociationtypeid.

Ogni oggetto database restituirà le seguenti colonne:

Esempio 1

Recupera tutte le trattative associate a un contatto specifico.

Query:

Risultato:

Esempio 2

Recupera tutti i contatti con fuso orario di Bogotà e le loro trattative.

Esempio 3

Recupera tutti i contatti e la somma totale dell'importo delle trattative concluse per ciascun contatto.

Restituisce:

association_definitions

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

Possono esserci più tipi di associazioni tra gli stessi oggetti. Il tipo di associazione principale, ovvero il tipo visualizzato in HubSpot quando i record sono associati, utilizza l'associazione in cui ISMAINASSOCIATIONDEFINITION è vero.

Questo oggetto database può restituire le seguenti colonne:

Esempio 1 

Recupera i tipi di associazioni disponibili nel tuo account.

Query:

 
Risultati:

Esempio 2

Recupera i tipi di associazioni disponibili tra offerte e aziende.

Query:

Risultati:

associazioni

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

Questo oggetto database può essere utile se il tuo account contiene una grande quantità di dati, causando un rallentamento delle viste associations_x_to_y.

Questo oggetto database può restituire le seguenti colonne:

Esempio 1

Recupera tutte le trattative e i contatti associati.

Query:

 
Risultati: 

Esempio 2 

Recupera tutti i ticket associati a un contatto specifico (ID contatto: 3005).

Query:

Risultati:

Esempio 3 

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

Query:

Risultato:

Query del proprietario

proprietari

Questo oggetto database contiene informazioni sugli utenti del tuo account HubSpot. Gli utenti possono essere impostati come proprietari dei 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 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

Recupera un proprietario specifico in base al suo ID proprietario.

Query:

Risultati: 

Esempio 3

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

Risultato: 

Query del 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 team aggiuntivi.

Questo oggetto database contiene informazioni sui team nel tuo account HubSpot. 

Questo oggetto database può restituire le seguenti colonne:

Esempio 1

Recupera tutti i team.

Query:

Restituisce:

owner_team

Questo oggetto database contiene informazioni su quali proprietari corrispondono a quali team nel tuo account HubSpot. 

Questo oggetto database può restituire le seguenti colonne:

Esempio 1

Recupera tutti i proprietari di un determinato team.

Query:

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

Restituisce

Query pipeline

Di seguito, scopri come interrogare i dati relativi alla pipeline di offerte e ticket, come le pipeline disponibili nel tuo account e le loro fasi.

Puoi unire questi dati con i dati degli oggetti per avere una visione completa delle tue pipeline. Ad esempio, puoi interrogare le trattative e le loro pipeline unendo i dati objects_deals_view o object_with_object_properties con i dati delle pipeline.

Pipeline

Questo oggetto del database contiene informazioni sulle pipeline di deal e ticket nel tuo account. Ogni riga restituita rappresenta una singola pipeline.

Questa tabella può restituire le seguenti colonne:

Esempio 1

Recupera tutte le pipeline di trattative disponibili, ordinate in base al loro ordine in HubSpot.

Query:

 
Risultati: 

Esempio 2

Recupera le trattative all'interno di una pipeline specifica. Unisce object_with_object_properties e pipelines.

Query:

Risultati: 

Esempio 3

Come nell'esempio 2 sopra, recupera le trattative all'interno di una pipeline specifica. Tuttavia, invece di utilizzare objects_deals nei join, utilizza object_with_object_properties.

Restituisce: 

pipeline_stages

Questa vista contiene informazioni sulle singole fasi all'interno di una pipeline. Identifica le fasi combinando l'ID del tipo di oggetto, l'ID della pipeline e l'ID della fase. Quando esegui il join con le pipeline, utilizza l'ID del tipo di oggetto e l'ID della pipeline.

Questo oggetto database può restituire le seguenti colonne:

Esempio 1 

Recupera le fasi della pipeline per una pipeline di trattative denominataPipeline vendite.

Query:

 
Risultati: 

Esempio 2

Recupera tutte le trattative e le rispettive fasi della pipeline.

Query:

Risultati: 

Query sulle proprietà

property_definitions

Questo oggetto database contiene informazioni sulle proprietà degli oggetti e sugli eventi nel tuo account HubSpot. Le proprietà degli eventi includono eventi standard, come aperture e clic delle email, e proprietà degli eventi comportamentali personalizzate. Queste informazioni possono essere utili per definire i valori presenti nei dati object_properties ed events.

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

Questo oggetto database può restituire le seguenti colonne:

Esempio 1

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

Query:

 
Risultati:

Query sugli eventi

Gli eventi includono eventi HubSpot standard ed eventi comportamentali personalizzati. Ogni evento ha un proprio oggetto database, denominato events_eventname.

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

Esempio 1

Recupera i 50 eventi di clic su e-mail più recenti.

Query:

Risultati: 

Esempio 2

Recupera tutti gli eventi di clic sulle e-mail dai contatti che hanno cliccato. Questa query ottiene i dati dei contatti unendo object_with_object_properties.

Query:

Risultato: 

Query_oggetto_e_tipo_evento

object_and_event_type_definitions

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

Questo oggetto database può restituire le seguenti colonne:

Esempio 1

Recupera tutti gli oggetti e gli eventi disponibili nel tuo account HubSpot.

Query:

 
Risultati: 

Query dei segmenti

Di seguito, scopri come interrogare i tuoi segmenti, come i segmenti di contatti e aziende disponibili e i record inclusi in tali segmenti.

segmenti

Questo oggetto database contiene informazioni sui segmenti di contatti e aziende di HubSpot. Restituisce una riga per segmento e le colonne includono dettagli sul segmento, come il nome, la dimensione e il tipo di oggetto dei record che contiene. Non contiene informazioni sui singoli record all'interno di ciascun segmento (vedi segment_membership). 

Questo oggetto database può restituire le seguenti colonne:

Esempio 1

Recupera tutti i segmenti di contatto.

Query:

 
Risultati: 

Esempio 2

Recupera un segmento di contatti specifico denominato Top subscribers 2021. 

Query:

Risultati: 

segment_membership

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

Contiene solo ID segmento e ID oggetto. Per ulteriori informazioni, unisci con l'oggetto database segmenti.

Questo oggetto database può restituire le seguenti colonne:

Esempio 1

Recupera gli ID di tutti i contatti nel segmentoTop subscribers 2021.

Query:

 
Risultati: 

Esempio 2

Recupera il nome e il cognome dei dettagli dei contatti nel segmento Top subscribers 2021.

Query:

Risultati: 

Domande frequenti

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

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

Potrebbe non esserci sempre una corrispondenza esatta perché alcuni nomi di proprietà vengono solitamente risolti in un nome più descrittivo sull'app. In casi come questo, può essere utile eseguire una ricerca approssimativa utilizzando l'operatore LIKE sulla colonna dell'etichetta (o anche della descrizione) in property_definitions.

Dopo aver determinato a quale tipo di oggetto appartiene la colonna, è facile determinare cosa interrogare. È sufficiente 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 tra loro due o più record diversi, dare un'occhiata alle associazioni. Le associazioni rappresentano le relazioni tra gli oggetti nel CRM HubSpot. Tutte le diverse associazioni possibili tra due tipi sono elencate in association_definitions. Nell'esempio sopra, per conoscere tutti i moduli a cui è collegata una campagna, è necessario interrogare ASSOCIATIONS_CAMPAIGNS_TO_FORMS:

Come faccio a conoscere lo stato dell'integrazione HubSpot-Snowflake?

Per ricevere aggiornamenti in tempo reale sullo stato di interruzioni e problemi relativi all'integrazione HubSpot-Snowflake, interroga la vista data_share_status:

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

I risultati verranno visualizzati come:

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