This page walks you through the setup steps required to use the Cloud Spanner API with the Google Cloud CLI and client libraries.
If you want to use Cloud Spanner with the Google Cloud console, see Quickstart using the console.
Before you begin
Your development machine should have the following installed:
- The gcloud CLI, which includes setting up the Google Cloud CLI (download).
Set up a Google Cloud project
-
Go to the Projects page in the Google Cloud console.
- Create a new Google Cloud project, or open an existing project by clicking on the project name.
-
Open a terminal window, and set your project as the default project for the Google Cloud CLI, replacing
MY_PROJECT_ID
with your project ID (not your project name):gcloud config set project MY_PROJECT_ID
-
Make sure that billing is enabled for your Cloud project. Learn how to check if billing is enabled on a project.
You can also learn about Cloud Spanner pricing.
-
Enable the Cloud Spanner API for the project.
Set up authentication and authorization
Cloud Spanner uses OAuth 2.0 for API authentication and authorization.
To run your code locally during development and testing, use the Google Cloud CLI along with Application Default Credentials. At a command prompt, run:
gcloud auth application-default login
After you authenticate using the gcloud auth application-default login
command, API client libraries that use the application default credentials
automatically pick up the created credentials. You need to run the command only
once per local user environment.
Run the Google Cloud CLI
Now that you've set up your development environment and authentication, run the
gcloud
command-line tool to interact with
Cloud Spanner:
gcloud spanner instance-configs list
You should see a list of the Cloud Spanner instance configurations that your project can access, including regional and multi-region configurations. Learn more about these in Instances.
You've completed the setup!
What's next
Learn how to use the Cloud Client Libraries to create a Cloud Spanner instance, database, tables, and indexes. Then store, query, and read data in Cloud Spanner.
- Getting started with Cloud Spanner in C++
- Getting started with Cloud Spanner in C#
- Getting started with Cloud Spanner in Go
- Getting started with Cloud Spanner in Java
- Getting started with Cloud Spanner in Node.js
- Getting started with Cloud Spanner in PHP
- Getting started with Cloud Spanner in Python
- Getting started with Cloud Spanner in Ruby
- Getting started with Cloud Spanner in REST
- Getting started with Cloud Spanner in gcloud