BigQuery
Google BigQuery 데이터셋을 SQL로 조회합니다.
Google Cloud에서 준비할 것
- 커넥터 전용 서비스 계정을 만들고 JSON 키 파일을 내려받습니다.
- 조회할 데이터셋에 서비스 계정을 BigQuery Data Viewer로 추가합니다.
- 조회 작업을 실행할 프로젝트에 BigQuery Job User 역할을 줍니다.
연결 설정
- 서비스 계정 키 파일을 선택하면 접근할 수 있는 프로젝트 목록이 나타납니다.
- 프로젝트를 하나 고릅니다. 프로젝트 역할 없이 데이터셋 권한만 있다면 프로젝트 ID를 직접 입력합니다.
- 데이터셋을 최대 100개까지 고릅니다. 데이터셋은 모두 같은 리전이어야 합니다.
- 탐색할 테이블을 고르고 저장합니다.
인증 정보나 프로젝트를 바꾸면 테이블 선택이 초기화됩니다. 테이블을 다시 고르고 시맨틱을 확인하세요. 계정별 커넥터 권한은 그대로 유지됩니다.
조회 범위
- GoogleSQL의
SELECT와WITH문을 실행합니다. JOIN, 집계, 서브쿼리를 쓸 수 있습니다. - 쓰기, 관리 명령, 스크립트는 실행하지 않습니다. Gate가 먼저 dry run으로 문장 종류를 확인합니다.
- 조회 한 번에 스캔할 수 있는 양에 상한이 있습니다. 기본값은 100 MiB이고 연결 설정에서 1 GiB 또는 10 GiB로 바꿀 수 있습니다.
LIMIT는 스캔량을 줄이지 않습니다. - 시간이 초과되면 Gate가 작업 취소를 요청합니다. Google 쪽 취소가 바로 끝나지 않을 수 있습니다.
오류
BigQuery가 돌려준 쿼리 오류 메시지와 위치는 그대로 보여 줍니다. AI가 이 정보를 보고 SQL을 고칠 수 있습니다.