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 deseas usar Spanner con la consola de Google Cloud, consulta la guía de inicio rápido para usar la consola.
Configura un proyecto de Google Cloud
-
Ve a la página Proyectos en la consola de Google Cloud.
- Crea un proyecto de Google Cloud nuevo o haz clic en el nombre del proyecto para abrir uno existente.
-
Abre una ventana de la terminal, configura tu proyecto como el proyecto predeterminado para Google Cloud CLI y reemplaza
MY_PROJECT_ID
por el ID de tu proyecto (no el nombre de tu proyecto):gcloud config set project MY_PROJECT_ID
-
Make sure that billing is enabled for your Google Cloud project.
También puedes obtener más información sobre los precios de Spanner.
-
Habilita 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
Select the tabs for how you plan to access the API:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
A fin de configurar la CLI de gcloud para usar la identidad temporal como cuenta de servicio y autenticarse en las APIs de Google, en lugar de tus credenciales de usuario, ejecuta el siguiente comando:
gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL
Para obtener más información, consulta Identidad temporal como cuenta de servicio.
Terraform
Para usar el código de Terraform en un entorno de desarrollo local, instala e inicializa gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
Para obtener más información, consulta Set up authentication for a local development environment.
Bibliotecas cliente
Para usar bibliotecas cliente en un entorno de desarrollo local, instala e inicializa gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
Para obtener más información, consulta Set up authentication for a local development environment.
Si deseas configurar tu archivo ADC local para usar la identidad temporal como cuenta de servicio a fin de autenticarte en las APIs de Google, en lugar de tus credenciales de usuario, ejecuta el siguiente comando:
gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL
Para obtener más información, consulta Identidad temporal como cuenta de servicio.
REST
Para usar la API de REST en un entorno de desarrollo local, debes usar las credenciales que proporcionas a gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .
Puedes usar la identidad temporal como cuenta de servicio a fin de generar un token de acceso para solicitudes de la API de REST. Para obtener más información, consulta Cuenta de servicio con identidad temporal.
Ejecuta Google Cloud CLI
Ahora que ya configuraste tu entorno de desarrollo y tu autenticación, ejecuta la herramienta de la línea de comandos de gcloud
para interactuar con Spanner:
gcloud spanner instance-configs list
Deberías ver una lista de las opciones de configuración de las instancias de Spanner a las que puede acceder tu proyecto, lo que incluye las configuraciones regionales, birregionales y multirregionales. Para obtener más información, consulta la descripción general de las instancias.
Terminaste la configuración.
¿Qué sigue?
Aprende a usar las bibliotecas cliente de Cloud y los controladores para crear una instancia, una base de datos, índices y tablas de Spanner. Luego, almacena, consulta y lee datos en Spanner.
- Comienza a usar Spanner en C++
- Comienza a usar Spanner en C#
- Comienza a usar Spanner en Go
- Comienza a usar Spanner en Java
- Comienza a usar Spanner en JDBC
- Comienza a usar Spanner en Node.js
- Comienza a usar Spanner en PHP
- Comienza a usar Spanner en Python
- Comienza a usar Spanner en Ruby
- Comienza a usar Spanner en REST
- Comienza a usar Spanner en gcloud
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-02-05 (UTC)