Skip to Content

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