콘텐츠로 건너뛰기
HubSpot 기술 자료
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

Snowflake에서 HubSpot 데이터 쿼리하기

마지막 업데이트 날짜: 2026년 9월 24일

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

Snowflake를 HubSpot 계정에 연결한 후에는 Snowflake의 Data Share를 사용하여 Snowflake 계정에서 HubSpot 데이터를 조회할 수 있습니다.

데이터 지연 및 Snowflake 계정 리전

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

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

Snowflake 환경 설정

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

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

  1. 워크시트 상단 행에서‘워크시트 작업 모음’을 클릭합니다.

    snowflake-worksheet-settings0
  2. 팝업 창에서:
    • '웨어하우스' 드롭다운 메뉴를 클릭한 다음, 해당웨어하우스를 선택합니다.
    • '데이터베이스' 드롭다운 메뉴를 클릭한 다음, 사용하려는 HubSpot 데이터베이스를 선택합니다.
    • '스키마' 드롭다운 메뉴를 클릭한 다음, 사용하려는 스키마를 선택합니다.
        • V2_DAILY: 테이블을 기반으로 데이터를 쿼리하는 일일스키마입니다 . 이 스키마의 데이터는 하루에 한 번 업데이트됩니다. 이 스키마를 사용하면 쿼리 속도가 빨라지므로 Snowflake에서 직접 쿼리를 실행할 때 권장됩니다.
        • V2_LIVE: HubSpot 데이터의 보안 뷰(Secure Views )를 기반으로 하는 실시간 스키마입니다. 이 스키마의 데이터는 최대 15분마다 업데이트됩니다. 대량의 데이터를 쿼리하는 경우 쿼리 속도가 느려질 수 있습니다. 이 경우, 먼저 ETL 프로세스를 통해 데이터를 자체 테이블로 복사한 후 해당 테이블을 쿼리하는 것이 권장됩니다.


      snowflake-worksheet-settings-window0

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

쿼리에 데이터베이스 및 스키마 유형을 수동으로 추가하려면 FROM 필드 시작 부분에 데이터베이스 이름을 입력한 후 스키마를 추가하십시오. 예:

 

SELECT objectTypeId, objectId, updatedAt

FROM hubspot_share_name.V2_LIVE.objects

WHERE objectTypeId = '0-3'

LIMIT 1;

데이터 개요

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

  • 개체: 연락처, 회사, 제품 등과 같은 표준 및 사용자 정의 개체. 
  • 레코드: 개별 연락처나 회사와 같은 개별 레코드. 
  • 연관 관계: 사용 가능한 모든 연관 관계 유형 및 현재 연관된 레코드.
  • 이벤트: 이메일 열람과 같은 표준 HubSpot 이벤트와 사용자 정의 행동 이벤트에 대한 이벤트 데이터.
  • 세그먼트: HubSpot 연락처 및 기업 세그먼트.
  • 소유자: HubSpot 계정 내 사용자 중, 특정 레코드의 소유자로 지정된 사용자.
  • 파이프라인:파이프라인 단계를 포함한거래및 티켓 파이프라인.
  • 속성: 속성 이력을 포함하여 CRM 레코드의 속성 및 해당 값.

자세히 알아보기 HubSpot의 CRM 데이터 모델. 

참고: 데이터 공유 기능을 발전시켜 나가는 과정에서 변경 사항이 도입될 예정이며, 일부는 호환성 문제를 일으킬 수 있는 변경 사항일 수 있습니다. HubSpot 개발자 변경 로그를 구독할 것을 적극 권장합니다. 이러한 변경 사항은 업데이트 전에 항상 변경 로그에 게시됩니다.

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

쿼리를 작성할 때LIMIT 및 ORDER BY 포함하면 반환되는 데이터의 양과 반환 순서를 제어할 수 있습니다. 예를 들어, 모든 연락처와 해당 속성을 조회하되, 결과 3개만 반환하고 연락처 ID 순으로 정렬하려면 다음과 같이 쿼리를 작성할 수 있습니다:

 

SELECT objectTypeId, updatedAt, ingestedAt

FROM objects

WHERE objectTypeId = '0-1'

정렬 기준 객체 ID

LIMIT 10;

열 데이터 유형

Snowflake에서 데이터를 쿼리할 때 반환되는 열은 쿼리하는 데이터에 따라 달라집니다. Snowflake에서 특정 테이블이나 뷰에 대해 사용 가능한 열을 확인하려면 왼쪽 사이드바에서 해당 뷰를 선택하면 됩니다.

참고:이 문서의 나머지 부분에서는 테이블과 뷰 모두에 해당하는 맥락에서 ‘데이터베이스 객체’라는 용어를 사용합니다.

snowflake-sidebar-view-column-details0


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

 

SELECT objectTypeId, updatedAt, ingestedAt

FROM objects

WHERE objectTypeId = '0-1'

정렬 기준 객체 ID

LIMIT 10;

 

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

  • 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: 연관 정의(association definition)를 고유하게 식별하는 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 객체 및 레코드에서 데이터를 쿼리하는 방법과 반환되는 데이터에 대해 알아보세요. 

객체 데이터는 공유 데이터베이스 객체에서 확인할 수 있습니다. objectTypeId로 필터링하여 을 사용하여 특정 객체 유형을 검색할 수 있습니다. OBJECT_WITH_OBJECT_PROPERTIES 를 사용하여 각 레코드의 현재 속성이 필요한 경우를 처리하세요. 속성 값은 properties JSON 열에 저장됩니다. OBJECTS 를 사용하고, OBJECT_PROPERTIES 또는 OBJECT_PROPERTIES_HISTORY 는 속성별 데이터에 사용됩니다.


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

사용자 정의 객체에는 생성 시 ID가 할당되며,2-고유_ID 형식으로 식별됩니다. 예를 들어,2-12345와 같습니다. object_and_event_type_definitions에 대해 자세히 알아보세요.

자세한 내용은 아래의 object_with_object_properties, object_properties, objects 및 object_properties_history를 참조하십시오.

object_with_object_properties

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

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

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

참고: 2022년 1월 25일부터, object_with_object_properties 테이블 및 뷰에 있는 'timestamp' 열(HubSpot에서 객체 레코드가 마지막으로 업데이트된 날짜 및 시간을 나타냄)은 'updatedat'으로 변경됩니다. 이는 나머지 데이터 공유에서 datetime 데이터가 표현되는 방식과 일치시키기 위한 조치입니다.

이는 호환성을 깨는 변경 사항이므로, 테이블과 뷰에 새로운 열인 'updatedat'이 추가되었습니다. 향후 90일 동안 이 두 개의 새 열은 대체 대상인 'timestamp' 열과 병존하게 됩니다. 이를 통해 사용자는 새로운 열로 전환할 수 있는 기회를 갖게 됩니다.

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

예제 1

모든 연락처와 해당 속성을 조회합니다.

쿼리:


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


반환 결과:

OBJECTTYPEID OBJECTID PROPERTIES
0-1 38960439 {"createdate": "1504656970152"...}
0-1 321740651 { "createdate": "1590183081949"...} 
0-1 98392101 { "생성일": "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;


반환 결과:

OBJECTID 거래명 거래 단계 거래금액
38960439 거래명 1 마감됨/실패 7488939
321740651 거래명 1 성사됨 9292029
98392101 거래명 1 성사 실패 62626528

객체

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

이 데이터베이스 객체는 속성 값이 포함되지 않은 현재 객체 데이터를 포함합니다. 핵심 레코드 속성만 필요한 경우 이 객체를 사용하거나, 선택한 속성이 필요한 경우 OBJECT_PROPERTIES와 조인하여 사용하십시오. 이 데이터베이스 객체를 object_properties 데이터베이스 객체와 함께 사용하면, 반환될 속성을 제어하면서 object_with_object_properties의 데이터를 복제할 수 있습니다.

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

열 이름 유형 설명
OBJECTTYPEID Varchar 객체 유형의 ID(예: contacts는 0-1).
OBJECTID 숫자 레코드의 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 데이터베이스 객체의 하위 집합입니다. 각 행에는 주어진 레코드에 설정된 현재 속성 값이 포함됩니다. 예를 들어, 연락처의 경우 ‘이름(First name )’ 속성에 대한 행이 하나,‘성 (Last name )’ 속성에 대한 행이 하나씩 존재합니다. 레코드에 특정 속성의 값이 없는 경우, 해당 행은 빈 문자열로 표시되거나 아예 표시되지 않습니다.

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

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

예제 1

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

쿼리:


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


반환 결과:

OBJECTTYPEID OBJECTID NAME VALUE
0-1 10401 firstname Brian
0-1 10401 도시 더블린
0-1 10401 성 갤러거
0-1 23451 이름 페르난도
0-1 23451 성 피에로
0-1 25751 이름 찰스
... ... ... ...

예 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);

 

반환 결과:

OBJECTTYPEID OBJECTID 이름 성 라이프사이클 단계
0-1 54325098 홉스 바론 리드
0-1 96805401 마일로 골드 리드
0-1 6922028 헨리 라일리 선두
... ... ... ... ...

object_properties_history

이 데이터베이스 객체에는 속성 값의 이력이 포함됩니다. 연락처의 경우 가장 최근 45개의 값이 포함되며, 그 외 모든 객체의 경우 가장 최근 20개의 값이 포함됩니다. 각 속성 이력 값에 대해 한 행씩 표시합니다. 속성의 현재 값은 해당 속성 이력에서 가장 최근의 UPDATEDAT타임스탬프에 의해 결정됩니다.

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

열 이름 유형 설명
OBJECTTYPEID Varchar 객체 유형의 ID(예: 연락처는 0-1).
OBJECTID 숫자 레코드의 ID(예: ID가 123752 연락처 레코드).
NAME Varchar 속성의 이름입니다.
VALUE 타임스탬프 속성의 값.
UPDATEDAT 타임스탬프 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 UPDATEDAT DESC;

 
반환 결과:

OBJECTID NAME VALUE 업데이트 날짜

136493192

hs_predictive_scoring_tier

tier_1

2022-06-22 22:45:05.931

136493192

hs_예측점수등급

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 object_properties_history
WHEREobject_properties_history.objectTypeId = '0-1'
AND object_properties_history.name = 'lifecyclestage'
AND object_properties_history.value = 'subscriber'
);


반환 결과:

OBJECTID 이름 성
54325098 홉스 바론
96805401 마일로 골드
6922028 헨리 라일리
... ... ...

연관 쿼리

연관 데이터는 ASSOCIATIONS 테이블에서 확인할 수 있습니다. combinedAssociationTypeId 필터링하여 특정 연관 유형을 조회할 수 있습니다. ASSOCIATIONS ASSOCIATION_DEFINITIONS 테이블과 조인하여 관련 객체 유형 및 연관 정의를 식별할 수 있습니다.

association_definitions

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

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

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

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

예제 1 

계정에서 사용 가능한 연관 유형을 가져옵니다.

쿼리:


SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
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 DEAL_TO_CONTACT
0-4 0-1 0-3 계약으로 전환된 문의
0-5 0-3 0-2 DEAL_TO_COMPANY
... ... ... ...

예제 2

거래와 기업 간에 사용 가능한 연관 유형을 가져옵니다.

쿼리:


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


반환 결과:

통합협회유형 FROMOBJECTTYPEID TOOBJECTTYPEID 이름
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

associations

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

이 데이터베이스 객체에는 모든 연관 유형에 대한 연관 레코드가 포함되어 있습니다. 연관 메타데이터가 필요한 경우 combinedAssociationTypeId 필터링하고 ASSOCIATION_DEFINITIONS 조인하십시오.

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

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

예제 1

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

쿼리:


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

 
반환 결과: 

COMBINEDASSOCIATIONTYPEID 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)와 관련된 모든 거래를 조회합니다. 이 예제에서는 combinedAssociationTypeId를 하드코딩하는 대신 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 Varchar 사용자의 이메일 주소입니다.
FIRSTNAME Varchar 사용자의 이름.
LASTNAME Varchar 사용자의 성.
ARCHIVED Boolean 사용자가 삭제되었는지 여부.
CREATEDAT 타임스탬프 HubSpot에서 사용자가 생성된 날짜 및 시간. 자세한 내용은 열 데이터 유형을 참조하십시오.
UPDATEDAT 타임스탬프 HubSpot에서 사용자가 마지막으로 업데이트된 날짜 및 시간입니다. 자세한 내용은 열 데이터 유형을 참조하십시오.
INGESTEDAT 타임스탬프 Snowflake가 데이터를 마지막으로 수집한 날짜 및 시간입니다.

예 1 

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

쿼리:


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

 
반환 결과: 

OWNERID USERID 이메일 이름 성
29584574 4621126 233620335 홉스 바론
30532717 4874784 3866015468 파블로 월터스
30580321 925511 7132752747 마일로 골드
... ... ... ... ...

예제 2

소유자 ID를 기준으로 특정 소유자를 조회합니다.

쿼리:


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


반환 결과: 

OWNERID 사용자 ID 이메일 이름 성
29584574 4621126 233620335 홉스 바론

예제 3

모든 연락처와 해당 소유자를 가져옵니다. 이 쿼리는 object_with_object_properties 및 연락처 속성 hubspot_owner_id를 사용하여 레코드를 소유자와 조인합니다.

 

SELECT

contact.objectId AS contact_id,

contact.properties:firstname::string AS contact_firstname,

contact.properties:lastname::string AS contact_lastname,

contact.properties:hubspot_owner_id::number AS contact_hubspot_owner_id,

owner.firstname AS owner_firstname,

owner.lastname AS owner_lastname,

owner.email AS owner_email

FROM object_with_object_properties AS contact

JOIN 소유자 AS 소유자

ON contact.properties:hubspot_owner_id::number = owner.ownerId

WHERE contact.objectTypeId = '0-1';

 


반환 결과: 

연락처 ID 연락처_이름 연락처_성 연락처_허브스팟_소유자_ID OWNER_FIRSTNAME OWNER_LASTNAME OWNER_EMAIL
113834202 Richard 그린필드 29584574 홉스 바론 hobbes.b@business.com
53540801 포드 칼 30241125 마일로 골드 milo.g@business.com
... ... ... ... ... ... ...

팀 쿼리

팀

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

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

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

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

예 1

모든 팀을 조회합니다.

쿼리:

SELECT teamId,teamName, primaryOwnerMembers

FROM teams

반환 결과:

TEAMID 팀명 주요 소유자 및 구성원
29584574 서브 팀 [233620335, 1234553]
30532717 슈퍼 팀 [3866015468, 126221873]
3058032 A팀 [7132752747]

owner_team

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

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

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

예시 1

지정된 팀의 모든 소유자를 가져옵니다.

쿼리:

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

반환 결과

TEAMID TEAMNAME ISTEAMPRIMARY
29584574 233620335 TRUE
29584574 1234553 TRUE 

파이프라인 쿼리

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

이 데이터를 객체 데이터와 조인하여 파이프라인에 대한 전체적인 현황을 파악할 수 있습니다. 예를 들어, ` object_with_object_properties pipelines`와 조인하여 거래 및 해당 파이프라인을 조회할 수 있습니다. 

pipelines

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

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

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

예 1

HubSpot 내 순서대로 정렬된 사용 가능한 모든 딜 파이프라인을 가져옵니다.

쿼리:


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

 
반환 결과: 

OBJECTTYPEID PIPELINEID LABEL
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.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

PIPELINE_NAME

605140072

Meowmix 글로벌 가입

영업 파이프라인

605457408

프리스키즈 리브랜딩

영업 파이프라인

604362473

프레시 스텝 앱 개발

영업 파이프라인

pipeline_stages

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

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

열 이름 유형 설명
PIPELINEID Varchar 파이프라인의 ID입니다.
STAGEID Varchar 스테이지의 ID입니다.
LABEL Varchar HubSpot에서 해당 스테이지의 이름.
DISPLAYORDER 번호 HubSpot에서 파이프라인이 표시되는 순서.
METADATA 변형 스테이지가 열려 있는지 또는 닫혀 있는지 여부를 포함하여 JSON 형식으로 된 스테이지 설명
ARCHIVED 부울 파이프라인 스테이지가 삭제되었는지 여부.
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 not archived
AND label = 'Sales Pipeline' LIMIT 1)
ORDER BY displayorder;

 
반환 결과: 

PIPELINEID STAGEID LABEL
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 프레시 스텝 앱 개발 영업 파이프라인 계약 체결
... ... ... ...

속성 쿼리

property_definitions

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

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

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

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

예 1

모든 연락처 속성의 이름과 설명을 가져옵니다.

쿼리:


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

 
반환 결과:

NAME LABEL 설명
entered_sql_stage SQL 단계로 입력됨 SQL 단계 일수 카운트 시작.
첫 전환 이벤트 이름
첫 번째 전환 이 연락처가 제출한 첫 번째 양식.
주소 주소 연락처의 주소.

이벤트 쿼리

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

이름  
EVENTS_AD_INTERACTION 광고에 대한 세부 정보 및 광고를 클릭하거나 광고와 상호작용한 후 양식을 제출하여 해당 광고와 상호작용한 연락처 정보.
EVENTS_AD_METRICS_IMPORTED_V0

 광고에 대한 세부 정보 및 해당 광고의 성과 지표.
EVENTS_CALL_MENTIONED_KEYWORD 통화 참가자가 언급한 키워드에 대한 세부 정보.
EVENTS_CLICKED_LINK_IN_EMAIL_V2

 연락처가 마케팅 이메일에서 클릭한 링크.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8 연락처가 'Conversations' 수신함 이메일에서 클릭한 링크.
EVENTS_COOKIE_BANNER_CLICKED 쿠키를 클릭한 연락처.
EVENTS_COOKIE_BANNER_VIEWED 쿠키를 확인한 연락처.
EVENTS_DOCUMENT_SHARED_V2 외부 링크를 통해 연락처와 공유된 영업 문서.
EVENTS_DOCUMENT_VIEWED_V2 외부 링크를 열어 해당 영업 문서를 확인한 영업 문서와 연락처.
EVENTS_DOCUMENT_COMPLETED_V2 마감된 영업 문서와 해당 문서를 마감한 연락처.
EVENTS_HS_SCHEDULED_EMAIL_V2 발송을 위해 HubSpot 이메일 서버로 전송된 이메일.
EVENTS_MTA_DELIVERED_EMAIL_V2 HubSpot 이메일 서버를 통해 수신자에게 성공적으로 전달된 이메일.
EVENTS_MTA_BOUNCED_EMAIL_V2 수신자의 이메일 서버에 의해 거부된 이메일 전송 시도.
EVENTS_OPENED_EMAIL_V2 연락처가 이메일을 열람한 경우.
EVENTS_REPORTED_SPAM_EMAIL_V2 수신자가 스팸으로 표시한 이메일.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 수신자가 이메일 구독 상태를 변경한 경우.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_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_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER> 통합 이벤트 (타임라인 V3 API)

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

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

  • occurredat
  • occurredatdateint

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



열 이름 유형 설명
EVENTTYPEID Varchar 이벤트 유형의 ID로, OBJECTTYPEID와 유사합니다.
object_and_event_type_definitions 뷰를 사용하여 계정의 모든 이벤트 유형 ID를 조회할 수 있습니다.
ID Varchar 이 ID는 이벤트 유형별로 고유합니다. 특정 이벤트 유형 내에서 동일한 ID를 가진 레코드는 두 개도 없습니다.
OBJECTTYPEID Varchar 이벤트를 완료한 개체의 유형입니다. 예를 들어, 이메일 링크 클릭의 경우 이 열에0-1 표시되며, 이는 연락처 개체를 나타냅니다.
OBJECTID 숫자 이벤트를 완료한 레코드의 ID입니다.
OCCURREDAT 타임스탬프 이벤트가 발생한 시점.

OCCURREDATDATEINT

 

 숫자 이벤트가 발생한 시점을 나타내는 숫자입니다. OCCURREDAT 열과 동일한 데이터를 포함하지만, 숫자 형식으로 포맷되어 테이블의 클러스터 키의 일부로 사용됩니다. 대부분의 경우, 이 숫자 대신 OCCURREDAT 타임스탬프를 사용할 수 있습니다.

OCCUREDATDATEINT

 숫자

이벤트가 발생한 시점을 나타내는 숫자입니다. 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 occuredAt
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.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_TIMESTAMP 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 홉스 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 Timestamp Snowflake에 데이터가 마지막으로 수집된 날짜 및 시간. 열 데이터 유형에 대해 자세히 알아보세요.

예 1

HubSpot 계정에서 사용할 수 있는 모든 객체 및 이벤트를 검색합니다.

쿼리:


SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

 
반환 결과: 

OBJECTTYPEID FULLYQUALIFIEDNAME
0-1 CONTACT
0-8 LINE_ITEM
0-11 대화
... ...

세그먼트 쿼리

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

세그먼트

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

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

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

예제 1

모든 연락처 세그먼트를 가져옵니다.

쿼리:


SELECT segmentId, name, size
FROM segments
WHERE objectTypeId = '0-1';

 
반환 결과: 

SEGMENTSID NAME SIZE
118131 주간 아웃리치 103
66156 블로그 구독자 수 455
771,852 2021년 상위 구독자 37
... ... ...

예제 2

" Top subscribers 2021"이라는 이름의 특정 연락처 세그먼트를 가져옵니다. 

쿼리:


SELECT segmentId, name, size 
FROM segments
WHERE objectTypeId = '0-1'
ANDsegmentName = 'Top subscribers 2021';


반환 결과: 

세그먼트 ID 이름 크기
771,852 2021년 상위 구독자 37

segment_membership

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

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

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

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

예제 1

'2021년 상위 구독자 ' 세그먼트에 속한 모든 연락처의 ID를 가져옵니다.

쿼리:


SELECT objectId
FROM segment_memberships
INNER JOIN segments
ON segment_memberships.segmentId = segments.segmentId
WHERE segments.objectTypeId = '0-1'
AND segments.name = 'Top Subscribers 2021';

 
반환 결과: 

OBJECTID
54325098
96805401
6922028
...

예제 2

'2021년 상위 구독자 ' 세그먼트에 속한 연락처의 이름과 성을 조회합니다.

쿼리:

 

SELECT

contact.objectId AS object_id,

contact.properties:firstname::string AS firstname,

contact.properties:lastname::string AS lastname

FROM object_with_object_properties AS contact

INNER JOIN segment_memberships AS membership

ON contact.objectId = membership.objectId

INNER JOIN segments

ON membership.segmentId = segments.segmentId

WHERE contact.objectTypeId = '0-1'

AND segments.objectTypeId = '0-1'

AND segments.name = '2021년 최다 구독자';

 


반환 결과: 

OBJECTID

이름

성

54325098

홉스

바론

96805401

마일로

골드

6922028

헨리

라일리

...

...

...

자주 묻는 질문

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

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


SELECT * FROM property_definitions

WHERE label = [column_name]

 

일부 속성 이름은 앱에서 더 설명적인 이름으로 변환되는 경우가 많기 때문에 항상 정확히 일치하는 것은 아닙니다. 이런 경우에는 property_definitions의 label(또는 description) 열에서 LIKE 연산자를 사용하여 근사 검색을 수행하면 도움이 될 수 있습니다.

컬럼이 어떤 객체 유형에 속하는지 확인한 후에는 쿼리 내용을 결정하는 것은 간단합니다. object_with_object_properties 쿼리하고 해당 유형의 objectTypeId 필터링하면 됩니다. properties JSON 컬럼에서 필요한 속성 값을 읽어오면 됩니다.

이 데이터 유형을 다른 데이터 유형과 어떻게 연결하나요? 예를 들어, 특정 캠페인의 양식을 가져오려면 어떻게 해야 하나요?

각 캠페인과 연결된 양식을 가져오려면 OBJECT_WITH_OBJECT_PROPERTIES, ASSOCIATIONS 및 ASSOCIATION_DEFINITIONS 테이블을 조인하십시오.


SELECT DISTINCT

campaigns.properties:hs_name::string AS campaign_name,

forms.properties:hs_form_id::string AS form_id

FROM object_with_object_properties AS campaigns

JOIN associations AS 협회

 ON association.fromObjectId = campaigns.objectId

JOIN association_definitions AS definition

 ON 정의.결합연관유형ID =

association.combinedAssociationTypeId

JOIN 객체_및_객체_속성 AS forms

ON forms.objectId = association.toObjectId

WHERE campaigns.objectTypeId = '0-35'

AND forms.objectTypeId = '0-28'

AND 정의.원본 객체 유형 ID = '0-35'

AND definition.toObjectTypeId = '0-28';

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

HubSpot-Snowflake 연동과 관련된 서비스 중단 및 문제에 대한 실시간 상태 업데이트를 받으려면 data_share_status 뷰를 쿼리하십시오:

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

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

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

이 뷰는 통합 상태에 대한 업데이트를 최신 순으로 제공합니다. 이 쿼리 결과를 대시보드에 통합하면 통합 성능을 추적하고 다운타임이나 서비스 중단을 감지하는 데 도움이 됩니다. 
이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.
목차 메뉴

관련 콘텐츠

New call-to-action