베타Google BigQuery에서 HubSpot 데이터에 액세스하기 (베타)
마지막 업데이트 날짜: 2026년 6월 30일
Google BigQuery를 HubSpot 계정에 연결한 후에는 BigQuery에서 HubSpot 데이터를 조회할 수 있습니다.
이 문서에서는 BigQuery로 동기화된 각 테이블의 스키마에 대한 정보를 제공하며, 이 정보를 Google의 문서와 함께 활용하여 BigQuery 계정에서 HubSpot 데이터를 조회할 수 있습니다.
데이터 개요
쿼리는 SQL을 사용하여 작성되며, 다음과 같은 HubSpot 데이터를 검색하는 데 사용할 수 있습니다.
- 객체: 연락처, 기업, 제품과 같은 표준 및 사용자 정의 객체.
- 레코드: 개별 연락처나 기업과 같은개별 레코드.
- 연관 관계: 사용 가능한 모든 연관 유형 및 현재 연관된 레코드.
- 이벤트: 이메일 열람과 같은 표준 HubSpot 이벤트와 사용자 정의 행동 이벤트에 대한 이벤트 데이터.
v1의 경우 다양한 유형의 개체 데이터가 결합됩니다. 즉, 모든 개체 유형의 모든 레코드가 하나의 데이터베이스 개체로 통합됩니다. 따라서 쿼리를 실행할 때는 “WHERE objectTypeId=’0-1’”과 같은 필터를 지정해야 합니다 .
사용자 정의 객체에는 생성 시 ID가 할당되며, 2-unique_ID 형식으로 식별됩니다. 예를 들어, 2-12345 같습니다.
자세히 알아보기 HubSpot의 CRM 데이터 모델.
동기화된 테이블 스키마
아래 섹션에서는 구성된 동기화 설정에 따라 HubSpot 계정에서 BigQuery로 동기화된 각 테이블의 스키마에 대한 세부 정보를 제공합니다.
object_properties 스키마
아래 스키마는 동기화된 object_properties 테이블에 대한 세부 정보를 제공합니다:
| 열 이름 | 유형 | 설명 |
| OBJECTTYPEID | 문자열 | 객체 유형의 ID(예: 연락처의 경우 0-1). |
| OBJECTID | INT64 | 레코드의 ID(예: 연락처 레코드의 경우 123752). |
| NAME | STRING | 속성의 이름입니다. |
| VALUE | JSON | 속성의 값 |
| 업데이트 날짜 | TIMESTAMP | HubSpot에서 레코드가 마지막으로 업데이트된 날짜 및 시간. |
| INGESTEDAT | TIMESTAMP | BigQuery에서 레코드를 마지막으로 가져온 날짜 및 시간입니다. |
object_with_object_properties 스키마
아래 스키마는 동기화된 object_with_object_properties 테이블에 대한 세부 정보를 제공합니다:
| 열 이름 | 유형 | 설명 |
| OBJECTTYPEID | STRING | 객체 유형의 ID(예: 연락처의 경우 0-1). |
| OBJECTID | INT64 | 레코드의 ID(예: 연락처 레코드의 경우 123752). |
| PROPERTIES | JSON | 레코드의 속성 값 |
| UPDATEDAT | TIMESTAMP | HubSpot에서 레코드가 마지막으로 업데이트된 날짜 및 시간. |
| INGESTEDAT | TIMESTAMP | BigQuery에서 레코드를 마지막으로 가져온 날짜 및 시간입니다. |
associations 스키마
아래 스키마는 동기화된 associations 테이블에 대한 세부 정보를 제공합니다:
| 열 이름 | 유형 | 설명 |
| COMBINEDASSOCIATIONTYPEID | STRING | 연관 정의의 고유 식별자입니다. |
| FROMOBJECTID | INT64 | 소스 객체의 ID입니다. |
| TOOBJECTID | INT64 | 대상 개체의 ID입니다. |
| INGESTEDAT | TIMESTAMP | BigQuery가 레코드를 마지막으로 수집한 날짜 및 시간입니다. |
association_definitions 스키마
아래 스키마는 동기화된 associations_definitions 테이블에 대한 세부 정보를 제공합니다:
| 열 이름 | 유형 | 설명 |
| COMBINEDASSOCIATIONTYPEID | STRING | 특정 연관성 정의에 대한 고유 식별자입니다. |
| ASSOCIATIONCATEGORY | STRING | 연관 유형의 출처입니다. 가능한 값으로는 HUBSPOT_DEFINED, USER_DEFINED 또는 INTEGRATOR_DEFINED가 있습니다. |
| ASSOCIATIONTYPEID | STRING | 해당 ASSOCIATIONCATEGORY 내의 연관 정의에 대한 고유 식별자입니다. 동일한 카테고리 내의 두 정의가 이 ID를 공유하지 않습니다. |
| FROMOBJECTTYPEID | STRING | 연관 관계의 소스 객체에 대한 객체 유형 ID입니다. |
| FROMOBJECTTYPE | STRING | 연관 관계의 소스 객체 유형의 이름입니다. |
| TOOBJECTTYPEID | STRING | 연관 관계의 대상 객체의 객체 유형 ID입니다. |
| TOOBJECTTYPE | STRING | 연관 관계의 대상 객체 유형의 이름입니다. |
| NAME | STRING | 연관 정의의 정의된 이름입니다. |
| LABEL | STRING | 연관 정의에 대한 설명 레이블입니다. |
| ISMAINASSOCIATIONDEFINITION | BOOLEAN | 이것이 주 연관 유형(true)인지 여부를 나타내며, HubSpot은 연관된 레코드에 이 유형을 표시합니다. |
| INGESTEDAT | TIMESTAMP | BigQuery가 해당 레코드를 마지막으로 수집한 날짜 및 시간입니다. |
이벤트
이벤트에는 표준 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를 조합하여 이벤트를 식별할 수 있습니다. 반환되는 열은 이벤트에 따라 다르며, 각 이벤트 속성마다 하나의 열이 할당됩니다. 모든 이벤트는 다음 열을 반환합니다:
| 열 이름 | 유형 | 설명 |
EVENTTYPEID |
STRING | 이벤트 유형의 ID로, OBJECTTYPEID와 유사합니다. object_and_event_type_definitions 뷰를 사용하여 계정 내의 모든 이벤트 유형 ID를 조회할 수 있습니다. |
ID |
STRING | 이 ID는 이벤트 유형별로 고유합니다. 특정 이벤트 유형 내에서 동일한 ID를 가진 레코드는 두 개도 없습니다. |
OBJECTTYPEID |
STRING | 이벤트를 완료한 객체의 유형입니다. 예를 들어, 이메일 링크 클릭의 경우 이 열에0-1 표시되며, 이는 연락처 객체를 나타냅니다. |
OBJECTID |
INT64 | 이벤트를 완료한 레코드의 ID입니다. |
OCCURREDAT |
TIMESTAMP | 이벤트가 발생한 시점. |
|
|
INT64 | 이벤트가 발생한 시점을 나타내는 숫자입니다. OCCURREDAT 열과 동일한 데이터를 포함하지만, 숫자 형식으로 포맷되어 테이블의 클러스터 키의 일부로 사용됩니다. 대부분의 경우, 이 숫자 대신 OCCURREDAT 타임스탬프를 사용할 수 있습니다. |
|
|
숫자 | 이벤트가 발생한 시점을 나타내는 숫자입니다. |
INGESTEDAT |
타임스탬프 | BigQuery가 데이터를 마지막으로 수집한 날짜 및 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요. |
PROPERTY_* |
Varchar | 이벤트 속성을 포함하는 개별 열입니다. |
관련 콘텐츠
관련 콘텐츠
