BigQuery
Google BigQuery와 연결하여 대규모 데이터를 SQL로 쿼리하고 분석할 수 있습니다.
주요 기능
- GCP 프로젝트 목록 조회
- SQL 쿼리 실행
- 테이블 목록 조회 및 스키마 확인
- 데이터셋 탐색
기본 정보
인증 방식
OAuth 2.0을 사용하여 Google 계정으로 인증합니다.
필요한 권한
https://www.googleapis.com/auth/bigquery: BigQuery 전체 접근 권한https://www.googleapis.com/auth/userinfo.email: 사용자 이메일 정보
입력 파라미터
- Read Only Mode (선택): 읽기 전용 모드를 활성화하면 SELECT 쿼리만 실행 가능합니다.
📝
Workspace API에서 수신한 원시 또는 파생 사용자 데이터의 사용은 제한적 사용 요건을 포함한 Google 사용자 데이터 정책을 준수합니다.
지원하는 MCP 도구
프로젝트 관리 도구
list_projects
BigQuery에 접근 가능한 모든 GCP 프로젝트 목록을 조회합니다.
쿼리 도구
execute_query
BigQuery SQL 문법을 사용하여 쿼리를 실행합니다.
테이블 관리 도구
list_tables
BigQuery 데이터베이스의 모든 테이블 목록을 조회합니다.
describe_table
특정 테이블의 스키마 정보를 조회합니다.
사용 예시
예를 들어,
- Prompt로 “BigQuery에서 sales 테이블의 구조를 알려줘” 라고 입력하면,
- LLM은 MCP를 통해
describe_table도구를 호출하여 테이블 스키마를 조회합니다. - 그리고, Tool 호출 결과를 기반으로 채팅에서 응답합니다.
주의사항
- Read Only 모드가 비활성화된 경우 INSERT, UPDATE, DELETE 등의 쿼리도 실행될 수 있으므로 주의하세요.
- 대용량 데이터 쿼리 시 비용이 발생할 수 있습니다.
- BigQuery의 쿼리 제한 및 할당량을 확인하세요.
Last updated on