Cómo configurar tu entorno

En esta página, se explican los pasos de configuración necesarios para usar la API de Cloud Spanner con Google Cloud CLI, bibliotecas cliente y 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.

Roles obligatorios

Para obtener los permisos que necesitas para usar bases de datos de Spanner y trabajar con ellas, pídele a tu administrador que te otorgue los siguientes roles de IAM:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Configura un Google Cloud proyecto

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

    Ir a la página Proyectos

  2. Crea un proyecto Google Cloud nuevo o haz clic en el nombre del proyecto para abrir uno existente.
  3. Abre una ventana de la terminal y configura tu proyecto como el proyecto predeterminado para Google Cloud CLI. Reemplaza MY_PROJECT_ID por tu ID del proyecto (no el nombre de tu proyecto):

    gcloud config set project MY_PROJECT_ID
  4. Verify that billing is enabled for your Google Cloud project.

  5. También puedes obtener más información sobre los precios de Spanner.
  6. 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

Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI ejecutando el siguiente comando:

gcloud init

Si usas un proveedor de identidad externo (IdP), primero debes acceder a gcloud CLI con tu identidad federada.

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.

    Instala Google Cloud CLI.

    Si usas un proveedor de identidad externo (IdP), primero debes acceder a gcloud CLI con tu identidad federada.

    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.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

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.

    Instala Google Cloud CLI.

    Si usas un proveedor de identidad externo (IdP), primero debes acceder a gcloud CLI con tu identidad federada.

    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.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

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.

    Instala Google Cloud CLI.

    Si usas un proveedor de identidad externo (IdP), primero debes acceder a gcloud CLI con tu identidad federada.

Si deseas obtener más información, consulta Autentica para usar REST en la Google Cloud documentación de autenticación.

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 configuraciones de instancias de Spanner a las que puede acceder tu proyecto, incluidas 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 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.