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

Google BigQuery(베타)에서 HubSpot 데이터 액세스

마지막 업데이트 날짜: 2026년 6월 1일

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

Data Hub Enterprise

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	STRING	객체 유형의 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_x_to_y 스키마

아래 스키마는 동기화된 associations_x_to_y_ 테이블에 대한 세부 정보를 제공합니다:

열 이름	유형	설명
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이 연관된 레코드에 표시하는 유형입니다.
[FROMOBJECTTYPE_OBJECTID]	INT64	소스 레코드의 객체 ID입니다. (예: ASSOCIATIONS_CONTACTS_TO_DEALS 뷰의 경우 CONTACT_OBJECTID).
[TOOBJECTTYPE_OBJECTID]	INT64	대상 레코드의 개체 ID입니다. (예: ASSOCIATIONS_CONTACTS_TO_DEALS 뷰의 경우 DEAL_OBJECTID).
INGESTEDAT	TIMESTAMP	BigQuery에 레코드가 마지막으로 수집된 날짜 및 시간.

associations 스키마

아래 스키마는 동기화된 associations 테이블에 대한 세부 정보를 제공합니다:

열 이름	유형	설명
COMBINEDASSOCIATIONTYPEID	문자열	연관 정의의 고유 식별자입니다.
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	이것이 HubSpot이 연관된 레코드에 표시하는 기본 연관 유형(true)인지 여부를 나타냅니다.
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	이벤트가 발생한 시점.
`OCCURREDATDATEINT`	INT64	이벤트가 발생한 시점을 나타내는 숫자입니다. `OCCURREDAT` 열과 동일한 데이터를 포함하지만, 숫자 형식으로 포맷되어 테이블의 클러스터 키의 일부로 사용됩니다. 대부분의 경우, 이 숫자 대신 `OCCURREDAT` 타임스탬프를 사용할 수 있습니다.
`OCCUREDATDATEINT`	숫자	이벤트가 발생한 시점을 나타내는 숫자입니다. `OCCURREDAT` 열과 동일한 데이터를 포함하지만, 숫자 형식으로 포맷되어 테이블의 클러스터 키의 일부로 사용됩니다. 대부분의 경우 이 숫자 대신 `OCCURREDAT` 타임스탬프를 사용할 수 있습니다.
`INGESTEDAT`	타임스탬프	BigQuery에 데이터가 마지막으로 수집된 날짜 및 시간입니다. 열 데이터 유형에 대해 자세히 알아보세요.
`PROPERTY_*`	Varchar	이벤트 속성을 포함하는 개별 열입니다.

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

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

베타Google BigQuery(베타)에서 HubSpot 데이터 액세스