gcloud CLI 설치 및 Cloud Spanner API 설정

이 페이지에서는 Google Cloud CLI, 클라이언트 라이브러리, Spanner 드라이버와 함께 Cloud Spanner API를 사용하는 데 필요한 설정 단계를 안내합니다.

Google Cloud Console에서 Spanner를 사용하려면 콘솔을 사용한 빠른 시작을 참조하세요.

시작하기 전에

개발 머신에 다음이 설치되어 있어야 합니다.

Google Cloud 프로젝트 설정

  1. Google Cloud Console의 프로젝트 페이지로 이동합니다.

    프로젝트 페이지로 이동

  2. 새 Google Cloud 프로젝트를 만들거나 프로젝트 이름을 클릭하여 기존 프로젝트를 엽니다.

  3. 터미널 창을 열고 MY_PROJECT_ID를 프로젝트 ID(프로젝트 이름 아님)로 바꾸어 프로젝트를 Google Cloud CLI의 기본 프로젝트로 설정합니다. 

    gcloud config set project MY_PROJECT_ID

  4. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

    5. Spanner 가격 책정에 대해서도 알아볼 수 있습니다.

  5. 프로젝트에서 Cloud Spanner API를 사용하도록 설정합니다.

    Cloud Spanner API 사용 설정

    참고: 다른 프로젝트의 서비스 계정을 사용하여 Spanner 인스턴스에 액세스하는 경우 두 프로젝트 모두에서 Spanner API를 사용 설정해야 합니다.

인증 및 승인 설정

Spanner는 API 인증과 승인에 OAuth 2.0을 사용합니다.

개발 및 테스트 시 코드를 로컬에서 실행하려면 애플리케이션 기본 사용자 인증 정보와 함께 Google Cloud CLI를 사용하세요. 명령 프롬프트에서 다음을 실행합니다.

gcloud auth application-default login

gcloud auth application-default login 명령어를 사용하여 인증을 완료하고 나면, 애플리케이션 기본 사용자 인증 정보를 사용하는 API 클라이언트 라이브러리가 생성된 사용자 인증 정보를 자동으로 선택합니다. 이 명령어를 로컬 사용자 환경당 한 번만 실행하면 됩니다.

Google Cloud CLI 실행

개발 환경과 인증을 설정했으므로 이제 gcloud 명령줄 도구를 실행하여 Spanner와 상호작용합니다.

gcloud spanner instance-configs list

프로젝트가 액세스할 수 있는 Spanner 인스턴스 구성의 목록(리전 구성, 이중 리전 구성, 멀티 리전 구성 포함)이 표시됩니다. 자세한 내용은 인스턴스 개요를 참조하세요.

이제 설정을 완료하였습니다.

다음 단계

Cloud 클라이언트 라이브러리와 드라이버를 사용하여 Spanner 인스턴스, 데이터베이스, 테이블, 색인을 만드는 방법을 알아봅니다. 그런 다음 Spanner에서 데이터를 저장하고 쿼리하고 읽으세요.