Acceder a la base de datos

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

Antes de empezar

En este documento se presupone que ya has creado una base de datos en el modo Datastore. Si no has creado ninguna base de datos, sigue las instrucciones de la guía de inicio rápido de Firestore en modo Datastore.

Acceder a tu base de datos desde App Engine

Para empezar a usar el modo Datastore y App Engine, consulta una de las siguientes páginas específicas de cada lenguaje:

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

Permisos del modo Datastore para App Engine

Las aplicaciones de App Engine pueden acceder a una base de datos en modo Datastore del mismo proyecto de forma predeterminada. Cada aplicación de App Engine usa una cuenta de servicio predeterminada de App Engine para gestionar el acceso a servicios como Firestore. Google CloudDe forma predeterminada, la cuenta de servicio predeterminada de App Engine tiene el rol de IAM Editor del proyecto, que incluye acceso completo de lectura y escritura al modo Datastore.

Puedes modificar los permisos de gestión de identidades y accesos de tu cuenta de servicio predeterminada de App Engine, pero es posible que tu aplicación pierda el acceso a Firestore a menos que le asignes un rol de gestión de identidades y accesos con los permisos de Firestore necesarios. Los roles de gestión de identidades y accesos Propietario de Datastore y Usuario de Datastore, por ejemplo, conceden acceso de lectura y escritura a Firestore en modo Datastore.

Si inhabilitas o eliminas la cuenta de servicio predeterminada de App Engine, tu aplicación de App Engine perderá el acceso a tu base de datos en modo Datastore. Si has inhabilitado tu cuenta de servicio de App Engine, puedes volver a habilitarla. Consulta cómo habilitar una cuenta de servicio. Si has eliminado tu cuenta de servicio de App Engine en los últimos 30 días, puedes restaurarla. Consulta cómo restaurar una cuenta de servicio.

Acceder 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 en uno que ya tengas.

Permisos del modo Datastore para Compute Engine

Las aplicaciones de Compute Engine pueden acceder a una base de datos en modo Datastore del mismo proyecto de forma predeterminada. Cada aplicación de Compute Engine usa una cuenta de servicio predeterminada de Compute Engine para gestionar el acceso a Google Cloud servicios como Firestore. De forma predeterminada, la cuenta de servicio predeterminada de Compute Engine tiene el rol de gestión de identidades y accesos Editor del proyecto, que incluye acceso completo de lectura y escritura al modo Datastore.

Para acceder a tu base de datos desde una instancia de Compute Engine, sigue estos pasos:

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

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

  3. Crea una instancia de Compute Engine.

Consola

  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 de API, define Permisos de acceso para proporcionar acceso a Datastore. Haz clic en Permitir acceso completo a todas las APIs de Cloud para conceder acceso a todas las APIs de Google Cloud o en Definir acceso para cada API, haz clic en el desplegable de Datastore y, a continuación, en Habilitado para conceder 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 con tu navegador.

gcloud

  1. Si aún no lo has hecho, instala la CLI de Google Cloud y configúralagcloud compute.

  2. Añade una instancia de VM de Compute Engine e iníciala siguiendo las instrucciones para iniciar una instancia de la documentación de Compute Engine. Especifica el ID del proyecto, el nombre de la instancia de VM y el cloud-platform o el datastore ámbito 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

    Sustituye [YOUR_PROJECT_ID] por el ID del proyecto que has creado anteriormente y [YOUR_INSTANCE_NAME] por el nombre que quieras usar para tu instancia de VM.

  3. Confirma que tu instancia se está ejecutando.

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

En este punto, todos los servicios y autorizaciones están configurados para tu proyecto y puedes empezar a escribir código o explorar la API.

Acceder a tu base de datos desde otra plataforma

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

Primero, crea una cuenta de servicio:

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

    Ir a Crear cuenta de servicio

  2. Selecciona un proyecto.

  3. En el campo Nombre de cuenta de servicio, escribe un nombre. La consola Google Cloud rellena el campo ID de cuenta de servicio con este nombre.

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

  5. Haz clic en Crear.

  6. Haz clic en el campo Selecciona un rol.

    En Todos los roles, selecciona un rol que conceda acceso a tu base de datos, como Datastore > Usuario de Cloud Datastore.

  7. Haz clic en Continuar.

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

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

A continuación, crea una clave de cuenta de servicio:

  1. En la Google Cloud consola, haz clic en la dirección de correo de la cuenta de servicio que has creado.
  2. Haz clic en Teclas.
  3. Haz clic en Añadir clave y, a continuación, en Crear clave.
  4. Haz clic en Crear. Se descargará un archivo de clave JSON en tu ordenador.
  5. Haz clic en Cerrar.

Usa esta cuenta de servicio para configurar las credenciales del código de tu aplicación, tal como se describe en el artículo Proporcionar credenciales de cuenta de servicio.

Cuotas y facturación

Se ofrece una cantidad determinada de cuota gratuita, tal como se describe en la página Precios y cuota. Esto significa que no es necesario habilitar la facturación para empezar a usar Firestore en el modo de Datastore hasta alcanzar los límites de la cuota gratuita. Sin embargo, si necesitas más recursos de los que ofrece la cuota gratuita, debes habilitar la facturación.

Siguientes pasos

Para habilitar la facturación, consulta el artículo Habilitar la facturación de un proyecto.