본문으로 건너뛰기

Google BigQuery 클라이언트

GoogleSQL을 작성하고, 실행 전에 쿼리 비용을 추정하고, 작업이 청구할 수 있는 바이트에 상한을 두세요.

한눈에 보기

쿼리 언어
SQL
드라이버
처음 사용할 때 다운로드
연결 방식
서비스 API

Google Cloud 로그인

인증 방식 (Auth Method)을 선택하고 이름이나 번호가 아닌 프로젝트 ID (Project ID)를 입력하세요. 애플리케이션 기본 사용자 인증 정보 (Application Default Credentials)는 gcloud 로그인 파일을 사용하며, 서비스 계정 키 (Service Account Key)는 JSON 파일이나 붙여 넣은 키를 받습니다.

Google Account (OAuth)는 Google Cloud Console에서 만든 데스크톱 OAuth 클라이언트로 브라우저에서 로그인하며, 클라이언트당 갱신 토큰 하나를 Keychain에 보관하므로 다음 연결부터는 브라우저가 열리지 않습니다. OAuth 클라이언트 하나는 Google 계정 하나로 로그인하므로 두 번째 계정에는 두 번째 클라이언트가 필요합니다. 모든 작업은 BigQuery REST API로 진행되어 호스트, 포트, SSH 터널이 없습니다. 위치 (Location)는 모든 작업의 처리 위치를 정합니다.

쿼리 및 비용 제어

Explain 메뉴의 Dry Run (Cost)는 쿼리를 실행하지 않고 처리 바이트, 청구 바이트, 온디맨드 비용을 추정합니다. 쿼리 후에는 같은 수치가 캐시 상태와 함께 표시되며, 최대 청구 바이트 (Max Bytes Billed)는 설정한 상한을 넘는 작업을 거부합니다.

자동 완성, 인용, 서식은 GoogleSQL을 따르며 STRUCT와 ARRAY 열은 JSON으로 표시됩니다. 데이터 세트가 데이터베이스 역할을 하며 ⌘K로 전환합니다. 작업은 쿼리 제한 시간까지 폴링한 뒤 취소됩니다. 그리드의 UPDATE와 DELETE는 선언된 기본 키로, 없으면 ARRAY, JSON, GEOGRAPHY를 제외한 모든 열로 행을 매칭하므로 동일한 행은 함께 바뀝니다. 한 행만 정확히 편집하려면 PRIMARY KEY (…) NOT ENFORCED를 선언하세요. 분할 테이블에서는 편집기에서 파티션 필터를 넣어 UPDATE와 DELETE를 작성하세요.

데이터 세트 및 DDL

CREATE SCHEMA, ALTER TABLE … ADD COLUMN, CREATE OR REPLACE VIEW 같은 DDL은 편집기에서 실행하세요. 새 데이터베이스… (New Database…)는 데이터 세트를 만들고, 테이블 이름은 사이드바에서 바꿀 수 있습니다. DDL 탭은 INFORMATION_SCHEMA.TABLES에서 각 정의를 읽으며, 클러스터링과 파티션은 Indexes에 표시됩니다.

이 페이지는 Google BigQuery에만 해당하는 내용을 다룹니다. Safe Mode, AI 도우미, MCP 서버 등 TablePro의 나머지 기능은 기능 페이지에서 볼 수 있습니다.

그 밖에

  • 데이터 이동

    테이블이나 쿼리 결과를 Mac에 CSV, JSON, SQL, XLSX, Markdown, HTML 및 XML로 내보내세요. Server-Side Export는 EXPORT DATA로 CSV, Parquet, 줄바꿈 구분 JSON을 gs:// 경로에 내보내므로 파일이 Mac을 거치지 않습니다.

  • 제한 사항

    • Structure 탭은 읽기 전용입니다. 편집기에서 DDL을 실행하세요.
    • 트랜잭션은 지원하지 않습니다.
  • BigQuery 연결에 필요한 IAM 역할은 무엇인가요?

    쿼리 실행에는 roles/bigquery.user, 데이터 읽기에는 roles/bigquery.dataViewer, 데이터 변경에는 roles/bigquery.dataEditor가 필요합니다.

  • 테이블 깊숙이 페이지를 넘기는 대신 필터를 쓰는 이유는 무엇인가요?

    뒤쪽 페이지마다 테이블을 처음부터 다시 스캔합니다. 대신 필터나 WHERE 절로 행을 좁히세요.

TablePro 받기

이 페이지의 모든 기능은 무료입니다.