Mac용 Google BigQuery 클라이언트

Auth Method를 고르고 Project ID에 프로젝트 이름이나 번호가 아닌 ID를 넣습니다. Application Default Credentials는 gcloud auth application-default login의 파일을 읽어 gcloud가 설정됐다면 가장 간단합니다. Service Account Key는 .json 키 파일이나 붙여넣은 JSON을 받습니다.

Google Account (OAuth)는 Google Cloud Console에서 만든 데스크톱 OAuth 클라이언트로 브라우저 로그인합니다. 갱신 토큰은 클라이언트당 하나씩 키체인에 보관해 다음 연결은 브라우저가 필요 없습니다. 한 OAuth 클라이언트는 Google 계정 하나이므로 두 번째 계정은 다른 클라이언트나 자체 갱신 토큰이 필요합니다.

모든 작업은 BigQuery REST API로 진행되어 호스트, 포트, 연결 URL이나 SSH 터널은 없습니다. Location은 모든 작업에 보낼 처리 위치를 정합니다. 클라우드 로그인도 참고하세요.

실행 전에 Explain 메뉴의 Dry Run (Cost)를 선택합니다. 처리·청구 예상 바이트, 캐시 적중 표시와 미국 달러 예상 비용을 보여 주며 쿼리 자체는 실행하지 않습니다.

실행 후 상태 표시줄에 처리·청구 바이트와 온디맨드 요금 예상 비용, 캐시 적중을 표시합니다. 확실한 상한은 Advanced 탭의 Max Bytes Billed로 정하며 BigQuery는 초과할 작업을 실행하지 않고 거부합니다.

완성, 인용과 서식은 GoogleSQL을 따르며 테이블 이름은 백틱, STRUCT·ARRAY 열은 JSON으로 표시합니다. 데이터 세트가 데이터베이스 역할로 사이드바에 표시되고 ⌘K로 전환하며 각 탭은 처음 데이터 세트에 남습니다. 작업은 쿼리 제한 시간까지 폴링 후 취소되고 No limit이면 완료까지 기다립니다.

셀·삽입·삭제는 그리드를 사용합니다. UPDATE·DELETE는 선언된 기본 키나 없으면 ARRAY·JSON·GEOGRAPHY 외 모든 열로 매칭해 동일 행은 함께 바뀝니다. 한 행을 정확히 편집하려면 PRIMARY KEY (…) NOT ENFORCED를 선언하세요. 분할 테이블은 편집기에서 파티션 필터로 UPDATE·DELETE를 작성하세요.

DDL은 편집기에서 CREATE SCHEMA, ALTER TABLE … ADD COLUMN, DROP COLUMN과 CREATE OR REPLACE VIEW 등으로 실행합니다. New Database…는 CREATE SCHEMA로 데이터 세트를 만들고 사이드바에서 테이블 이름을 바꿉니다. DDL 탭은 INFORMATION_SCHEMA.TABLES에서 정의를 읽으며 클러스터링·파티션은 Indexes에 표시합니다.

TablePro에는 BigQuery 가져오기가 없습니다. 테이블이나 쿼리 결과를 Mac에 CSV, JSON, SQL, XLSX, Markdown, HTML 및 XML로 내보냅니다.

Server-Side Export는 EXPORT DATA로 테이블을 gs:// 접두사 아래에 분할된 CSV, Parquet나 줄 구분 JSON으로 언로드합니다. 본인 연결·권한으로 실행하고 화면은 완료까지 기다리며 Mac에는 파일을 쓰지 않습니다.

iPhone과 iPad 앱에는 Google BigQuery 드라이버가 없습니다. Mac에서 동기화한 Google BigQuery 연결은 목록에 표시되지만 열리지 않습니다.