베타Microsoft Azure Synapse Analytics에서 HubSpot 데이터에 액세스하세요

Azure Synapse용 Data Out을 사용하여 선택한 HubSpot CRM 데이터를 귀하가 소유한 Azure Synapse 전용 SQL 풀의 테이블로 내보내세요. HubSpot은 선택한 데이터의 전체 내보내기 결과를 바탕으로 각 출력 테이블을 새로 고칩니다. 동기화가 완료된 후에는 SQL 또는 선호하는 BI 및 분석 도구를 사용하여 테이블을 쿼리함으로써 HubSpot 데이터를 다른 비즈니스 데이터와 결합할 수 있습니다.

참고: 슈퍼 관리자인 경우, 이 기능을 사용하려면 계정을Data Studio 베타 프로그램에 등록해야합니다.

제한 사항 및 고려 사항 이해

이 기능을 사용하기 전에, 사전에 수행해야 할 단계와 기능의 제한 사항, 그리고 사용 시 발생할 수 있는 결과를 충분히 숙지하시기 바랍니다.

• HubSpot은 테이블을 개별적으로 업데이트합니다. 동기화가 진행 중일 때 여러 테이블에 걸쳐 쿼리를 실행하면, 일부 테이블은 다른 테이블보다 먼저 업데이트될 수 있습니다.
• Data Out은 과거 스냅샷 보존 기능을 제공하지 않습니다. 새로 고침이 성공적으로 완료된 후, 대상 테이블에는 최신 스냅샷이 포함됩니다.
• HubSpot 계정당 각 개체, 이벤트 유형 또는 연관 쌍은 하나의 반복 Azure Synapse 동기화에 포함될 수 있습니다. 이 제한은 다른 Data Out 제공자와는 별개입니다.
• OBJECTS_CONTACTS와 같은 개체별 테이블은 아직 지원되지 않습니다.
• HubSpot에서 테이블 이름을 정규화한 후 두 테이블 이름이 중복되면, 해당 내보내기가 실패합니다. 자세한 내용은 테이블 및 열 이름 규칙을 참조하십시오.

내보낼 수 있는 데이터 파악하기

HubSpot에서 Azure Synapse Analytics로 다음 데이터를 동기화할 수 있습니다.

• 개체 및 레코드: 연락처, 회사, 거래, 티켓, 제품 등 선택된 표준 및 사용자 지정 개체와 해당 레코드.
• 속성: 레코드의 선택된 속성 값 및 속성 내역.
• 연관 관계: 연관 관계 정의를 포함하여 레코드 간의 선택된 관계.
• 이벤트: 선택한 표준 HubSpot 이벤트 및 사용자 지정 행동 이벤트(선택한 이벤트 속성 포함).

서로 다른 개체의 데이터는 개체 테이블에 통합됩니다. 개체 테이블을 읽을 때는 OBJECTTYPEID 사용하여 특정 개체로 필터링하십시오. 예를 들어, 연락처의 경우 0-1 사용합니다. 사용자 정의 개체는 생성 시 ID가 할당되며 2-{unique_id} 형식(예: 2-12345)으로 식별됩니다.

내보내기 형식 이해하기

설정 과정에서 다음을 선택합니다:

• 대상 Azure Synapse 전용 SQL 엔드포인트 및 데이터베이스.
• 동기화할 데이터 소스: 개체, 이벤트, 연관 관계 또는 이러한 소스의 조합.
• 동기화 일정.

HubSpot은 HubSpot 관리형 스토리지에 임시 Parquet 내보내기 파일을 생성하고, 그 결과를 Azure Synapse 전용 SQL 풀의 테이블에 기록합니다. 스테이징 버킷을 제공하거나 관리할 필요가 없습니다.

Azure Synapse에서 데이터 찾기

HubSpot은 대상에 대해 HubSpot에서 관리하는 스키마 내에 출력 테이블을 생성합니다. HubSpot은 객체 데이터를 이 문서에 설명된 세 개의 객체 테이블로 내보냅니다. 또한 HubSpot은 선택한 이벤트 유형마다 하나의 테이블을 생성하며, 가능한 경우 선택한 연관 쌍마다 하나의 쌍별 테이블을 생성합니다.

<database>.hubspot_data_out_<destination-id>.<table-name>

정확한 스키마 이름은 동기화 구성 페이지에서 확인할 수 있습니다. 예:

• your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• your_database.hubspot_data_out_456.EVENTS_VISITED_PAGE
• your_database.hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

테이블 및 열 이름

HubSpot은 내보낸 테이블 및 열 이름을 대문자, 숫자, 밑줄로 정규화합니다:

• 공백과 하이픈은 밑줄로 대체됩니다.
• 그 외의 영숫자가 아닌 문자는 제거됩니다.
• 128자보다 긴 이름은 축약됩니다.
• 중복되는 열 이름에는 접미사가 추가됩니다.
• 중복되는 테이블 이름이 있는 경우 해당 내보내기가 실패합니다.

식별자를 쿼리할 때는, 특히 쿼리를 동적으로 구성하는 경우 대괄호를 사용하십시오. 식별자의 대소문자 구분 여부는 Synapse 데이터베이스의 정렬 방식에 따라 달라집니다. 예:

SELECT *
FROM [your_database].[hubspot_data_out_456].[OBJECT_WITH_OBJECT_PROPERTIES]
WHERE [OBJECTTYPEID] = '0-1';

열 유형

열 유형은 내보낸 데이터를 따르며 다음과 같이 Azure Synapse 유형에 매핑됩니다:

참고: PROPERTIES OBJECT_WITH_OBJECT_PROPERTIES 열은 JSON 형식의 문자열로 내보내집니다. 이 열은 JSON 열 유형이 아닌 NVARCHAR(MAX)로 저장됩니다. 쿼리 예제는 FAQ를 참조하십시오.

개체 테이블 검토

개체 데이터를 선택하면 HubSpot에서 다음 테이블을 내보냅니다.

OBJECT_PROPERTIES

이 테이블에는 속성 값마다 한 행씩 포함됩니다. 특정 객체를 읽으려면 OBJECTTYPEID 필터링하십시오.

OBJECT_WITH_OBJECT_PROPERTIES

이 테이블에는 레코드당 한 행이 포함되며, 선택한 속성 값이 하나의 PROPERTIES 열로 그룹화되어 있습니다. 특정 객체를 조회하려면 OBJECTTYPEID 필터링하십시오.

OBJECT_PROPERTIES_HISTORY

이 테이블에는 속성 변경 내역이 포함되어 있습니다. 현재 값만 저장하는 OBJECT_PROPERTIES 달리, 이 테이블은 속성의 각 과거 값마다 한 행씩을 포함합니다. 단일 레코드 및 속성에 대한 전체 타임라인을 보려면 UPDATEDAT 순으로 정렬하십시오.

연관 테이블 검토

연관 데이터를 선택하면 HubSpot은 연관 레코드와 연관 정의를 내보냅니다.

ASSOCIATIONS

이 테이블에는 두 레코드 간의 선택된 연관 관계마다 한 행씩 포함됩니다.

ASSOCIATION_DEFINITIONS

이 테이블에는 선택한 연관 관계 정의 하나당 한 행이 포함됩니다.

ASSOCIATIONS_<FROM_OBJECT>_TO_<TO_OBJECT>

선택된 연관성 쌍에 대해 HubSpot은 ASSOCIATIONS_CONTACTS_TO_COMPANIES 같이 쌍별 연관성 테이블도 내보낼 수 있습니다. 이러한 테이블에는 연관성 레코드와 연관성 정의 메타데이터가 함께 포함됩니다.

이벤트 테이블 검토

이벤트 데이터를 선택하면 HubSpot은 이벤트 유형별로 하나의 테이블을 내보냅니다. 테이블 이름은 EVENTS_<EVENT_NAME> 형식을 따르며, 예를 들어 EVENTS_VISITED_PAGE 같습니다.

각 이벤트 테이블에는 표준 이벤트 열과 선택한 각 이벤트 속성에 대한 열이 하나씩 포함됩니다.

동기화 일정 관리

HubSpot 설정 과정에서 동기화 일정을 구성할 수 있습니다. 또한 HubSpot에서 수동으로 재동기화를 실행할 수도 있습니다. 동기화가 실행될 때마다 선택한 데이터의 전체 스냅샷이 생성됩니다. 데이터 양을 조절하려면 포함할 개체, 이벤트, 연관 관계 및 속성을 선택하십시오.

참고: 베타 기간 중에는 사용 가능한 동기화 빈도가 제한될 수 있습니다. 향후 릴리스에서 추가적인 빈도 옵션이 제공될 수 있습니다.

동기화 모니터링 및 오류 처리

HubSpot에서 Azure Synapse 동기화를 모니터링할 수 있습니다. 동기화는 다음 상태 중 하나를 가질 수 있습니다:

동기화가 실패할 경우:

• HubSpot은 어떤 테이블이 성공했는지, 실패했는지에 대한 세부 정보와 함께 '실패' 상태를 표시합니다.
• 테이블을 업데이트할 수 없는 경우, 일반적으로 이전에 성공적으로 동기화된 데이터는 계속 사용할 수 있습니다.
• 반복 동기화의 경우, 다음 예약된 동기화에서 전체 동기화가 자동으로 다시 시도됩니다.
• HubSpot에서 언제든지 수동으로 재동기화를 실행할 수 있습니다.

자주 묻는 질문

데이터를 쿼리하려면 어떻게 해야 하나요?

SQL을 사용하여 대상 스키마의 테이블을 쿼리하세요. 예를 들어, 모든 연락처 레코드를 읽어보려면:

SELECT *
FROM [your_database].[hubspot_data_out_456].[OBJECT_WITH_OBJECT_PROPERTIES]
WHERE [OBJECTTYPEID] = '0-1';

PROPERTIES JSON 문자열에서 특정 속성을 읽어오는 방법:

SELECT
  [OBJECTID],
  JSON_VALUE([PROPERTIES], '$.email') AS [email]
FROM [your_database].[hubspot_data_out_456].[OBJECT_WITH_OBJECT_PROPERTIES]
WHERE [OBJECTTYPEID] = '0-1';

하나의 데이터 유형을 여러 동기화에 걸쳐 내보낼 수 있나요?

HubSpot 계정당 각 개체, 이벤트 유형 또는 연관 쌍은 하나의 반복 Azure Synapse 동기화에 포함될 수 있습니다. 이 제한은 다른 Data Out 제공자와는 별개입니다.

예를 들어, 연락처가 이미 반복적인 Azure Synapse 대상에 내보내진 경우, 첫 번째 동기화를 아카이브하기 전까지는 다른 반복적인 Azure Synapse 동기화에 연락처를 추가할 수 없습니다. 하지만 동시에 지원되는 다른 Data Out 제공업체로 연락처를 내보내는 것은 가능합니다.

개체별 테이블이 지원되나요?

아니요. OBJECTS_CONTACTS 같은 개체별 테이블은 아직 지원되지 않습니다. 특정 개체의 레코드를 가져오려면 OBJECT_WITH_OBJECT_PROPERTIES 사용하고 OBJECTTYPEID 필터링하십시오.

HubSpot은 이전 스냅샷을 보관하나요?

아니요. Data Out은 과거 스냅샷 보존 기능을 제공하지 않습니다. 새로 고침이 성공적으로 완료된 후, 대상 테이블에는 최신 스냅샷이 포함됩니다. 테이블을 업데이트할 수 없는 경우, 일반적으로 이전에 성공적으로 동기화된 데이터는 계속 사용할 수 있습니다.