마지막 업데이트 날짜: 2026년 9월 4일
요약
HubSpot 마켓플레이스의 Amazon Redshift 앱을 사용하여 HubSpot CRM 개체, 연관 관계 및 이벤트를 Amazon Redshift로 내보낼 수 있습니다. HubSpot에서 내보낼 데이터를 선택하고, 동기화 일정을 구성하며, 동기화 활동을 모니터링할 수 있습니다.
이 문서에서는 앱을 설치 및 연결하고, 데이터 내보내기 동기화를 구성하며, 동기화를 모니터링하거나 관리하는 방법을 다룹니다.
참고: 만약 귀하가 슈퍼 관리자인 경우, 계정을 ‘개선된 Amazon Redshift 통합’ 베타 프로그램에 등록할 수 있습니다.
시작하기 전에
필수 사항 확인
다음 사항이 준비되어 있는지 확인하십시오:
- HubSpot 계정에 연결되어 있으며 AWS 계정에 액세스하도록 구성된 AWS IAM(Identity and Access Management) 역할.
- HubSpot에서 연결할 수 있는 Amazon Redshift 프로비저닝된 클러스터 또는 서버리스 워크그룹.
- 임시 Parquet 파일을 임시 저장할 Amazon S3 버킷. 이 버킷은 Redshift 클러스터 또는 서버리스 워크그룹과 동일한 AWS 리전에 있어야 합니다.
- HubSpot은 임시 Parquet 파일을 구성된 Amazon S3 스테이징 버킷으로 복사하며, 해당 파일을 삭제하지 않습니다. 오래된 파일을 제거하고 스토리지 비용을 관리하려면 AWS 계정에서 S3 라이프사이클 규칙을 생성하십시오.
- 대상 데이터베이스에서 일회성 SQL 권한 부여를 실행할 수 있는 Redshift 관리자.
- HubSpot 및 AWS 콘솔에 대한 액세스 권한. 각 콘솔을 별도의 탭에서 여는 것이 좋습니다.
제한 사항 및 고려 사항 이해
- 각 동기화 작업은 선택한 데이터의 전체 스냅샷을 생성합니다.
- 동기화할 때마다 대상 테이블이 덮어쓰기됩니다. Redshift에서 추가된 테이블 수준 권한이나 설정은 동기화 사이에 유지되지 않습니다.
- 포함할 개체, 연관 관계 및 이벤트를 선택하여 내보낼 데이터의 양을 제어할 수 있습니다.
- 동기화가 실패하면 다음 예약된 동기화에서 전체 동기화가 자동으로 다시 시도됩니다.
Amazon Redshift 앱 설치 및 연결
- HubSpot 앱 마켓플레이스에서 Amazon Redshift 앱 목록을 엽니다.
- HubSpot 계정에 연결된 AWS 역할을 선택합니다.
- '설치'를 클릭합니다.
- '다음'을 클릭합니다.
- HubSpot 계정에 연결되어 있고 AWS 계정에 액세스하도록 구성된 AWS IAM 역할을 생성합니다.
- 역할의 Amazon 리소스 이름(ARN)을 입력합니다.
- 'Amazon Redshift에 연결'을 클릭하십시오.
AWS 역할 구성
HubSpot은 연결된 AWS 역할을 사용하여 임시 Parquet 파일을 S3 스테이징 버킷에 작성하고, 해당 파일을 Redshift로 로드합니다.
- 'S3 버킷 URL' 필드에 HubSpot이 임시 Parquet 파일을 스테이징하는 데 사용할 S3 버킷의 URL을 입력합니다.
버킷 내의 특정 경로에 대한 액세스를 제한하려면 URL에 접두사를 포함할 수 있습니다. 버킷은 Redshift 클러스터 또는 서버리스 워크그룹과 동일한 AWS 리전에 있어야 합니다.
참고: HubSpot은 설계상 Parquet 파일을 구성된 S3 스테이징 버킷으로 복사하며, 해당 파일을 삭제하지 않습니다. 오래된 파일을 자동으로 제거하려면 AWS에서 S3 라이프사이클 규칙을 생성하십시오.
- 드롭다운 메뉴에서 Redshift 배포 유형을 선택하십시오:
- Redshift Serverless
- 프로비저닝된 클러스터
- 연결된 AWS 역할에 배포 유형에 맞는 권한 정책을 적용하여 업데이트하십시오:
- Redshift Serverless: 워크그룹 ARN을 입력하세요. HubSpot에서 해당 ARN이 포함된 정책을 생성합니다. 정책을 복사하여 연결된 AWS 역할에 연결하세요.
- 프로비저닝된 클러스터: 정책 템플릿을 복사하십시오.
YOUR_REGION,YOUR_ACCOUNT_ID,YOUR_CLUSTER_ID및YOUR_DATABASE을(를) 귀하의 AWS 계정 값으로 대체한 후, 해당 정책을 연결된 AWS 역할에 연결하십시오.
- AWS IAM에서 HubSpot에 연결된 역할을 엽니다.
- 생성된 권한 정책을 역할에 연결하거나, 정책 내용을 사용하여 인라인 정책을 생성하십시오.
- 동일한 AWS IAM 역할에서 HubSpot에서 생성한 문구로 신뢰 정책을 업데이트하십시오.
HubSpot은 사용자가 선택한 Redshift 배포 유형에 따라 서로 다른 신뢰 정책 문구를 생성합니다.
AWS 역할을 Redshift에 연결합니다.
Amazon Redshift에서 이전 섹션에서 업데이트한 것과 동일한 AWS 역할을 Redshift 설정에 연결하십시오.
- Redshift Serverless: HubSpot과 함께 사용하는 네임스페이스의 네임스페이스 구성 페이지를 엽니다. '보안 및 암호화' 탭에서 'IAM 역할 관리'를 클릭한 다음 'IAM 역할 연결'을 선택합니다.
- 프로비저닝된 클러스터: 클러스터를 열고 ‘작업’을 클릭한 다음 ‘IAM 역할 관리’ > ‘IAM 역할 연결’을 선택합니다.
Redshift 권한 부여
- HubSpot에서 대상 데이터베이스를 선택합니다.
- Redshift 관리자에게 요청하여 선택한 데이터베이스에서 SQL 스크립트를 실행하도록 하십시오.
HubSpot은 이 권한을 사용하여 동기화 중에 대상에 대한 스키마를 생성합니다.
- '연결 테스트'를 클릭합니다.
- 연결 테스트가 성공하면 '다음'을 클릭합니다.
데이터 내보내기 동기화 구성
- 내보낼 데이터 소스를 선택합니다.
- 포함할 개체, 연관 관계 및 이벤트 테이블을 선택합니다.
- 동기화 빈도와 시작 시간을 구성합니다.
- '동기화 시작'을 클릭하십시오.
동기화가 실행될 때마다 선택한 데이터의 전체 스냅샷이 Amazon Redshift로 내보내집니다.
동기화 모니터링 및 관리
동기화 세부 정보 페이지에서 다음 정보를 확인할 수 있습니다.
- 동기화 상태.
- 마지막 동기화 시간.
- 오류.
- 동기화 활동.
- 동기화 내역.
동기화 세부 정보 페이지를 열려면:
- HubSpot 계정에서 ‘데이터 관리 ’ > ‘데이터 통합’으로 이동합니다.
- '앱 동기화' 탭에서 Amazon Redshift 앱 동기화를 검색합니다.
- 확인하려는 Amazon Redshift 동기화를 클릭합니다.
동기화 세부 정보 페이지에서 다음 작업을 수행할 수도 있습니다:
- '일시 중지'를 클릭하여 동기화를 일시 중지합니다.
- '보관'을 클릭하여 동기화를 보관합니다.
- '지금 동기화'를 클릭하여 수동으로 동기화를 시작합니다.
동기화 상태
| 상태 | 설명 |
|---|---|
| 동기화 중 | 동기화가 진행 중입니다. |
| 동기화됨 | 가장 최근의 동기화가 성공적으로 완료되었습니다. |
| 실패 | 가장 최근의 동기화 실행에서 오류가 발생했습니다. |
| 보관됨 | 동기화 구성이 보관되거나 제거되었습니다. |
동기화 실패 해결
동기화가 실패하면:
- HubSpot에서 동기화 상태가 '실패'로 표시됩니다.
- 테이블별 세부 정보에서 어떤 테이블이 성공했는지 또는 실패했는지 확인할 수 있습니다.
- 다음 예약된 동기화 시점에 전체 동기화가 자동으로 다시 시도됩니다.
- '지금 동기화'를 클릭하여 수동으로 다른 동기화를 시작할 수 있습니다.
