Fråga efter HubSpot-data i Snowflake
Senast uppdaterad: mars 4, 2022
Gäller för:
Operations Hub Enterprise |
När du har anslutit Snowflake till ditt HubSpot-konto kan du använda Snowflakes datadelning för att fråga efter HubSpot-data från ditt Snowflake-konto.
Förfrågningar konstrueras med hjälp av SQL och kan användas för att hämta HubSpot-data, t.ex:
- Objekt: standardobjekt och anpassade objekt, t.ex. kontakter, företag och produkter.
- Register: enskilda register, t.ex. en enskild kontaktperson eller ett företag.
- Föreningar: alla tillgängliga associationstyper och för närvarande associerade poster.
- Ägare: Användare i ditt HubSpot-konto i förhållande till de poster som de är ägare till.
- Pipelines:pipelines för affärer och biljetter, inklusive pipeline-steg.
- Egenskaper: egenskaper och deras värden i CRM-poster, inklusive egenskapshistorik.
- Evenemang: Händelsedata för både standardhändelser i HubSpot, t.ex. öppning av e-postmeddelanden, och anpassade beteendehändelser.
- Listor: HubSpot-listor över kontakter och företag (BETA).
Läs mer om HubSpots CRM-datamodell.
Konfigurera din Snowflake-miljö
För att söka efter HubSpot-data i Snowflake måste du välja lager, databas och schema som du vill söka från. Du kan antingen ställa in dem på kalkylbladsnivå för att inkludera dem automatiskt i dina frågor eller så kan du lägga till dem manuellt.
Välj lager, databas och schema på kalkylbladsnivå:
- Klicka påÅtgärdsfältet för arbetsbladet på den övre raden i arbetsbladet.
- I popup-fönstret:
- Klicka på rullgardinsmenynLager och välj sedan dittlager.
- Klicka på rullgardinsmenynDatabas och välj sedan din HubSpot-databas.
- Klicka på rullgardinsmenynSchema och välj sedan det schema du vill använda:
- V2_LIVE: det levande schemat baserat på säkra vyer av HubSpot-data. Data i det här schemat uppdateras upp till var 15:e minut. Om du frågar efter en stor uppsättning data kan frågorna vara långsamma. I det här fallet rekommenderas att du först kopierar data till en egen tabell med en ETL-process och sedan frågar i den tabellen.
- V2_DAILY (BETA): Det dagliga schemat för att söka data baserat på tabeller. Data i detta schema uppdateras en gång per dag. Användning av detta schema ger snabbare sökningar och rekommenderas för sökningar direkt i Snowflake.
När din miljö är konfigurerad kan du göra sökningar på dina HubSpot-data utan att behöva lägga till din databas eller schematyp manuellt i sökningar.
Om du vill lägga till din databas och schematyp manuellt i frågor lägger du till databasnamnet följt av schemat i början av FROM-fältet
. Till exempel:
SELECT objectTypeId, objectId
FROM hubspot_share_name.V2_LIVE.object_with_object_properties
WHERE objectTypeId = '0-1'
Översikt över uppgifter
Förfrågningar konstrueras med hjälp av SQL och kan användas för att hämta HubSpot-data, t.ex:
- Objekt: standardobjekt och anpassade objekt, t.ex. kontakter, företag och produkter.
- Register: enskilda register, t.ex. en enskild kontaktperson eller ett företag.
- Föreningar: alla tillgängliga associationstyper och för närvarande associerade poster.
- Ägare: Användare i ditt HubSpot-konto i förhållande till de poster som de är ägare till.
- Pipelines:pipelines för affärer och biljetter, inklusive pipeline-steg.
- Egenskaper: egenskaper och deras värden i CRM-poster, inklusive egenskapshistorik.
- Evenemang: Händelsedata för både standardhändelser i HubSpot, t.ex. öppning av e-postmeddelanden, och anpassade beteendehändelser.
- Listor: HubSpot-listor över kontakter och företag (BETA).
Läs mer om HubSpots CRM-datamodell.
Begränsning och ordnande av returnerade uppgifter
När du konstruerar frågor kan du kontrollera hur mycket data som returneras och i vilken ordning den returneras genom att inkludera LIMIT
och ORDER BY
i din fråga. Om du till exempel vill fråga efter alla kontakter med deras egenskaper, men bara returnera tre resultat och ordna dem efter kontakt-ID, kan du konstruera din fråga på följande sätt:
SELECT objectTypeId, objectId, egenskaper
FROM object_with_object_properties
WHERE objectTypeId = "0-1
ORDER BY objectId
LIMIT 10;
Förfrågningar om objekt
Nedan får du veta hur du frågar efter data från specifika HubSpot-objekt och -poster och vilka data som returneras.
Du kan använda följande objekt-ID:n när du gör sökningar:
Objektnamn | ObjectTypeId |
Kontakter | 0-1 |
Företag | 0-2 |
Erbjudanden | 0-3 |
Förlovning | 0-4 |
Biljetter | 0-5 |
Poster | 0-8 |
Anpassade objekt kommer att tilldelas ett ID när de skapas och identifieras som2-unique_ID. Till exempel2-12345. Läs mer om object_and_event_type_definitions.
object_with_object_properties
Den här vyn innehåller data från dina HubSpot-poster. Förfrågningar till den här tabellen returnerar en rad för varje post i ett objekt (t.ex. alla kontaktposter i contacts-objektet). Alla egenskaper lagras i kolumnen Egenskaper, som är en Snowflake-variant / JSON kolumn.
Denna vy kan visa följande kolumner:
Namn på kolumnen | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | ID för objekttypen (t.ex. kontakter är 0-1 ). |
OBJECTID |
Antal | Postens ID ( t.ex. en kontaktpost med ID 123752 ). |
EGENSKAPER |
Variant | Registrets fastighetsvärden. |
UPDATEDAT |
Tidsstämpel | Datum och tid då posten senast uppdaterades i HubSpot. Läs mer om kolumndatatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast När uppgifterna senast togs in av Snowflake. |
Exempel 1
Hämta alla kontakter och deras egenskaper.
Fråga:
SELECT objectTypeId, objectId, egenskaper
FROM object_with_object_properties
WHERE objectTypeId = "0-1
Returnerar:
OBJECTTYPEID | OBJECTID | EGENSKAPER |
0-1 | 38960439 | {"skapad": "1504656970152"...} |
0-1 | 321740651 | { "createdate": "1590183081949"...} |
0-1 | 98392101 | { "createdate": "1533566477279"...} |
... | ... | ... |
Exempel 2
Hämta namn och stadium för upp till tre affärer.
Fråga:
SELECTobjectId,
properties:dealname::string AS dealname,
properties:dealstage::string AS dealstage,
properties:amount::number AS dealamount
FROM object_with_object_properties
WHERE objectTypeId = "0-3
LIMIT 3;
Returnerar:
OBJECTID | DEALNAME | DEALSTAGE | DEALAMOUNT |
38960439 | Namn på affären 1 |
2021-10-12 13:49:35.219
|
2021-10-12 13:49:35.219
|
321740651 | Namn på affären 1 |
2021-10-12 13:49:35.219
|
2021-10-12 13:49:35.219
|
98392101 | Namn på affären 1 |
2021-10-12 13:49:35.219
|
2021-10-12 13:49:35.219 |
objekt
Den här vyn är en delmängd av uppgifterna i tabellen object_with_object_properties. Varje returnerad rad returnerar objekt-ID för varje post. Den här vyn returnerar endast befintliga poster. När en post tas bort i HubSpot tas den bort från den här vyn.
Den här vyn kan vara användbar om ditt konto har en stor mängd data, vilket leder till att object_with_object_properties fungerar långsamt. Genom att använda den här tabellen tillsammans med tabellen object_properties blir det möjligt att replikera data i object_with_object_properties, samtidigt som man behåller kontrollen över vilka egenskaper som returneras.
Denna vy kan visa följande kolumner:
Namn på kolumnen | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | ID för objekttypen (t.ex. kontakter är 0-1 ). |
OBJECTID |
Antal | Postens ID ( t.ex. en kontaktpost med ID 123752 ). |
INGESTEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast togs in av Snowflake. Läs mer om kolumndatatyper. |
Exempel 1
Hämta alla kontaktuppgifter.
Fråga:
SELECT objectTypeId, objectId
FROM objects
WHERE objectTypeId = '0-1'
Returnerar:
OBJECTTYPEID | OBJECTID |
0-1 | 36721864 |
0-1 | 103580363 |
0-1 | 56047670 |
... | ... |
objekt_egenskaper
Denna tabell är en delmängd av tabellen object_with_object_properties. Varje rad innehåller det aktuella egenskapsvärdet för en viss post. En kontakt har till exempel en rad för egenskapen Förnamn och en rad för egenskapenEfternamn. Om en post inte har något värde för en egenskap visas raden antingen med en tom sträng eller inte alls.
Den här tabellen kan vara användbar om ditt konto har en stor mängd data, vilket leder till att object_with_object_properties fungerar långsamt. Genom att använda den här tabellen tillsammans med tabellen object_properties är det möjligt att replikera data i object_with_object_properties, samtidigt som man kontrollerar vilka egenskaper som returneras.
Denna vy kan visa följande kolumner:
Namn på kolumnen | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | ID för objekttypen (t.ex. kontakter är 0-1 ). |
OBJECTID |
Antal | Postens ID ( t.ex. en kontaktpost med ID 123752 ). |
NAMN |
Varchar | Namnet på egenskapen. |
VÄRDE |
Tidsstämpel | Fastighetens värde. |
UPDATEDAT |
Tidsstämpel | Datum och tid då posten senast uppdaterades i HubSpot. Läs mer om kolumndatatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast När uppgifterna senast togs in av Snowflake. |
Exempel 1
Hämta egenskaperna för förnamn, efternamn och stad för alla kontakter.
Fråga:
SELECT objectTypeId, objectId, namn, värde
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ("firstname", "lastname", "city")
ORDER BY objectId;
Returnerar:
OBJECTTYPEID | OBJECTID | NAMN | VÄRDE |
0-1 | 10401 | Förnamn | Brian |
0-1 | 10401 | staden | Dublin |
0-1 | 10401 | efternamn | Gallagher |
0-1 | 23451 | Förnamn | Fernando |
0-1 | 23451 | efternamn | Fierro |
0-1 | 25751 | Förnamn | Charles |
... | ... | ... | ... |
Exempel 2
Hämta förnamn, efternamn och livscykelstadium för alla kontakter och kombinera dem till en rad per kontakt. I det här exemplet används SQL PIVOT-syntaxen.
Fråga:
SELECT objectId, förnamn, efternamn, livscykelstadium
FROM
(
SELECT objectId, namn, värde
FROM object_properties
WHERE objectTypeId = "0-1
AND name IN ('firstname', 'lastname', 'lifecyclestage')
)
PIVOT(MAX(value) FOR name IN ('firstname', 'lastname', 'lifecyclestage')) AS p(objectId, förnamn, efternamn, livscykel);
Returnerar:
OBJECTTYPEID | OBJECTID | FÖRNAMN | LASTNAME | LIVSCYKELSTADIUM |
0-1 | 54325098 | Hobbes | Baron | bly |
0-1 | 96805401 | Milo | Guld | bly |
0-1 | 6922028 | Henry | Riley | bly |
... | ... | ... | ... | ... |
object_properties_history
Denna vy innehåller historiska fastighetsvärden. För kontakter innehåller den de senaste 45 värdena. För alla andra objekt innehåller den de senaste 20 värdena. Visar en rad för varje historiskt egenskapsvärde. Det aktuella värdet för en egenskap bestäms av den senaste tidsstämpeln UPDATEDAT i egenskapens historik.
Denna vy kan visa följande kolumner:
Namn på kolumnen | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | ID för objekttypen (t.ex. kontakter är 0-1 ). |
OBJECTID |
Antal | Postens ID ( t.ex. en kontaktpost med ID 123752 ). |
NAMN |
Varchar | Namnet på egenskapen. |
VÄRDE |
Tidsstämpel | Fastighetens värde. |
UPDATEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast uppdaterades i HubSpot. Läs mer om kolumndatatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast togs in av Snowflake. |
Exempel 1
Hämta historiken för en enskild egenskap för en enskild kontakt.
Fråga:
SELECT objectId, namn, värde, tidsstämpel
FROM object_properties_history
WHERE objectTypeId = "0-1
AND objectId = 585
AND name = "hs_predictivescoringtier".
ORDER BY timestamp DESC;
Returnerar:
OBJECTTYPEID | OBJECTID | FÖRNAMN | LASTNAME | LIVSCYKELSTADIUM |
0-1 | 54325098 | Hobbes | Baron | bly |
0-1 | 96805401 | Milo | Guld | bly |
0-1 | 6922028 | Henry | Riley | bly |
... | ... | ... | ... | ... |
Exempel 2
Hämta det aktuella namnet på alla kontakter som någonsin har haft livscykelstadiet Abonnent.
Fråga:
VÄLJ
objectId,
properties:firstname::string AS firstname,
properties:lastname::string AS lastname
FROM object_with_object_properties
WHERE object_with_object_properties.objectTypeId = "0-1
AND objectId IN (
SELECT objectId
FROM object_properties_history
WHERE
object_properties_history.objectTypeId = '0-1'
AND object_properties_history.name = "lifecyclestage".
AND object_properties_history.value = "subscriber".
);
Returnerar:
OBJECTID | FÖRNAMN | LASTNAME |
54325098 | Hobbes | Baron |
96805401 | Milo | Guld |
6922028 | Henry | Riley |
... | ... | ... |
Förfrågningar om sammanslutningar
Nedan får du veta hur du frågar efter associationer, t.ex. vilka typer av associationer som finns tillgängliga mellan objekt och vilka poster som för närvarande är associerade.
association_definitioner
Den här vyn innehåller information om alla tillgängliga associationstyper mellan HubSpot-objekt, med en rad per associationstyp. Du kan koppla ihop den här tabellen med tabellen Associations för att få information om specifika associationer.
Det kan finnas flera typer av associationer mellan samma objekt. Den huvudsakliga associationstypen, som är den typ som visas i HubSpot när poster är associerade, använder associationen där ISMAINASSOCIATIONDEFINITION
är sann
.
Denna vy kan visa följande kolumner:
Namn på kolumnen | Typ | Beskrivning |
COMBINEDASSOCIATIONTYPEID |
Varchar | Den unika identiteten för definitionen av en sammanslutning. |
KATEGORI |
Varchar | Källan till föreningstypen. En av följande: HUBSPOT_DEFINED , USER_DEFINED , INTEGRATOR_DEFINED |
ID |
Antal | Identifiering av definitionen av en sammanslutning inom dess kategori. |
FROMOBJECTTYPEID |
Varchar | ID för det objekt som är källan till associationsdefinitionen. |
TOOBJECTTYPEID |
Varchar | ID för det objekt som är målet för associationsdefinitionen. |
NAMN |
Varchar | Föreningsdefinitionens namn. |
ETIKETT |
Varchar | Etikett för definitionen av föreningen. |
ISMAINASSOCIATIONDEFINITION |
Boolean | Om definitionen av föreningen är huvudtypen. När det är sant är det definitionen som HubSpot visar på associerade poster. |
INGESTEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast togs in av Snowflake. Läs mer om kolumndatatyper. |
Exempel 1
Hämta de typer av föreningar som finns tillgängliga på ditt konto.
Fråga:
SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
ORDER BY category, id
Returnerar:
KOMBINERADFÖRENINGSTYP | FROMOBJECTTYPEID | TOOBJECTTYPEID | NAMN |
0-1 | 0-1 | 0-2 | KONTAKT_TILL_FÖRETAG |
0-2 | 0-2 | 0-1 | FÖRETAG_TILL_KONTAKT |
0-3 | 0-3 | 0-1 | DEAL_TO_CONTACT |
0-4 | 0-1 | 0-3 | KONTAKT_TILL_DEAL |
0-5 | 0-3 | 0-2 | DEAL_TO_COMPANY |
... | ... | ... | ... |
Exempel 2
Hämta de tillgängliga associationstyperna mellan affärer och företag.
Fråga:
VÄLJ
combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = "0-3" AND toObjectTypeId = "0-2
AND isMainAssociationDefinition = trueORDER BY category, id
Returnerar:
KOMBINERADFÖRENINGSTYP | FROMOBJECTTYPEID | TOOBJECTTYPEID | NAMN |
0-5 | 0-3 | 0-2 | DEAL_TO_COMPANY |
0-271 | 0-3 | 0-2 | DEAL_TO_PRIMARY_COMPANY |
0-341 | 0-3 | 0-2 | DEAL_TO_COMAPNY_UNLABELED |
föreningar
Den här vyn innehåller information om sambanden mellan specifika poster. Varje rad representerar en koppling från ett objekt till ett annat objekt. Rader kan finnas i den här tabellen även om de refererade posterna har tagits bort. Du kan kontrollera om det finns poster genom att göra en sammanfogning med objekttabellen.
Denna vy kan visa följande kolumner:
Namn på kolumnen | Typ | Beskrivning |
COMBINEDASSOCIATIONTYPEID |
Varchar | Den unika identiteten för definitionen av en sammanslutning. |
FROMOBJECTID |
Antal | ID för källobjektet. |
TOOBJECTID |
Antal | ID för destinationsobjektet. |
INGESTEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast togs in av Snowflake. Läs mer om kolumndatatyper. |
Exempel 1
Hämta alla associerade affärer och kontakter.
Fråga:
SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE combinedAssociationTypeId = "0-5
Returnerar:
KOMBINERADFÖRENINGSTYP | FROMOBJECTID | TOOBJECTID |
0-5 | 6626541373 | 233620335 |
0-5 | 6616436082 | 3866015468 |
0-5 | 6690805943 | 7132752747 |
... | ... | ... |
Exempel 2
Hämta alla biljetter som är kopplade till en viss kontakt (kontakt-ID: 3005).
Fråga:
SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE associationCategory = "HUBSPOT_DEFINED
AND combinedAssociationTypeId = "0-15
AND fromObjectId = 3005;
Returnerar:
KOMBINERADFÖRENINGSTYP | FROMOBJECTID | TOOBJECTID |
0-5 | 6626541373 | 233620335 |
Exempel 3
Hämta alla affärer som är kopplade till en specifik kontakt (kontakt-ID: 4464). I stället för att hårdkoda combinedAssociationTypeId används association_definitions i det här exemplet.
Fråga:
SELECT combinedAssociationType, fromObjectId, toObjectId,
FROM associations
WHERE
combinedAssociationTypeId = (
SELECT combinedAssociationTypeId
FROM association_definitions
WHERE fromObjectTypeId = '0-1'
AND toObjectTypeId = "0-3".
AND isMainAssociationDefinition)
AND fromObjectId = 4464;
Returnerar:
KOMBINERADFÖRENINGSTYP | FROMOBJECTID | TOOBJECTID |
0-5 | 6626541373 | 233620335 |
Förfrågningar från ägaren
ägare
Den här vyn innehåller information om användarna i ditt HubSpot-konto. Användare kan anges som registerägare och kommer att innehålla både ett användar-ID och ett ägar-ID, beroende på sammanhanget. Båda ID:n kan användas för att identifiera samma användare.
Denna vy kan visa följande kolumner:
Namn på kolumnen | Typ | Beskrivning |
OWNERID |
Antal | Användarens ägar-ID. |
USERID |
Antal | Användarens användar-ID. Användare med NULL i denna kolumn har raderats. |
EMAIL |
Varchar | Användarens e-postadress. |
FÖRNAMN |
Varchar | Användarens förnamn. |
LASTNAME |
Varchar | Användarens efternamn. |
ISACTIVE |
Boolean | Om användaren har tagits bort. |
CREATEDAT |
Tidsstämpel | Datum och tid då användaren skapades i HubSpot. Se kolumndatatyper för mer information. |
UPDATEDAT |
Tidsstämpel | Datum och tid då användaren senast uppdaterades i HubSpot. Se kolumndatatyper för mer information. |
Exempel 1
Hämta alla användare. Filtret WHERE isActive = true
tar bort raderade användare från de returnerade uppgifterna.
Fråga:
SELECT ownerId, userId, email, förnamn, efternamn
FROM owners
WHERE isActive = true
Returnerar:
OWNERID | ACTIVEUSERID | FÖRNAMN | LASTNAME | |
29584574 | 4621126 | 233620335 | Hobbes | Baron |
30532717 | 4874784 | 3866015468 | Pablo | Walters |
30580321 | 925511 | 7132752747 | Milo | Guld |
... | ... | ... | ... | ... |
Exempel 2
Hämta en specifik ägare med hjälp av dennes ägar-ID.
Fråga:
SELECT ownerId, userId, email, förnamn, efternamn
FROM owners
WHERE ownerId = 29584574;
Returnerar:
OWNERID | ACTIVEUSERID | FÖRNAMN | LASTNAME | |
29584574 | 4621126 | 233620335 | Hobbes | Baron |
Exempel 3
Hämta alla kontakter och deras ägare. Den här frågan kopplar ihop poster till ägare med object_with_object_properties och kontaktens egenskap hubspot_owner_id.
VÄLJ
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
FROM object_with_object_properties contact
inner join owners owner on contact.properties:hubspot_owner_id::number = owner.ownerId
where objectTypeId = "0-1";
Returnerar:
CONTACTID | KONTAKT_FÖRNAMN | KONTAKT_EFTERNAMN | CONTACT_HUBSPOT_OWNER_ID | ÄGARE_FÖRNAMN | ÄGARE_NÄMNESNAMN | ÄGAREN_EMAIL |
113834202 | Richard | Greenfield | 29584574 | Hobbes | Baron | hobbes.b@business.com |
53540801 | Ford | Karl | 30241125 | Milo | Guld | milo.g@business.com |
... | ... | ... | ... | ... | ... | ... |
Förfrågningar om rörledningar
Nedan får du veta hur du söker efter data om affärer och biljettpipelines, till exempel vilka pipelines som finns tillgängliga på ditt konto och deras stadier.
Du kan kombinera dessa data med objektdata för att få en fullständig bild av dina pipelines. Du kan t.ex. fråga efter affärer och deras pipelines genom att koppla object_with_object_properties-data till pipelines-data.
rörledningar
Den här vyn innehåller information om affärs- och biljettpipelines i ditt konto. Varje återgiven rad representerar en enskild pipeline.
Tabellen kan visa följande kolumner:
Namn på kolumnen | Typ | Beskrivning |
PIPELINEID |
Varchar | Rörledningens ID. |
OBJECTTYPEID |
Varchar | ID för det objekt som rörledningen kan innehålla (t.ex. erbjudanden eller biljetter). |
ETIKETT |
Varchar | Namnet på pipelinen i HubSpot. |
DISPLAYORDER |
Antal | Ordningen i vilken pipeline visas i HubSpot. |
ARKIVERAD |
Boolean | Om rörledningen har tagits bort. |
CREATEDAT |
Tidsstämpel | När rörledningen skapades. |
UPDATEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast uppdaterades i HubSpot. Läs mer om kolumndatatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast togs in av Snowflake. |
Exempel 1
Hämta alla tillgängliga pipelines för affärer, ordnade efter ordning i HubSpot.
Fråga:
SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = "0-3
OCH inte arkiverad
ORDER BY displayorder;
Returnerar:
OBJECTTYPEID | PIPELINEID | ETIKETT |
0-3 | 1bed503c-37f7-4f51-9d40-7598902673f4 | Försäljningspipeline |
0-3 | 12659678 | Licenser Pipeline |
0-3 | 75e28846-ad0d-4be2-a027-5e1da6590b98 | Nya frågor |
... | ... | ... |
Exempel 2
Hämta affärer inom en specifik pipeline. Sammanfogar object_with_object_properties och pipelines.
Fråga:
VÄLJdeals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name
FROM object_with_object_properties deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
WHERE deals.objecttypeId = "0-3
AND pipelines.objectTypeId = "0-3";
Returnerar:
DEAL_ID | DEAL_NAME | PIPELINE_NAME |
605140072 | Meowmix global registrering | Försäljningspipeline |
605457408 | Friskies byter varumärke | Försäljningspipeline |
604362473 | Nya steg för att bygga en app | Försäljningspipeline |
pipeline_stages
Den här vyn innehåller information om enskilda steg i en pipeline. Identifiera steg genom att kombinera objekttyp-ID, pipeline-ID och steg-ID. När du ansluter dig till rörledningar använder du objekttyp-ID och rörlednings-ID.
Tabellen kan visa följande kolumner:
Namn på kolumnen | Typ | Beskrivning |
PIPELINEID |
Varchar | Rörledningens ID. |
OBJECTTYPEID |
Varchar | ID för det objekt som rörledningen kan innehålla (t.ex. erbjudanden eller biljetter). |
ETIKETT |
Varchar | Namnet på pipelinen i HubSpot. |
DISPLAYORDER |
Antal | Ordningen i vilken pipeline visas i HubSpot. |
ARKIVERAD |
Boolean | Om rörledningen har tagits bort. |
UPDATEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast uppdaterades i HubSpot. Läs mer om kolumndatatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast togs in av Snowflake. |
Exempel 1
Hämta pipeline-steg för en affärspipeline som heterSales pipeline.
Fråga:
SELECT pipelineid, stageId, etikett
FROM pipeline_stages
WHERE inte arkiverad
AND pipelineid = (
SELECT pipelineid
FROM pipelines
WHERE objectTypeId = "0-3
OCH inte arkiverad
AND label = "Sales Pipeline" LIMIT 1)
ORDER BY displayorder;
Returnerar:
PIPELINEID | STAGEID | ETIKETT |
941650 | 941651 | Kontaktad |
941650 | 941652 | Tidsplanerad tid |
941650 | 941653 | Faktura skickad |
... | ... | ... |
Exempel 2
Hämta alla affärer och deras respektive stadier i pipeline.
Fråga:
VÄLJdeals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name,
pipeline_stages.label pipeline_stage_name
FROM object_with_object_properties deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
INNER JOIN pipeline_stages
ON deals.objectTypeId = pipeline_stages.pipelineid
AND deals.properties:pipeline::string = pipeline_stages.pipelineid
AND deals.properties:dealstage::string = pipeline_stages.stageId
WHERE deals.objecttypeId = "0-3";
Returnerar:
DEAL_ID | DEAL_NAME | PIPELINE_NAME | PIPELINE_STAGE_NAME |
605140072 | Meowmix global registrering | Försäljningspipeline | Avtal skickat |
605457408 | Friskies byter varumärke | Försäljningspipeline | Tidsplanerad tid |
604362473 | Nya steg för att bygga en app | Försäljningspipeline | Kontrakt undertecknat |
... | ... | ... | ... |
Förfrågningar om fastigheter
Egendomsdefinitioner
Den här vyn innehåller information om objekt- och händelseegenskaper i ditt HubSpot-konto. Händelseegenskaperna omfattar standardhändelser, t.ex. öppningar och klick i e-postmeddelanden, och anpassade beteendehändelseegenskaper. Den här informationen kan vara till hjälp för att definiera värden som finns i object_properties och händelsedata.
Du kan identifiera specifika egenskaper genom att kombinera deras objekttyp-ID och namn. Du kan hämta liknande information med hjälp av API:et för egenskaper.
Denna vy kan visa följande kolumner:
Namn på kolumnen | Typ | Beskrivning |
OBJECTYPEID |
Varchar | ID för det objekt som händelsen avser. |
NAMN |
Varchar | Egendomens interna namn. |
ETIKETT |
Varchar | Fastighetens etikett. |
BESKRIVNING |
Varchar | Boendets beskrivning. |
TYP |
Varchar | Egendomens typ (t.ex. sträng, nummer, datum). |
FIELDTYPE |
Varchar | Egendomens fälttyp. Definierar hur egenskapen visas i HubSpot och på formulär (t.ex. kryssruta, välj). |
DISPLAYORDER |
Antal | Fastighetens visningsordning. |
GROUPNAME |
Varchar | Fastighetens gruppnamn. |
OPTIONER |
Variant | För uppräkningsegenskaper, en matris med egenskapens alternativ, inklusive varje alternativs attribut (t.ex. visningsordning, etikett). |
CREATEDUSERID |
Antal | ID för den användare som skapade egenskapen. |
REFERENCEDOBJECTTYPE |
Varchar | Den typ av objekt som egenskapen refererar till. Egenskaper för ägare returnerar värdet OWNER. |
KALKULERAD |
Boolean | Om egenskapen är en beräknad egenskap. |
EXTERNA ALTERNATIV |
Boolean | Om fastighetens alternativ definieras i ett externt system. |
HAR ETT UNIKT VÄRDE |
Boolean | Om fastighetens värden är unika. Kan endast anges när du skapar en egenskap via API. |
HIDDEN |
Boolean | Om egenskapen är dold i HubSpot. |
SHOWCURRENCYSYMBOL |
Boolean | Om ett värde för en talegenskap ska formateras som en valuta. |
FORMFIELD |
Boolean | Om den här egenskapen kan användas i formulär. |
READONLYDEFINITION |
Boolean | Om egenskapen kan redigeras i HubSpot. |
READONLYVALUE |
Boolean | Om egenskapens värde kan redigeras i HubSpot. |
HUBSPOTDEFINIERAD |
Boolean | Om egenskapen skapades av HubSpot eller av en användare. |
ARKIVERAD |
Boolean | Om egenskapen har tagits bort. |
CREATEDAT |
Tidsstämpel | Datum och tid då egenskapen skapades i HubSpot. |
UPDATEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast uppdaterades i HubSpot. Läs mer om kolumndatatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast togs in av Snowflake. |
Exempel 1
Hämta namn och beskrivningar för alla kontaktegenskaper.
Fråga:
Välj namn, etikett, beskrivning
FROM property_definitions
WHERE objectTypeId = "0-1
Returnerar:
NAMN | ETIKETT | BESKRIVNING |
entered_sql_stage | Har gått in i SQL-stadiet | Starträkning SQL stage dagar. |
first_conversion_event_name
|
Första konverteringen | Det första formuläret som denna kontakt skickade in. |
adress | Adress | Kontaktpersonens adress. |
Förfrågningar om evenemang
Händelser inkluderar standardhändelser från HubSpot och anpassade beteendehändelser. Varje händelse har en egen vy, märkt som events_eventname
.
Tillgängliga evenemang är bland annat:
- Klicka på annonser (
events_ad_clicked
) - Öppningar och klick på e-postmeddelanden (
events_opened_email_V2
,events_clicked_link_in_email_v2
, etc.). - Webbanalys (
events_visited_page
)
Du kan identifiera händelser genom att kombinera deras ID för händelsetyp och ID. Kolumnerna som returneras beror på händelsen, med en kolumn för varje händelseegenskap. Alla händelser returnerar följande kolumner:
Observera: HubSpot har lagt till två nya kolumner i alla evenemangstabeller och vyer:
inträffade på
inträffade vid en tidpunkt i
Dessa kolumner kommer att ersätta kolumnerna occuredat
och occuredatdateint
den 24 april 2022. Från och med det datumet kommer de gamla kolumnerna inte längre att vara tillgängliga, och försök att söka i en tabell eller vy som innehåller händelser med hjälp av dessa kolumner kommer att misslyckas. Läs mer om brytande ändringar för Snowflake-datadelar.
Namn på kolumnen | Typ | Beskrivning |
EVENTTYPEID |
Varchar | Rörledningens ID. |
ID |
Varchar | ID för det objekt som rörledningen kan innehålla (t.ex. erbjudanden eller biljetter). |
OBJECTTYPEID |
Varchar | Den typ av objekt som avslutade händelsen. Om du till exempel klickar på en e-postlänk visas0-1 i den här kolumnen, vilket representerar kontaktobjektet. |
OBJECTID |
Antal | ID för den post som avslutade händelsen. |
OCCURREDAT |
Tidsstämpel | När händelsen inträffade. |
|
Antal | Ett nummer som anger när händelsen inträffade. Innehåller samma data som kolumnen OCCURREDAT , men formaterad som ett nummer och används som en del av klusternyckeln i tabellen. I de flesta fall kan du använda OCCURREDAT-tidsstämpeln i stället för det här numret. |
|
Antal |
Ett nummer som anger när händelsen inträffade. Innehåller samma data som kolumnen Observera att den här kolumnen kommer att upphöra att användas den 24 april 2022 och ersättas med |
OCCUREDAT |
Tidsstämpel |
När händelsen inträffade. Observera att denna kolumn kommer att upphöra den 24 april 2022 och ersättas med |
INGESTEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast togs in av Snowflake. Läs mer om kolumndatatyper. |
PROPERTY_* |
Varchar | Enskilda kolumner som innehåller händelsens egenskaper. |
Exempel 1
Hämta de 50 senaste klickhändelserna i e-postmeddelanden.
Fråga:
SELECT eventTypeId, objectTypeId, objectId, occuredAt, hs_click_raw_url
FROM events_clicked_link_in_email_V2
ORDER BY occuredAt
LIMIT 50;
Returnerar:
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 |
... | ... | ... | ... | ... |
Exempel 2
Hämta alla klickhändelser i e-postmeddelanden efter de kontakter som klickade. Den här frågan hämtar kontaktuppgifter genom att gå samman med object_with_object_properties.
Fråga:
VÄLJ
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;
Returnerar:
CLICK_TIMESTAMP | CLICK_URL | KONTAKT_FÖRNAMN | KONTAKT_EFTERNAMN |
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 | Baron |
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 | Guld |
2018-11-08 09:37:41.426 | https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164 | Harlow | Villari |
... | ... | ... | ... |
Object_and_event_type_definitions
Den här vyn innehåller definitioner för alla objekt och händelser som är tillgängliga i ditt HubSpot-konto.
Denna vy kan visa följande kolumner:
Namn på kolumnen | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | ID för det objekt som rörledningen kan innehålla (t.ex. erbjudanden eller biljetter). |
FULLSTÄNDIGT NAMN |
Varchar | Namnet på objektet eller händelsen. |
INGESTEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast togs in av Snowflake. Läs mer om kolumndatatyper. |
Exempel 1
Hämta alla objekt och händelser som finns tillgängliga i ditt HubSpot-konto.
Fråga:
SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;
Returnerar:
OBJECTTYPEID | FULLSTÄNDIGT NAMN |
0-1 | KONTAKT |
0-2 | FÖRETAG |
0-3 | DEAL |
0-4 | ENGAGEMANG |
0-5 | BILJETT |
0-8 | LINE_ITEM |
0-11 | SAMTAL |
... | ... |
Förfrågningar om listor (BETA)
Nedan får du veta hur du söker i dina listor, t.ex. de tillgängliga kontakt- och företagslistorna och de poster som ingår i dessa listor.
förteckningar
Den här vyn innehåller information om HubSpot-kontakt- och företagslistor. En rad per lista returneras och kolumnerna innehåller information om listan, t.ex. listnamn, storlek och objekttyp för de poster som den innehåller. Innehåller inte information om enskilda poster i varje lista (se list_membership).
Denna vy kan visa följande kolumner:
Namn på kolumnen | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | Typ av poster i listan (t.ex. kontakt eller företag). |
LISTID |
Antal | Listans ID. Kopplar till kolumnen LISTID i tabellen list-memberships. |
CLASSICLISTID |
Antal | Ett ID som är specifikt för kontaktlistor och som matchar ID:et i listans URL i HubSpot. |
LISTNAME |
Varchar | Namnet på listan. |
LISTSIZE |
Antal | Antalet poster i listan. |
CREATEDBYUSERID |
Antal | ID för den användare som skapade listan. |
CREATEDAT |
Tidsstämpel | När listan skapades i HubSpot. |
UPPDATERAD MED ANVÄNDARNAMN |
Antal | ID för den användare som senast uppdaterade listan. |
UPDATEDAT |
Tidsstämpel | Datum och tid då datumet senast uppdaterades i HubSpot. Läs mer om kolumndatatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast togs in av Snowflake. |
Exempel 1
Hämta alla kontaktlistor.
Fråga:
SELECT listId, listName, listSize
FRÅN listor
WHERE objectTypeId = "0-1";
Returnerar:
LISTID | LISTNAME | LISTSIZE |
118131 | Veckovis utåtriktad verksamhet | 103 |
66156 | Bloggprenumeranter | 455 |
771852 | Bästa prenumeranter 2021 | 37 |
... | ... | ... |
Exempel 2
Hämta en specifik kontaktlista som heter Toppabonnenter 2021.
Fråga:
SELECT listId, listName, listSize
FRÅN listor
WHERE objectTypeId = "0-1
ANDlistName = "De bästa abonnenterna 2021";
Returnerar:
LISTID | LISTNAME | LISTSIZE |
771852 | Bästa prenumeranter 2021 | 37 |
list_membership
Den här vyn innehåller information om vilka poster som är medlemmar i vilka listor, med en rad per post i listan. Om du till exempel har en lista över bloggprenumeranter med 500 kontakter kommer tabellen att visa 500 rader.
Innehåller endast list-id och objekt-id. Mer information finns i tabellen listor.
Denna vy kan visa följande kolumner:
Namn på kolumnen | Typ | Beskrivning |
LISTID |
Varchar | Listans ID. Kopplar till kolumnen HS_LIST_ID i tabellen lists. |
OBJECTID |
Varchar | ID för posten i listan. |
UPDATEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast uppdaterades i HubSpot. Läs mer om kolumndatatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tid då uppgifterna senast togs in av Snowflake. |
Exempel 1
Hämta ID:n för alla kontakter i listanToppabonnenter 2021.
Fråga:
Välj objectId
FROM list_memberships
INNER JOIN listor
ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = "0-1
AND lists.name = "Top Subscribers 2021";
Returnerar:
OBJECTID |
54325098 |
96805401 |
6922028 |
... |
Exempel 2
Hämta för- och efternamn för uppgifter om kontakter i listan Toppabonnenter 2021.
Fråga:
VÄLJ
contact.objectId AS objectid,
contact.properties:firstname::string AS firstname,
contact.properties:lastname::string AS lastname
FROM object_with_object_properties contact
INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId
INNER JOIN lists ON list_memberships.listId = lists.listId
WHERE
contact.objectTypeId = "0-1
AND lists.objectTypeId = "0-1
AND lists.listName = "Top Subscribers 2021".
Returnerar:
OBJECTID | FÖRNAMN | EFTERNAMN |
54325098 | Hobbes | Baron |
96805401 | Milo | Guld |
6922028 | Henry | Riley |
... | ... | ... |
Datatyper för kolumner
När du frågar efter data i Snowflake beror kolumnerna som returneras på vilka data du frågar efter. Du kan visa de tillgängliga kolumnerna för en viss tabell eller vy i Snowflake genom att välja vyni den vänstra sidofältet.

Om du vill returnera en specifik kolumn inkluderar du den kolumnen i SELECT-fältet
i din fråga. Följande fråga returnerar till exempel endast kolumnerna FROMOBJECTID
och TOOBJECTID
:
SELECTfromObjectTypeId, toObjectTypeId
FROM association_definitions
Nedan finns allmänna definitioner av kolumner som en fråga kan ge tillbaka. För andra definitioner som inte finns med nedan, se de enskilda vydefinitionerna i artikeln ovan.
- OBJECTTYPEID: ett VARCHAR-värde som representerar ett objekts typ. Exempelvis representerar 0-1 kontaktobjektet, 0-2 representerar företagsobjektet och 2-1232 kan representera ett anpassat objekt i ditt konto. I listor hänvisar detta till listtypen (t.ex. kontakt eller företag). Du kan fråga efter alla objekt- och händelse-ID:n i ditt konto med hjälp av vyn object_and_event_type_definitions.
- OBJECTID: ett BIGINT-nummer som representerar en enda post av en viss typ av objekt i ditt HubSpot-konto. För att identifiera en post måste du använda både objekttyp-ID och objekt-ID.
- INGESTEDAT: tidsstämpeln för när en datarad lades till Snowflake, representerad av ett TIMESTAMP_NTZ-värde. Inte relaterat till den logiska tidsstämpeln för en skapelse- eller uppdateringsoperation i HubSpot.
- På grund av HubSpots interna behandling kan en rads tidsstämpel för inmatning uppdateras även om inga andra kolumner i raden har ändrats.
- När du bygger ETL-processer som kopierar nyligen ändrade data rekommenderas att du baserar dina frågor på tidsstämpeln för inmatning. Om ditt flöde kopierar data dagligen rekommenderas dessutom att du kopierar data från de två föregående dagarna för att ta hänsyn till förseningar.
- CREATEDAT och UPDATEDAT: den logiska tidsstämpeln för när data skapades eller uppdaterades i HubSpot, representerad av ett TIMESTAMP_NTZ-värde . Dessa tidsstämplar kommer att matcha tidsstämplar i HubSpot. Den tid som visas i HubSpot för ett datum för skapande av en post kommer till exempel att vara densamma som tidsstämpeln i kolumnen CREATEDAT i Snowflake. Dessa är inte direkt relaterade till tidsstämpeln för inmatning och det rekommenderas inte att basera ETL-processer på denna egenskap.
- COMBINEDASSOCIATIONTYPE: ett VARCHAR-värde som unikt identifierar en associationsdefinition.
Thank you for your feedback, it means a lot to us.
Relaterat innehåll
-
Skapa anpassade rapporter för enskilda objekt
Med en rapport om ett enskilt objekt kan du analysera ett objekt, t.ex. kontakter, i förhållande till...
Kunskapsbas -
Förstå attributionsrapportering
När du skapar en rapport om kontaktskapande, affärsskapande eller intäktstilldelning kan du läsa nedanstående...
Kunskapsbas -
Skapa webbadresser för spårning
Spårningswebbadresser hjälper dig att mäta effektiviteten i dina marknadsföringskampanjer genom att...
Kunskapsbas