Hoppa till innehåll
Observera: Översättningen av denna artikel är endast avsedd att underlätta för dig. Översättningen har skapats automatiskt med hjälp av en översättningsprogramvara och har eventuellt inte korrekturlästs. Den engelska versionen av denna artikel bör därför betraktas som den gällande versionen med den senaste informationen. Du kan komma åt den här.
Reports

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.

    snowflake-worksheet-settings0
  • 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.

      snowflake-worksheet-settings-window0

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:


SELECT

objectId,
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
WHEREobject_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ÄLJcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = "0-3" AND toObjectTypeId = "0-2
AND isMainAssociationDefinition = true

ORDER 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 EMAIL 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 EMAIL 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ÄLJ

deals.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ÄLJ

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

INTRÄFFADE VID EN TIDPUNKT I

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.

INTRÄFFADE PÅ

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.

Observera att den här kolumnen kommer att upphöra att användas den 24 april 2022 och ersättas med OCCURREDATDATEINT.

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

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
AND
listName = "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.

snowflake-sidebar-view-column-details0


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:


SELECT
fromObjectTypeId, 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.
Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.