BigQuery

BigQuery는 Google Cloud Platform(GCP)의 강력한 데이터 웨어하우스 서비스로, 대규모 데이터 분석에 탁월한 기능을 제공합니다. BigQuery를 AIRIS와 연동하면 다양한 데이터 소스를 통합하여 고객에 대한 인사이트를 얻기 위한 포괄적인 기반을 마련할 수 있습니다.

AIRIS에 BigQuery 연결하면, AIRIS 데이터를 BigQuery로 내보낼 수 있어, 더 자세한 분석과 리포팅이 가능합니다.


AIRIS에 BigQuery 연결

연동을 위해 아래 설정 단계를 완료하세요:

  1. BigQuery 데이터 세트와 서비스 계정 만들기
  2. Appier 콘솔에서 연결 추가하기

1) BigQuery 데이터 세트와 서비스 계정 생성

AIRIS와 BigQuery를 연결하려면 이에 맞는 권한이 부여된 데이터 세트와 서비스 계정이 필요합니다. 다음 단계를 완료하세요:

  1. BigQuery 데이터 세트를 생성합니다.
  2. Google Cloud 서비스 계정을 생성합니다. 프로젝트 수준에서 BigQuery User 역할을 부여합니다.
  3. 서비스 계정의 새 키를 생성하고 JSON 파일 형식으로 개인 키를 다운로드합니다.
  4. BigQuery 콘솔로 돌아가서 서비스 계정에 데이터 세트 접근 권한을 부여합니다. 데이터 세트에 대해 다음 역할을 할당하세요:
    • BigQuery Data Editor
    • BigQuery Data Viewer
👍

AIRIS에서 최적의 성과와 데이터 가용성을 위해 BigQuery 데이터 세트 생성 시 다중 지역(Multi-region) 위치를 선택하는게 좋습니다.

2. Appier 콘솔에서 연결 추가

Appier 엔터프라이즈 콘솔에서 공통 설정 > 연동 > 파트너 연동으로 이동한 다음, BigQuery를 클릭하고 + BigQuery 연결을 클릭합니다.

연결을 설명하는 이름과 BigQuery 계정 정보를 입력한 뒤 연결을 클릭합니다:

  • 데이터 세트 ID: BigQuery 콘솔에서 복사한 데이터 세트 ID.
  • 서비스 계정 키: 다운로드한 JSON 키 파일.
📘

참고

BigQuery 데이터를 AIRIS로 가져오는 방법은 BigQuery (AIRIS)를 참조하세요.


BigQuery로 데이터 내보내기

AIRIS에서 BigQuery로 활동 리포트를 내보내는 방법은 두 가지가 있습니다:

  • 활동 리포트에서 직접 내보내기를 클릭해 한 번만 내보내기
  • 스케줄 배치를 생성해 자동으로 정기적으로 내보내기

내보내기 참고 사항

  • 대용량 데이터는 500만 건씩 배치로 나누어 처리합니다. 처리되는 배치가 순차적으로 BigQuery에 생성되는 것을 확인할 수 있습니다.
  • 모든 데이터는 문자열 형식으로 내보내집니다. 다른 데이터 타입으로 변환하려면 BigQuery 문서를 참조하세요.
  • BigQuery에 생성되는 테이블 이름 규칙은 다음과 같습니다:
내보내기 방법BigQuery 테이블 이름
스케줄 배치스케줄 배치 이름 뒤에 테이블 생성 시간(Unix 타임스탬프) 추가."daily_customer_activity_1753276245"
수동 내보내기 (리포트 페이지에서)활동 리포트 이름 사용."campaign_customer_report"

문제 해결

권한 거부 (오류 403)

가장 흔한 내보내기 실패의 원인으로, 서비스 계정에 필요한 BigQuery 권한이 없을 때 발생합니다. 이 문제를 해결하려면 서비스 계정에 다음 권한이 있는지 확인하세요:

  • 프로젝트 수준에서 BigQuery User 역할
  • 특정 데이터 세트에 대해 BigQuery Data ViewerBigQuery Data Editor 권한