Configurar un entorno

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

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

Roles obligatorios

Para obtener los permisos que necesitas para usar e interactuar con las bases de datos de Spanner, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Configurar un Google Cloud proyecto

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

    Ir a la página Proyectos

  2. Crea un Google Cloud proyecto o abre uno que ya tengas haciendo clic en su nombre.

  3. Abre una ventana de terminal y define tu proyecto como el proyecto predeterminado de la CLI de Google Cloud. Para ello, sustituye MY_PROJECT_ID por el ID de tu proyecto (no por el nombre): 

    gcloud config set project MY_PROJECT_ID

  4. Verify that billing is enabled for your Google Cloud project.

    5. También puedes consultar los precios de Spanner.

  5. Habilita la API de Cloud Spanner en el proyecto.

    Habilita la API Cloud Spanner.

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

Configurar 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 la CLI de Google Cloud ejecutando el siguiente comando: 

gcloud init

Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Para configurar gcloud CLI de forma que use la suplantación de identidad de la cuenta de servicio para autenticarse en las APIs de Google en lugar de usar 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 el artículo Suplantación de identidad de cuentas de servicio.

Terraform

Para usar el código de Terraform en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

    Instala Google Cloud CLI.

    Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud 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 de cliente

Para usar bibliotecas de cliente en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

    Instala Google Cloud CLI.

    Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud 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.

Para configurar tu archivo ADC local de forma que use la suplantación de identidad de la cuenta de servicio para autenticarte en las APIs de Google en lugar de usar 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 el artículo Suplantación de identidad de cuentas de servicio.

REST

Para usar la API REST en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.

    Instala Google Cloud CLI.

    Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Puedes usar la suplantación de identidad de una cuenta de servicio para generar un token de acceso para las solicitudes de la API REST. Para obtener más información, consulta el artículo Cuenta de servicio suplantada.

Ejecutar Google Cloud CLI

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

gcloud spanner instance-configs list

Debería ver una lista de las configuraciones de instancias de Spanner a las que puede acceder su proyecto, incluidas las configuraciones regionales, birregionales y multirregionales. Para obtener más información, consulta la descripción general de las instancias.

¡Has completado la configuración!

Siguientes pasos

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