베타Amazon Redshift에서 HubSpot 데이터에 액세스하기
마지막 업데이트 날짜: 2026년 10월 26일
‘Amazon Redshift용 Data Out’을 사용하여 선택한 HubSpot CRM 데이터를 본인이 소유한 Amazon Redshift 데이터베이스의 테이블로 내보낼 수 있습니다. 동기화가 실행될 때마다 선택한 데이터의 전체 스냅샷이 기록되며, 이전 스냅샷은 대체됩니다. 동기화가 완료된 후에는 SQL 또는 선호하는 BI 및 분석 도구를 사용하여 테이블을 쿼리함으로써 HubSpot 데이터를 다른 비즈니스 데이터와 결합할 수 있습니다.
참고: 슈퍼 관리자인 경우, 이 기능을 사용하려면 계정을Data Studio 베타 프로그램에 등록해야합니다.
특정 기능에 대해 HubSpot 크레딧 필요 Data Studio의 단일 데이터 웨어하우스 소스에서 HubSpot CRM으로 데이터를 직접 동기화하는 경우 HubSpot 크레딧이 소모되지 않습니다. 동기화 전에 Data Studio에서 데이터를 준비하는 경우(예: 계산된 필드 생성 또는 다른 데이터 소스와 조인), 해당 작업에는 HubSpot 크레딧이 소모됩니다.
제한 사항 및 고려 사항 이해
이 기능을 사용하기 전에, 사전에 수행해야 할 단계와 기능의 제한 사항, 그리고 사용 시 발생할 수 있는 결과를 충분히 숙지하시기 바랍니다.
- 동기화할 때마다 대상 테이블이 최신 스냅샷으로 대체됩니다. HubSpot은 Redshift에 이전 스냅샷을 보관하지 않습니다.
- HubSpot은 S3 버킷에 임시로 저장한 Parquet 파일을 삭제하지 않습니다. 해당 파일을 자동으로 제거하려면 버킷 또는 접두사에 S3 라이프사이클 정책을 설정하십시오.
- 각 객체, 이벤트 유형 또는 연관 쌍은 HubSpot 계정당 하나의 정기적인 Redshift Data Out 동기화에 포함될 수 있습니다.
- 민감한 데이터는 아직 지원되지 않습니다. 민감한 속성은 내보내기에서 제외할 수 있습니다.
OBJECTS_CONTACTS와 같은 개체별 테이블은 아직 지원되지 않습니다.
내보낼 수 있는 데이터 파악하기
HubSpot에서 Amazon Redshift로 다음 데이터를 동기화할 수 있습니다.
- 개체: 연락처, 회사, 거래, 티켓 및 제품과 같은 표준 및 사용자 지정 개체.
- 레코드: 선택한 개체에 대한 개별 레코드.
- 속성: 레코드의 선택된 속성 값 및 속성 내역.
- 연관 관계: 연관 관계 정의를 포함하여 레코드 간의 선택된 관계.
- 이벤트: 선택한 표준 HubSpot 이벤트 및 사용자 지정 행동 이벤트(선택한 이벤트 속성 포함).
서로 다른 개체의 데이터는 개체 테이블에 통합되어 있습니다. 개체 테이블을 읽을 때는 OBJECTTYPEID 사용하여 특정 개체로 필터링하십시오. 예를 들어, 연락처의 경우 0-1 사용합니다. 사용자 정의 개체는 생성 시 ID가 할당되며, 2-{unique_id} 형식(예: 2-12345)으로 식별됩니다.
내보내기 형식 이해하기
설정 과정에서 다음을 선택합니다:
- Redshift 데이터베이스 및 HubSpot이 테이블을 생성할 클러스터 또는 서버리스 워크그룹.
- HubSpot이 데이터를 Redshift로 로드하기 전에 데이터를 임시 저장하는 데 사용하는 S3 버킷.
- 동기화할 데이터 소스: 개체, 이벤트, 연관 관계 또는 이러한 소스의 조합.
- 동기화 일정.
HubSpot은 데이터를 Parquet 파일로 내보내고, 해당 파일을 S3 버킷에 임시 저장한 후 Redshift 테이블로 로드합니다.
참고: HubSpot은 스테이징 버킷에서 데이터를 삭제하지 않습니다. 버킷을 자동으로 정리하도록 버킷 수명 주기 정책을 설정하는 것이 좋습니다.
Redshift에서 데이터 찾기
HubSpot은 각 데이터 소스마다 대상 이름과 동일한 이름의 HubSpot 관리 스키마 내에 하나의 테이블을 생성합니다:
<database>.hubspot_data_out_<destination-id>.<table-name>
스키마 이름은 Redshift 동기화 구성 페이지에서 확인할 수 있습니다. 예:
your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIESyour_database.hubspot_data_out_456.EVENTS_VISITED_PAGEyour_database.hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES
각 동기화 시 테이블은 최신 스냅샷으로 대체됩니다. 동기화 중에 테이블에 오류가 발생하면, 다음 동기화가 성공적으로 완료될 때까지 이전 데이터는 그대로 유지됩니다.
HubSpot은 S3 버킷 내 HubSpot에서 관리하는 접두사 아래에 Parquet 파일을 임시 저장한 후, 이를 Redshift로 로드합니다:
s3://<bucket>/<prefix>/hubspot-dataout/<portal-id>/<destination-id>/<run-id>/<table-name>/
이러한 스테이징 파일은 사용자가 삭제할 때까지 버킷에 남아 있습니다. 자동으로 삭제하려면 버킷 또는 접두사에 S3 라이프사이클 정책을 구성하십시오.
참고: 테이블 및 열 이름은 내보낸 데이터에서 가져옵니다. Redshift의 127자 식별자 제한을 준수하기 위해 이름이 축약될 수 있습니다. 열 유형은 내보낸 데이터를 따릅니다.
객체 테이블 검토
객체 데이터를 선택하면 HubSpot은 다음 테이블을 내보냅니다.
OBJECT_PROPERTIES
이 테이블에는 속성 값마다 한 행이 포함됩니다. 특정 객체를 읽으려면 OBJECTTYPEID 필터링하십시오.
| 열 이름 | 유형 | 설명 |
|---|---|---|
OBJECTTYPEID |
문자열 | 개체의 ID입니다. 예를 들어, 연락처의 경우 0-1 사용합니다. |
OBJECTID |
숫자 | 레코드의 ID입니다. |
NAME |
문자열 | 속성 이름. |
VALUE |
문자열 | 속성 값. |
UPDATEDAT |
타임스탬프 | HubSpot에서 속성 값이 마지막으로 업데이트된 날짜 및 시간. |
INGESTEDAT |
타임스탬프 | 데이터가 내보내기 소스로 마지막으로 수집된 날짜 및 시간입니다. |
OBJECT_WITH_OBJECT_PROPERTIES
이 테이블에는 레코드당 한 행이 포함되며, 선택한 속성 값이 하나의 PROPERTIES 열로 그룹화되어 있습니다. 특정 객체를 조회하려면 OBJECTTYPEID 필터링하십시오.
| 열 이름 | 유형 | 설명 |
|---|---|---|
OBJECTTYPEID |
문자열 | 개체의 ID입니다. 예를 들어, 연락처의 경우 0-1 사용합니다. |
OBJECTID |
숫자 | 레코드의 ID입니다. |
PROPERTIES |
객체 또는 JSON | 레코드에 대해 선택된 속성 값입니다. |
UPDATEDAT |
타임스탬프 | HubSpot에서 레코드의 선택된 속성이 마지막으로 업데이트된 날짜 및 시간입니다. |
INGESTEDAT |
타임스탬프 | 데이터가 내보내기 소스로 마지막으로 수집된 날짜 및 시간입니다. |
OBJECT_PROPERTIES_HISTORY
이 테이블에는 속성 변경 내역이 포함되어 있습니다. 현재 값만 저장하는 OBJECT_PROPERTIES 달리, 이 테이블은 속성의 각 과거 값마다 한 행씩을 포함합니다. 단일 레코드 및 속성에 대한 전체 타임라인을 보려면 UPDATEDAT 순으로 정렬하십시오.
| 열 이름 | 유형 | 설명 |
|---|---|---|
OBJECTTYPEID |
VARCHAR | 개체의 ID입니다. |
OBJECTID |
BIGINT | 레코드의 ID입니다. |
NAME |
VARCHAR | 속성 이름입니다. |
VALUE |
VARCHAR | 해당 시점의 속성 값입니다. |
UPDATEDAT |
TIMESTAMP | HubSpot에서 해당 값이 설정된 날짜 및 시간. |
INGESTEDAT |
TIMESTAMP | 데이터가 내보내기 소스로 마지막으로 수집된 날짜 및 시간입니다. |
연관 테이블 검토
연관 데이터를 선택하면 HubSpot은 연관 레코드와 연관 정의를 내보냅니다.
ASSOCIATIONS
이 테이블에는 두 레코드 간의 선택된 연관 관계마다 한 행씩 포함됩니다.
| 열 이름 | 유형 | 설명 |
|---|---|---|
COMBINEDASSOCIATIONTYPEID |
문자열 | 연관 정의에 대한 고유 식별자입니다. |
ASSOCIATIONCATEGORY |
문자열 | 연관 유형의 출처입니다. 값으로는 HUBSPOT_DEFINED, USER_DEFINED 또는 INTEGRATOR_DEFINED 포함될 수 있습니다. |
ASSOCIATIONTYPEID |
숫자 | 해당 범주 내의 연관성 정의에 대한 식별자입니다. |
FROMOBJECTID |
숫자 | 소스 레코드의 ID입니다. |
TOOBJECTID |
숫자대상 레코드의 ID입니다. | 대상 레코드의 ID입니다. |
INGESTEDAT |
타임스탬프 | 데이터가 내보내기 소스로 마지막으로 수집된 날짜 및 시간입니다. |
ASSOCIATION_DEFINITIONS
이 테이블에는 선택한 연관 관계 정의 하나당 한 행이 포함됩니다.
| 열 이름 | 유형 | 설명 |
|---|---|---|
COMBINEDASSOCIATIONTYPEID |
문자열 | 연관 정의에 대한 고유 식별자. |
CATEGORY |
문자열 | 연관 유형의 출처입니다. 값으로는 HUBSPOT_DEFINED, USER_DEFINED 또는 INTEGRATOR_DEFINED 포함될 수 있습니다. |
ID |
숫자 | 해당 카테고리 내의 연관 관계 정의에 대한 식별자입니다. |
FROMOBJECTTYPEID |
문자열 | 소스 객체의 ID입니다. |
TOOBJECTTYPEID |
문자열 | 대상 객체의 ID입니다. |
NAME |
문자열 | 연관 정의의 이름입니다. |
LABEL |
문자열 | 연관 정의의 레이블입니다. |
INGESTEDAT |
타임스탬프 | 데이터가 내보내기 소스로 마지막으로 수집된 날짜 및 시간입니다. |
ISMAINASSOCIATIONDEFINITION |
부울 | HubSpot이 이 연관 관계 정의를 연관된 레코드에서 주 연관 관계로 표시할지 여부. |
ASSOCIATIONS_<FROM_OBJECT>_TO_<TO_OBJECT>
선택된 연관성 쌍에 대해 HubSpot은 ASSOCIATIONS_CONTACTS_TO_COMPANIES 같이 쌍별 연관성 테이블도 내보낼 수 있습니다. 이러한 테이블에는 연관성 레코드와 연관성 정의 메타데이터가 함께 포함됩니다.
| 열 이름 | 유형 | 설명 |
|---|---|---|
COMBINEDASSOCIATIONTYPEID |
문자열 | 연관 정의에 대한 고유 식별자입니다. |
ASSOCIATIONCATEGORY |
문자열 | 연관 유형의 출처입니다. 값으로는 HUBSPOT_DEFINED, USER_DEFINED 또는 INTEGRATOR_DEFINED 포함될 수 있습니다. |
ASSOCIATIONTYPEID |
숫자 | 해당 범주 내의 연관성 정의에 대한 식별자입니다. |
[FROMOBJECT]_OBJECTID |
숫자 | 소스 레코드의 ID입니다. 예: CONTACT_OBJECTID. |
[TOOBJECT]_OBJECTID |
숫자 | 대상 레코드의 ID입니다. 예: COMPANY_OBJECTID. |
INGESTEDAT |
타임스탬프 | 데이터가 내보내기 소스로 마지막으로 수집된 날짜 및 시간입니다. |
TOOBJECTTYPEID |
문자열 | 대상 개체의 ID입니다. |
FROMOBJECTTYPEID |
문자열 | 소스 객체의 ID입니다. |
NAME |
문자열 | 연관 정의의 이름입니다. |
LABEL |
문자열 | 연관 정의의 레이블입니다. |
ISMAINASSOCIATIONDEFINITION |
부울 | HubSpot이 이 연관 관계 정의를 연관된 레코드에서 주 연관 관계로 표시할지 여부. |
이벤트 테이블 검토
이벤트 데이터를 선택하면 HubSpot은 이벤트 유형별로 하나의 테이블을 내보냅니다. 테이블 이름은 EVENTS_<EVENT_NAME> 형식을 따르며, 예를 들어 EVENTS_VISITED_PAGE 같습니다.
각 이벤트 테이블에는 표준 이벤트 열과 선택한 각 이벤트 속성에 대한 열이 하나씩 포함됩니다.
| 열 이름 | 유형 | 설명 |
|---|---|---|
EVENTTYPEID |
문자열 | 이벤트 유형 ID. |
ID |
문자열 | 고유한 이벤트 ID입니다. |
OBJECTTYPEID |
문자열 | 이벤트와 연관된 객체의 ID입니다. |
OBJECTID |
숫자 | 이벤트와 관련된 레코드의 ID입니다. |
INGESTEDAT |
타임스탬프 | 이벤트가 내보내기 소스로 수집된 날짜 및 시간입니다. |
OCCURREDATDATEINT |
숫자 | 이벤트 날짜를 YYYYMMDD 형식의 정수로 나타낸 값입니다. |
OCCURREDAT |
타임스탬프 | 이벤트가 발생한 날짜 및 시간. |
PROPERTY_<PROPERTY_NAME> |
문자열 | 선택된 이벤트 속성입니다. 예를 들어, page_title 속성은 PROPERTY_PAGE_TITLE 내보내집니다. |
동기화 일정 관리
HubSpot에서 설정하는 동안 동기화 일정을 구성할 수 있습니다. 또한 HubSpot에서 수동으로 재동기화를 실행할 수도 있습니다. 동기화가 실행될 때마다 선택한 데이터의 전체 스냅샷이 생성됩니다. 데이터 양을 조절하려면 포함할 개체, 이벤트, 연관 관계 및 속성을 선택하십시오.
참고: 베타 기간 중에는 ‘1회’, ‘6시간마다’, ‘12시간마다’, ‘매일’, ‘매주’, ‘매월’과 같이 제한된 동기화 빈도만 사용할 수 있습니다. 향후 릴리스에서 추가적인 빈도 옵션이 제공될 수 있습니다.
동기화 모니터링 및 오류 처리
HubSpot에서 Amazon Redshift 동기화를 모니터링할 수 있습니다. 동기화는 다음 상태 중 하나를 가질 수 있습니다:
| 상태 | 의미 |
|---|---|
| 동기화 중 | 현재 동기화 작업이 진행 중입니다. |
| 동기화됨 | 마지막 동기화가 성공적으로 완료되었습니다. |
| 실패 | 마지막 동기화 실행에서 오류가 발생했습니다. |
| 보관됨 | 동기화 구성이 보관되거나 제거되었습니다. |
동기화가 실패할 경우:
- HubSpot에는 ‘실패’ 상태가 표시되며, 테이블별 세부 정보에서 어떤 테이블이 성공했는지, 실패했는지 확인할 수 있습니다.
- 테이블은 HubSpot이 해당 테이블의 모든 데이터 로딩을 완료한 후에만 업데이트되므로, 데이터가 부분적으로만 로딩된 테이블은 절대 표시되지 않습니다.
- 테이블 동기화가 실패한 경우, 다음 동기화가 성공적으로 완료될 때까지 이전 데이터가 그대로 유지됩니다.
- 다음 예약된 동기화 시점에 전체 동기화가 자동으로 다시 시도됩니다.
- HubSpot에서 언제든지 수동으로 재동기화를 실행할 수 있습니다.
이전 실행에서 성공했던 테이블은 이후 실행이 실패하더라도 수정되지 않습니다.
자주 묻는 질문
데이터를 쿼리하려면 어떻게 해야 하나요?
SQL을 사용하여 대상 스키마의 테이블을 쿼리하세요. 예:
모든 연락처 레코드 읽기:
SELECT * FROM your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES WHERE OBJECTTYPEID = '0-1';PROPERTIES JSON 열에서 특정 속성 읽기:
SELECT OBJECTID, JSON_EXTRACT_PATH_TEXT(PROPERTIES, 'email') AS email FROM your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES WHERE OBJECTTYPEID = '0-1';하나의 데이터 유형을 여러 Redshift 동기화에 내보낼 수 있나요?
각 개체, 이벤트 유형 또는 연관 쌍은 HubSpot 계정당 하나의 정기 Redshift Data Out 동기화에 포함될 수 있습니다. 예를 들어, 연락처가 이미 하나의 정기 Redshift 대상에 내보내진 경우, 첫 번째 동기화를 아카이브하기 전까지는 다른 정기 Redshift 동기화에 연락처를 추가할 수 없습니다.
개체별 테이블이 지원되나요?
아니요. OBJECTS_CONTACTS 같은 개체별 테이블은 아직 지원되지 않습니다. 특정 개체의 레코드를 가져오려면 OBJECT_WITH_OBJECT_PROPERTIES 사용하고 OBJECTTYPEID 필터링하십시오.
민감 정보는 지원되나요?
아니요. Data Out to Redshift에서는 아직 민감한 데이터가 지원되지 않습니다. 민감한 속성은 내보내기에서 제외할 수 있습니다.
HubSpot은 이전 스냅샷을 보관하나요?
아니요. 동기화할 때마다 대상 테이블이 최신 스냅샷으로 대체되므로, Redshift에는 이전 스냅샷이 보관되지 않습니다. 또한 HubSpot은 S3 버킷에 임시로 저장한 Parquet 파일을 삭제하지 않습니다. S3 라이프사이클 정책을 구성하여 해당 파일이 자동으로 만료되도록 설정하십시오.
관련 콘텐츠
관련 콘텐츠
