Interrogare i dati di HubSpot in Snowflake

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

Ritardo nei dati e regione del vostro account Snowflake

Si avrà accesso allo schema V2_LIVE, aggiornato ogni 15 minuti, e allo schema V2_DAILY, aggiornato ogni giorno.

Nota bene: le seguenti viste dello schema V2_LIVE vengono aggiornate solo giornalmente: 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 e selezionare il magazzino.
  • Fare clic sul menu a discesa Database e 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:

Panoramica dei dati

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

• Oggetti: oggetti standard e personalizzati, come contatti, aziende, prodotti.
• Record: record individuali, 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.
• Elenchi: Elenchi di contatti e aziende di HubSpot.
• Proprietari: utenti del vostro account HubSpot, in relazione ai record di cui sono impostati come proprietari.
• Pipeline: pipeline di transazioni e ticket, comprese le fasi della pipeline.
• Proprietà: proprietà e relativi valori sui record del CRM, compresa la cronologia delle proprietà.

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

Nota bene: con l'evolversi della condivisione dei dati, introdurremo modifiche, alcune delle quali di rottura. Si consiglia vivamente di iscriversi al change log 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, si può controllare la quantità di dati restituiti e l'ordine in cui vengono restituiti, includendo LIMIT e ORDER BY nella query. Per esempio, per interrogare tutti i contatti con le loro proprietà, ma restituendo solo tre risultati e ordinandoli per ID 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, utilizzeremo il termine oggetto di 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 restituirà solo le colonne OBJECTID e UpdatedAt:


SELECTobjectId, updatedAt
FROM objects_contacts



Di seguito sono riportate le definizioni generali delle colonne che una query potrebbe restituire. Per altre definizioni non incluse di seguito, si vedano 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 dell'account. Negli elenchi, questo valore si riferisce al tipo di elenco (ad esempio, contatti o aziende). È possibile interrogare tutti gli ID degli oggetti e degli eventi dell'account utilizzando la vista Definizioni_di_tipo_di_oggetto_e_di_evento.
• 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 vengono restituiti da una query con colonne VARCHAR quando sarebbe auspicabile che fossero di tipo diverso. In questi casi, si consiglia di convertire il tipo di dati VARCHAR nei tipi desiderati utilizzando 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 usate 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 degli oggetti

Di seguito, scoprirete 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 vengono 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 dei tipi di oggetto e di evento.

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

oggetti_x viste

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 OBJECTS_<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 oggetti HubSpot (cioè non personalizzati) disponibili, una breve descrizione dei dati che rappresentano e le viste corrispondenti:

Ogni oggetto del database restituisce le seguenti colonne:

Esempio 1

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

Interrogazione:


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



Restituzione:

Esempio 2

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

Query:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

Restituzione:

Esempio 3

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

Interrogazione:

Poiché i dati relativi alla quantità di deal 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 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 Properties, che è una colonna Snowflake Variant / JSON.

Questa vista può restituire le seguenti colonne:

Attenzione: 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. In questo modo si ha la possibilità 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

Recupera tutti i contatti e le loro proprietà.

Interrogazione:

Restituzione:

Esempio 2

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

Interrogazione:

Restituzione:

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 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 ha una grande quantità di dati, con conseguente rallentamento delle prestazioni delle viste object_with_object_properties e objects_x. 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 di database può restituire le seguenti colonne:

Esempio 1

Recuperare tutti i record di contatto.

Interrogazione:

Restituzione:

proprietà_oggetto

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

Recupera le proprietà di nome, cognome e città per tutti i contatti.

Interrogazione:

Restituzione:

Esempio 2

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

Interrogazione:

Restituzione:

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 di database può restituire le seguenti colonne:

Esempio 1

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

Interrogazione:

Restituzione:

Esempio 2

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

Interrogazione:

Restituzione:

Domande di associazione

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_affari contiene solo i record di associazione tra gli oggetti contatto e affare. 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 qui di seguito.
• Combinato: Tutti i record di tutti i tipi di associazione vengono combinati in un unico oggetto del database. Pertanto, quando si esegue una query, è necessario specificare un filtro come "WHERE combinedassociationtypeid='0-32' ". Per saperne di più, vedere le associazioni e le definizioni_di_associazione qui di seguito.

associazioni_x_a_y viste

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

Ogni oggetto del database restituisce le seguenti colonne:

Esempio 1

Recupera tutte le offerte associate a un contatto specifico.

Interrogazione:

Restituzione:

Esempio 2

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

Esempio 3

Recupera tutti i contatti e la somma totale delle transazioni chiuse per ogni contatto.

Restituzione:

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 associazioni per ottenere informazioni sulle associazioni specifiche del record.

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

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recuperare i tipi di associazioni disponibili nel proprio account.

Interrogazione:

Restituzione:

Esempio 2

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

Interrogazione:

Restituzione:

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 l'account ha una grande quantità di dati, con conseguente lentezza delle viste associations_x_to_y.

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recupera tutte le offerte e i contatti associati.

Interrogazione:

Restituzione:

Esempio 2

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

Interrogazione:

Restituzione:

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 a association_definitions.

Interrogazione:

Restituzione:

Domande del proprietario

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.

Interrogazione:

Restituzione:

Esempio 2

Recupera un proprietario specifico in base al suo ID.

Interrogazione:

Restituzione:

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.

Restituzione:

Domande del team

squadre

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

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

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recuperare tutte le squadre.

Interrogazione:

Restituzione:

squadra_proprietario

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

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recupera tutti i proprietari di una determinata squadra.

Interrogazione:

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

Restituzioni

Interrogazione della pipeline

Di seguito, scoprirete come interrogare idati della pipeline di transazioni e ticket, come le pipeline disponibili nel vostro 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.

condutture

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

Questa tabella può restituire le seguenti colonne:

Esempio 1

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

Interrogazione:

Restituzione:

Esempio 2

Recupera gli affari all'interno di una pipeline specifica. Unisce object_with_object_properties e pipeline.

Interrogazione:

Restituzione:

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.

Restituzione:

Stadi della pipeline

Questa vista contiene informazioni sulle singole fasi di una pipeline. Gli stadi si identificano combinando l'ID del tipo di oggetto, l'ID della pipeline e l'ID dello stadio. Quando ci si unisce alle pipeline, si usa l'ID del tipo di oggetto e l'ID della pipeline.

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recupera le fasi della pipeline per una pipeline di trattative denominata Pipeline di vendita.

Interrogazione:

Restituzione:

Esempio 2

Recupera tutti gli accordi e le rispettive fasi della pipeline.

Interrogazione:

Restituzione:

Domande sulla 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 di database può restituire le seguenti colonne:

Esempio 1

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

Interrogazione:

Restituzione:

Richieste 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 restituiscono le seguenti colonne:

Esempio 1

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

Interrogazione:

Restituzione:

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 a object_with_object_properties.

Interrogazione:

Restituzione:

Richieste_di_tipo_di_oggetto_e_di_evento

definizioni_di_tipo_di_oggetto_e_di_evento

Questo oggetto del 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

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

Interrogazione:

Restituzione:

Elenchi di query

Di seguito, si spiega come interrogare gli elenchi, ad esempio gli elenchi di contatti e di aziende disponibili e i record inclusi in tali elenchi.

elenchi

Questo oggetto di database contiene informazioni sugli elenchi di contatti e aziende di HubSpot. Restituisce una riga per ogni elenco e le colonne includono i dettagli dell'elenco, come il nome dell'elenco, le dimensioni e il tipo di oggetto dei record che contiene. Non contiene informazioni sui singoli record di ciascun elenco (vedere list_membership).

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recupera tutti gli elenchi di contatti.

Interrogazione:

Restituzione:

Esempio 2

Recuperare un elenco di contatti specifico denominato Top subscribers 2021.

Interrogazione:

Restituzione:

elenco_membri

Questo oggetto database contiene informazioni su quali record sono membri di quali elenchi, con una riga per ogni record dell'elenco. Ad esempio, se si dispone di un elenco di iscritti al blog con 500 contatti, l'oggetto database restituirà 500 righe.

Contiene solo gli ID degli elenchi e gli ID degli oggetti. Per ulteriori informazioni, unirsi all'oggetto del database Elenchi.

Questo oggetto di database può restituire le seguenti colonne:

Esempio 1

Recupera gli ID di tutti i contatti nell'elenco Top subscribers 2021.

Interrogazione:

Restituzione:

Esempio 2

Recupera i nomi e i cognomi dei contatti presenti nell'elenco Top subscribers 2021.

Interrogazione:

Restituzione:

Domande frequenti

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

In generale, si desidera 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:

Potrebbe non esserci sempre una corrispondenza esatta, perché alcuni nomi di proprietà vengono solitamente risolti con un nome più descrittivo nell'applicazione. In casi come questo, 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 avete bisogno di collegare due o più record diversi tra loro, date un'occhiata 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 faccio a conoscere lo stato dell'integrazione HubSpot-Snowflake?

Per ricevere aggiornamenti in tempo reale sullo stato delle interruzioni e dei problemi dell'integrazione HubSpot-Snowflake, interrogare 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.