주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. .

스노우플레이크에서 HubSpot 데이터 쿼리하기

마지막 업데이트 날짜: 2월 12, 2025

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

Operations Hub Enterprise

스노우플레이크를 HubSpot 계정에 연결한 후, 스노우플레이크의 데이터 공유를 사용하여 스노우플레이크 계정에서 HubSpot 데이터를 쿼리할 수 있습니다.

데이터 지연 및 스노우플레이크 계정 지역

15분마다 업데이트되는 V2_LIVE 스키마와 매일 업데이트되는 V2_DAILY 스키마에 액세스할 수 있습니다.

참고: V2_LIVE 스키마의 다음 보기는 매일만 업데이트됩니다: 연관 정의, 소유자, 파이프라인 및 파이프라인_단계.

스노우플레이크 환경 설정

Snowflake에서 HubSpot 데이터를 쿼리하려면 쿼리하려는 웨어하우스, 데이터베이스 및 스키마를 선택해야 합니다. 워크시트 수준에서 쿼리에 자동으로 포함되도록 설정하거나 수동으로 추가할 수 있습니다.

워크시트 수준에서 웨어하우스, 데이터베이스 및 스키마를 선택하려면 다음과 같이 하세요:

워크시트의 맨 위 행에서 워크시트 작업 표시줄을 클릭합니다.
팝업 창에서
- 창고 드롭다운 메뉴를 클릭한 다음 창고를 선택합니다.
- 데이터베이스 드롭다운 메뉴를 클릭한 다음 HubSpot 데이터베이스를 선택합니다.
- 스키마 드롭다운 메뉴를 클릭한 다음 사용하려는 스키마를 선택합니다:

환경이 구성되면 데이터베이스나 스키마 유형을 쿼리에 수동으로 추가할 필요 없이 HubSpot 데이터에 대한 쿼리를 수행할 수 있습니다.

데이터베이스 및 스키마 유형을 쿼리에 수동으로 추가하려면 FROM 필드 시작 부분에 데이터베이스 이름 뒤에 스키마를 추가합니다. 예를 들어

SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

데이터 개요

쿼리는 SQL을 사용하여 구성되며 다음과 같은 HubSpot 데이터를 검색하는 데 사용할 수 있습니다:

개체: 연락처, 회사, 제품 등의 표준 및 사용자 지정 개체입니다.
기록: 개인 연락처나 회사 등의 개별 기록입니다.
연결: 사용 가능한 모든 연결 유형과 현재 연결된 레코드입니다.
이벤트: 이메일 열기와 같은 표준 HubSpot 이벤트와 사용자 지정 행동 이벤트 모두에 대한 이벤트 데이터입니다.
목록: HubSpot 연락처 및 회사 목록.
소유자: 소유자로 설정된 레코드와 관련된 HubSpot 계정의 사용자입니다.
파이프라인: 파이프라인 단계를 포함한 거래 및 티켓 파이프라인.
속성: 속성 기록을 포함한 CRM 레코드의 속성 및 해당 값입니다.

HubSpot의 CRM 데이터 모델에대해 자세히 알아보세요 .

참고: 데이터 공유를 발전시키면서 변경 사항을 도입할 예정이며, 그 중 일부는 획기적인 변경 사항입니다. HubSpot의 개발자 변경 로그를 구독할 것을 적극 권장합니다. 이러한 변경 사항은 항상 업데이트 전에 변경 로그에 게시됩니다.

반환된 데이터 제한 및 주문

쿼리를 구성할 때 쿼리에 LIMIT 및 ORDER BY 을 포함하여 반환되는 데이터의 양과 반환되는 순서를 제어할 수 있습니다. 예를 들어 모든 연락처의 속성을 쿼리하되 3개의 결과만 반환하고 연락처 ID별로 순서를 지정하려면 다음과 같이 쿼리를 구성할 수 있습니다:

SELECT objectTypeId, updatedAt, ingestedAt
FROM objects_deals
ORDER BY objectId
LIMIT 10;

열 데이터 유형

Snowflake에서 데이터를 쿼리할 때 반환되는 열은 쿼리하는 데이터에 따라 달라집니다. 왼쪽 사이드바에서 뷰를 선택하여 Snowflake에서 특정 테이블 또는 뷰에 사용 가능한 열을 볼 수 있습니다.

참고:이 문서의 나머지 부분에서는 컨텍스트가 테이블과 뷰 모두에 적용되는 경우 데이터베이스 개체라는 용어를 사용합니다.

특정 열을 반환하려면 쿼리의 SELECT 필드에 해당 열을 포함하세요. 예를 들어 다음 쿼리는 OBJECTID 및 UpdatedAt 열만 반환합니다:

SELECTobjectId, updatedAt
FROM objects_contacts

다음은 쿼리가 반환할 수 있는 열에 대한 일반적인 정의입니다. 아래에 포함되지 않은 다른 정의는 위 문서의 개별 보기 정의를 참조하세요.

객체 유형: 객체의 유형을 나타내는 VARCHAR 값입니다. 예를 들어 0-1은 연락처 개체를 나타내고 0-2는 회사 개체를 나타내며 2-1232는 계정의 사용자 지정 개체를 나타낼 수 있습니다. 목록에서 이 값은 목록의 유형(예: 연락처 또는 회사)을 나타냅니다. object_and_event_type_definitions 보기를 사용하여 계정의 모든 개체 및 이벤트 ID를 쿼리할 수 있습니다.
OBJECTID: HubSpot 계정에 있는 특정 유형의 개체에 대한 단일 레코드를 나타내는 BIGINT 번호입니다. 레코드를 식별하려면 개체 유형 ID와 개체 ID를 모두 사용해야 합니다.
INGESTEDAT: 데이터 행이 스노우플레이크에 추가된 시점의 타임스탬프로, TIMESTAMP_NTZ 값으로 표시됩니다. HubSpot에서 생성 또는 업데이트 작업의 논리적 타임스탬프와는 관련이 없습니다.
- HubSpot의 내부 처리로 인해 행의 다른 열이 변경되지 않은 경우에도 행의 수집 타임스탬프가 업데이트될 수 있습니다.
- 최근에 변경된 데이터를 복사하는 ETL 프로세스를 구축할 때는 수집 타임스탬프를 기준으로 쿼리를 작성하는 것이 좋습니다. 또한 흐름이 매일 데이터를 복사하는 경우, 지연을 고려하기 위해 지난 이틀 동안의 데이터를 복사하는 것이 좋습니다.
CREATEDAT 및 UPDATEAT: HubSpot에서 데이터가 생성되거나 업데이트된 시점의 논리적 타임스탬프( TIMESTAMP_NTZ 값으로 표시됨)입니다. 이러한 타임스탬프는 HubSpot의 타임스탬프와 일치합니다. 예를 들어, 레코드의 생성 날짜에 대해 HubSpot에 표시되는 시간은 Snowflake의 CREATEDAT 열에 있는 타임스탬프와 동일합니다. 이러한 속성은 수집 타임스탬프와 직접 관련이 없으며, 이러한 속성을 기반으로 ETL 프로세스를 수행하는 것은 권장되지 않습니다.
결합된연결유형: 연결 정의를 고유하게 식별하는 VARCHAR 값입니다.

데이터 유형 변환

때때로 쿼리에서 다른 유형으로 데이터를 반환하는 것이 바람직한데도 VARCHAR 열이 있는 데이터가 반환되는 경우가 있습니다. 이런 경우에는 눈송이 함수를 사용하여 VARCHAR 데이터 유형을 원하는 유형으로 변환하는 것이 좋습니다. 예를 들어, 대부분의 데이터베이스 객체에서 객체 레코드의 속성은 VARCHAR 데이터 유형으로 저장되지만 숫자 및 날짜/시간 값을 포함하는 경우도 있습니다. 다음과 같은 함수
try_to_number, try_to_timestamp_ntz와 같은 함수를 사용하여 이러한 VARCHAR 데이터를 각각 숫자 및 날짜/시간 유형으로 변환할 수 있습니다:

SELECT objectid, value AS amount_str, try_to_number(value) AS amount
FROM object_properties WHERE objecttypeid='0-3' AND name='amount' LIMIT 1

개체 쿼리

아래에서 특정 HubSpot 개체 및 레코드의 데이터를 쿼리하는 방법과 반환되는 데이터에 대해 알아보세요.

서로 다른 유형의 개체 데이터는 두 가지 방식으로 구성되고 사용할 수 있습니다:

개별: 각 개체 유형은 자체 보기에 저장되며 동일한 개체 유형의 레코드만 포함합니다(예: objects_contacts에는 연락처 레코드만 포함). 따라서 쿼리할 때 objecttypeid를 지정할 필요가 없습니다. 이러한 뷰는 개체 유형 ID를 알 필요가 없으므로 쿼리하기가 더 쉽습니다. 또한 개체에 해당하는 각 행과 해당 속성의 현재 버전이 포함된 보다 사용하기 쉬운 형식으로 데이터를 반환합니다. 쿼리 속도가 느리지 않다면 이러한 보기를 사용하여 개체 데이터를 검색하는 것이 좋습니다. 아래의 Objects_X 보기에서 자세히 알아보세요.
결합됨: 결합: 모든 개체 유형에 대한 모든 레코드가 하나의 데이터베이스 개체로 결합됩니다. 따라서 쿼리할 때 "WHERE objectTypeId='0-1'"과 같은 필터를 지정해야 합니다. 예를 들어 쿼리할 때 다음과 같은 objectTypeId를 사용할 수 있습니다:

개체 이름	객체 유형 ID
연락처	0-1
기업	0-2
라인 항목	0-8

사용자 지정 객체에는 생성 시 ID가 할당되며 2-unique_ID로 식별됩니다. 예: 2-12345. object_and_event_type_definitions에 대해 자세히 알아보세요.

이러한 데이터베이스 개체는 일반적으로 object_x 보기에서 얻을 수 있는 것보다 더 나은 쿼리 성능을 원하는 경우에 적합합니다. 자세한 내용은 아래의 object_with_object_properties, object_properties, objects 및 object_properties_history에서 참조하세요.

objects_x 조회

이 데이터베이스 개체에서 사용자 지정 개체를 포함하여 사용 가능한 각 개체 유형에는 고유한 특정 보기가 있으며 각 보기에는 해당 특정 개체 유형의 개체에 대한 레코드만 포함되어 있습니다. 이러한 보기의 이름은 OBJECTS_<객체 유형 이름> 형식을 따르며, 여기서 <객체 유형 이름>은 객체 유형의 복수형 레이블입니다(객체 유형에 복수형이 없는 경우 <객체 유형 이름>은 단순히 "S"로 연결된 객체 유형 이름의 단수형 레이블이 됩니다).

이 보기에 대한 쿼리는 객체의 각 속성을 별도의 열로 사용할 수 있는 객체 내의 각 레코드에 대해 하나의 행을 반환합니다.

아래에서 사용 가능한 HubSpot(즉, 사용자 지정이 아닌) 개체 유형의 전체 목록, 해당 개체 유형이 나타내는 데이터에 대한 간략한 설명 및 해당 보기를 참조하세요:

HubSpot 개체 유형	객체 유형 ID	설명
연락처	0-1	비즈니스와 상호 작용하는 개인에 대한 정보
회사	0-2	개별 비즈니스 또는 조직에 대한 정보
DEAL	0-3	연락처 또는 회사와의 수익 기회에 대한 세부 정보입니다.
참여	0-4	메모, 작업, 이메일, 회의, 통화 등 CRM 작업의 데이터를 저장합니다.
티켓	0-5	고객의 도움 또는 지원 요청을 대변합니다.
인용	0-14	잠재적 구매자와 가격 정보를 공유하는 데 사용됩니다.
양식_제출	0-15	HubSpot 양식의 개별 제출에 대한 세부 정보.
LINE_ITEM	0-8	거래에서 판매되는 제품의 하위 집합을 나타냅니다. 제품이 거래에 첨부되면 해당 제품은 라인 품목이 됩니다.
대화	0-11	여러 채널에서 수신되는 메시지에 대한 세부 정보입니다.
랜딩 페이지	0-25	랜딩 페이지 세부 정보
작업	0-27	할 일 목록에 대한 정보 저장
FORM	0-28	방문자 및 연락처에 대한 리드 정보를 수집하는 데 사용됩니다.
마케팅_이메일	0-29	마케팅 허브의 이메일에 대한 세부 정보
AD_ACCOUNT	0-30	링크드인, 페이스북, 구글의 광고 계정에 대한 정보를 저장합니다.
AD_CAMPAIGN	0-31	광고 캠페인에 대한 세부 정보입니다. 광고 캠페인에는 하나 이상의 광고가 포함될 수 있습니다.
AD_GROUP	0-32	광고 캠페인 내 광고의 논리적 그룹화
AD	0-33	개별 광고에 대한 세부 정보
캠페인	0-35	관련 마케팅 자산 및 콘텐츠에 대한 정보를 통해 공동 마케팅 활동의 효과를 쉽게 측정할 수 있습니다.
SITE_PAGE	0-38	웹사이트의 개별 페이지에 대한 데이터
BLOG_POST	0-39	블로그 게시물에 대한 데이터
개체 목록	0-45	속성 또는 활동에 따른 개체 레코드 그룹화에 대한 정보
CALL	0-48	다른 CRM 레코드(예: 연락처)에서 걸려온 통화
인보이스	0-53	외부 회계 시스템과 인보이스 관리 및 동기화
MEDIA_BRIDGE	0-57	Hubspot으로 가져온 미디어 자산에 대한 정보
시퀀스	0-58	시퀀스는 시간이 지남에 따라 연락처를 육성하기 위한 일련의 타겟팅된 시간 지정 이메일 템플릿입니다.
DEAL_SPLIT	0-72	거래 분할은 여러 사용자 간에 거래 크레딧을 공유하는 데 사용됩니다.
SALES_DOCUMENT	0-83	영업 문서는 팀 전체가 문서를 업로드하고 연락처와 공유할 수 있는 콘텐츠 라이브러리를 구축합니다.
피드백_제출	0-19	피드백 설문조사에 제출된 정보를 저장합니다.
구독	0-69	구독에는 정기결제에 대한 세부 정보가 포함되어 있습니다.
커머스 결제	0-101	고객으로부터 수집한 자금에 대한 데이터가 포함되어 있습니다.

각 데이터베이스 객체는 다음과 같은 열을 반환합니다:

열 이름	유형	설명
객체 유형	바이트열	개체 유형의 ID(예: 연락처는 0-1)입니다.
객체ID	번호	레코드의 ID(예: ID가 123752인 연락처 레코드)입니다.
업데이트	타임스탬프	이 개체가 HubSpot에서 마지막으로 업데이트된 날짜와 시간입니다.
INGESTEDAT	타임스탬프	스노우플레이크가 데이터를 마지막으로 수집한 날짜와 시간입니다.
PROPERTY_*	바이트열	개체 속성의 최신 버전을 포함하는 개별 열. 날짜 또는 숫자 유형( 속성_정의에 지정된 대로)이 있는 각 개체 속성에 대해 두 개의 열이 있습니다: 속성 값을 문자열로 포함하는 열입니다. 열 이름은 property_unparsed_[name] 입니다. 예를 들어 DEAL 객체 속성인 deal_amount의 열은 property_unparsed_deal_amount입니다. 기본 유형으로 변환된 값을 포함하는 열입니다. 열의 이름은 property_[name]이며, 예를 들어 DEAL 객체 속성인 deal_amount의 열은 property_deal_amount입니다. 잘못된 데이터로 인해 기본 유형으로 변환에 실패하면 이 열에는 null이 포함됩니다.

예제 1

모든 연락처의 이름, 성, 수명 주기 단계를 검색합니다.

쿼리:

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

반환합니다:

객체ID	이름	성	라이프사이클
54325098	홉스	남작	리드
96805401	Milo	골드	리드
6922028	Henry	Riley	리드

예제 2

최대 3개의 거래 이름과 단계를 검색합니다.

쿼리:

SELECT objectId, property_dealName, property_dealStage, property_amount AS dealAmount
FROM objects_deals LIMIT 3

반환합니다:

객체ID	속성_거래명	속성_딜스테이지	속성_딜금액
38960439	거래 이름 1	닫힌원	34199
321740651	테스트 거래 123	14845019	8383663
98392101	팝업 캐노피	닫힌원	9309007

예제 3

금액별 상위 3개 딜의 딜 이름과 단계를 검색합니다.

쿼리:

거래 금액 데이터는 숫자 데이터 유형으로 제공되므로 변환이나 캐스팅 작업 없이 주문에 사용할 수 있습니다.

SELECT objectId, property_dealName, property_dealStage, property_amount AS dealAmount
FROM objects_deals ORDER BY property_amount DESC LIMIT 3

반환합니다:

객체ID	속성_거래명	속성_딜스테이지	속성_딜금액
98392101	팝업 캐노피	닫힌원	9309007
321740651	테스트 거래 123	14845019	8383663
38960439	거래 이름 1	닫힌원	34199

객체_위드_객체_프로퍼티

이 데이터베이스 객체에는 HubSpot 레코드의 데이터가 포함되어 있습니다. 이 데이터베이스 개체에 대한 쿼리는 개체 유형 내의 각 레코드에 대해 하나의 행을 반환합니다(예: 연락처 개체 유형에 있는 모든 연락처 레코드). 모든 속성은 눈송이 변형 / JSON 열인 속성 열에 저장됩니다.

이 뷰는 다음 열을 반환할 수 있습니다:

열 이름	유형	설명
`OBJECTTYPEID`	바이트열	개체 유형의 ID(예: 연락처는 `0-1`)입니다.
`OBJECTID`	번호	레코드의 ID(예: ID가 `123752` 인 연락처 레코드).
`PROPERTIES`	변형	레코드의 속성 값입니다.
`UPDATEDAT`	타임스탬프	HubSpot에서 레코드가 마지막으로 업데이트된 날짜와 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.
`INGESTEDAT`	타임스탬프	스노우플레이크가 데이터를 마지막으로 수집한 날짜와 시간입니다.

참고: 2022년 1월 25일, 개체 레코드가 HubSpot에서 마지막으로 업데이트된 날짜와 시간을 나타내는 object_with_object_properties 테이블 및 보기의 열, timestamp가 updatedat로 변경됩니다. 이는 나머지 데이터 공유에서날짜/시간 데이터가 표시되는 방식과 일치하기 위한 것입니다 .

이것은 획기적인 변경이므로 테이블과 보기에 새 열인 updatedat가 추가되었습니다. 앞으로 90일 동안 이 두 개의 새 열은 대체하려는 열인 timestamp와 공존하게 됩니다. 이 기간 동안 새 열을 사용하도록 전환할 수 있습니다.

90일 후인 2022년 1월 25일에는 테이블 및 뷰에서 timestamp 열이 제거됩니다. 이 날짜 이후에는 타임스탬프 열을 사용하여 object_with_object_properties 테이블 또는 보기를 쿼리하려는 모든 시도가 실패합니다.

예제 1

모든 연락처와 해당 연락처의 속성을 검색합니다.

쿼리:

SELECT objectTypeId, objectId, properties
FROM object_with_object_properties
WHERE objectTypeId = '0-1'

반환합니다:

객체 유형	객체ID	속성
0-1	38960439	{"createdate": "1504656970152"...}
0-1	321740651	{ "createdate": "1590183081949"...}
0-1	98392101	{ "createdate": "1533566477279"...}
...	...	...

예 2

최대 3개의 거래 이름과 단계를검색할 수 있습니다.

쿼리:

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;

반환합니다:

객체ID	거래명	DEALSTAGE	딜라마운트
38960439	거래 이름 1	닫힘	7488939
321740651	거래 이름 1	닫힌원	9292029
98392101	거래 이름 1	닫힘	62626528

객체

이 데이터베이스 객체는 object_with_object_properties 데이터베이스 객체에 있는 데이터의 하위 집합입니다. 반환된 각 행은 각 레코드의 객체 ID를 반환합니다. 이 데이터베이스 개체는 기존 레코드만 반환합니다. HubSpot에서 레코드가 삭제되면 이 데이터베이스 개체에서 제거됩니다. 이 데이터베이스 개체는 object_with_object_properties 테이블에 있는 데이터의 하위 집합입니다. 반환된 각 행은 각 레코드의 개체 ID를 반환합니다. 이 보기는 기존 레코드만 반환합니다. HubSpot에서 레코드가 삭제되면 이 보기에서 제거됩니다.

이 데이터베이스 개체는 계정에 많은 양의 데이터가 있어 object_with_object_properties 및 objects_x 보기의 성능이 느려지는 경우에 유용할 수 있습니다. 이 데이터베이스 개체를 object_properties 데이터베이스 개체와 함께 사용하면 반환되는 속성에 대한 제어를 유지하면서 object_with_object_properties의 데이터를 복제할 수 있습니다.

이 데이터베이스 객체는 다음 열을 반환할 수 있습니다:

열 이름	유형	설명
`OBJECTTYPEID`	바이트열	개체 유형의 ID(예: 연락처는 `0-1`)입니다.
`OBJECTID`	번호	레코드의 ID(예: ID가 `123752` 인 연락처 레코드).
`INGESTEDAT`	타임스탬프	스노우플레이크에서 데이터를 마지막으로 수집한 날짜 및 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.

예제 1

모든 연락처 기록을 검색합니다.

쿼리:

SELECT objectTypeId, objectId
FROM objects
WHERE objectTypeId = '0-1'

반환합니다:

객체 유형	객체ID
0-1	36721864
0-1	103580363
0-1	56047670
...	...

객체_프로퍼티

이 데이터베이스 객체는 object_with_object_properties 데이터베이스 객체의 하위 집합입니다. 각 행에는 지정된 레코드에 설정된 현재 속성 값이 포함되어 있습니다. 예를 들어 연락처에는 이름 속성에 대한 행이 하나 있고 성 속성에 대한 행이 하나 있습니다. 레코드에 속성 값이 없는 경우 해당 행은 빈 문자열로 표시되거나 아예 표시되지 않습니다.

이 데이터베이스 객체는 다음 열을 반환할 수 있습니다:

열 이름	유형	설명
`OBJECTTYPEID`	바이트열	개체 유형의 ID(예: 연락처는 `0-1`)입니다.
`OBJECTID`	번호	레코드의 ID(예: ID가 `123752` 인 연락처 레코드).
`NAME`	바이트열	숙소의 이름입니다.
`VALUE`	타임스탬프	부동산의 가치입니다.
`UPDATEDAT`	타임스탬프	HubSpot에서 레코드가 마지막으로 업데이트된 날짜와 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.
`INGESTEDAT`	타임스탬프	스노우플레이크가 데이터를 마지막으로 수집한 날짜와 시간입니다.

예제 1

모든 연락처의 이름, 성, 도시 속성을 검색합니다.

쿼리:

SELECT objectTypeId, objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'city')
ORDER BY objectId;

반환합니다:

객체 유형	객체ID	이름	VALUE
0-1	10401	이름	Brian
0-1	10401	도시	더블린
0-1	10401	성	갤러거
0-1	23451	이름	Fernando
0-1	23451	성	Fierro
0-1	25751	이름	Charles
...	...	...	...

예제 2

모든 연락처의 이름, 성, 수명 주기 단계를 검색하여 연락처당 하나의 행으로 결합합니다. 이 예에서는 SQL PIVOT 구문을 사용합니다.

쿼리:

SELECT objectId, firstname, lastname, lifecyclestage
FROM
(
SELECT objectId, name, value
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, firstname, lastname, lifecyclestage);

반환합니다:

객체 유형	객체ID	이름	성	라이프사이클
0-1	54325098	홉스	남작	리드
0-1	96805401	Milo	골드	리드
0-1	6922028	Henry	Riley	리드
...	...	...	...	...

객체_프로퍼티_역사

이 데이터베이스 객체에는 과거 속성 값이 포함되어 있습니다. 연락처의 경우 가장 최근 45개의 값이 포함됩니다. 다른 모든 개체의 경우 가장 최근 20개의 값이 포함됩니다. 각 기록 속성 값에 대한 행을 표시합니다. 속성의 현재 값은 속성 기록에서 가장 최근의 업데이트된 타임스탬프에 의해 결정됩니다.

이 데이터베이스 객체는 다음 열을 반환할 수 있습니다:

열 이름	유형	설명
`OBJECTTYPEID`	바이트열	개체 유형의 ID(예: 연락처는 `0-1`)입니다.
`OBJECTID`	번호	레코드의 ID(예: ID가 `123752` 인 연락처 레코드).
`NAME`	바이트열	숙소의 이름입니다.
`VALUE`	타임스탬프	부동산의 가치입니다.
`UPDATEDAT`	타임스탬프	HubSpot에서 데이터가 마지막으로 업데이트된 날짜와 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.
`INGESTEDAT`	타임스탬프	스노우플레이크가 데이터를 마지막으로 수집한 날짜와 시간입니다.

예제 1

단일 연락처에 대한 단일 속성의 기록을 검색합니다.

쿼리:

SELECT objectId, name, value, updatedAt
FROM object_properties_history
WHERE objectTypeId = '0-1'
AND objectId = 136493192
AND name = 'hs_predictivescoringtier'
ORDER BY UPDATEDAT DESC;

반환합니다:

객체ID	이름	VALUE	업데이트
136493192	HS_Predictivescoringtier	tier_1	2022-06-22 22:45:05.931
136493192	HS_Predictivescoringtier	tier_2	2021-09-18 08:20:56.622
136493192	HS_Predictivescoringtier	tier_3	2019-11-31 18:20:22.851
...	...	...	...

예제 2

라이프사이클 단계가 구독자였던 모든 연락처의 현재 이름을 검색합니다.

쿼리:

SELECT
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'
);

반환합니다:

객체ID	이름	성
54325098	홉스	남작
96805401	Milo	골드
6922028	Henry	Riley
...	...	...

연결 쿼리

개체 데이터와 마찬가지로 연결 데이터는 두 가지 방식으로 구성됩니다:

개인: 각 연결 유형은 자체 보기에 저장되며 해당 유형의 레코드만 포함합니다. 예를 들어, associations_contacts_to_deals에는 연락처와 거래 개체 간의 연결 레코드만 포함됩니다. 따라서 쿼리할 때 연관 유형 ID를 지정할 필요가 없습니다. 이러한 뷰를 사용하기 위해 CRM 데이터 모델에 익숙하지 않아도 되므로 쿼리하기가 매우 쉽습니다. 또한 두 개체 간의 연결 레코드에 대한 풍부한 설명을 반환하므로 objects_x 뷰와의 조인에서 쉽게 사용할 수 있습니다. 쿼리 속도가 느리지 않다면 이러한 보기를 사용하여 연결 데이터를 검색하는 것이 좋습니다. 아래의 연관_x_to_y 뷰에서 자세히 알아보세요.
결합됨: 결합됨: 모든 연결 유형에 대한 모든 레코드가 하나의 데이터베이스 개체로 결합됩니다. 따라서 쿼리할 때 "WHERE combinedassociationtypeid='0-32'"와 같은 필터를 지정해야 합니다. 아래 연관 및 연관_정의에서 자세한 내용을 참조하세요.

연관성_x_to_y 보기

각 연결 유형에는 연관_<연결 유형 이름>으로 레이블이 지정된 자체 보기가 있습니다(예: 연관_계약_투_딜). 각 보기는 연관 데이터베이스 개체에 있는 데이터의 하위 집합이며 특정 결합된 연관 유형 ID의 레코드만 포함합니다.

각 데이터베이스 객체는 다음과 같은 열을 반환합니다:

열 이름	유형	설명
결합연결유형ID	바이트열	연결 정의의 고유 식별자입니다.
연관 카테고리	바이트열	연결 유형의 소스입니다. 다음 중 하나입니다: 허브스팟_정의, 사용자_정의, 통합자_정의
연관 유형 ID	바이트열	특정 연관 카테고리 내의 연관 정의의 고유 식별자, 즉 연관 카테고리에 있는 두 정의가 동일한 연관 유형 ID를 갖지 않습니다.
부터객체유형ID	바이트열	연결 정의의 소스인 객체 유형 ID입니다.
부터객체 유형	바이트열	연결 정의의 소스인 객체 유형의 이름입니다.
토브젝트 유형	바이트열	연결 정의의 대상인 객체 유형 ID입니다.
TOOBJECTTYPE	바이트열	연결 정의의 대상인 객체 유형의 이름입니다.
이름	바이트열	연결 정의의 이름입니다.
라벨	바이트열	연관 정의의 설명입니다.
주요 연관 정의	부울	연결 정의가 기본 유형인지 여부입니다. true인 경우, 이 정의는 연결된 레코드에 HubSpot이 표시하는 정의입니다.
[FROMOBJECTTYPE_OBJECTID] 예: ASSOCIATIONS_CONTACTS_TO_DEALS 뷰의 경우, 이는 CONTACT_OBJECTID입니다.	번호	소스 오브젝트의 오브젝트 ID입니다.
[TOOBJECTTYPE_OBJECTID] 예: ASSOCIATIONS_CONTACTS_TO_DEALS 뷰의 경우 DEAL_OBJECTID입니다.	번호	대상 객체의 객체 ID입니다.
INGESTEDAT	타임스탬프	스노우플레이크가 데이터를 마지막으로 수집한 날짜와 시간입니다.

예제 1

특정 연락처와 관련된 모든 거래를 검색합니다.

쿼리:

SELECT
연락처_객체Id, 거래_객체Id

FROM associations_contacts_to_deals

WHERE contactId = 6626541373

반환합니다:

연락처_객체ID	DEAL_OBJECTID
6626541373	233620335
6626541373	90253678

예제 2

보고타 시간대를 기준으로 한 모든 연락처와 해당 거래를 검색합니다.

SELECT contacts.property_firstname 연락처_이름,

contacts.property_lastname contact_lastname,
contacts.property_email contact_email,
deals.property_dealtype deal_type, deals.property_amount deal_amount
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacts.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
where contacts.property_hs_timezone='america_slash_bogota'

연락처_이름	연락처_성	연락처_이메일	DEAL_TYPE	DEAL_AMOUNT
David	마갈하에스	dmagalhaes@example.com	신규 비즈니스	74848
Fernanda	Rodrigues	fmoreira@example.com	신규 비즈니스	253530

예제 3

모든 연락처와 각 연락처의 거래 성사 금액의 총합을 검색합니다.

SELECT SUM(deals.property_hs_closed_amount) AS
total_closed_amount, contacts.property_email contact_email
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacts.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
GROUP BY contact_email
ORDER BY total_closed_amount DESC

반환합니다:

총_마감_금액	연락처_이메일
98474793	johndoe@riverview.com
849488	sallymae@longford.com

연관_정의

이 데이터베이스 객체에는 연결 유형당 하나의 행으로 HubSpot 객체 간에 사용 가능한 모든 연결 유형에 대한 정보가 포함되어 있습니다. 이 데이터베이스 개체를 연결 데이터베이스 개체와 조인하여 레코드별 연결 정보를 얻을 수 있습니다.

동일한 객체 간에는 여러 유형의 연결이 있을 수 있습니다. 기본 연결 유형은 레코드가 연결될 때 HubSpot에 표시되는 유형으로, ISMAINASSOCIATIONDEFINITION 이 true 인 연결을 사용합니다.

이 데이터베이스 객체는 다음 열을 반환할 수 있습니다:

열 이름	유형	설명
`COMBINEDASSOCIATIONTYPEID`	바이트열	연결 정의의 고유 식별자입니다.
`CATEGORY`	바이트열	연결 유형의 소스입니다. 다음 중 하나입니다: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	번호	해당 카테고리 내 연관 정의의 식별자입니다.
`FROMOBJECTTYPEID`	바이트열	연결 정의의 소스인 객체의 ID입니다.
`TOOBJECTTYPEID`	바이트열	연결 정의의 대상인 객체의 ID입니다.
`NAME`	바이트열	연결 정의의 이름입니다.
`LABEL`	바이트열	연관 정의의 레이블입니다.
`ISMAINASSOCIATIONDEFINITION`	부울	연결 정의가 기본 유형인지 여부입니다. true이면 연결된 레코드에 HubSpot이 표시하는 정의입니다.
`INGESTEDAT`	타임스탬프	스노우플레이크에서 데이터를 마지막으로 수집한 날짜 및 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.

예제 1

계정에서 사용 가능한 연결 유형을 검색합니다.

쿼리:

SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
ORDER BY category, id

반환합니다:

결합연결 유형	부터객체유형ID	토브젝트 유형	이름
0-1	0-1	0-2	연락처_투_회사
0-2	0-2	0-1	회사_투_연락처
0-3	0-3	0-1	거래_투_연락처
0-4	0-1	0-3	연락처_to_거래
0-5	0-3	0-2	거래처_투_회사
...	...	...	...

예제 2

거래와 회사 간에 사용 가능한 연결 유형을 검색합니다.

쿼리:

SELECTcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2' AND isMainAssociationDefinition = true
ORDER BY category, id

반환합니다:

결합연결 유형	부터객체유형ID	토브젝트 유형	이름
0-5	0-3	0-2	거래처_투_회사
0-271	0-3	0-2	거래처_투_주요_회사
0-341	0-3	0-2	거래_투_기업_언라벨드

연관성

이 데이터베이스 객체에는 특정 레코드 간의 연결에 대한 정보가 포함되어 있습니다. 각 행은 한 객체에서 다른 객체로의 연결을 나타냅니다. 참조된 레코드가 삭제되었더라도 이 데이터베이스 객체에는 행이 존재할 수 있습니다. 개체 테이블과 조인하여 레코드가 있는지 확인할 수 있습니다.

이 데이터베이스 개체는 계정에 많은 양의 데이터가 있어 연관성_x_to_y 뷰의 성능이 느려지는 경우에 유용할 수 있습니다.

이 데이터베이스 객체는 다음 열을 반환할 수 있습니다:

열 이름	유형	설명
`COMBINEDASSOCIATIONTYPEID`	바이트열	연결 정의의 고유 식별자입니다.
`FROMOBJECTID`	번호	소스 개체의 ID입니다.
`TOOBJECTID`	번호	대상 개체의 ID입니다.
`INGESTEDAT`	타임스탬프	스노우플레이크에서 데이터를 마지막으로 수집한 날짜 및 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.

예제 1

관련된 모든 거래 및 연락처를 검색합니다.

쿼리:

SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE combinedAssociationTypeId = '0-5'

반환합니다:

결합연결유형ID	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335
0-5	6616436082	3866015468
0-5	6690805943	7132752747
...	...	...

예 2

특정 연락처(연락처 ID: 3005)와 관련된 모든 티켓을 검색합니다.

쿼리:

SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE associationCategory = 'HUBSPOT_DEFINED'
AND combinedAssociationTypeId = '0-15'
AND fromObjectId = 3005;

반환합니다:

결합연결 유형	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

예제 3

특정 연락처(연락처 ID: 4464)와 관련된 모든 거래를 검색합니다. 이 예에서는 결합된AssociationTypeId를 하드 코딩하는 대신 association_definitions로 조인합니다.

쿼리:

SELECT combinedAssociationTypeId, fromObjectId toObjectId,
FROM associations
WHERE
combinedAssociationTypeId = (
SELECT combinedAssociationTypeId
FROM association_definitions
WHERE fromObjectTypeId = '0-1'
AND toObjectTypeId = '0-3'
AND isMainAssociationDefinition)
AND fromObjectId = 4464;

반환합니다:

결합연결유형ID	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

소유자 쿼리

소유자

이 데이터베이스 개체에는 HubSpot 계정의 사용자에 대한 정보가 포함되어 있습니다. 사용자는 레코드 소유자로 설정할 수 있으며 컨텍스트에 따라 사용자 ID와 소유자 ID를 모두 포함할 수 있습니다. 두 ID 모두 동일한 사용자를 식별하는 데 사용할 수 있습니다.

이 데이터베이스 객체는 다음 열을 반환할 수 있습니다:

열 이름	유형	설명
`OWNERID`	번호	사용자의 소유자 ID입니다.
`USERID`	번호	사용자의 사용자 ID입니다. 이 열에 NULL이 있는 사용자는 삭제되었습니다.
`EMAIL`	바이트열	사용자의 이메일 주소입니다.
`FIRSTNAME`	바이트열	사용자의 이름입니다.
`LASTNAME`	바이트열	사용자의 성입니다.
`ARCHIVED`	부울	사용자가 삭제되었는지 여부.
`CREATEDAT`	타임스탬프	사용자가 HubSpot에서 생성된 날짜와 시간입니다. 자세한 내용은 열 데이터 유형을 참조하세요.
`UPDATEDAT`	타임스탬프	사용자가 HubSpot에서 마지막으로 업데이트한 날짜와 시간입니다. 자세한 내용은 열 데이터 유형을 참조하세요.
`INGESTEDAT`	타임스탬프	스노우플레이크가 데이터를 마지막으로 수집한 날짜와 시간입니다.

예제 1

모든 사용자를 검색합니다. WHERE archived = false 필터는 반환된 데이터에서 삭제된 사용자를 제거합니다.

쿼리:

SELECT ownerId, userId, email, firstname, lastname FROM owners WHERE archived = false

반환합니다:

소유자 ID	USERID	이메일	이름	성
29584574	4621126	233620335	홉스	남작
30532717	4874784	3866015468	Pablo	Walters
30580321	925511	7132752747	Milo	골드
...	...	...	...	...

예제 2

소유자 ID로 특정 소유자를 검색합니다.

쿼리:

SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE ownerId = 29584574;

반환합니다:

소유자 ID	USERID	이메일	이름	성
29584574	4621126	233620335	홉스	남작

예제 3

모든 연락처와 그 소유자를 검색합니다. 이 쿼리는 object_with_object_properties 및 연락처 속성 hubspot_owner_id를 사용하여 레코드를 소유자에 조인합니다.

SELECT contact.objectId contactid, contact.property_firstname contact_firstname, contact.property_lastname contact_lastname, contact.property_hubspot_owner_id contact_hubspot_owner_id, owner.firstname owner_firstname, owner.lastname owner_lastname, owner.email owner_email FROM objects_contacts contact

JOIN owners owner ON contact.property_hubspot_owner_id = owner.ownerId

반환합니다:

연락처	연락처_이름	연락처_성	연락처_허브스팟_소유자_ID	소유자_이름	소유자_성명	소유자_이메일
113834202	Richard	그린필드	29584574	홉스	남작	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	골드	milo.g@business.com
...	...	...	...	...	...	...

팀 쿼리

팀

HubSpot의 팀을 사용하면 조직 및 보고 목적으로 사용자를 그룹으로 구성할 수 있습니다. 기본 팀과 추가 팀을 가질 수 있습니다.

이 데이터베이스 개체에는 HubSpot 계정의 팀에 대한 정보가 포함되어 있습니다.

이 데이터베이스 객체는 다음 열을 반환할 수 있습니다:

열 이름	유형	설명
TEAMID	번호	팀 ID입니다.
팀명	바이트열	팀 이름입니다.
부모팀ID	번호	상위 팀의 팀 ID입니다.
어린이 팀	배열	하위 팀의 팀 ID입니다.
기본 소유자	바이트열	팀 주 멤버의 소유자 ID입니다.
보조 소유자	부울	팀 보조 멤버의 소유자 ID입니다.
INGESTEDAT	타임스탬프	스노우플레이크가 마지막으로 데이터를 수집한 날짜와 시간입니다.

예제 1

모든 팀을 검색합니다.

쿼리:

SELECT teamId,teamName, primaryOwnerMembers

팀으로부터

반환합니다:

TEAMID	팀명	기본 소유자
29584574	하위 팀	[233620335, 1234553]
30532717	슈퍼 팀	[3866015468, 126221873]
3058032	팀	[7132752747]

소유자_팀

이 데이터베이스 개체에는 HubSpot 계정에서 어떤 소유자가 어떤 팀에 해당하는지에 대한 정보가 포함되어 있습니다.

이 데이터베이스 객체는 다음 열을 반환할 수 있습니다:

열 이름	유형	설명
TEAMID	번호	팀 ID입니다.
소유자 ID	번호	사용자의 소유자 ID입니다.
ISTEAMPRIMARY	부울	이 팀이 이 소유자의 기본 팀인지 여부입니다.
INGESTEDAT	타임스탬프	스노우플레이크가 데이터를 마지막으로 수집한 날짜와 시간입니다.

예제 1

지정된 팀의 모든 소유자를 검색합니다.

쿼리:

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

반환

TEAMID	팀명	ISTEAMPRIMARY
29584574	233620335	TRUE
29584574	1234553	TRUE

파이프라인 쿼리

아래에서 계정에서 사용 가능한 파이프라인과 그 단계 등거래 및 티켓 파이프라인 데이터를쿼리하는 방법을 알아보세요 .

이 데이터를 개체 데이터와 조인하여 파이프라인의 전체 보기를 확인할 수 있습니다. 예를 들어, objects_deals_view 또는 object_with_object_properties 데이터를 파이프라인 데이터와 조인하여 거래와 해당 파이프라인을 쿼리할 수 있습니다.

파이프라인

이 데이터베이스 개체에는 계정의 거래 및 티켓 파이프라인에 대한 정보가 포함되어 있습니다. 반환된 각 행은 하나의 파이프라인을 나타냅니다.

이 테이블은 다음과 같은 열을 반환할 수 있습니다:

열 이름	유형	설명
`PIPELINEID`	바이트열	파이프라인의 ID입니다.
`OBJECTTYPEID`	바이트열	파이프라인에 포함될 수 있는 개체의 ID(예: 거래 또는 티켓)입니다.
`LABEL`	바이트열	HubSpot에서 파이프라인의 이름입니다.
`DISPLAYORDER`	번호	HubSpot에서 파이프라인이 표시되는 순서입니다.
`ARCHIVED`	부울	파이프라인이 삭제되었는지 여부입니다.
`CREATEDAT`	타임스탬프	파이프라인이 생성된 시점.
`UPDATEDAT`	타임스탬프	HubSpot에서 데이터가 마지막으로 업데이트된 날짜와 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.
`INGESTEDAT`	타임스탬프	스노우플레이크가 데이터를 마지막으로 수집한 날짜와 시간입니다.

예제 1

사용 가능한 모든 거래 파이프라인을 HubSpot에서 주문 순서대로 검색합니다.

쿼리:

SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = '0-3'AND not archived
ORDER BY displayorder;

반환합니다:

객체 유형	PIPELINEID	라벨
0-3	1bed503c-37f7-4f51-9d40-7598902673f4	영업 파이프라인
0-3	12659678	라이선스 파이프라인
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	신규 비즈니스
...	...	...

예제 2

특정 파이프라인 내의 거래를 검색합니다. object_with_object_properties와 파이프라인을 조인합니다.

쿼리:

SELECT

deals.objectId deal_id, deals.property_dealname deal_name, pipelines.label pipeline_name FROM objects_deals deals INNER JOIN pipelines ON deals.objectTypeId = pipelines.objectTypeId AND deals.property_pipeline = pipelines.pipelineid WHERE pipelines.objectTypeId = '0-3';

반환합니다:

DEAL_ID	DEAL_NAME	파이프라인_이름
605140072	Meowmix 글로벌 가입	영업 파이프라인
605457408	프리스키즈 리브랜딩	영업 파이프라인
604362473	Fresh Step 앱 빌드	영업 파이프라인

예제 3

위의 예 2와 동일하게 특정 파이프라인 내에서 거래를 검색합니다. 하지만 조인에서 objects_deals를 사용하는 대신 object_with_object_properties를 사용합니다.

SELECT 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';

반환합니다:

DEAL_ID	DEAL_NAME	파이프라인_이름
605140072	Meowmix 글로벌 가입	영업 파이프라인
605457408	프리스키즈 리브랜딩	영업 파이프라인
604362473	Fresh Step 앱 빌드	영업 파이프라인

파이프라인_단계

이 보기에는 파이프라인 내의 개별 단계에 대한 정보가 포함되어 있습니다. 개체 유형 ID, 파이프라인 ID 및 스테이지 ID를 조합하여 스테이지를 식별합니다. 파이프라인으로 조인할 때는 개체 유형 ID와 파이프라인 ID를 사용합니다.

이 데이터베이스 객체는 다음 열을 반환할 수 있습니다:

열 이름	유형	설명
`PIPELINEID`	바이트열	파이프라인의 ID입니다.
`STAGEID`	바이트열	스테이지의 ID입니다.
`LABEL`	바이트열	HubSpot의 무대 이름입니다.
`DISPLAYORDER`	번호	HubSpot에서 파이프라인이 표시되는 순서입니다.
`METADATA`	변형	스테이지의 개방형 또는 폐쇄형 여부를 포함한 JSON 형식의 설명입니다.
`ARCHIVED`	부울	파이프라인 단계가 삭제되었는지 여부입니다.
`CREATEDAT`	타임스탬프	파이프라인 단계가 생성되었을 때

예제 1

영업 파이프라인이라는 거래 파이프라인에 대한 파이프라인 단계를 검색합니다.

쿼리:

SELECT pipelineid, stageId, label
FROM pipeline_stages
WHERE not archived
AND pipelineid = (
SELECT pipelineid
FROM pipelines
WHERE objectTypeId = '0-3'
AND not archived
AND label = 'Sales Pipeline' LIMIT 1)
ORDER BY displayorder;

반환합니다:

PIPELINEID	STAGEID	라벨
941650	941651	연락처
941650	941652	예약된 앱
941650	941653	송장 전송
...	...	...

예제 2

모든 거래와 해당 파이프라인 단계를 검색합니다.

쿼리:

SELECT
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';

반환합니다:

DEAL_ID	DEAL_NAME	파이프라인_이름	파이프라인_단계_이름
605140072	Meowmix 글로벌 가입	영업 파이프라인	계약서 전송
605457408	프리스키즈 리브랜딩	영업 파이프라인	예약된 앱
604362473	Fresh Step 앱 빌드	영업 파이프라인	계약 체결
...	...	...	...

속성 쿼리

속성_정의

이 데이터베이스 개체에는 HubSpot 계정의 개체 속성 및 이벤트 속성에 대한 정보가 포함되어 있습니다. 이벤트 속성에는 이메일 열기 및 클릭과 같은 표준 이벤트와 사용자 지정 동작 이벤트 속성이 포함됩니다. 이 정보는 object_properties 및 이벤트 데이터에 있는 값을 정의하는 데 유용할 수 있습니다.

개체 유형 ID와 이름을 조합하여 특정 속성을 식별할 수 있습니다. 속성 API를 사용하여 유사한 정보를 검색할 수 있습니다.

이 데이터베이스 객체는 다음 열을 반환할 수 있습니다:

열 이름	유형	설명
`OBJECTYPEID`	바이트열	이벤트가 연관된 객체의 ID입니다.
`NAME`	바이트열	속성의 내부 이름입니다.
`LABEL`	바이트열	숙소의 레이블입니다.
`DESCRIPTION`	바이트열	숙소의 설명입니다.
`TYPE`	바이트열	속성의 유형(예: 문자열, 숫자, 날짜/시간)입니다.
`FIELDTYPE`	바이트열	속성의 필드 유형입니다. 속성이 HubSpot 및 양식에 표시되는 방식(예: 확인란, 선택)을 정의합니다.
`DISPLAYORDER`	번호	숙소의 표시 순서입니다.
`GROUPNAME`	바이트열	속성의 그룹 이름입니다.
`OPTIONS`	변형	열거형 속성의 경우, 각 옵션의 속성(예: 표시 순서, 레이블)을 포함한 속성 옵션의 배열입니다.
`CREATEDUSERID`	번호	속성을 생성한 사용자의 ID입니다.
`REFERENCEDOBJECTTYPE`	바이트열	프로퍼티가 참조하는 객체의 유형입니다. 소유자 프로퍼티는 OWNER 값을 반환합니다.
`CALCULATED`	부울	속성이 계산된 속성인지 여부입니다.
`EXTERNALOPTIONS`	부울	숙소의 옵션이 외부 시스템에 정의되어 있는지 여부입니다.
`HASUNIQUEVALUE`	부울	속성의 값이 고유한지 여부. API를 통해 속성을 생성할 때만 설정할 수 있습니다.
`HIDDEN`	부울	숙소가 HubSpot에 숨겨져 있는지 여부입니다.
`SHOWCURRENCYSYMBOL`	부울	숫자 속성 값의 형식이 통화로 지정되는지 여부입니다.
`FORMFIELD`	부울	이 속성을 양식에서 사용할 수 있는지 여부입니다.
`READONLYDEFINITION`	부울	HubSpot에서 속성을 편집할 수 있는지 여부입니다.
`READONLYVALUE`	부울	HubSpot에서 속성 값을 편집할 수 있는지 여부입니다.
`HUBSPOTDEFINED`	부울	속성이 HubSpot에 의해 생성되었는지, 아니면 사용자가 생성했는지 여부입니다.
`ARCHIVED`	부울	속성이 삭제되었는지 여부입니다.
`CREATEDAT`	타임스탬프	HubSpot에서 속성이 생성된 날짜와 시간입니다.
`UPDATEDAT`	타임스탬프	HubSpot에서 데이터가 마지막으로 업데이트된 날짜와 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.
`INGESTEDAT`	타임스탬프	스노우플레이크가 데이터를 마지막으로 수집한 날짜와 시간입니다.

예제 1

모든 연락처 속성에 대한 이름과 설명을 검색합니다.

쿼리:

SELECT name, label, description
FROM property_definitions
WHERE objectTypeId = '0-1'

반환합니다:

이름	라벨	설명
entered_sql_stage	SQL 단계 진입	SQL 단계 일수 계산을 시작합니다.
첫_전환_이벤트_이름	첫 번째 전환	이 연락처가 제출한 첫 번째 양식입니다.
주소	거리 주소	연락처의 주소입니다.

이벤트 쿼리

이벤트에는 표준 HubSpot 이벤트와 사용자 지정 동작 이벤트가 포함됩니다. 각 이벤트에는 events_eventname 로 레이블이 지정된 자체 데이터베이스 개체가 있습니다.

이름
이벤트_광고_인터랙션	광고를 클릭하거나 광고에 참여한 후 양식을 제출하여 광고와 상호작용한 연락처의 세부 정보입니다.
이벤트_광고_메트릭_임포트_v0	광고의 세부 정보 및 실적 지표를 확인할 수 있습니다.
이벤트_통화_멘션된_키워드	통화 참여자가 언급한 키워드에 대한 세부 정보입니다.
이벤트_클릭_링크_인_이메일_V2	연락처가 마케팅 이메일에서 클릭한 링크.
이벤트_클릭_링크_인_트래킹된_받은 편지함_이메일_v8	연락처별 대화 받은 편지함 이메일에서 클릭한 링크입니다.
이벤트_쿠키_배너_클릭됨	쿠키를 클릭한 연락처.
이벤트_쿠키_배너_보기	쿠키를 열람한 연락처.
이벤트_문서_공유_v2	외부 링크를 통해 연락처와 공유한 영업 문서.
이벤트_문서_보기_v2	외부 링크를 열어 영업 문서 및 연락처를 열람한 영업 담당자가 있습니다.
이벤트_문서_완료_v2	영업 문서 및 해당 문서가 마감된 연락처.
이벤트_HS_예정_이메일_v2	HubSpot 이메일 서버에 제출된 이메일이 전송됩니다.
이벤트_TA_전달된_이메일_v2	HubSpot 이메일 서버에서 수신자에게 성공적으로 전달된 이메일입니다.
이벤트_타_바운스된_이메일_v2	수신자의 이메일 서버에서 거부된 이메일 전송 시도입니다.
이벤트_열린_이메일_v2	연락처별로 이메일이 열립니다.
이벤트_보고된_스팸_이메일_v2	수신자가 스팸으로 표시한 이메일.
이벤트_업데이트_이메일_구독_상태_v2	수신자의 이메일 이메일 구독 변경.
이벤트_열린_추적_받은 편지함_이메일_v8	보존 받은 편지함 이메일은 연락처별로 열립니다.
이벤트_MB_미디어_재생	연락처별 동영상 재생 활동.
이벤트 V2_연락처_예약_미팅_스루_시퀀스	연락처가 시퀀스를 통해 미팅을 예약했습니다.
이벤트 V2_연락처_등록_인_시퀀스	시퀀스에서 등록한 연락처입니다.
이벤트 V2_접촉_완료_시퀀스	시퀀스가 완료되었습니다.
이벤트 V2_연락처_응답_시퀀스_이메일	연락처가 시퀀스를 통해 전송된 이메일(또는 시퀀스를 등록하지 않은 수신 이메일)에 답장했습니다.
이벤트 V2_연락처_등록되지 않은 시퀀스	시퀀스에서 등록되지 않은 연락처입니다.
이벤트 V2_연락처_등록되지_않음_수동으로_부터_시퀀스	사용자가 연락처 등록을 수동으로 취소했습니다.
이벤트 V2_연락처_미수신_시퀀스_이메일	연락처 구독을 취소하고 시퀀스 등록을 취소합니다.
이벤트 V2_시퀀스_이메일_바운스됨	시퀀스 이메일이 반송되었습니다.
events_v2_sequence_errored	시퀀스 오류로 인해 등록이 취소되었습니다.
이벤트 V2_시퀀스_스텝_실행	시퀀스 단계가 실행되었습니다.
이벤트_방문_페이지	연락처별 웹사이트 페이지 방문 횟수.
events_<통합_이벤트_이름>_<고유_식별자>	통합 이벤트(타임라인 V3 API)

이벤트 유형 ID와 ID를 결합하여 이벤트를 식별할 수 있습니다. 반환되는 열은 이벤트에 따라 다르며 각 이벤트 속성에 대해 하나의 열이 반환됩니다. 모든 이벤트는 다음과 같은 열을 반환합니다:

참고: HubSpot은 모든 이벤트 테이블과 보기에 두 개의 새로운 열을 추가했습니다:

occurredat
occurredatdateint

이 열은 2022년 11월 24일에 occuredat 및 occuredatdateint 열을 대체할 예정입니다. 해당 날짜에는 이전 열을 더 이상 사용할 수 없으며, 해당 열을 사용하여 이벤트를 포함하는 데이터베이스 개체 또는 보기를 쿼리하려는 시도는 실패합니다. 눈송이 데이터 공유의 중단 변경 사항에 대해 자세히 알아보세요.

열 이름	유형	설명
`EVENTTYPEID`	바이트열	이벤트 유형의 ID로, OBJECTTYPEID와 유사합니다. object_and_event_type_definitions 보기를 사용하여 계정의 모든 이벤트 유형 ID를 쿼리할 수 있습니다.
`ID`	바이트열	이벤트 유형별로 고유합니다. 주어진 이벤트 유형 내에서 두 개의 레코드가 동일한 ID를 가질 수 없습니다.
`OBJECTTYPEID`	바이트열	이벤트를 완료한 개체의 유형입니다. 예를 들어 이메일 링크 클릭은 이 열에 연락처 개체를 나타내는 `0-1` 을 표시합니다.
`OBJECTID`	번호	이벤트를 완료한 레코드의 ID입니다.
`OCCURREDAT`	타임스탬프	이벤트가 발생한 시기.
`OCCURREDATDATEINT`	번호	이벤트가 발생한 시점을 나타내는 숫자입니다. `OCCURREDAT` 열과 동일한 데이터를 포함하지만 숫자로 서식이 지정되어 테이블의 클러스터 키의 일부로 사용됩니다. 대부분의 경우 이 숫자 대신 `OCCURREDAT` 타임스탬프를 사용할 수 있습니다.
`OCCUREDATDATEINT`	번호	이벤트가 발생한 시점을 나타내는 숫자입니다. `OCCURREDAT` 열과 동일한 데이터를 포함하지만 숫자로 서식이 지정되어 테이블의 클러스터 키의 일부로 사용됩니다. 대부분의 경우 이 숫자 대신 `OCCURREDAT` 타임스탬프를 사용할 수 있습니다. 참고: 이 열은 2022년 11월 24일에 더 이상 사용되지 않으며 `OCCURREDATDATEINT` 으로 대체됩니다.
`OCCUREDAT`	타임스탬프	이벤트가 발생한 시기. 참고: 이 열은 2022년 11월 24일에 더 이상 사용되지 않으며 `OCCURREDAT` 으로 대체됩니다.
`INGESTEDAT`	타임스탬프	스노우플레이크에서 데이터를 마지막으로 수집한 날짜 및 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.
`PROPERTY_*`	바이트열	이벤트 속성을 포함하는 개별 열입니다.

예제 1

가장 최근의 이메일 클릭 이벤트 50개를 검색합니다.

쿼리:

SELECT eventTypeId, objectTypeId, objectId, occuredAt, property_hs_click_raw_url AS hs_click_raw_url
FROM events_clicked_link_in_email_V2 ORDER BY occuredAtLIMIT 50;

반환합니다:

이벤트 유형	객체 유형	객체ID	발생 날짜	HS_CLICK_ROW_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
...	...	...	...	...

예제 2

클릭한 연락처의 모든 이메일 클릭 이벤트를 검색합니다. 이 쿼리는 object_with_object_properties와 조인하여 연락처 데이터를 가져옵니다.

쿼리:

SELECT click.occuredat 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;

반환합니다:

클릭_타임스탬프	CLICK_URL	연락처_이름	연락처_성
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	홉스	남작
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	골드
2018-11-08 09:37:41.426	https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Harlow	Villari
...	...	...	...

개체 및 이벤트 유형 쿼리

객체_및_이벤트_유형_정의

이 데이터베이스 개체에는 HubSpot 계정에서 사용할 수 있는 모든 개체 및 이벤트에 대한 정의가 포함되어 있습니다.

이 데이터베이스 객체는 다음 열을 반환할 수 있습니다:

열 이름	유형	설명
`OBJECTTYPEID`	바이트열	파이프라인에 포함될 수 있는 개체의 ID(예: 거래 또는 티켓)입니다.
`FULLYQUALIFIEDNAME`	바이트열	개체 또는 이벤트의 이름입니다.
`INGESTEDAT`	타임스탬프	스노우플레이크에서 데이터를 마지막으로 수집한 날짜와 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.

예제 1

HubSpot 계정에서 사용 가능한 모든 개체와 이벤트를 검색합니다.

쿼리:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

반환합니다:

객체 유형	전체 자격 이름
0-1	연락처
0-8	LINE_ITEM
0-11	대화
...	...

쿼리 나열

아래에서 사용 가능한 연락처 및 회사 목록과 해당 목록에 포함된 레코드 등 목록을 쿼리하는 방법을 알아보세요.

이 데이터베이스 개체에는 HubSpot 연락처 및 회사 목록에 대한 정보가 포함되어 있습니다. 목록당 하나의 행을 반환하며 열에는 목록 이름, 크기 및 목록에 포함된 레코드의 개체 유형과 같은 목록 세부 정보가 포함됩니다. 각 목록 내의 개별 레코드에 대한 정보는 포함하지 않습니다( list_membership 참조).

이 데이터베이스 객체는 다음 열을 반환할 수 있습니다:

열 이름	유형	설명
`OBJECTTYPEID`	바이트열	목록에 있는 레코드 유형(예: 연락처 또는 회사)입니다.
`LISTID`	번호	목록의 ID입니다. 목록 멤버십 테이블의 LISTID 열에 조인합니다.
`CLASSICLISTID`	번호	연락처 목록에 고유한 ID로, HubSpot의 목록 URL에 있는 ID와 일치합니다.
`NAME`	바이트열	목록의 이름입니다.
`SIZE`	번호	목록에 있는 레코드 수입니다.
`CREATEDBYUSERID`	번호	목록을 만든 사용자의 ID입니다.
`CREATEDAT`	타임스탬프	목록이 HubSpot에서 생성된 경우.
`UPDATEDBYUSERID`	번호	가장 최근에 목록을 업데이트한 사용자의 ID입니다.
`UPDATEDAT`	타임스탬프	날짜가 HubSpot에서 마지막으로 업데이트된 날짜 및 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.
`INGESTEDAT`	타임스탬프	스노우플레이크가 데이터를 마지막으로 수집한 날짜와 시간입니다.

예제 1

모든 연락처 목록을 검색합니다.

쿼리:

SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1';

반환합니다:

LISTID	이름	크기
118131	주간 아웃리치	103
66156	블로그 구독자	455
771852	상위 구독자 2021	37
...	...	...

예제 2

상위 구독자 2021이라는 특정 연락처 목록을 검색합니다.

쿼리:

SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1' ANDlistName = 'Top subscribers 2021';

반환합니다:

LISTID	이름	크기
771852	상위 구독자 2021	37

목록_멤버십

이 데이터베이스 객체에는 어떤 레코드가 어떤 목록의 멤버인지에 대한 정보가 목록의 레코드당 한 행씩 포함되어 있습니다. 예를 들어 500명의 연락처가 있는 블로그 구독자 목록이 있는 경우 데이터베이스 개체는 500개의 행을 반환합니다.

목록 ID와 객체 ID만 포함합니다. 자세한 내용은 목록 데이터베이스 개체를 사용하여 조인하세요.

이 데이터베이스 객체는 다음 열을 반환할 수 있습니다:

열 이름	유형	설명
`LISTID`	바이트열	목록의 ID입니다. 목록 테이블의 HS_LIST_ID 열에 조인합니다.
`OBJECTID`	바이트열	목록에 있는 레코드의 ID입니다.
`UPDATEDAT`	타임스탬프	HubSpot에서 데이터가 마지막으로 업데이트된 날짜와 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.
`INGESTEDAT`	타임스탬프	스노우플레이크가 데이터를 마지막으로 수집한 날짜와 시간입니다.

예제 1

2021년 상위 구독자 목록에 있는 모든 연락처의 ID를 검색합니다.

쿼리:

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

반환합니다:

객체ID

54325098

96805401

6922028

...

예제 2

2021년 상위 구독자 목록에서 연락처 세부정보의 이름과 성을 검색합니다.

쿼리:

SELECT

contact.objectId AS objectid, contact.property_firstname AS firstname, contact.property_lastname AS lastname FROM objects_contacts contact INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId INNER JOIN lists ON list_memberships.listId = lists.listId WHERE lists.objectTypeId = '0-1' AND lists.name = 'Top Subscribers 2021'

반환합니다:

객체ID	이름	성
54325098	홉스	남작
96805401	Milo	골드
6922028	Henry	Riley
...	...	...

자주 묻는 질문

Hubspot 앱의 보고서와 유사한 데이터를 생성하고 싶은데 어떻게 해야 하나요?

일반적으로 비교하려는 보고서에 있는 열을 보고 싶을 것입니다. 보고서 시각화가 표 형식이 아닌 경우 테이블로 변환하면 보고서에 포함된 열이 표시됩니다. 이러한 열은 일반적으로 개체 유형 또는 이벤트 유형의 속성입니다. 다음 단계는 열이 해당하는 개체 유형 속성을 파악하는 것입니다. property_definitions를 쿼리하여 이 작업을 수행할 수 있습니다:

SELECT * FROM property_definitions

WHERE label = [column_name]

일부 속성 이름은 일반적으로 앱에서 더 자세한 설명이 포함된 이름으로 확인되므로 항상 정확히 일치하지 않을 수 있습니다. 이런 경우 property_definitions의 레이블(또는 설명) 열에서 LIKE 연산자를 사용하여 퍼지 검색을 수행하면 도움이 될 수 있습니다.

열이 속한 객체 유형을 결정한 후에는 무엇을 쿼리할지 결정하는 것은 간단합니다. 해당 유형에 해당하는 object_x 보기를 검색하기만 하면 됩니다.

이 데이터 유형을 다른 데이터 유형에 연결하려면 어떻게 해야 하나요(예: 캠페인용 양식을 검색하는 방법)?

두 개 이상의 서로 다른 레코드를 서로 연결해야 하는 경우 연관을 살펴보세요. 연결은 HubSpot CRM에서 개체 간의 관계를 나타냅니다. 두 유형 간에 가능한 모든 다른 연결이 association_definitions에 나열됩니다. 위의 예에서 캠페인이 연결된 모든 양식을 확인하려면 ASSOCIATIONS_CAMPAIGNS_TO_FORMS를 쿼리해야 합니다:

SELECT campaigns.property_hs_name campaign_name, forms.property_hs_form_id form_id FROM objects_campaigns campaigns JOIN associations_campaigns_to_forms assoc ON assoc.campaign_objectid=campaigns.objectid JOIN objects_forms forms ON forms.objectid=assoc.form_objectid GROUP BY campaign_name

HubSpot-Snowflake 통합 상태를 어떻게 알 수 있나요?

HubSpot-Snowflake 통합에 대한 중단 및 문제에 대한 실시간 상태 업데이트를 받으려면 data_share_status 보기를 쿼리하세요:

SELECT * FROM hubspot.public.data_share_status LIMIT 1

결과는 다음과 같이 표시됩니다:

상태	메시지	업데이트
확인	현재 알려진 사건 없음	2023-04-10 09:21:20.123

이 보기는 통합 상태에 대한 업데이트를 시간 역순으로 제공합니다. 이 쿼리의 결과를 대시보드에 통합하면 통합의 성능을 추적하고 다운타임이나 중단을 감지하는 데 도움이 됩니다.

이 문서가 도움이 되었나요? 예 아니요

이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.

스노우플레이크에서 HubSpot 데이터 쿼리하기

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

데이터 지연 및 스노우플레이크 계정 지역

스노우플레이크 환경 설정

데이터 개요

반환된 데이터 제한 및 주문

열 데이터 유형

데이터 유형 변환

개체 쿼리

objects_x 조회

예제 1

예제 2

예제 3

객체_위드_객체_프로퍼티

예제 1

예 2

객체

예제 1

객체_프로퍼티

예제 1

예제 2

객체_프로퍼티_역사

예제 1

예제 2

연결 쿼리

연관성_x_to_y 보기

예제 1

예제 2

예제 3

연관_정의

예제 1

예제 2

연관성

예제 1

예 2

예제 3

소유자 쿼리

소유자

예제 1

예제 2

예제 3

팀 쿼리

팀

예제 1

소유자_팀

예제 1

파이프라인 쿼리

파이프라인

예제 1

예제 2

예제 3

파이프라인_단계

예제 1

예제 2

속성 쿼리

속성_정의

예제 1

이벤트 쿼리

예제 1

예제 2

개체 및 이벤트 유형 쿼리

객체_및_이벤트_유형_정의

예제 1

쿼리 나열

목록

예제 1

예제 2

목록_멤버십

예제 1

예제 2

자주 묻는 질문

Hubspot 앱의 보고서와 유사한 데이터를 생성하고 싶은데 어떻게 해야 하나요?

이 데이터 유형을 다른 데이터 유형에 연결하려면 어떻게 해야 하나요(예: 캠페인용 양식을 검색하는 방법)?

HubSpot-Snowflake 통합 상태를 어떻게 알 수 있나요?

관련 콘텐츠