GCP) 빅쿼리 - API 및 권한 설정

GCP) 빅쿼리 - API 및 권한 설정

빅쿼리(BigQuery)의 기능을 온전하게 사용하기 위한 API 설정과 권한 설정에 대해 알아본다.


개요

빅쿼리(BigQuery)를 시작하는데 이래저래 버튼을 누르다보면 뭔가 안될때가 있다. 억울하게 나만 안되는 것 같은 느낌이 들 때가 있는데 그럴 때는 API 설정과 권한 설정을 확인해보아야 한다. 이와 관련한 내용을 알아보자.

API 설정

정말 이상하게도 GCP 프로젝트를 생성하게 되면 기본적으로 빅쿼리 API가 활성화가 되어있는데 막상 빅쿼리를 쓰기 시작하려고 보면 API가 활성화 되어있지 않다면서 경고 또는 에러메세지가 뜨는 경우가 있다. 조금 기다리면 빅쿼리를 사용해도 해당 에러가 뜨지 않게 되는 경우도 있지만, 확실하게 하려면 다음과 같이 빅쿼리 API 메뉴를 찾아가서 직접 한 번 눌러주는 것이 빠른 해결책이다.
빅쿼리 API 메뉴

다음과 같은 빅쿼리 API 상세페이지에서 [관리] 버튼을 한 번 더 눌러주자.
빅쿼리 API 상세 페이지

참고로 상기 내용은 버그로 추정되며 향후 패치로 인해 바로잡힐 수 있다는 점을 참고하자.

권한 설정

프로젝트 소유자인 경우는 문제가 없지만 그렇지 않은 경우는 특정 계정에 대한 권한 설정이 되어있지 않은 경우는 데이터를 생성하는 등 빅쿼리에서 각종 작업을 시도할 때 다음과 같은 에러가 발생할 수 있다.
빅쿼리 권한 에러

상기 에러를 해결하기 위해 계정의 권한 설정을 할 수 있는 IAM 설정 페이지로 이동하도록 하자. 사이드바 메뉴에서 다음과 같이 IAM 메뉴를 확인할 수 있다.
IAM 메뉴

IAM 메뉴를 눌러 메인페이지로 이동하면 다음과 같이 프로젝트에 속한 계정 목록을 볼 수 있다.
IAM 메인페이지

왼쪽의 체크박스를 체크✅하고 [+👨🏻‍💼엑세스 권한 부여] 버튼을 눌러주면 다음과 같이 권한 설정 페이지를 볼 수 있다.
권한 설정 - 01

“역할 지정” 영역에 있는 “역할 선택” 선택 영역을 눌러
권한 설정 - 02

최종적으로 다음과 같이 권한이 할당된 것을 볼 수 있다.
권한 설정 - 03

해당 빅쿼리 관리자 권한은 권한 관련 공식문서 페이지에서 확인할 수 있다.
권한 설정 - 04

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×