Accede a tu base de datos

En esta página, se describe cómo acceder a una base de datos de Firestore en modo Datastore desde diferentes y plataformas de Google Cloud.

Antes de comenzar

En este documento, se supone que ya creaste una base de datos en modo Datastore. Si no creaste una base de datos, sigue las instrucciones de Firestore en modo Datastore Guía de inicio rápido.

Accede a tu base de datos desde App Engine

A fin de comenzar con el modo Datastore y App Engine, consulta una de las siguientes páginas específicas para cada lenguaje:

Entorno estándar de App Engine Entorno flexible de App Engine

Permisos del modo Datastore para App Engine

Las apps de App Engine pueden acceder a una base de datos en modo Datastore en el mismo proyecto de forma predeterminada. Cada aplicación de App Engine usa un servicio predeterminado de App Engine cuenta para administrar el acceso a Google Cloud servicios, como Firestore. De forma predeterminada, la cuenta de servicio predeterminada de App Engine tiene el rol de IAM de editor de proyectos, que incluye acceso completo de lectura y escritura al modo Datastore.

Puedes modificar los permisos de IAM de tu cuenta de servicio predeterminada de App Engine, pero tu app puede perder el acceso a Firestore, a menos que asignes una función de IAM con los permisos requeridos de Firestore. Por ejemplo, los roles de IAM propietario de Datastore y usuario de Datastore otorgan acceso de lectura y escritura a Firestore en modo Datastore.

Si inhabilitas o borras la cuenta de servicio predeterminada de App Engine, tu app de App Engine perderá el acceso a la base de datos en modo Datastore. Si inhabilitaste tu cuenta de servicio de App Engine, puedes volver a habilitarla. Consulta cómo habilitar una cuenta de servicio. Si borraste tu cuenta de servicio de App Engine en los últimos 30 días, puedes restablecerla. Para ello, consulta cómo recuperar una cuenta de servicio.

Accede a tu base de datos desde una instancia de Compute Engine

En esta sección, se muestra cómo activar y acceder a una base de datos en modo Datastore desde una instancia de VM de Compute Engine en un proyecto nuevo o existente.

Permisos del modo Datastore para Compute Engine

Las apps de Compute Engine pueden acceder a una base de datos en modo Datastore del mismo proyecto de forma predeterminada. Cada app de Compute Engine usa una cuenta de servicio predeterminada de Compute Engine para administrar el acceso a los servicios de Google Cloud, como Firestore. De forma predeterminada, la cuenta de servicio predeterminada de Compute Engine tiene el rol de IAM de Editor de proyecto, que incluye acceso completo de lectura y escritura al modo Datastore.

Completa los siguientes pasos para acceder a tu base de datos desde una instancia de Compute Engine:

  1. Habilita la API de Google Compute Engine para tu proyecto.
    Habilita la API de Compute Engine

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

  3. Crea una instancia de Compute Engine.

Console

  1. En la consola de Google Cloud, ve a la página Instancias de VM.
  2. Haz clic en el botón Crear instancia.
  3. En la sección Identidad y acceso a la API, configura Alcance del acceso para proporcionar acceso a Datastore. Haz clic en Permitir el acceso total a todas las API de Cloud a fin de otorgar acceso a todas las API de Google Cloud o haz clic en Configurar el acceso para cada API, haz clic en el menú desplegable Datastore y, luego, en Habilitado si quieres otorgar acceso a Datastore.
  4. Haz clic en el botón Crear para crear la instancia de VM.
  5. Confirma que tu instancia se esté ejecutando.
  6. Para usar esta nueva instancia de VM de Compute Engine, conéctate a ella mediante tu navegador.

gcloud

  1. Si aún no lo has hecho, instala la Google Cloud CLI y configura gcloud compute.

  2. Agrega una instancia de VM de Compute Engine y, luego, iníciala con las instrucciones iniciar una instancia en la documentación de Compute Engine. Especifica el ID del proyecto, el nombre de la instancia de VM y el alcance cloud-platform o datastore, como se muestra en el siguiente ejemplo.

    export PROJECT_ID=[YOUR_PROJECT_ID]
export INSTANCE_NAME=[YOUR_INSTANCE_NAME]
gcloud compute instances create $INSTANCE_NAME --project $PROJECT_ID --scopes datastore

    Reemplaza [YOUR_PROJECT_ID] por el ID del proyecto que creaste anteriormente y [YOUR_INSTANCE_NAME] por el nombre que deseas usar para tu instancia de VM.

  3. Confirma que tu instancia se esté ejecutando.

  4. Para utilizar esta nueva instancia de VM, conéctate a la VM.

Ahora, todos los servicios y las autorizaciones están configurados para tu proyecto y puedes comenzar a escribir código o explorar la API.

Cómo acceder a tu base de datos desde otra plataforma

En esta sección, se muestra cómo acceder a la base de datos en modo Datastore desde una aplicación externa que se ejecuta en una plataforma fuera de Google Cloud.

Primero, crea una cuenta de servicio:

  1. En la consola de Google Cloud, ve a la página Crear cuenta de servicio.

    Ve a Crear cuenta de servicio

  2. Selecciona un proyecto

  3. Escribe un nombre en el campo Nombre de cuenta de servicio. El La consola de Google Cloud completa el campo ID de cuenta de servicio según esta de la fuente de datos.

  4. Opcional: en el campo Descripción de la cuenta de servicio, ingresa una descripción.

  5. Haz clic en Crear.

  6. Haz clic en el campo Seleccionar una función.

    En Todas las funciones, selecciona una función que otorgue acceso a tu base de datos, como Datastore > Usuario de Cloud Datastore.

  7. Haga clic en Continuar.

  8. Haz clic en Listo para terminar de crear la cuenta de servicio.

    No cierres la ventana del navegador. La usarás en el siguiente procedimiento.

Luego, crea una clave de cuenta de servicio:

  1. En la consola de Google Cloud, haz clic en la dirección de correo electrónico de la cuenta de servicio que creaste.
  2. Haga clic en Claves.
  3. Haz clic en Agregar clave -> Crear nueva clave.
  4. Haz clic en Crear. Se descargará un archivo de claves JSON en tu computadora.
  5. Haga clic en Cerrar.

Usa esta cuenta de servicio para configurar las credenciales de tu código de la aplicación, como se describe en la página sobre cómo proporcionar credenciales de cuenta de servicio.

Cuotas y facturación

Ofrecemos determinado valor de cuota gratuita, como se describe en Precios y cuota. Esto significa que no tienes que habilitar la facturación a fin de comenzar o para usar Firestore en modo Datastore si te mantienes dentro de los límites de cuota gratuita. Sin embargo, si necesitas más recursos de los que proporciona la debes habilitar la facturación.

¿Qué sigue?

Para habilitar la facturación, consulta Habilita la facturación para un proyecto.