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

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

마지막 업데이트 날짜: 2025년 12월 31일

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

Data Hub Enterprise

Snowflake를 HubSpot 계정에 연결한 후에는 Snowflake의 데이터 공유 기능을 사용하여 Snowflake 계정에서 HubSpot 데이터를 쿼리할 수 있습니다.

데이터 지연 및 Snowflake 계정 지역

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

주의 사항: V2_LIVE 스키마의 다음 뷰는 매일만 업데이트됩니다: association_definitions, owners, pipelines 및 pipeline_stages.

Snowflake 환경 설정

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

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

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

데이터 유형 변환

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

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에는 연락처 레코드만 포함됩니다. 이를 통해 쿼리 시 객체 유형 ID(objecttypeid)를 지정할 필요가 없습니다. 이러한 뷰는 객체 유형 ID를 알 필요가 없어 쿼리가 더 용이합니다. 또한 각 행이 하나의 객체와 해당 속성의 최신 버전에 대응하는, 활용하기 쉬운 형식으로 데이터를 반환합니다. 쿼리 속도가 느려지지 않는 한 객체 데이터 검색 시 이러한 뷰를 사용하는 것이 좋습니다. 자세한 내용은 아래 Objects_X 뷰에서 확인하세요.
결합형: 모든 객체 유형의 레코드가 하나의 데이터베이스 객체로 통합됩니다. 따라서 쿼리 시 "WHERE objectTypeId='0-1'"과 같은 필터를 지정해야 합니다. 예를 들어 쿼리 시 다음과 같은 객체 유형 ID를 사용할 수 있습니다:

객체 이름	ObjectTypeId
연락처	0-1
기업	0-2
라인 항목	0-8

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

이러한 데이터베이스 개체는 일반적으로 objects_x 뷰에서 얻을 수 있는 것보다 더 나은 쿼리 성능을 원할 때 적합합니다. 자세한 내용은 아래 object_with_object_properties, object_properties, objects 및 object_properties_history에서 확인하세요.

objects_x 뷰

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

이 뷰에 대한 쿼리는 개체 내 각 레코드에 대해 한 행을 반환하며, 개체의 각 속성은 별도의 열로 제공됩니다.

사용 가능한 HubSpot(즉, 비사용자 정의) 객체 유형의 포괄적인 목록, 해당 데이터의 간략한 설명 및 대응 뷰는 아래를 참조하십시오:

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

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

열 이름	유형	설명
OBJECTTYPEID	Varchar	객체 유형의 ID(예: contacts는 0-1).
OBJECTID	Number	레코드의 ID(예: ID가 123752인 연락처 레코드).
업데이트 날짜	타임스탬프	HubSpot에서 이 개체가 마지막으로 업데이트된 날짜 및 시간.
INGESTEDAT	타임스탬프	Snowflake에서 데이터를 마지막으로 수집한 날짜 및 시간입니다.
PROPERTY_*	Varchar	개체의 속성 최신 버전을 포함하는 개별 열입니다. property_definitions에 지정된 대로 날짜 또는 숫자 유형을 가진 각 개체 속성에 대해 두 개의 열이 생성됩니다: 속성 값을 문자열로 포함하는 열입니다. 열 이름은 property_unparsed_[name]이 됩니다. 예를 들어, DEAL 객체의 속성 deal_amount는 property_unparsed_deal_amount 열을 가집니다. 값을 네이티브 타입으로 변환한 열. 열 이름은 property_[이름]이 됩니다. 예를 들어, 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

반환 결과:

OBJECTID	FIRSTNAME	LASTNAME	LIFECYCLESTAGE
54325098	Hobbes	Baron	리드
96805401	Milo	골드	리드
6922028	헨리	라일리	리드

예시 2

최대 세 건의 거래에 대한 거래명과 단계를 조회합니다.

쿼리:

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

반환값:

OBJECTID	PROPERTY_DEALNAME	PROPERTY_DEALSTAGE	부동산 거래 금액
38960439	거래명 1	클로즈드원	34199
321740651	테스트 거래 123	14845019	8383663
98392101	팝업 캐노피	closedwon	9309007

예제 3

금액 기준 상위 3개 거래의 거래명과 단계를 조회합니다.

쿼리:

거래 금액 데이터는 숫자 데이터형으로 제공되므로 변환이나 형변환 없이 정렬에 사용할 수 있습니다.

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

반환값:

OBJECTID	PROPERTY_DEALNAME	PROPERTY_DEALSTAGE	부동산 거래 금액
98392101	팝업 캐노피	폐쇄된 거래	9309007
321740651	테스트 거래 123	14845019	8383663
38960439	거래 이름 1	클로즈드원	34199

object_with_object_properties

이 데이터베이스 객체는 HubSpot 레코드 데이터를 포함합니다. 이 데이터베이스 객체에 대한 쿼리는 객체 유형(예: contacts 객체 유형의 모든 연락처 레코드) 내 각 레코드에 대해 한 행을 반환합니다. 모든 속성은 Properties 열에 저장되며, 이는 Snowflake Variant / JSON 열입니다.

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

열 이름	유형	설명
`OBJECTTYPEID`	Varchar	객체 유형의 ID(예: contacts는 `0-1`).
`OBJECTID`	Number	레코드의 ID(예: ID가 `123752인` 연락처 레코드).
`속성`	바리언트	레코드의 속성 값들.
`업데이트 날짜`	타임스탬프	HubSpot에서 레코드가 마지막으로 업데이트된 날짜 및 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.
`INGESTEDAT`	타임스탬프	데이터가 Snowflake에 마지막으로 수집된 날짜 및 시간입니다.

참고: 2022년 1월 25일부터 object_with_object_properties 테이블 및 뷰의 timestamp 열(HubSpot에서 객체 레코드가 마지막으로 업데이트된 날짜 및 시간을 나타냄)은 updatedat으로 변경됩니다. 이는 datetime 데이터가 ..

중대한 변경 사항이므로, 새 열 updatedat이 테이블과 뷰에 추가되었습니다. 향후 90일 동안 이 두 새 열은 대체 대상인 기존 timestamp 열과 병행 사용됩니다. 이를 통해 새 열 사용으로 전환할 수 있는 시간이 주어집니다.

90일 후인 2022년 1월 25일, 테이블과 뷰에서 timestamp 열이 제거됩니다. 이 날짜 이후에는 object_with_object_properties 테이블이나 뷰를 timestamp 열을 사용하여 쿼리하려는 모든 시도가 실패할 것입니다.

예제 1

모든 연락처와 해당 속성을 가져옵니다.

쿼리:

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

반환값:

OBJECTTYPEID	OBJECTID	속성
0-1	38960439	{"createdate": "1504656970152"...}
0-1	321740651	{ "생성일시": "1590183081949"...}
0-1	98392101	{ "생성일": "1533566477279"...}
...	...	...

예시 2

최대 세 건의 거래에 대한 거래명과 단계를가져옵니다.

쿼리:

SELECT
objectId,
properties:dealname::string AS dealname,
properties:dealstage::string AS 거래단계,
properties:amount::number AS 거래금액
FROM 객체_속성_포함_객체
WHERE objectTypeId = '0-3'
LIMIT 3;

반환값:

OBJECTID	거래명	거래 단계	거래금액
38960439	거래명 1	폐쇄 손실	7488939
321740651	거래 이름 1	종료승	9292029
98392101	거래 이름 1	폐쇄 패배	62626528

objects

이 데이터베이스 객체는 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`	Varchar	객체 유형의 ID(예: contacts는 `0-1`).
`OBJECTID`	Number	레코드의 ID(예: ID가 `123752인` 연락처 레코드).
`INGESTEDAT`	타임스탬프	Snowflake가 데이터를 마지막으로 수집한 날짜 및 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.

예시 1

모든 연락처 레코드를 검색합니다.

쿼리:

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

반환값:

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

object_properties

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

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

컬럼 이름	유형	설명
`객체 유형 ID`	Varchar	객체 유형의 ID(예: contacts는 `0-1`).
`OBJECTID`	Number	레코드의 ID(예: ID가 `123752인` 연락처 레코드).
`NAME`	Varchar	속성의 이름입니다.
`VALUE`	타임스탬프	속성의 값.
`업데이트 날짜`	타임스탬프	HubSpot에서 레코드가 마지막으로 업데이트된 날짜 및 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.
`INGESTEDAT`	타임스탬프	데이터가 Snowflake에 마지막으로 수집된 날짜 및 시간입니다.

예시 1

모든 연락처의 이름, 성, 도시 속성을 가져옵니다.

쿼리:

SELECT objectTypeId, objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND 이름 IN ('이름', '성', '도시')
ORDER BY objectId;

반환값:

OBJECTTYPEID	OBJECTID	NAME	값
0-1	10401	이름	Brian
0-1	10401	도시	더블린
0-1	10401	성	Gallagher
0-1	23451	이름	페르난도
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	OBJECTID	이름	성	생애주기 단계
0-1	54325098	Hobbes	Baron	리드
0-1	96805401	마일로스	골드	리드
0-1	6922028	헨리	라일리	리드
...	...	...	...	...

object_properties_history

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

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

컬럼 이름	유형	설명
`OBJECTTYPEID`	Varchar	객체 유형의 ID(예: contacts는 `0-1`).
`OBJECTID`	Number	레코드의 ID(예: ID가 `123752인` 연락처 레코드).
`NAME`	Varchar	속성의 이름입니다.
`VALUE`	타임스탬프	속성의 값.
`업데이트 날짜`	타임스탬프	HubSpot에서 데이터가 마지막으로 업데이트된 날짜와 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.
`INGESTEDAT`	타임스탬프	Snowflake에서 데이터를 마지막으로 수집한 날짜 및 시간입니다.

예시 1

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

쿼리:

SELECT objectId, name, value, updatedAt
FROM object_properties_history
WHERE objectTypeId = '0-1'
AND objectId = 136493192
AND name = 'hs_predictivescoringtier'
ORDER BY 업데이트된 날짜 DESC;

반환값:

OBJECTID	NAME	VALUE	업데이트 날짜
136493192	hs_예측점수계층	tier_1	2022-06-22 22:45:05.931
136493192	hs_predictivescoringtier	tier_2	2021-09-18 08:20:56.622
136493192	hs_예측점수계층	tier_3	2019-11-31 18:20:22.851
...	...	...	...

예시 2

구독자( Subscriber) 라이프사이클 단계를 가진 적이 있는 모든 연락처의 현재 이름을 조회합니다.

쿼리:

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 객체 속성 기록
WHEREobject_properties_history.objectTypeId = '0-1'
AND object_properties_history.name = 'lifecyclestage'
AND object_properties_history.value = 'subscriber'
);

반환값:

OBJECTID	이름	성
54325098	Hobbes	Baron
96805401	Milo	골드
6922028	헨리	라일리
...	...	...

연관 쿼리

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

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

associations_x_to_y 뷰

각 연관 유형은 associations_<연관 유형 이름>으로 명명된 고유한 뷰를 가집니다(예: associations_contacts_to_deals). 각 뷰는 associations 데이터베이스 객체의 데이터 하위 집합이며 특정 combinedassociationtypeid의 레코드만 포함합니다.

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

컬럼 이름	유형	설명
COMBINEDASSOCIATIONTYPEID	Varchar	연관 정의의 고유 식별자.
ASSOCIATIONCATEGORY	Varchar	연관 유형의 소스입니다. 다음 중 하나입니다: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ASSOCIATIONTYPEID	Varchar	특정 연관 범주 내의 연관 정의에 대한 고유 식별자입니다. 즉, 연관 범주 내의 두 정의는 동일한 associationtypeid를 가질 수 없습니다.
FROMOBJECTTYPEID	Varchar	연관 정의의 소스가 되는 객체 유형 ID입니다.
FROMOBJECTTYPE	Varchar	연관 정의의 소스인 객체 유형의 이름입니다.
TOOBJECTTYPEID	Varchar	연관 정의의 대상이 되는 객체 유형 ID입니다.
TOOBJECTTYPE	Varchar	연관 정의의 대상이 되는 객체 유형의 이름입니다.
NAME	Varchar	연관 정의의 이름입니다.
LABEL	Varchar	연관 정의에 대한 설명.
ISMAINASSOCIATIONDEFINITION	부울	연관 정의가 주요 유형인지 여부. true인 경우, 해당 정의는 HubSpot이 연관된 레코드에 표시하는 정의입니다.
[FROMOBJECTTYPE_OBJECTID] 예: ASSOCIATIONS_CONTACTS_TO_DEALS 뷰의 경우 CONTACT_OBJECTID가 됩니다.	Number	소스 개체의 개체 ID입니다.
[TOOBJECTTYPE_OBJECTID] 예: ASSOCIATIONS_CONTACTS_TO_DEALS 뷰의 경우 DEAL_OBJECTID가 됩니다.	숫자	대상 개체의 개체 ID입니다.
INGESTEDAT	타임스탬프	Snowflake가 데이터를 마지막으로 수집한 날짜와 시간입니다.

예시 1

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

쿼리:

SELECT
contact_objectId, deal_objectId

FROM associations_contacts_to_deals

WHERE contactId = 6626541373

반환값:

CONTACT_OBJECTID	DEAL_OBJECTID
6626541373	233620335
6626541373	90253678

예시 2

보고타 시간대를 기준으로 하는 모든 연락처와 해당 거래 내역을 조회합니다.

SELECT contacts.property_firstname contact_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/bogota'

CONTACT_FIRSTNAME	CONTACT_LASTNAME	연락처 이메일	거래 유형	거래 금액
David	Magalhães	dmagalhaes@example.com	newbusiness	74848
페르난다	Rodrigues	fmoreira@example.com	newbusiness	253530

예시 3

모든 연락처와 각 연락처별 거래 완료 금액의 총합을 조회합니다.

SELECT SUM(거래.부동산_시간대_마감_금액) AS
총_체결_금액, 연락처.부동산_이메일 연락처_이메일
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
총 체결 금액 내림차순으로 정렬

반환값:

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

association_definitions

이 데이터베이스 객체는 HubSpot 객체 간에 사용 가능한 모든 연관 유형에 대한 정보를 포함하며, 연관 유형별로 한 행씩 구성됩니다. 이 데이터베이스 객체를 associations 데이터베이스 객체와 조인하여 레코드별 연관 정보를 얻을 수 있습니다.

동일한 개체 간에는 여러 유형의 연관성이 존재할 수 있습니다. 레코드가 연관될 때 HubSpot에 표시되는 주요 연관 유형은 ISMAINASSOCIATIONDEFINITION이 true인 연관성을 사용합니다.

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

컬럼 이름	유형	설명
`COMBINEDASSOCIATIONTYPEID`	Varchar	연관 정의의 고유 식별자.
`CATEGORY`	Varchar	연관 유형의 소스입니다. 다음 중 하나입니다: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Number	카테고리 내의 연관 정의 식별자.
`FROMOBJECTTYPEID`	Varchar	연관 정의의 소스인 개체의 ID입니다.
`TOOBJECTTYPEID`	Varchar	연관 정의의 대상이 되는 개체의 ID입니다.
`NAME`	Varchar	연관 정의의 이름입니다.
`LABEL`	Varchar	연관 정의의 레이블.
`ISMAINASSOCIATIONDEFINITION`	부울	연관 정의가 주 유형인지 여부. true인 경우, 해당 정의는 HubSpot이 연관된 레코드에 표시하는 정의입니다.
`INGESTEDAT`	타임스탬프	Snowflake가 데이터를 마지막으로 가져온 날짜와 시간. 열 데이터 유형에 대해 자세히 알아보세요.

예시 1

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

쿼리:

SELECT 결합된협회유형ID, 출처객체유형ID, 대상객체유형ID, 이름
FROM association_definitions
ORDER BY category, id

반환값:

COMBINEDASSOCIATIONTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAME
0-1	0-1	0-2	회사 연락처
0-2	0-2	0-1	연락처 회사
0-3	0-3	0-1	연락처 거래
0-4	0-1	0-3	거래에 대한 연락처
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

반환값:

결합된 연관 유형	FROMOBJECTTYPEID	대상 유형 ID	이름
0-5	0-3	0-2	회사별 거래
0-271	0-3	0-2	DEAL_TO_PRIMARY_COMPANY
0-341	0-3	0-2	DEAL_TO_COMAPNY_UNLABELED

associations

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

이 데이터베이스 객체는 계정에 대량의 데이터가 있어 associations_x_to_y 뷰의 성능이 저하될 때 유용할 수 있습니다.

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

열 이름	유형	설명
`COMBINEDASSOCIATIONTYPEID`	Varchar	연관 정의의 고유 식별자.
`FROMOBJECTID`	Number	소스 개체의 ID입니다.
`TOOBJECTID`	Number	대상 객체의 ID입니다.
`INGESTEDAT`	타임스탬프	Snowflake가 데이터를 마지막으로 가져온 날짜 및 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.

예시 1

모든 연관된 거래 및 연락처 조회.

쿼리:

SELECT 결합 연관 유형 ID, 출처 객체 ID, 대상 객체 ID
FROM associations
WHERE 결합 연관 유형 ID = '0-5'

반환값:

COMBINEDASSOCIATIONTYPEID	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335
0-5	6616436082	3866015468
0-5	6690805943	7132752747
...	...	...

예시 2

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

쿼리:

SELECT 결합 연관 유형 ID, 출처 객체 ID, 대상 객체 ID
FROM associations
WHERE associationCategory = 'HUBSPOT_DEFINED'
AND combinedAssociationTypeId = '0-15'
AND fromObjectId = 3005;

반환값:

COMBINEDASSOCIATIONTYPE	FROMOBJECTID	대상ID
0-5	6626541373	233620335

예시 3

특정 연락처(연락처 ID: 4464)와 연결된 모든 거래를 검색합니다. combinedAssociationTypeId를 하드코딩하는 대신, 이 예제는 association_definitions 테이블과 조인합니다.

쿼리:

SELECT 결합연관유형ID, 출처객체ID, 대상객체ID,
FROM associations
WHERE
combinedAssociationTypeId = (
SELECT 결합연관유형ID
FROM association_definitions
WHERE fromObjectTypeId = '0-1'
AND 대상 객체 유형 ID = '0-3'
AND isMainAssociationDefinition)
AND fromObjectId = 4464;

반환값:

결합 연관 유형 ID	FROMOBJECTID	대상ID
0-5	6626541373	233620335

소유자 쿼리

소유자

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

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

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

예시 1

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

쿼리:

SELECT 소유자ID, 사용자ID, 이메일, 이름, 성 FROM 소유자 WHERE archived = false

반환값:

OWNERID	USERID	이메일	이름	성
29584574	4621126	233620335	Hobbes	Baron
30532717	4874784	3866015468	파블로	월터스
30580321	925511	7132752747	Milo	골드
...	...	...	...	...

예시 2

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

쿼리:

SELECT 소유자ID, 사용자ID, 이메일, 이름, 성
FROM 소유자
WHERE ownerId = 29584574;

반환값:

OWNERID	사용자 ID	이메일	이름	성
29584574	4621126	233620335	Hobbes	Baron

예시 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.email owner_email FROM objects_contacts contact

JOIN 소유자 소유자 ON 연락처.허브스팟_소유자_ID = 소유자.소유자ID

반환값:

연락처 ID	CONTACT_FIRSTNAME	CONTACT_LASTNAME	CONTACT_HUBSPOT_OWNER_ID	소유자 이름	소유자 성	OWNER_EMAIL
113834202	Richard	그린필드	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	칼	30241125	Milo	골드	milo.g@business.com
...	...	...	...	...	...	...

팀 쿼리

팀

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

이 데이터베이스 객체는 HubSpot 계정의 팀에 대한 정보를 포함합니다.

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

컬럼 이름	유형	설명
TEAMID	숫자	팀 ID.
TEAMNAME	Varchar	팀 이름.
PARENTTEAMID	숫자	상위 팀의 팀 ID.
CHILDTEAMIDS	배열	자식 팀의 팀 ID입니다.
PRIMARYOWNERMEMBERS	Varchar	팀의 주 멤버들의 소유자 ID들.
SECONDARYOWNERMEMBERS	Boolean	팀 보조 구성원의 소유자 ID입니다.
INGESTEDAT	타임스탬프	Snowflake가 데이터를 마지막으로 수집한 날짜 및 시간.

예시 1

모든 팀을 검색합니다.

쿼리:

SELECT 팀ID, 팀명, 주요소유자구성원

FROM teams

반환값:

팀ID	팀명	PRIMARYOWNERMEMBERS
29584574	하위 팀	[233620335, 1234553]
30532717	슈퍼 팀	[3866015468, 126221873]
3058032	A 팀	[7132752747]

owner_team

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

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

컬럼 이름	유형	설명
TEAMID	숫자	팀 ID.
OWNERID	번호	사용자의 소유자 ID.
ISTEAMPRIMARY	부울	이 팀이 해당 소유자의 기본 팀인지 여부.
INGESTEDAT	타임스탬프	Snowflake가 데이터를 마지막으로 수집한 날짜 및 시간입니다.

예시 1

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

쿼리:

SELECT 팀ID, 소유자ID, 팀주요담당자 여부
FROM teams
WHERE 팀ID = 29584574

반환값

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	TRUE
29584574	1234553	TRUE

파이프라인 쿼리

아래에서 거래 및 티켓 파이프라인 데이터를 쿼리하는 방법을 알아보세요. 예를 들어, 계정에서 사용 가능한 파이프라인과 그 단계들을 확인할 수 있습니다.

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

pipelines

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

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

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

예시 1

HubSpot 내 순서대로 정렬된 사용 가능한 모든 거래 파이프라인을 검색합니다.

쿼리:

SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = '0-3'AND not archived
순서 지정: 표시 순서;

반환 결과:

OBJECTTYPEID	PIPELINEID	라벨
0-3	1bed503c-37f7-4f51-9d40-7598902673f4	영업 파이프라인
0-3	12659678	라이선스 파이프라인
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	신규 사업
...	...	...

예시 2

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

쿼리:

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 거래.부동산파이프라인 = 파이프라인.파이프라인ID WHERE pipelines.objectTypeId = '0-3';

반환값:

거래 ID	거래명	PIPELINE_NAME
605140072	Meowmix 글로벌 가입	영업 파이프라인
605457408	프리스키즈 리브랜딩	영업 파이프라인
604362473	Fresh Step 앱 구축	영업 파이프라인

예제 3

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

SELECT deals.objectId deal_id, 거래.속성:거래명::varchar 거래명, 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	PIPELINE_NAME
605140072	Meowmix 글로벌 가입	영업 파이프라인
605457408	프리스키 리브랜딩	영업 파이프라인
604362473	Fresh Step 앱 구축	영업 파이프라인

pipeline_stages

이 뷰는 파이프라인 내 개별 단계에 대한 정보를 포함합니다. 객체 유형 ID, 파이프라인 ID 및 단계 ID를 조합하여 단계를 식별합니다. 파이프라인과 조인할 때는 객체 유형 ID와 파이프라인 ID를 사용하십시오.

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

컬럼 이름	유형	설명
`PIPELINEID`	Varchar	파이프라인의 ID입니다.
`STAGEID`	Varchar	스테이지의 ID.
`LABEL`	Varchar	HubSpot에서 스테이지의 이름입니다.
`DISPLAYORDER`	숫자	HubSpot에서 파이프라인이 표시되는 순서입니다.
`메타데이터`	변형	스테이지가 열려 있는지 닫혀 있는지 여부를 포함한 스테이지에 대한 JSON 형식의 설명
`보관됨`	부울	파이프라인 스테이지가 삭제되었는지 여부.
`CREATEDAT`	타임스탬프	파이프라인 단계가 생성된 시점.

예시 1

Sales pipeline이라는 거래 파이프라인의 파이프라인 단계를 검색합니다.

쿼리:

SELECT pipelineid, stageId, label
FROM pipeline_stages
WHERE not archived
AND pipelineid = (
SELECT pipelineid
FROM pipelines
WHERE objectTypeId = '0-3'
AND 보관되지 않음
AND 라벨 = '영업 파이프라인' LIMIT 1)
디스플레이순서로 정렬;

반환값:

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

반환값:

거래 ID	거래명	PIPELINE_NAME	파이프라인 단계 이름
605140072	Meowmix 글로벌 가입	영업 파이프라인	계약서 발송
605457408	프리스키 리브랜딩	영업 파이프라인	약속 예약됨
604362473	Fresh Step 앱 구축	영업 파이프라인	계약 체결
...	...	...	...

속성 쿼리

property_definitions

이 데이터베이스 객체는 HubSpot 계정의 객체 속성 및 이벤트 속성에 대한 정보를 포함합니다. 이벤트 속성에는 이메일 열람 및 클릭과 같은 표준 이벤트와 사용자 정의 행동 이벤트 속성이 포함됩니다. 이 정보는 object_properties 및 events 데이터에서 발견되는 값을 정의하는 데 유용할 수 있습니다.

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

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

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

예시 1

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

쿼리:

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

반환값:

NAME	라벨	설명
입력된_SQL_단계	SQL 단계 진입	SQL 단계 일수 카운트 시작.
첫 전환 이벤트 이름	첫 전환	이 연락처가 제출한 첫 번째 양식입니다.
주소	도로 주소	연락처의 주소.

이벤트 쿼리

이벤트에는 표준 HubSpot 이벤트와 사용자 정의 행동 이벤트가 포함됩니다. 각 이벤트는 events_eventname으로 명명된 고유한 데이터베이스 객체를 가집니다.

이름
EVENTS_AD_INTERACTION	광고 및 광고를 클릭하거나 광고와 상호 작용한 후 양식을 제출하여 광고와 상호 작용한 연락처에 대한 세부 정보.
EVENTS_AD_METRICS_IMPORTED_V0	광고 및 해당 광고의 성과 지표에 대한 세부 정보.
EVENTS_CALL_MENTIONED_KEYWORD	통화 참가자가 언급한 키워드에 대한 세부 정보.
이메일 내 클릭된 링크 V2	마케팅 이메일에서 연락처가 클릭한 링크.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	연락처가 대화함 이메일에서 클릭한 링크.
EVENTS_COOKIE_BANNER_CLICKED	쿠키 배너를 클릭한 연락처.
EVENTS_COOKIE_BANNER_VIEWED	쿠키를 본 연락처.
EVENTS_DOCUMENT_SHARED_V2	외부 링크를 통해 연락처와 공유된 영업 문서.
EVENTS_DOCUMENT_VIEWED_V2	외부 링크를 열어 본 영업 문서 및 이를 확인한 연락처.
EVENTS_DOCUMENT_COMPLETED_V2	판매 문서를 완료한 연락처.
이벤트_HS_예약된_이메일_V2	HubSpot 이메일 서버로 전송을 위해 제출된 이메일.
이벤트_MTA_전달된_이메일_V2	HubSpot 이메일 서버를 통해 수신자에게 성공적으로 전달된 이메일.
이벤트_MTA_반송된_이메일_V2	수신자의 이메일 서버에서 거부된 이메일 전달 시도.
EVENTS_OPENED_EMAIL_V2	연락처가 이메일을 열람한 횟수.
EVENTS_REPORTED_SPAM_EMAIL_V2	수신자가 스팸으로 표시한 이메일.
이벤트 업데이트 이메일 구독 상태 V2	수신자에 의한 이메일 구독 변경 사항.
이벤트_열람_추적된_받은편지함_이메일_V8	연락처별 대화함 이메일 열람.
EVENTS_MB_MEDIA_PLAYED	연락처별 동영상 재생 활동.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	연락처가 시퀀스를 통해 회의를 예약했습니다.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	연락처가 시퀀스에서 등록했습니다.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	시퀀스가 완료되었습니다.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	시퀀스를 통해 발송된 이메일에 연락처가 답장했습니다(또는 시퀀스에서 탈퇴한 수신 이메일).
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	시퀀스에서 연락처가 탈퇴되었습니다.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	사용자가 수동으로 연락처의 시퀀스 구독을 취소했습니다.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	연락처가 시퀀스 구독을 취소했습니다.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	시퀀스 이메일이 반송되었습니다.
EVENTS_V2_SEQUENCE_ERRORED	시퀀스 오류 발생으로 구독 취소됨.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	시퀀스 단계가 실행되었습니다.
EVENTS_VISITED_PAGE	연락처의 웹사이트 페이지 방문.
EVENTS_<통합 이벤트 이름>_<고유 식별자>	통합 이벤트 (타임라인 V3 API)

이벤트 유형 ID와 ID를 조합하여 이벤트를 식별할 수 있습니다. 반환되는 열은 이벤트마다 다르며, 각 이벤트 속성마다 하나의 열이 할당됩니다. 모든 이벤트는 다음 열을 반환합니다:

참고: HubSpot은 모든 이벤트 테이블 및 뷰에 두 개의 새 열을 추가했습니다:

발생일
발생일자int

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

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

예시 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 발생시간LIMIT 50;

반환 결과:

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

예시 2

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

쿼리:

SELECT click.발생일 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 클릭 LEFT JOIN object_with_object_properties contact ON 클릭.객체유형ID = 연락처.객체유형ID AND 클릭.객체ID = 연락처.객체ID LIMIT 3;

반환값:

CLICK_TIMESTAMP	클릭 URL	CONTACT_FIRSTNAME	CONTACT_LASTNAME
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	골드
2018-11-08 09:37:41.426	https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Harlow	빌라리
...	...	...	...

Object_and_event_type_queries

object_and_event_type_definitions

이 데이터베이스 객체는 HubSpot 계정에서 사용 가능한 모든 객체 및 이벤트에 대한 정의를 포함합니다.

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

컬럼 이름	유형	설명
`OBJECTTYPEID`	Varchar	파이프라인이 포함할 수 있는 개체(예: 거래 또는 티켓)의 ID입니다.
`FULLYQUALIFIEDNAME`	Varchar	개체 또는 이벤트의 이름입니다.
`INGESTEDAT`	타임스탬프	Snowflake가 데이터를 마지막으로 수집한 날짜 및 시간입니다. 컬럼 데이터 유형에 대해 자세히 알아보세요.

예시 1

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

쿼리:

SELECT objectTypeId, fullyQualifiedName
FROM 객체_및_이벤트_유형_정의;

반환 내용:

OBJECTTYPEID	FULLYQUALIFIEDNAME
0-1	CONTACT
0-8	라인 항목
0-11	대화
...	...

세그먼트 쿼리

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

세그먼트

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

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

열 이름	유형	설명
`OBJECTTYPEID`	Varchar	세그먼트 내 레코드의 유형(예: 연락처 또는 회사).
`SEGMENTID`	Number	세그먼트의 ID입니다. 세그먼트 멤버십 테이블의SEGMENTID 열과 조인됩니다.
`CLASSICSEGMENTID`	숫자	HubSpot에서 세그먼트의 URL에 있는 ID와 일치하는 연락처 세그먼트 전용 ID입니다.
`NAME`	Varchar	세그먼트의 이름입니다.
`크기`	Number	세그먼트 내 레코드 수.
`CREATEDBYUSERID`	숫자	세그먼트를 생성한 사용자의 ID입니다.
`CREATEDAT`	타임스탬프	HubSpot에서 세그먼트가 생성된 날짜.
`업데이트한 사용자 ID`	숫자	세그먼트를 가장 최근에 업데이트한 사용자의 ID입니다.
`업데이트 날짜`	타임스탬프	HubSpot에서 해당 데이터가 마지막으로 업데이트된 날짜 및 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.
`INGESTEDAT`	타임스탬프	Snowflake에서 데이터를 마지막으로 수집한 날짜 및 시간입니다.

예시 1

모든 연락처 세그먼트를 검색합니다.

쿼리:

SELECT 세그먼트ID, 이름, 크기
FROM segments
WHERE objectTypeId = '0-1';

반환 결과:

SEGMENTSID	NAME	크기
118131	주간 아웃리치	103
66156	블로그 구독자	455
771852	2021년 최고 구독자	37
...	...	...

예시 2

'Top subscribers 2021'이라는 특정 연락처 세그먼트를 검색합니다.

쿼리:

SELECT segmentId, name, size
FROM segments
WHERE objectTypeId = '0-1' ANDsegmentName = '2021년 최다 구독자';

반환값:

SEGMENTID	NAME	크기
771852	2021년 최다 구독자	37

segment_membership

이 데이터베이스 객체는 어떤 레코드가 어떤 세그먼트의 구성원인지에 대한 정보를 포함하며, 세그먼트 내 레코드당 한 행으로 구성됩니다. 예를 들어, 500명의 연락처가 있는 '블로그 구독자' 세그먼트가 있다면, 데이터베이스 객체는 500개의 행을 반환합니다.

세그먼트 ID와 객체 ID만 포함합니다. 자세한 내용은 segments 데이터베이스 객체와 조인하세요.

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

컬럼 이름	유형	설명
`SEGMENTID`	Varchar	세그먼트의 ID입니다. 세그먼트 테이블의 HS_SEGMENT_ID 열과 조인됩니다.
`OBJECTID`	Varchar	세그먼트 내 레코드의 ID입니다.
`업데이트 날짜`	타임스탬프	HubSpot에서 데이터가 마지막으로 업데이트된 날짜 및 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.
`INGESTEDAT`	타임스탬프	Snowflake에서 데이터를 마지막으로 수집한 날짜 및 시간입니다.

예시 1

2021년 최상위 구독자 세그먼트에 속한 모든 연락처의 ID를 조회합니다.

쿼리:

SELECT objectId
FROM segment_memberships
INNER JOIN segments
ON 세그먼트_멤버십.세그먼트Id = 세그먼트.세그먼트Id
WHERE segments.objectTypeId = '0-1'
AND segments.name = '2021년 최다 구독자';

반환 결과:

OBJECTID

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 세그먼트_멤버십스 ON 연락처.객체ID = 세그먼트_멤버십스.객체ID INNER JOIN segments ON segments_memberships.segmentId = segments.segmentId WHERE segments.objectTypeId = '0-1' AND segments.name = '2021년 최상위 구독자'

반환값:

OBJECTID	이름	성
54325098	Hobbes	Baron
96805401	마일로스	골드
6922028	헨리	라일리
...	...	...

자주 묻는 질문

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

일반적으로 비교 대상 보고서에 포함된 열을 확인해야 합니다. 보고서가 표 형식이 아닌 경우, 표로 변환하면 보고서에 포함된 열을 확인할 수 있습니다. 이러한 열은 일반적으로 객체 유형 또는 이벤트 유형의 속성입니다. 다음 단계는 열이 해당하는 객체 유형 속성을 파악하는 것입니다. property_definitions를 쿼리하여 확인할 수 있습니다:

SELECT * FROM property_definitions

WHERE label = [column_name]

일부 속성명은 앱에서 더 설명적인 이름으로 변환되는 경우가 있어 항상 정확히 일치하지 않을 수 있습니다. 이 경우 property_definitions의 label(또는 description) 열에 LIKE 연산자를 사용한 퍼지 검색이 도움이 됩니다.

컬럼이 속한 객체 유형을 확인한 후에는 쿼리 대상을 결정하는 것은 간단합니다. 해당 유형에 대응하는 object_x 뷰를 검색하기만 하면 됩니다.

이 데이터 유형을 다른 유형에 연결하려면 어떻게 해야 하나요? 예를 들어 캠페인용 양식을 가져오는 방법은?

서로 다른 두 개 이상의 레코드를 연결해야 한다면 연관 관계(associations)를 살펴보세요. 연관 관계는 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 캠페인_이름

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

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

SELECT * FROM hubspot.public.data_share_status LIMIT 1

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

상태	메시지	업데이트 날짜
OK	현재 알려진 문제 없음	2023-04-10 09:21:20.123

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

이 문서가 도움이 되었나요?

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

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

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

데이터 지연 및 Snowflake 계정 지역

Snowflake 환경 설정

데이터 개요

반환되는 데이터 제한 및 정렬

컬럼 데이터 유형

데이터 유형 변환

객체 쿼리

objects_x 뷰

예시 1

예시 2

예제 3

object_with_object_properties

예제 1

예시 2

objects

예시 1

object_properties

예시 1

예시 2

object_properties_history

예시 1

예시 2

연관 쿼리

associations_x_to_y 뷰

예시 1

예시 2

예시 3

association_definitions

예시 1

예시 2

associations

예시 1

예시 2

예시 3

소유자 쿼리

소유자

예시 1

예시 2

예시 3

팀 쿼리

팀

예시 1

owner_team

예시 1

파이프라인 쿼리

pipelines

예시 1

예시 2

예제 3

pipeline_stages

예시 1

예시 2

속성 쿼리

property_definitions

예시 1

이벤트 쿼리

예시 1

예시 2

Object_and_event_type_queries

object_and_event_type_definitions

예시 1

세그먼트 쿼리

세그먼트

예시 1

예시 2

segment_membership

예시 1

예시 2

자주 묻는 질문

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

이 데이터 유형을 다른 유형에 연결하려면 어떻게 해야 하나요? 예를 들어 캠페인용 양식을 가져오는 방법은?

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

관련 콘텐츠

관련 콘텐츠