Salta al contenuto
Nota bene: la traduzione in olandese 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: novembre 8, 2021

Si applica a:

Operations Hub Enterprisee

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

Le query sono costruite utilizzando SQL e possono essere utilizzate per recuperare i dati di HubSpot come ad esempio:

  • Oggetti: oggetti standard e personalizzati, come contatti, aziende, prodotti.
  • Record: record individuali, come un contatto individuale o un'azienda.
  • Associazioni: tutti i tipi di associazione disponibili e i record attualmente associati.
  • Proprietari: utenti nel tuo account HubSpot, in relazione ai record di cui sono impostati come proprietari.
  • Pipeline:pipeline di accordi e biglietti, comprese le fasi della pipeline.
  • Proprietà: le proprietà e i loro valori sui record CRM, compresa la storia delle proprietà.
  • Eventi: dati di eventi sia per gli eventi standard di HubSpot, come le aperture delle email, sia per gli eventi comportamentali personalizzati.
  • Elenchi: Elenchi di contatti e aziende di HubSpot (BETA).

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

Imposta il tuo ambiente Snowflake

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

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

  • Nella riga superiore del foglio di lavoro, clicca sulla barra delleazioni del foglio di lavoro.

    snowflake-worksheet-settings0
  • Nella finestra pop-up:
    • Clicca sul menu a tendinaWarehouse, quindi seleziona il tuomagazzino.
    • Fai clic sul menu a discesaDatabase, quindi seleziona il tuo database HubSpot.
    • Fai clic sul menu a discesaSchema, quindi seleziona lo schema che vuoi utilizzare:
      • V2_LIVE: lo schema live basato su Secure Views dei dati HubSpot. I dati in questo schema vengono aggiornati fino a ogni 15 minuti. Se stai interrogando un grande insieme di dati, le query possono essere lente. In questo caso, si consiglia di copiare i dati nella propria tabella prima con un processo ETL, quindi interrogare quella tabella.
      • 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'utilizzo di questo schema risulterà in query più veloci ed è raccomandato per le query direttamente in Snowflake.

      snowflake-worksheet-settings-window0

Con il tuo ambiente configurato, puoi fare delle query ai tuoi dati HubSpot senza bisogno di aggiungere il tuo database o il tipo di schema alle query manualmente.

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


SELEZIONA 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 i dati di HubSpot come ad esempio:

  • Oggetti: oggetti standard e personalizzati, come contatti, aziende, prodotti.
  • Record: record individuali, come un contatto individuale o un'azienda.
  • Associazioni: tutti i tipi di associazione disponibili e i record attualmente associati.
  • Proprietari: utenti nel tuo account HubSpot, in relazione ai record di cui sono impostati come proprietari.
  • Pipeline:pipeline di accordi e biglietti, comprese le fasi della pipeline.
  • Proprietà: proprietà e i loro valori sui record CRM, compresa la storia delle proprietà.
  • Eventi: dati di eventi sia per gli eventi standard di HubSpot, come le aperture delle email, sia per gli eventi comportamentali personalizzati.
  • Elenchi: Elenchi di contatti e aziende di HubSpot (BETA).

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

Limitare e ordinare i dati restituiti

Quando costruisci le query, puoi controllare quanti dati vengono restituiti, insieme all'ordine in cui vengono restituiti, includendo LIMIT e ORDER BY nella tua query. Per esempio, per interrogare tutti i contatti con le loro proprietà, ma restituire solo tre risultati e ordinarli per ID del contatto, potresti costruire la tua query come segue:


SELECT objectTypeId, objectId, properties
da object_with_object_properties
DOVE objectTypeId = '0-1'
ORDINE PER objectId
LIMIT 10;

Interrogazioni di oggetti

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

È possibile utilizzare i seguenti ID oggetto quando si esegue la query:

Nome dell'oggetto ObjectTypeId
Contatti 0-1
Aziende 0-2
Offerte 0-3
Fidanzamento 0-4
Biglietti 0-5
Voci 0-8

Aglioggetti personalizzati sarà assegnato un ID al momento della creazione, e sarà identificato come2-unique_ID. Per esempio,2-12345. Per saperne di più su object_and_event_type_definitions.

oggetto_con_proprietà_oggetto

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

Questa vista può restituire le seguenti colonne:

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

Esempio 1

Recupera tutti i contatti e le loro proprietà.

Domanda:


SELECT objectTypeId, objectId, properties
da object_with_object_properties
DOVE objectTypeId = '0-1'


Ritorna:

OBJECTTYPEID OBJECTID PROPRIETÀ
0-1 38960439 {"createdate": "1504656970152"...}
0-1 321740651 { "createdate": "1590183081949"...}
0-1 98392101 { "createdate": "1533566477279"...}
... ... ...

Esempio 2

Recupera il nome dell'affare e la fase di un massimo di tre affari.

Domanda:


SELEZIONA

objectId,
properties:dealname::string AS dealname,
properties:dealtage::string AS dealtage,
properties:amount::number AS dealamount
da object_with_object_properties
DOVE objectTypeId = '0-3'
LIMIT 3;


Ritorna:

OBJECTID 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 nella 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 cancellato in HubSpot, sarà rimosso da questa vista.

Questa vista può essere utile se il tuo account ha una grande quantità di dati, che portano a object_with_object_properties ad essere lento. Utilizzando questa tabella con la tabella object_properties è possibile replicare i dati in object_with_object_properties, mantenendo il controllo su quali proprietà vengono restituite.

Questa vista può restituire le seguenti colonne:

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

Esempio 1

Recupera tutti i record di contatto.

Domanda:


SELEZIONA objectTypeId, objectId
dagli oggetti
DOVE objectTypeId = '0-1'


Ritorna:

OBJECTTYPEID OBJECTID
0-1 36721864
0-1 103580363
0-1 56047670
... ...

oggetto_proprietà

Questa tabella è un sottoinsieme della tabella object_with_object_properties. Ogni riga contiene il valore corrente della proprietà impostata su un dato record. Per esempio, un contatto avrà una riga per la sua proprietà First name e una riga per la sua proprietàLast name. Se un record non ha un valore per una proprietà, la riga apparirà o con una stringa vuota o non apparirà affatto.

Questa tabella può essere utile se il tuo account ha una grande quantità di dati, portando object_with_object_properties ad eseguire lentamente. Usando questa tabella con la tabella object_properties è possibile replicare i dati in object_with_object_properties, controllando però quali proprietà vengono restituite.

Questa vista può restituire le seguenti colonne:

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

Esempio 1

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

Domanda:


SELECT objectTypeId, objectId, nome, valore
da object_properties
DOVE objectTypeId = '0-1'
E nome in ('nome', 'cognome', 'città')
ORDER BY objectId;


Ritorna:

OBJECTTYPEID OBJECTID 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 Charles
... ... ... ...

Esempio 2

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

Domanda:


SELECT objectId, firstname, lastname, lifecyclestage
DA
(
SELECT objectId, nome, valore
da object_properties
DOVE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'lifecyclestage')
)
PIVOT(MAX(value) FOR name IN ('firstname', 'lastname', 'lifecyclestage')) AS p(objectId, firstname, lastname, lifecyclestage);

Ritorna:

OBJECTTYPEID OBJECTID NOME LASTNAME CICLO DI VITA
0-1 54325098 Hobbes Barone piombo
0-1 96805401 Milo Oro piombo
0-1 6922028 Henry Riley piombo
... ... ... ... ...

storia_di_proprietà_di_oggetto

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 di proprietà. Il valore attuale di una proprietà è determinato dal timestamp UPDATEDAT più recente nello storico della proprietà.

Questa vista può restituire le seguenti colonne:

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

Esempio 1

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

Domanda:


SELECT objectId, nome, valore, timestamp
da object_properties_history
DOVE objectTypeId = '0-1'
E objectId = 585
E nome = 'hs_predictivescoringtier'
ORDER BY timestamp DESC;


Ritorna:

OBJECTTYPEID OBJECTID NOME LASTNAME CICLO DI VITA
0-1 54325098 Hobbes Barone piombo
0-1 96805401 Milo Oro piombo
0-1 6922028 Henry Riley piombo
... ... ... ... ...

Esempio 2

Recupera il nome attuale di tutti i contatti che hanno avuto uno stadio del ciclo di vita di Subscriber.

Domanda:


SELEZIONA
objectId,
properties:firstname::string AS firstname,
properties:lastname::string AS lastname
da object_with_object_properties
WHERE object_with_object_properties.objectTypeId = '0-1'
E objectId IN (
SELECT objectId
da object_properties_history
DOVEobject_properties_history.objectTypeId = '0-1'
E object_properties_history.name = 'lifecyclestage'
E object_properties_history.value = 'subscriber
);


Ritorna:

OBJECTID NOME LASTNAME
54325098 Hobbes Barone
96805401 Milo Oro
6922028 Henry Riley
... ... ...

Interrogazioni dell'associazione

Di seguito, imparate come interrogare le associazioni, come i tipi disponibili di associazioni tra oggetti e i record che sono attualmente associati.

definizioni_associazione

Questa vista contiene informazioni su tutti i tipi di associazione disponibili tra gli oggetti HubSpot, con una riga per tipo di associazione. Puoi unire questa tabella con la tabella delle associazioni per ottenere informazioni sulle associazioni specifiche dei record.

Ci possono essere più tipi di associazioni tra gli stessi oggetti. Il tipo di associazione principale, che è il tipo visualizzato in HubSpot quando i record sono associati, usa l'associazione dove ISMAINASSOCIATIONDEFINITION è vero.

Questa vista può restituire le seguenti colonne:

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

Esempio 1

Recupera i tipi di associazioni disponibili nel tuo account.

Domanda:


SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
da definizioni_associazione
ORDINE PER categoria, id


Ritorna:

ASSOCIAZIONE COMBINATA TIPO FROMOBJECTTYPEID TOOBJECTTYPEID NOME
0-1 0-1 0-2 CONTATTO CON L'AZIENDA
0-2 0-2 0-1 AZIENDA DA CONTATTARE
0-3 0-3 0-1 AFFARE_A_CONTATTO
0-4 0-1 0-3 CONTATTO_ALL'AFFARE
0-5 0-3 0-2 AFFARE_A_SOCIETÀ
... ... ... ...

Esempio 2

Recupera i tipi di associazione disponibili tra accordi e aziende.

Domanda:


SELEZIONAcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
da association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2'
AND isMainAssociationDefinition = true

ORDINE PER categoria, id


Ritorna:

ASSOCIAZIONE COMBINATA TIPO FROMOBJECTTYPEID TOOBJECTTYPEID NOME
0-5 0-3 0-2 AFFARE_A_SOCIETÀ
0-271 0-3 0-2 AFFARE_ALLA_PRIMA_AZIENDA
0-341 0-3 0-2 DA_A_COMPARSA_NON ETICHETTATA

associazioni

Questa vista contiene informazioni sulle associazioni tra specifici record. Ogni riga rappresenta un'associazione da un oggetto ad un altro oggetto. Le righe possono essere presenti in questa tabella anche se i record di riferimento sono stati cancellati. Puoi controllare se i record esistono unendosi con la tabella degli oggetti.

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
COMBINEDASSOCIATIONTYPEID Varchar L'identificatore unico della definizione dell'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 l'ultima volta da Snowflake. Per saperne di più sui tipi di dati delle colonne.

Esempio 1

Recupera tutti gli affari e i contatti associati.

Domanda:


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


Ritorna:

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

Esempio 2

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

Domanda:


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


Ritorna:

ASSOCIAZIONE COMBINATA TIPO FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

Esempio 3

Recupera tutti gli affari associati ad un contatto specifico (ID contatto: 4464). Invece di codificare combinedAssociationTypeId, questo esempio si unisce con association_definitions.

Domanda:


SELECT combinedAssociationType, fromObjectId, toObjectId,
dalle associazioni
DOVE
combinedAssociationTypeId = (
SELEZIONARE combinedAssociationTypeId
da definizioni_associazione
DOVE fromObjectTypeId = '0-1'
E toObjectTypeId = '0-3'
E isMainAssociationDefinition)
E fromObjectId = 4464;


Ritorna:

ASSOCIAZIONE COMBINATA TIPO FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

proprietari

Questa vista contiene informazioni sugli utenti del tuo 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
OWNERID Numero L'ID del proprietario dell'utente.
USERID Numero L'ID utente dell'utente. Gli utenti con NULL in questa colonna sono stati cancellati.
EMAIL Varchar L'indirizzo e-mail dell'utente.
NOME Varchar Il nome dell'utente.
LASTNAME Varchar Il cognome dell'utente.
ISACTIVE Booleano Se l'utente è stato cancellato.
CREATEDAT Timestamp La data e l'ora in cui l'utente è stato creato in HubSpot. Vedi i tipi di dati delle colonne per maggiori informazioni.
AGGIORNATOAT Timestamp La data e l'ora dell'ultimo aggiornamento dell'utente in HubSpot. Vedi i tipi di dati delle colonne per maggiori informazioni.

Esempio 1

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

Domanda:


SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE isActive = true


Ritorna:

OWNERID ACTIVEUSERID EMAIL NOME LASTNAME
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 proprietario.

Domanda:


SELECT ownerId, userId, email, firstname, lastname
dai proprietari
DOVE ownerId = 29584574;


Ritorna:

OWNERID ACTIVEUSERID EMAIL NOME LASTNAME
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à hubspot_owner_id del contatto.


SELEZIONA
contact.objectId contact_id,
contact.properties:firstname::string contact_firstname,
contact.properties:lastname::string contact_lastname,
contact.properties:hubspot_owner_id::number contact_hubspot_owner_id,
owner.firstname owner_firstname,
owner.lastname owner_lastname,
owner.email owner_email
da oggetto_con_oggetto_proprietà contatto
inner join proprietario proprietario su contact.properties:hubspot_owner_id::number = owner.ownerId
dove objectTypeId = '0-1';


Ritorna:

CONTACTID NOME_CONTATTO NOME_CONTATTO CONTATTO_PROPRIETARIO_HUBSPOT NOME_PROPRIETARIO PROPRIETARIO_NOME ULTIMO PROPRIETARIO_EMAIL
113834202 Richard Greenfield 29584574 Hobbes Barone hobbes.b@business.com
53540801 Ford Karl 30241125 Milo Oro milo.g@business.com
... ... ... ... ... ... ...

Interrogazioni della pipeline

Di seguito, imparate come interrogare i dati della pipeline di deal e ticket, come le pipeline disponibili nel vostro account e le loro fasi.

Puoi unire questi dati con i dati degli oggetti per una visione completa delle tue pipeline. Per esempio, puoi interrogare le offerte e le loro pipeline unendo i dati di object_with_object_properties con i dati delle pipeline.

condutture

Questa vista 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:

Nome della colonna Tipo Descrizione
PIPELINEID Varchar L'ID della conduttura.
OBJECTTYPEID Varchar L'ID dell'oggetto che la pipeline può contenere (ad esempio, offerte o biglietti).
ETICHETTA Varchar Il nome della pipeline in HubSpot.
DISPLAYORDER Numero L'ordine in cui la pipeline viene visualizzata in HubSpot.
ARCHIVIO Booleano Se la pipeline è stata cancellata.
CREATEDAT Timestamp Quando la pipeline è stata creata.
AGGIORNATOAT Timestamp La data e l'ora dell'ultimo aggiornamento dei dati in HubSpot. Scopri di più sui tipi di dati delle colonne.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti l'ultima volta da Snowflake.

Esempio 1

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

Domanda:


SELECT objectTypeId, pipelineId, label
dalle condutture
DOVE objectTypeId = '0-3'
E non archiviato
ORDER BY displayorder;


Ritorna:

OBJECTTYPEID 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 accordi all'interno di una specifica pipeline. Unisce object_with_object_properties e pipeline.

Domanda:


SELEZIONA

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


Ritorna:

DEAL_ID NOME_AFFARE NOME DEL PIPLINE
605140072 Iscrizione globale Meowmix Pipeline di vendita
605457408 Friskies rebrand Pipeline di vendita
604362473 Costruire app a passo fresco Pipeline di vendita

fasi della pipeline

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 ci si unisce alle pipeline, si usano 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 conduttura.
OBJECTTYPEID Varchar L'ID dell'oggetto che la pipeline può contenere (ad esempio, offerte o biglietti).
ETICHETTA Varchar Il nome della pipeline in HubSpot.
DISPLAYORDER Numero L'ordine in cui la pipeline viene visualizzata in HubSpot.
ARCHIVIO Booleano Se la pipeline è stata cancellata.
AGGIORNATOAT Timestamp La data e l'ora dell'ultimo aggiornamento dei dati in HubSpot. Scopri di più sui tipi di dati delle colonne.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti l'ultima volta da Snowflake.

Esempio 1

Recupera le fasi della pipeline per una pipeline di affari chiamataSales pipeline.

Domanda:


SELECT pipelineid, stageId, label
da pipeline_stages
DOVE non archiviato
E pipelineid = (
SELEZIONA pipelineid
da condutture
DOVE objectTypeId = '0-3'
E non archiviato
E etichetta = 'Pipeline di vendita' LIMIT 1)
ORDER BY displayorder;


Ritorna:

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

Esempio 2

Recupera tutti gli affari e le loro rispettive fasi della pipeline.

Domanda:


SELEZIONA

deals.objectId deal_id,
deal.properties:dealname::varchar deal_name,
pipeline.label pipeline_name,
pipeline_stage.label pipeline_stage_name
FROM object_with_object_properties 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
WHERE deals.objecttypeId = '0-3';


Ritorna:

DEAL_ID NOME_AFFARE NOME DEL PIPLINE NOME DELLA PIPELINE
605140072 Iscrizione globale Meowmix Pipeline di vendita Contratto inviato
605457408 Friskies rebrand Pipeline di vendita Appuntamento programmato
604362473 Costruire app a passo fresco Pipeline di vendita Contratto firmato
... ... ... ...

definizioni_di_proprietà

Questa vista contiene informazioni sulle proprietà degli oggetti e sugli eventi nel tuo account HubSpot. Le proprietà degli eventi includono gli eventi standard, come le aperture delle email e i click, e le proprietà degli eventi comportamentali personalizzati. Queste informazioni possono essere utili per definire i valori trovati in object_properties e nei dati degli eventi.

Potete identificare proprietà specifiche combinando il loro ID del tipo di oggetto e il loro nome. Potete recuperare informazioni simili usando l'API delle proprietà.

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
OBJECTYPEID Varchar L'ID dell'oggetto a cui si riferisce l'evento.
NOME Varchar Il 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).
FIELDTYPE Varchar Il tipo di campo della proprietà. Definisce come la proprietà viene visualizzata in HubSpot e nei form (per esempio, checkbox, select).
DISPLAYORDER Numero L'ordine di visualizzazione della proprietà.
GROUPNAME Varchar Il nome del gruppo della proprietà.
OPZIONI Variante Per le proprietà di enumerazione, un array di opzioni della proprietà, inclusi gli attributi di ogni opzione (ad esempio, ordine di visualizzazione, etichetta).
CREATEDUSERID Numero L'ID dell'utente che ha creato la proprietà.
REFERENCEDOBJECTTYPE Varchar Il tipo di oggetto a cui la proprietà fa riferimento. Le proprietà proprietario restituiranno un valore di OWNER.
CALCOLATO Booleano Se la proprietà è una proprietà calcolata.
EXTERNALOPTIONS Booleano Se le opzioni della proprietà sono definite in un sistema esterno.
HA UN VALORE UNICO Booleano Se i valori della proprietà sono unici. Può essere impostato solo quando si crea una proprietà attraverso l'API.
HIDDEN Booleano Se la proprietà è nascosta in HubSpot.
SIMBOLO DELLA VETRINA Booleano Se il valore di una proprietà numerica è formattato come valuta.
FORMFIELD Booleano Se questa proprietà può essere usata nei moduli.
READONLYDEFINITION Booleano Se la proprietà può essere modificata in HubSpot.
READONLYVALUE Booleano Se il valore della proprietà può essere modificato in HubSpot.
HUBSPOTDEFINED Booleano Se la proprietà è stata creata da HubSpot o da un utente.
ARCHIVIO Booleano Se la proprietà è stata cancellata.
CREATEDAT 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. Scopri di più sui tipi di dati delle colonne.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti l'ultima volta da Snowflake.

Esempio 1

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

Domanda:


SELEZIONA nome, etichetta, descrizione
dalle definizioni_di proprietà
DOVE objectTypeId = '0-1'


Ritorna:

NOME ETICHETTA DESCRIZIONE
stadio_sql inserito Entrata nella fase SQL Iniziare il conteggio dei giorni della tappa SQL.
nome del primo evento di conversione
Prima conversione Il primo modulo presentato da questo contatto.
indirizzo Indirizzo L'indirizzo del contatto.

Richieste di eventi

Gli eventi includono eventi HubSpot standard ed eventi comportamentali personalizzati. Ogni evento ha una propria vista, etichettata comeEvents_eventname.

Gli eventi disponibili includono:

  • Eventi di clic dell'annuncio(events_ad_clicked)
  • Aperture e clic di e-mail(events_opened_email_V2,events_clicked_link_in_email_v2, ecc.)
  • Analisi web(eventi_visitati_pagina)

Puoi identificare gli eventi combinando il loro 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:

Nome della colonna Tipo Descrizione
EVENTTYPEID Varchar L'ID della conduttura.
ID Varchar L'ID dell'oggetto che la pipeline può contenere (ad esempio, offerte o biglietti).
OBJECTTYPEID Varchar Il tipo di oggetto che ha completato l'evento. Per esempio, un clic su un link e-mail visualizzerebbe0-1 in questa colonna, che rappresenta l'oggetto contatti.
OBJECTID Numero L'ID del record che ha completato l'evento.
OCCORSOIN DATAINT Numero Un numero che rappresenta quando l'evento si è verificato. Contiene gli stessi dati della colonna OCCUREDAT, ma formattati come numero e usati come parte della chiave cluster della tabella. Nella maggior parte dei casi, puoi usare il timestamp OCCUREDAT invece di questo numero.
OCCUREDAT Timestamp Quando si è verificato l'evento.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti l'ultima volta da Snowflake. Per saperne di più sui tipi di dati delle colonne.
PROPRIETÀ_* Varchar Singole colonne contenenti le proprietà dell'evento.

Esempio 1

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

Domanda:


SELECT eventTypeId, objectTypeId, objectId, occuredAt, hs_click_raw_url
FROM events_clicked_link_in_email_V2
ORDER BY occuredAt

LIMIT 50;


Ritorna:

EVENTTYPEID OBJECTTYPEID OBJECTID OCCUREDAT 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 click delle email dai contatti che hanno cliccato. Questa query ottiene i dati dei contatti unendosi a object_with_object_properties.

Domanda:


SELECT
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 events_clicked_link_in_email_V2 click
LEFT JOIN object_with_object_properties contact
ON click.objectTypeId = contact.objectTypeId
AND click.objectId = contact.objectId
LIMIT 3;


Ritorna:

CLICK_TIMESTAMP CLICK_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 oggetto e evento

Questa vista contiene le definizioni di tutti gli oggetti e gli eventi disponibili nel tuo account HubSpot.

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
OBJECTTYPEID Varchar L'ID dell'oggetto che la pipeline può contenere (ad esempio, offerte o biglietti).
FULLYQUALIFIEDNAME Varchar Il nome dell'oggetto o dell'evento.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti 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 tuo account HubSpot.

Domanda:


SELECT objectTypeId, fullyQualifiedName
da object_and_event_type_definitions;


Ritorna:

OBJECTTYPEID FULLYQUALIFIEDNAME
0-1 CONTATTO
0-2 AZIENDA
0-3 DEAL
0-4 INGAGGIO
0-5 TICKET
0-8 LINEA_ITEM
0-11 CONVERSAZIONE
... ...

Elenchi di query (BETA)

Di seguito, imparate come interrogare le vostre liste, come le liste di contatti e di aziende disponibili e i record inclusi in queste liste.

elenca

Questa vista contiene informazioni sui contatti HubSpot e sugli elenchi aziendali. Riporta una riga per elenco e le colonne includono i dettagli dell'elenco come il nome, la dimensione e il tipo di oggetto dei record che contiene. Non contiene informazioni sui singoli record all'interno di ogni lista (vedi list_membership).

Questa vista può restituire le seguenti colonne:

Nome della colonna Tipo Descrizione
OBJECTTYPEID Varchar Il tipo di record nella lista (ad esempio, contatto o azienda).
LISTID Numero L'ID della lista. Si unisce alla colonna LISTID nella tabella list-memberships.
CLASSICLISTID Numero Un ID specifico per le liste di contatti che corrisponde all'ID nell'URL della lista in HubSpot.
LISTNAME Varchar Il nome della lista.
LISTSIZE Numero Il numero di record nella lista.
CREATEDBYUSERID Numero L'ID dell'utente che ha creato la lista.
CREATEDAT Timestamp Quando la lista è stata creata in HubSpot.
UPDATEDBYUSERID Numero L'ID dell'utente che ha aggiornato la lista più recentemente.
AGGIORNATOAT Timestamp La data e l'ora dell'ultimo aggiornamento della data in HubSpot. Scopri di più sui tipi di dati delle colonne.
INGESTEDAT Timestamp La data e l'ora in cui i dati sono stati ingeriti l'ultima volta da Snowflake.

Esempio 1

Recupera tutte le liste di contatti.

Domanda:


SELEZIONA listId, listName, listSize
dagli elenchi
DOVE objectTypeId = '0-1';


Ritorna:

LISTID LISTNAME LISTSIZE
118131 Spostamenti settimanali 103
66156 Iscritti al blog 455
771852 Top abbonati 2021 37
... ... ...

Esempio 2

Recupera un elenco di contatti specifico chiamato Top subscribers 2021.

Domanda:


SELEZIONA listId, listName, listSize
dagli elenchi
WHERE objectTypeId = '0-1'
AND
listName = 'Top subscribers 2021';


Ritorna:

LISTID LISTNAME LISTSIZE
771852 Top abbonati 2021 37

elenco_membri

Questa vista contiene informazioni su quali record sono membri di quali liste, con una riga per record nella lista. Per esempio, se hai una lista di iscritti al Blog con 500 contatti, la tabella restituirà 500 righe.

Contiene solo gli ID dei listini e gli ID degli oggetti. Per maggiori informazioni, unisciti alla tabella dei listini.

Questa vista può restituire le seguenti colonne:

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

Esempio 1

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

Domanda:


Selezionare objectId
da list_memberships
INNER JOIN elenchi
ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021';


Ritorna:

OBJECTID
54325098
96805401
6922028
...

Esempio 2

Recupera il nome e il cognome dei dettagli dei contatti nella Top subscribers 2021

Domanda:


SELEZIONA
contact.objectId AS objectid,
contact.properties:firstname::string AS firstname,
contact.properties:lastname::string AS lastname
da contatto_con_oggetto_proprietà
INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId
INNER JOIN lists ON list_memberships.listId = lists.listId
DOVE
contatto.objectTypeId = '0-1'
AND lists.objectTypeId = '0-1'
AND lists.listName = 'Top Subscribers 2021'


Ritorna:

OBJECTID NOME COGNOME
54325098 Hobbes Barone
96805401 Milo Oro
6922028 Henry Riley
... ... ...

Tipi di dati della colonna

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, includi quella colonna nel campo SELECT della tua query. Per esempio, la seguente query restituirà solo le colonne FROMOBJECTID e TOOBJECTID:


SELEZIONA
fromObjectTypeId, toObjectTypeId
da association_definitions

Qui sotto ci sono definizioni generali per le colonne che una query potrebbe restituire. Per altre definizioni non incluse qui sotto, vedi le definizioni delle singole viste nell'articolo qui sopra.

  • OBJECTTYPEID: un valore VARCHAR che rappresenta il tipo di un oggetto. Per esempio, 0-1 rappresenta l'oggetto contatti, 0-2 rappresenta l'oggetto aziende, e 2-1232 potrebbe rappresentare un oggetto personalizzato nel tuo account. Nelle liste, questo si riferisce al tipo di lista (ad esempio, contatto o azienda). Puoi interrogare tutti gli ID degli oggetti e degli eventi nel tuo account usando la vista object_and_event_type_definitions.
  • OBJECTID: un numero BIGINT che rappresenta un singolo record di un dato 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 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 ingresso di una riga può essere aggiornato anche se nessun'altra colonna della riga è cambiata.
    • Quando si costruiscono processi ETL che copiano dati modificati di recente, si raccomanda di basare le query sul timestamp di ingresso. Inoltre, se il flusso copia i dati quotidianamente, si raccomanda 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 corrisponderanno ai timestamp in HubSpot. Per esempio, il tempo visualizzato in HubSpot per la data di creazione di un record sarà lo stesso del timestamp nella colonna CREATEDAT in Snowflake. Questi non sono direttamente collegati al timestamp di ingestione, e non è raccomandato basare i processi ETL su queste proprietà.
  • COMBINEDASSOCIATIONTYPE: un valore VARCHAR che identifica univocamente una definizione di associazione.