Instala gcloud CLI y configura la API de Cloud Spanner

En esta página, se explican los pasos de configuración necesarios para usar la API de Cloud Spanner con Google Cloud CLI, las bibliotecas cliente y los controladores de Spanner.

Si quieres usar Spanner con la consola de Google Cloud, consulta la guía de inicio rápido para usar la consola.

Antes de comenzar

Tu máquina de desarrollo debe tener instalado lo que se menciona a continuación:

Configura un proyecto de Google Cloud

  1. Ve a la página Proyectos en la consola de Google Cloud.

    Ir a la página Proyectos

  2. Crea un proyecto de Google Cloud nuevo o haz clic en el nombre del proyecto para abrir uno existente.

  3. Abre una ventana de terminal y establece tu proyecto como el proyecto predeterminado para Google Cloud CLI. Para ello, reemplaza MY_PROJECT_ID por el ID del proyecto (no el nombre del proyecto): 

    gcloud config set project MY_PROJECT_ID

  4. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

    5. También puedes obtener más información sobre los precios de Spanner.

  5. Habilitar la API de Cloud Spanner para el proyecto

    Habilitar la API de Cloud Spanner

    Nota: Si usas una cuenta de servicio en un proyecto diferente para acceder a tu instancia de Spanner, debes habilitar la API de Spanner en ambos proyectos.

Configura la autenticación y la autorización

Spanner usa OAuth 2.0 para la autenticación y autorización de API.

Para ejecutar tu código de manera local durante el desarrollo y las pruebas, usa Google Cloud CLI junto con las credenciales predeterminadas de la aplicación. En un símbolo del sistema, ejecuta lo que se menciona a continuación:

gcloud auth application-default login

Después de autenticarte con el comando gcloud auth application-default login, las bibliotecas cliente de la API que usan las credenciales predeterminadas de la aplicación seleccionan de forma automática las credenciales creadas. Solo debes ejecutar el comando una vez por cada entorno de usuario local.

Ejecuta Google Cloud CLI

Ahora que configuraste tu entorno de desarrollo y autenticación, ejecuta la herramienta de línea de comandos de gcloud para interactuar con Spanner:

gcloud spanner instance-configs list

Deberías ver una lista de los parámetros de configuración de instancias de Spanner a los que puede acceder tu proyecto, incluidos los parámetros de configuración regionales y multirregionales. Obtén más información sobre estas en Instancias.

Terminaste la configuración.

¿Qué sigue?

Aprende a usar las bibliotecas cliente y los controladores de Cloud para crear una instancia, una base de datos, índices y tablas de Spanner. Luego, almacena, consulta y lee datos en Spanner.