Salta al contenuto
Nota bene: la traduzione in italiano di questo articolo è fornita solo per comodità. La traduzione viene creata automaticamente tramite un software di traduzione e potrebbe non essere stata revisionata. Pertanto, la versione inglese di questo articolo deve essere considerata come la versione di governo contenente le informazioni più recenti. È possibile accedervi qui.
Reports

Interrogare i dati di HubSpot in Snowflake

Ultimo aggiornamento: luglio 25, 2022

Si applica a:

Operations Hub Enterprise

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.

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

  • OggettiOggetti 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.
  • 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à.
  • Eventi: i dati degli eventi sia per gli eventi standard di HubSpot, come le aperture delle e-mail, sia per gli eventi comportamentali personalizzati.
  • Liste: Elenchi di contatti e aziende di HubSpot (BETA).

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

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.

    snowflake-worksheet-settings0
  • 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_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 eseguendo una query su un insieme di dati di grandi dimensioni, 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.

      Nota bene: Questo schema è attualmente disponibile solo se la regione del vostro account Snowflake corrisponde alla regione dell'account Snowflake di HubSpot. Per gli account HubSpot nel data center UE, ciò significa EU_CENTRAL_1_AWS. Per tutti gli altri account HubSpot, significa US_EAST_1_AWS.

      • V2_DAILY (BETA): 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.

      snowflake-worksheet-settings-window0

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:


SELEZIONARE objectTypeId, objectId
FROM hubspot_share_name.V2_LIVE.object_with_object_properties
DOVE objectTypeId = '0-1'

Panoramica dei dati

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

  • OggettiOggetti 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.
  • Proprietari: utenti dell'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à.
  • Eventi: i dati degli eventi sia per gli eventi standard di HubSpot, come le aperture delle e-mail, sia per gli eventi comportamentali personalizzati.
  • Liste: Elenchi di contatti e aziende di HubSpot (BETA).

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

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. 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:


SELEZIONARE objectTypeId, objectId, proprietà
FROM oggetto_con_proprietà_di_oggetto
DOVE objectTypeId = '0-1'
ORDINATO PER objectId
LIMIT 10;

Interrogazione degli oggetti

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

Per l'interrogazione è possibile utilizzare i seguenti ID di oggetto:

Nome dell'oggetto OggettoTipoId
Contatti 0-1
Aziende 0-2
Offerte 0-3
Il fidanzamento 0-4
Biglietti 0-5
Voci di linea 0-8

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.

oggetto_con_proprietà_di_oggetto

Questa vista contiene i dati dei record di HubSpot. Le interrogazioni a questa tabella restituiscono una riga per ogni record all'interno di un oggetto (ad esempio, tutti i record dei contatti nell'oggetto Contatti). Tutte le proprietà sono memorizzate nella colonna Proprietà, che è una colonna Variante Snowflake / JSON colonna.

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
TIPO DI OGGETTO Varchar L'ID del tipo di oggetto (ad esempio, contatti è 0-1).
OGGETTO Numero L'ID del record (ad esempio, un record di contatto con ID 123752).
PROPRIETÀ Variante I valori di proprietà del record.
AGGIORNATOAT Timestamp La data e l'ora dell'ultimo aggiornamento del record in HubSpot. Per saperne di più sui tipi di dati delle colonne.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti per l'ultima volta da Snowflake.

Esempio 1

Recupera tutti i contatti e le loro proprietà.

Interrogazione:


SELEZIONARE objectTypeId, objectId, proprietà
FROM oggetto_con_proprietà_di_oggetto
DOVE objectTypeId = '0-1'


Restituzione:

TIPO DI OGGETTO OGGETTO PROPRIETÀ
0-1 38960439 {"createdate": "1504656970152"...}
0-1 321740651 {"createdate": "1590183081949"...}
0-1 98392101 {"createdate": "1533566477279"...}
... ... ...

Esempio 2

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

Interrogazione:


SELEZIONARE

objectId,
properties:dealname::string AS dealname,
properties:dealstage::string AS dealstage,
properties:amount::number AS dealamount
FROM oggetto_con_proprietà_oggetto
DOVE objectTypeId = '0-3'
LIMITE 3;


Restituzione:

OGGETTO NOME DEALNAME DEALSTAGE DEALAMOUNT
38960439 Nome dell'affare 1
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219
321740651 Nome dell'affare 1
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219
98392101 Nome dell'affare 1
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219

oggetti

Questa vista è 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.

Questa vista può essere utile se l'account ha una grande quantità di dati e quindi object_with_object_properties funziona lentamente. L'uso di questa tabella con la tabella object_properties consente di replicare i dati in object_with_object_properties, mantenendo il controllo sulle proprietà restituite.

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
TIPO DI OGGETTO Varchar L'ID del tipo di oggetto (ad esempio, contatti è 0-1).
OGGETTO Numero L'ID del record (ad esempio, un record di contatto con ID 123752).
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti per l'ultima volta da Snowflake. Per saperne di più sui tipi di dati delle colonne.

Esempio 1

Recuperare tutti i record di contatto.

Interrogazione:


SELEZIONARE objectTypeId, objectId
DA oggetti
DOVE objectTypeId = '0-1'


Restituzione:

TIPO DI OGGETTO OGGETTO
0-1 36721864
0-1 103580363
0-1 56047670
... ...

proprietà_oggetto

Questa tabella è un sottoinsieme della tabella 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.

Questa tabella può essere utile se l'account ha una grande quantità di dati, con conseguente lentezza di esecuzione di object_with_object_properties. L'uso di questa tabella con la tabella object_properties consente di replicare i dati in object_with_object_properties, controllando quali proprietà vengono restituite.

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
TIPO DI OGGETTO Varchar L'ID del tipo di oggetto (ad esempio, contatti è 0-1).
OGGETTO Numero L'ID del record (ad esempio, un record di contatto con ID 123752).
NOME Varchar Il nome della proprietà.
VALORE Timestamp Il valore dell'immobile.
AGGIORNATOAT Timestamp La data e l'ora dell'ultimo aggiornamento del record in HubSpot. Per saperne di più sui tipi di dati delle colonne.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti per l'ultima volta da Snowflake.

Esempio 1

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

Interrogazione:


SELEZIONARE objectTypeId, objectId, name, value
DALLE PROPRIETA' DELL'OGGETTO
DOVE objectTypeId = '0-1'
E nome in ('nome', 'cognome', 'città')
ORDINATO PER objectId;


Restituzione:

TIPO DI OGGETTO OGGETTO NOME VALORE
0-1 10401 nome Brian
0-1 10401 città Dublino
0-1 10401 cognome Gallagher
0-1 23451 nome Fernando
0-1 23451 cognome Fierro
0-1 25751 nome Carlo
... ... ... ...

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:


SELEZIONARE objectId, nome, cognome, fase del ciclo di vita
DA
(
SELECT objectId, nome, valore
DALLE PROPRIETA' DELL'OGGETTO
DOVE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'lifecyclestage')
)
PIVOT(MAX(valore) PER nome IN ('nome', 'cognome', 'fase del ciclo di vita')) AS p(objectId, firstname, lastname, lifecyclestage);

Restituzione:

TIPO DI OGGETTO OGGETTO NOME COGNOME STAGIONE DELLA VITA
0-1 54325098 Hobbes Barone piombo
0-1 96805401 Milo Oro piombo
0-1 6922028 Enrico Riley piombo
... ... ... ... ...

oggetto_proprietà_storia

Questa vista 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à.

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
TIPO DI OGGETTO Varchar L'ID del tipo di oggetto (ad esempio, contatti è 0-1).
OGGETTO Numero L'ID del record (ad esempio, un record di contatto con ID 123752).
NOME Varchar Il nome della proprietà.
VALORE Timestamp Il valore dell'immobile.
AGGIORNATOAT Timestamp La data e l'ora dell'ultimo aggiornamento dei dati in HubSpot. Per saperne di più sui tipi di dati delle colonne.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti per l'ultima volta da Snowflake.

Esempio 1

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

Interrogazione:


SELEZIONARE objectId, nome, valore, timestamp
DALLA STORIA DELLE PROPRIETÀ DEGLI OGGETTI
DOVE objectTypeId = '0-1'
E objectId = 585
E nome = "hs_predictivescoringtier".
ORDINATO PER timestamp DESC;


Restituzione:

TIPO DI OGGETTO OGGETTO NOME COGNOME STAGIONE DELLA VITA
0-1 54325098 Hobbes Barone piombo
0-1 96805401 Milo Oro piombo
0-1 6922028 Enrico Riley piombo
... ... ... ... ...

Esempio 2

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

Interrogazione:


SELEZIONARE
objectId,
properties:firstname::string AS firstname,
proprietà:cognome::stringa COME cognome
FROM oggetto_con_oggetto_proprietà
DOVE oggetto_con_oggetto_proprietà.objectTypeId = '0-1'
E objectId IN (
SELEZIONARE objectId
FROM oggetto_proprietà_storia
DOVEoggetto_con_proprietà_storia.objectTypeId = '0-1'
E object_properties_history.name = 'lifecyclestage'
AND object_properties_history.value = 'subscriber'
);


Restituzione:

OGGETTO NOME COGNOME
54325098 Hobbes Barone
96805401 Milo Oro
6922028 Enrico Riley
... ... ...

Domande di associazione

Di seguito, si spiega come interrogare le associazioni, ad esempio i tipi di associazioni disponibili tra gli oggetti e i record attualmente associati.

definizioni_di_associazione

Questa vista contiene informazioni su tutti i tipi di associazione disponibili tra gli oggetti HubSpot, con una riga per tipo di associazione. È possibile unire questa tabella con la tabella delle 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 è vero.

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
TIPO DI ASSOCIAZIONE COMBINATA Varchar L'identificatore univoco della definizione di associazione.
CATEGORIA Varchar L'origine del tipo di associazione. Una delle seguenti opzioni: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ID Numero L'identificatore della definizione di associazione all'interno della sua categoria.
FROMOBJECTTYPEID Varchar L'ID dell'oggetto che è l'origine della definizione di associazione.
ID TOOBJECTTYPEID Varchar L'ID dell'oggetto che è la destinazione della definizione di associazione.
NOME Varchar Il nome della definizione di associazione.
ETICHETTA Varchar L'etichetta della definizione di associazione.
DEFINIZIONE DI ASSOCIAZIONE PRINCIPALE Booleano Se la definizione di associazione è il tipo principale. Se è vero, la definizione è quella che HubSpot visualizza sui record associati.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti per l'ultima volta da Snowflake. Per saperne di più sui tipi di dati delle colonne.

Esempio 1

Recuperare i tipi di associazioni disponibili nel proprio account.

Interrogazione:


SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
DA DEFINIZIONI_ASSOCIAZIONI
ORDINATO PER categoria, id


Restituzione:

TIPO DI ASSOCIAZIONE COMBINATA FROMOBJECTTYPEID ID TOOBJECTTYPEID NOME
0-1 0-1 0-2 CONTATTO_A_AZIENDA
0-2 0-2 0-1 AZIENDA_DA_CONTATTARE
0-3 0-3 0-1 ACCORDO_A_CONTATTO
0-4 0-1 0-3 CONTATTO_PER_L'AFFARE
0-5 0-3 0-2 ACCORDO_A_AZIENDA
... ... ... ...

Esempio 2

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

Interrogazione:


SELEZIONAREcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
DA DEFINIZIONI_ASSOCIAZIONI
DOVE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2'
E isMainAssociationDefinition = vero

ORDINATO PER categoria, id


Restituzione:

TIPO DI ASSOCIAZIONE COMBINATA FROMOBJECTTYPEID ID TOOBJECTTYPEID NOME
0-5 0-3 0-2 ACCORDO_A_AZIENDA
0-271 0-3 0-2 ACCORDO_A_A_AZIENDA_PRIMARIA
0-341 0-3 0-2 ACCORDO_A_COMAPNY_NON_ETICHETTATO

associazioni

Questa vista 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 questa tabella anche se i record di riferimento sono stati eliminati. È possibile verificare l'esistenza di record mediante un'associazione con la tabella degli oggetti.

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
TIPO DI ASSOCIAZIONE COMBINATA Varchar L'identificatore univoco della definizione di associazione.
FROMOBJECTID Numero L'ID dell'oggetto sorgente.
TOOBJECTID Numero L'ID dell'oggetto di destinazione.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti per l'ultima volta da Snowflake. Per saperne di più sui tipi di dati delle colonne.

Esempio 1

Recuperare tutte le offerte e i contatti associati.

Interrogazione:


SELECT combinedAssociationTypeId, fromObjectId, toObjectId
DA associazioni
DOVE combinedAssociationTypeId = '0-5'


Restituzione:

TIPO DI ASSOCIAZIONE COMBINATA FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335
0-5 6616436082 3866015468
0-5 6690805943 7132752747
... ... ...

Esempio 2

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

Interrogazione:


SELECT combinedAssociationTypeId, fromObjectId, toObjectId
DA associazioni
DOVE associationCategory = 'HUBSPOT_DEFINED'
AND combinedAssociationTypeId = '0-15'
E fromObjectId = 3005;


Restituzione:

TIPO DI ASSOCIAZIONE COMBINATA FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

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:


SELECT combinedAssociationType, fromObjectId, toObjectId,
DALLE ASSOCIAZIONI
DOVE
combinedAssociationTypeId = (
SELECT combinedAssociationTypeId
DA DEFINIZIONI_ASSOCIAZIONI
DOVE fromObjectTypeId = '0-1'
E toObjectTypeId = '0-3'
AND isMainAssociationDefinition)
E fromObjectId = 4464;


Restituzione:

TIPO DI ASSOCIAZIONE COMBINATA FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

Domande del proprietario

proprietari

Questa vista 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 loro contesto. Entrambi gli ID possono essere utilizzati per identificare lo stesso utente.

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
PROPRIETÀ Numero L'ID proprietario dell'utente.
ID UTENTE Numero ID utente dell'utente. Gli utenti con NULL in questa colonna sono stati eliminati.
MANDATO Varchar L'indirizzo e-mail dell'utente.
NOME Varchar Nome dell'utente.
COGNOME Varchar Il cognome dell'utente.
ISATTIVO Booleano Se l'utente è stato cancellato.
CREATO Timestamp La data e l'ora di creazione dell'utente in HubSpot. Per ulteriori informazioni, vedere i tipi di dati delle colonne.
AGGIORNATOAT Timestamp La data e l'ora dell'ultimo aggiornamento dell'utente in HubSpot. Per ulteriori informazioni, vedere i tipi di dati delle colonne.

Esempio 1

Recupera tutti gli utenti. Il filtro WHERE isActive = true rimuove gli utenti eliminati dai dati restituiti.

Interrogazione:


SELECT ownerId, userId, email, firstname, lastname
DAI PROPRIETARI
DOVE isActive = true


Restituzione:

PROPRIETÀ ID UTENTE ATTIVO MANDATO NOME COGNOME
29584574 4621126 233620335 Hobbes Barone
30532717 4874784 3866015468 Pablo Walters
30580321 925511 7132752747 Milo Oro
... ... ... ... ...

Esempio 2

Recupera un proprietario specifico in base al suo ID.

Interrogazione:


SELECT ownerId, userId, email, firstname, lastname
DAI PROPRIETARI
DOVE ownerId = 29584574;


Restituzione:

PROPRIETÀ ID UTENTE ATTIVO MANDATO NOME COGNOME
29584574 4621126 233620335 Hobbes Barone

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.


SELEZIONARE
contact.objectId contact_id,
contact.properties:firstname::string contact_firstname,
contact.properties:lastname::string contact_lastname,
contact.properties:hubspot_owner_id::numero contact_hubspot_owner_id,
proprietario.nome proprietario_nome,
proprietario.cognome proprietario_cognome,
proprietario.email proprietario_email
FROM oggetto_con_proprietà_oggetto contatto
inner join proprietari su contact.properties:hubspot_owner_id::number = owner.ownerId
dove objectTypeId = '0-1';


Restituzione:

CONTATTO NOME_CONTATTO NOME_CONTATTO CONTATTO_HUBSPOT_PROPRIETARIO_ID NOME_PROPRIETARIO NOME_PROPRIETARIO INDIRIZZO E-MAIL DEL PROPRIETARIO
113834202 Riccardo Greenfield 29584574 Hobbes Barone hobbes.b@business.com
53540801 Ford Karl 30241125 Milo Oro milo.g@business.com
... ... ... ... ... ... ...

Interrogazione della pipeline

Di seguito, scoprirete come interrogare i dati 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_with_object_properties con i dati delle pipeline.

condutture

Questa vista contiene informazioni sulle pipeline di transazioni e biglietti presenti nel vostro account. Ogni riga restituita rappresenta una singola pipeline.

Questa tabella può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
PIPELINEID Varchar L'ID della condotta.
TIPO DI OGGETTO Varchar L'ID dell'oggetto che la pipeline può contenere (ad esempio, offerte o biglietti).
ETICHETTA Varchar Il nome della pipeline in HubSpot.
ORDINE DI VISUALIZZAZIONE Numero L'ordine di visualizzazione della pipeline in HubSpot.
ARCHIVIATO Booleano Se la pipeline è stata cancellata.
CREATO Timestamp Quando è stata creata la pipeline.
AGGIORNATOAT Timestamp La data e l'ora dell'ultimo aggiornamento dei dati in HubSpot. Per saperne di più sui tipi di dati delle colonne.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti per l'ultima volta da Snowflake.

Esempio 1

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

Interrogazione:


SELEZIONARE objectTypeId, pipelineId, label
DALLE CONDOTTE
DOVE objectTypeId = '0-3'
E non archiviato
ORDINATO PER ordine di visualizzazione;


Restituzione:

TIPO DI OGGETTO PIPELINEID ETICHETTA
0-3 1bed503c-37f7-4f51-9d40-7598902673f4 Pipeline di vendita
0-3 12659678 Licenze Pipeline
0-3 75e28846-ad0d-4be2-a027-5e1da6590b98 Nuovi affari
... ... ...

Esempio 2

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

Interrogazione:


SELEZIONARE

deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipeline.label pipeline_name
FROM oggetto_con_proprietà_di_oggetto deals
INNER JOIN pipeline
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
DOVE deals.objecttypeId = '0-3'
AND pipelines.objectTypeId = '0-3';


Restituzione:

ID DEAL NOME DEAL NOME TUBO
605140072 Iscrizione globale a Meowmix Pipeline di vendita
605457408 Marchio Friskies Pipeline di vendita
604362473 Costruire un'app a passo fresco Pipeline di vendita

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.

Questa tabella può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
PIPELINEID Varchar L'ID della condotta.
TIPO DI OGGETTO Varchar L'ID dell'oggetto che la pipeline può contenere (ad esempio, offerte o biglietti).
ETICHETTA Varchar Il nome della pipeline in HubSpot.
ORDINE DI VISUALIZZAZIONE Numero L'ordine di visualizzazione della pipeline in HubSpot.
ARCHIVIATO Booleano Se la pipeline è stata cancellata.
AGGIORNATOAT Timestamp La data e l'ora dell'ultimo aggiornamento dei dati in HubSpot. Per saperne di più sui tipi di dati delle colonne.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti per l'ultima volta da Snowflake.

Esempio 1

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

Interrogazione:


SELEZIONARE pipelineid, stageId, label
DA pipeline_stages
DOVE non archiviato
E pipelineid = (
SELEZIONA pipelineid
DALLE CONDOTTE
DOVE objectTypeId = '0-3'
E non archiviata
AND label = 'Sales Pipeline' LIMIT 1)
ORDINAMENTO PER ORDINE DI ESPOSIZIONE;


Restituzione:

PIPELINEID STAGEID ETICHETTA
941650 941651 Contattato
941650 941652 Appuntamento fissato
941650 941653 Fattura inviata
... ... ...

Esempio 2

Recupera tutti gli accordi e le rispettive fasi della pipeline.

Interrogazione:


SELEZIONARE

deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipeline.label nome_pipeline,
pipeline_stages.label pipeline_stage_name
FROM oggetto_con_proprietà_di_oggetto deals
INNER JOIN pipeline
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
INNER JOIN pipeline_stages
ON deals.objectTypeId = pipeline_stages.pipelineid
E deals.properties:pipeline::string = pipeline_stages.pipelineid
E deals.properties:dealstage::string = pipeline_stages.stageId
DOVE deals.objecttypeId = '0-3';


Restituzione:

ID DEAL NOME DEAL NOME TUBO NOME_PIPELINE_STAGE
605140072 Iscrizione globale a Meowmix Pipeline di vendita Contratto inviato
605457408 Marchio Friskies Pipeline di vendita Appuntamento fissato
604362473 Costruire un'app a passi freschi Pipeline di vendita Contratto firmato
... ... ... ...

Domande sulla proprietà

definizioni_di_proprietà

Questa vista 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 in object_properties e nei dati degli eventi.

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

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
TIPO DI OGGETTO Varchar L'ID dell'oggetto a cui si riferisce l'evento.
NOME Varchar Nome interno della proprietà.
ETICHETTA Varchar L'etichetta della proprietà.
DESCRIZIONE Varchar La descrizione della proprietà.
TIPO Varchar Il tipo di proprietà (ad esempio, stringa, numero, data).
TIPO DI CAMPO Varchar Il tipo di campo della proprietà. Definisce la modalità di visualizzazione della proprietà in HubSpot e nei moduli (ad esempio, casella di controllo, selezione).
ORDINE DI VISUALIZZAZIONE Numero L'ordine di visualizzazione della proprietà.
NOME GRUPPO Varchar Il nome del gruppo della proprietà.
OPZIONI Variante Per le proprietà enumerative, una matrice delle opzioni della proprietà, compresi gli attributi di ciascuna opzione (ad esempio, ordine di visualizzazione, etichetta).
ID UTENTE CREATO Numero L'ID dell'utente che ha creato la proprietà.
TIPO DI OGGETTO DI RIFERIMENTO Varchar Il tipo di oggetto a cui fa riferimento la proprietà. Le proprietà Owner restituiranno il valore OWNER.
CALCOLATO Booleano Se la proprietà è una proprietà calcolata.
OPZIONI ESTERNE Booleano Se le opzioni della proprietà sono definite in un sistema esterno.
VALORE DELL'UNIONE Booleano Se i valori della proprietà sono unici. Può essere impostato solo quando si crea una proprietà tramite l'API.
NASCOSTO Booleano Se la proprietà è nascosta in HubSpot.
SIMBOLO DELLA VETRINA Booleano Se il valore di una proprietà numerica è formattato come valuta.
CAMPO DI FORMAZIONE Booleano Se questa proprietà può essere utilizzata nei moduli.
DEFINIZIONE DI SOLA LETTURA Booleano Se la proprietà può essere modificata in HubSpot.
VALORE LEGGIBILE Booleano Se il valore della proprietà può essere modificato in HubSpot.
PUNTO DI MONTAGGIO DEFINITO Booleano Se la proprietà è stata creata da HubSpot o da un utente.
ARCHIVIATO Booleano Se la proprietà è stata eliminata.
CREATO Timestamp La data e l'ora in cui la proprietà è stata creata in HubSpot.
AGGIORNATOAT Timestamp La data e l'ora dell'ultimo aggiornamento dei dati in HubSpot. Per saperne di più sui tipi di dati delle colonne.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti per l'ultima volta da Snowflake.

Esempio 1

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

Interrogazione:


SELEZIONARE nome, etichetta, descrizione
DALLE DEFINIZIONI_PROPRIETARIE
DOVE objectTypeId = '0-1'


Restituzione:

NOME ETICHETTA DESCRIZIONE
inserito_sql_stage Entrata nella fase SQL Inizio conteggio giorni tappa SQL.
nome_evento_di_conversione
Prima conversione Il primo modulo inviato da questo contatto.
indirizzo Indirizzo stradale L'indirizzo del contatto.

Richieste di eventi

Gli eventi comprendono eventi standard di HubSpot ed eventi comportamentali personalizzati. Ogni evento ha una propria vista, etichettata come nome_evento.

Gli eventi disponibili includono:

  • Eventi di clic sugli annunci(events_ad_clicked)
  • Aperture e clic delle e-mail(eventi_apertura_email_V2, eventi_cliccata_collegamento_in_email_v2, ecc.)
  • Analisi web(pagina_eventi_visitati)

È 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:

Attenzione: HubSpot ha aggiunto due nuove colonne a tutte le tabelle e le visualizzazioni degli eventi:

  • si è verificato a
  • si è verificato alla data del

Queste colonne sostituiranno le colonne occuredat e occuredatdateint il 24 aprile 2022. A quella data, le vecchie colonne non saranno più disponibili e i tentativi di interrogare una tabella o una vista contenente eventi che utilizzano tali colonne falliranno. Per saperne di più sui cambiamenti di rotta per le condivisioni di dati Snowflake.



Nome della colonna Tipo Descrizione
EVENTTYPEID Varchar L'ID della condotta.
ID Varchar L'ID dell'oggetto che la pipeline può contenere (ad esempio, offerte o biglietti).
TIPO DI OGGETTO Varchar Il tipo di oggetto che ha completato l'evento. Ad esempio, un clic su un link di posta elettronica visualizzerà 0-1 in questa colonna, che rappresenta l'oggetto Contatti.
OGGETTO Numero L'ID del record che ha completato l'evento.
OCCORRENTE Timestamp Quando si è verificato l'evento.

SI È VERIFICATO ALLA DATA DEL

Numero Un numero che rappresenta la data in cui si è verificato l'evento. Contiene gli stessi dati della colonna OCCURREDAT, ma formattati come numero e utilizzati come parte della chiave cluster della tabella. Nella maggior parte dei casi, è possibile utilizzare il timestamp OCCURREDAT al posto di questo numero.

SI È VERIFICATO ALLA DATAINT

Numero

Un numero che rappresenta la data in cui si è verificato l'evento. Contiene gli stessi dati della colonna OCCURREDAT, ma formattati come numero e utilizzati come parte della chiave cluster della tabella. Nella maggior parte dei casi, è possibile utilizzare il timestamp OCCURREDAT al posto di questo numero.

Attenzione: questa colonna sarà deprecata il 24 aprile 2022 e sostituita da OCCURREDATDATEINT.

OCCORRENTE Timestamp

Quando si è verificato l'evento.

Attenzione: questa colonna sarà deprecata il 24 aprile 2022 e sostituita da OCCURREDAT.

INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti per l'ultima volta da Snowflake. Per saperne di più sui tipi di dati delle colonne.
PROPRIETA'_* Varchar Singole colonne contenenti le proprietà dell'evento.

Esempio 1

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

Interrogazione:


SELECT eventTypeId, objectTypeId, objectId, occuredAt, hs_click_raw_url
FROM eventi_clicked_link_in_email_V2
ORDINATO PER occuredAt

LIMIT 50;


Restituzione:

EVENTTYPEID TIPO DI OGGETTO OGGETTO OCCORRENTE HS_CLICK_RAW_URL
4-666288 0-1 45318579 2016-08-04 21:06:43.245 http://website.com?utm_campaign=Launch&utm_source=hs_email&utm_medium=email&utm_content=32520579
4-666288 0-1 80701 2016-08-29 13:31:28.622 https://cta-image-cms2.hubspot.com/ctas/v2/public/cs/ci/?pg=f0f6585a-08fc-4273-8422-49cfaddcf8d8&pid=1976760&ecid=ACsprvtkRbakerw4BiWlaDL7xFAqau1aW9m1_PAqSfQiWarY69X7Ds42zHGYTCfhHJLrXUP86Nxu
4-666288 0-1 26146013 2017-11-30 14:27:11.528 https://hubs.ly/H097a37a?utm_source=hs_email&utm_medium=email&utm_content=58251290
... ... ... ... ...

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:


SELEZIONARE
click.timestamp click_timestamp,
click.property_hs_click_raw_url click_url,
contact.properties:firstname::varchar contact_firstname,
contact.properties:lastname::varchar contact_lastname
FROM eventi_cliccati_collegamento_in_email_V2 click
LEFT JOIN oggetto_con_proprietà_oggetto contatto
ON click.objectTypeId = contact.objectTypeId
E click.objectId = contact.objectId
LIMITE 3;


Restituzione:

CLICK_TIMESTAMP CLICCA_URL NOME_CONTATTO NOME_CONTATTO
2019-01-04 22:35:41.264 https://help.website.com/articles/tutorial/how-to-use-email-tool?utm_source=hs_automation&utm_medium=email&utm_content=68042217 Hobbes Barone
2018-11-08 09:37:41.400 https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164 Milo Oro
2018-11-08 09:37:41.426 https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164 Harlow Villari
... ... ... ...

definizioni_di_tipo_di_oggetto_e_di_evento

Questa vista contiene le definizioni di tutti gli oggetti e gli eventi disponibili nell'account HubSpot.

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
TIPO DI OGGETTO Varchar L'ID dell'oggetto che la pipeline può contenere (ad esempio, offerte o biglietti).
NOME COMPLETAMENTE QUALIFICATO Varchar Il nome dell'oggetto o dell'evento.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti per l'ultima volta da Snowflake. Per saperne di più sui tipi di dati delle colonne.

Esempio 1

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

Interrogazione:


SELEZIONARE objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;


Restituzione:

TIPO DI OGGETTO NOME COMPLETAMENTE QUALIFICATO
0-1 CONTATTO
0-2 AZIENDA
0-3 DEAL
0-4 INGAGGIO
0-5 BIGLIETTO
0-8 LINE_ITEM
0-11 CONVERSAZIONE
... ...

Elenchi di query (BETA)

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

Questa vista 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).

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
TIPO DI OGGETTO Varchar Il tipo di record dell'elenco (ad esempio, contatto o azienda).
LISTA Numero L'ID dell'elenco. Si unisce alla colonna LISTID della tabella List-Memberships.
CLASSICLISTID Numero Un ID specifico per gli elenchi di contatti che corrisponde all'ID nell'URL dell'elenco in HubSpot.
NOME ELENCO Varchar Il nome dell'elenco.
DIMENSIONE Numero Il numero di record nell'elenco.
CREATO DA USERID Numero L'ID dell'utente che ha creato l'elenco.
CREATO Timestamp Quando l'elenco è stato creato in HubSpot.
AGGIORNATO PER ID UTENTE Numero L'ID dell'utente che ha aggiornato l'elenco più di recente.
AGGIORNATOAT Timestamp La data e l'ora dell'ultimo aggiornamento in HubSpot. Per saperne di più sui tipi di dati delle colonne.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti per l'ultima volta da Snowflake.

Esempio 1

Recupera tutti gli elenchi di contatti.

Interrogazione:


SELEZIONARE listId, listName, listSize
da elenchi
DOVE objectTypeId = '0-1';


Restituzione:

LISTA NOME ELENCO DIMENSIONE
118131 Attività di sensibilizzazione settimanale 103
66156 Iscritti al blog 455
771852 Primi abbonati 2021 37
... ... ...

Esempio 2

Recuperare un elenco di contatti specifico denominato Top subscribers 2021.

Interrogazione:


SELEZIONARE listId, listName, listSize
DA LISTE
DOVE objectTypeId = '0-1'
E
listName = 'Top subscribers 2021';


Restituzione:

LISTA NOME ELENCO DIMENSIONE
771852 Primi abbonati 2021 37

elenco_membri

Questa vista 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, la tabella restituirà 500 righe.

Contiene solo gli ID degli elenchi e gli ID degli oggetti. Per ulteriori informazioni, unirsi alla tabella degli elenchi.

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
LISTA Varchar L'ID dell'elenco. Si unisce alla colonna HS_LIST_ID della tabella elenchi.
OGGETTO Varchar L'ID del record nell'elenco.
AGGIORNATOAT Timestamp La data e l'ora dell'ultimo aggiornamento dei dati in HubSpot. Per saperne di più sui tipi di dati delle colonne.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti per l'ultima volta da Snowflake.

Esempio 1

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

Interrogazione:


SELEZIONARE l'oggettoId
DA lista_membri
INNER JOIN elenchi
su list_memberships.listId = lists.listId
DOVE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021';


Restituzione:

OGGETTO
54325098
96805401
6922028
...

Esempio 2

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

Interrogazione:


SELEZIONARE
contatto.objectId come objectid,
contact.properties:firstname::string AS firstname,
contact.properties:lastname::string AS lastname
FROM oggetto_con_proprietà_di_oggetto contatto
INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId
INNER JOIN liste su list_memberships.listId = lists.listId
DOVE
contact.objectTypeId = '0-1'
E lists.objectTypeId = '0-1'
AND lists.listName = 'Top Subscribers 2021'


Restituzione:

OGGETTO NOME COGNOME
54325098 Hobbes Barone
96805401 Milo Oro
6922028 Enrico Riley
... ... ...

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.

snowflake-sidebar-view-column-details0


Per restituire una colonna specifica, includerla nel campo SELECT della query. Ad esempio, la seguente query restituirà solo le colonne FROMOBJECTID e TOOBJECTID:


SELEZIONARE
daObjectTypeId, toObjectTypeId
DA DEFINIZIONI_ASSOCIAZIONI

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_tipo_oggetto_e_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. Questi non sono direttamente correlati al timestamp di ingestione e non è consigliabile basare i processi ETL su queste proprietà.
  • COMBINEDASSOCIATIONTYPE: un valore VARCHAR che identifica in modo univoco una definizione di associazione.
Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.