이 페이지에서는 BigQuery API용 Cloud 클라이언트 라이브러리를 시작하는 방법을 설명합니다. 이전 Google API 클라이언트 라이브러리를 포함한 Cloud API용 클라이언트 라이브러리에 대한 자세한 내용은 클라이언트 라이브러리 설명을 참조하세요.
클라이언트 라이브러리 설치
C#
자세한 내용은 C# 개발 환경 설정을 참조하세요.
Install-Package Google.Cloud.BigQuery.V2 -Pre
Go
자세한 내용은 Go 개발 환경 설정을 참조하세요.
go get -u cloud.google.com/go/bigquery
자바
자세한 내용은 자바 개발 환경 설정을 참조하세요.
Maven을 사용하는 경우 pom.xml
파일에 다음을 추가합니다. BOM에 대한 자세한 내용은 Google Cloud Platform 라이브러리 BOM을 참조하세요.
Gradle을 사용하는 경우 종속 항목에 다음을 추가합니다.
SBT를 사용하는 경우 종속 항목에 다음을 추가합니다.
IntelliJ 또는 Eclipse를 사용하는 경우 다음 IDE 플러그인을 사용하여 클라이언트 라이브러리를 프로젝트에 추가할 수 있습니다.
이 플러그인은 서비스 계정의 키 관리와 같은 추가 기능을 제공합니다. 자세한 내용은 각 플러그인의 문서를 참조하세요.
Node.js
자세한 내용은 Node.js 개발 환경 설정을 참조하세요.
npm install --save @google-cloud/bigquery
PHP
자세한 내용은 Google Cloud에서 PHP 사용을 참조하세요.
composer require google/cloud-bigquery
Python
자세한 내용은 Python 개발 환경 설정을 참조하세요.
pip install --upgrade google-cloud-bigquery
Ruby
자세한 내용은 Ruby 개발 환경 설정을 참조하세요.
gem install google-cloud-bigquery
인증 설정
클라이언트 라이브러리를 실행하려면 먼저 서비스 계정을 만들고 환경 변수를 설정하여 인증을 설정해야 합니다. 다음 단계에 따라 인증 설정을 완료합니다. 다른 인증 방법은 GCP 인증 문서를 참조하세요.
Cloud Console
서비스 계정을 만듭니다.
-
Cloud Console에서 서비스 계정 만들기 페이지로 이동합니다.
서비스 계정 만들기로 이동 - 프로젝트를 선택합니다.
-
서비스 계정 이름 필드에 이름을 입력합니다. Cloud Console은 이 이름을 기반으로 서비스 계정 ID 필드를 채웁니다.
서비스 계정 설명 필드에 설명을 입력합니다. 예를 들면
Service account for quickstart
입니다. - 만들기를 클릭합니다.
-
역할 선택 필드를 클릭합니다.
빠른 액세스에서 기본을 클릭한 후 소유자를 클릭합니다.
- 계속을 클릭합니다.
-
완료를 클릭하여 서비스 계정 만들기를 마칩니다.
브라우저 창을 닫지 마세요. 다음 단계에서 사용합니다.
서비스 계정 키 만들기
- Cloud Console에서 만든 서비스 계정의 이메일 주소를 클릭합니다.
- 키를 클릭합니다.
- 키 추가를 클릭한 후 새 키 만들기를 클릭합니다.
- 만들기를 클릭합니다. JSON 키 파일이 컴퓨터에 다운로드됩니다.
- 닫기를 클릭합니다.
명령줄
로컬 머신 또는 Cloud Shell에서 Cloud SDK를 사용하여 다음 명령어를 실행할 수 있습니다.
-
서비스 계정을 만듭니다. NAME을 서비스 계정 이름으로 바꿉니다.
gcloud iam service-accounts create NAME
-
서비스 계정에 권한을 부여합니다. PROJECT_ID를 프로젝트 ID로 바꿉니다.
gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:NAME@PROJECT_ID.iam.gserviceaccount.com" --role="roles/owner"
-
키 파일을 생성합니다. FILE_NAME을 키 파일 이름으로 바꿉니다.
gcloud iam service-accounts keys create FILE_NAME.json --iam-account=NAME@PROJECT_ID.iam.gserviceaccount.com
GOOGLE_APPLICATION_CREDENTIALS
환경 변수를 설정하여 애플리케이션 코드에 사용자 인증 정보를 제공합니다.
[PATH]를 서비스 계정 키가 포함된 JSON 파일의 파일 경로로 바꿉니다. 이 변수는 현재 셸 세션에만 적용되므로 새 세션을 연 경우 변수를 다시 설정합니다.
Linux 또는 macOS
export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"
예를 들면 다음과 같습니다.
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/my-key.json"
Windows
PowerShell:
$env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"
예를 들면 다음과 같습니다.
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\my-key.json"
명령어 프롬프트:
set GOOGLE_APPLICATION_CREDENTIALS=[PATH]
클라이언트 라이브러리 사용
다음 예시에서는 클라이언트를 초기화하고 BigQuery API 공개 데이터 세트에서 쿼리를 수행하는 방법을 보여줍니다.
C#
이 샘플을 사용해 보기 전에 BigQuery API 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 BigQuery API C# API 참조 문서를 확인하세요.
Go
이 샘플을 사용해 보기 전에 BigQuery API 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 BigQuery API Go API 참조 문서를 확인하세요.
자바
이 샘플을 사용해 보기 전에 BigQuery API 빠른 시작: 클라이언트 라이브러리 사용의 자바 설정 안내를 따르세요. 자세한 내용은 BigQuery API 자바 API 참조 문서를 확인하세요.
Node.js
이 샘플을 사용해 보기 전에 BigQuery API 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 BigQuery API Node.js API 참조 문서를 확인하세요.
PHP
이 샘플을 사용해 보기 전에 BigQuery API 빠른 시작: 클라이언트 라이브러리 사용의 PHP 설정 안내를 따르세요. 자세한 내용은 BigQuery API PHP API 참조 문서를 확인하세요.
Python
이 샘플을 사용해 보기 전에 BigQuery API 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 BigQuery API Python API 참조 문서를 확인하세요.
Ruby
이 샘플을 사용해 보기 전에 BigQuery API 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 BigQuery API Ruby API 참조 문서를 확인하세요.
추가 리소스
C#
Go
자바
Node.js
PHP
Python
Ruby
타사 BigQuery API 클라이언트 라이브러리
위 표에 나열된 Google 지원 클라이언트 라이브러리 외에 타사 라이브러리 집합을 사용할 수 있습니다.
언어 | 라이브러리 |
---|---|
Python | pandas-gbq(마이그레이션 가이드) |
R | bigrquery |
Scala | spark-bigquery |
다음 단계
직접 사용해 보기
Google Cloud를 처음 사용하는 경우 계정을 만들어 실제 시나리오에서 BigQuery의 성능을 평가할 수 있습니다. 또한 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
BigQuery 무료로 사용해 보기