Almacenar y consultar datos en Firestore en modo Datastore

Antes de empezar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

• Si no eres el propietario del proyecto, tu cuenta debe tener los siguientes permisos para completar esta guía de inicio rápido:

  • Tu cuenta requiere el rol Propietario de Datastore que contiene el permiso datastore.databases.create necesario para crear una instancia en modo Datastore.
  • El modo Datastore requiere una aplicación de App Engine activa. Si el proyecto no tiene ninguna aplicación, esta guía de inicio rápido creará una. En ese caso, necesitas el permiso appengine.applications.create. El propietario del proyecto puede asignar este permiso con un rol personalizado de gestión de identidades y accesos.

Crear una base de datos

1. Para crear una instancia de base de datos, abre la sección Datastore de la Google Cloud consola
   . Ve a la página Datastore

2. Selecciona un modo de base de datos.

   Cuando creas una base de datos de Firestore, puedes usar Firestore en modo nativo o en modo Datastore. No puedes usar ambos modos en el mismo proyecto.

   Selecciona una de las opciones de base de datos:

   • Firestore en modo nativo

     Opción recomendada para aplicaciones móviles y web. Para empezar a usar Firestore, sigue las instrucciones de la guía de inicio rápido de Firestore.

   • Firestore en modo Datastore

     Recomendado para arquitecturas de aplicaciones con servidores backend.

   Para obtener más información sobre cómo seleccionar un modo de base de datos y una comparación de las funciones, consulta Elegir entre el modo nativo y el modo Datastore.

3. Selecciona una ubicación de la base de datos. El modo Datastore admite ubicaciones multirregionales y regionales.

   Una ubicación multirregional maximiza la disponibilidad y la durabilidad. Las ubicaciones regionales ofrecen una latencia de escritura más baja. Para obtener más información sobre los tipos de ubicaciones, consulta Ubicaciones del modo Datastore. La ubicación se aplica tanto a las bases de datos en modo Datastore como a las aplicaciones de App Engine de tu Google Cloud proyecto.

   Haz clic en Crear base de datos. Una vez que se haya inicializado la base de datos, la consolaGoogle Cloud te dirigirá a la página Entidades de Datastore.

Datos del almacén

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

   Ir a la página Entidades

   En esta página puedes almacenar, consultar, actualizar y eliminar datos.

2. Haz clic en Crear entidad.

3. En la página Crear una entidad, usa [default] en Espacio de nombres.

4. Escribe Task en el campo Tipo. En Identificador de clave, deja el valor predeterminado Numeric ID (auto-generated).

5. En Propiedades, use el botón Añadir propiedad para añadir estas propiedades:

   Nombre	Tipo	Valor	Indexada
   description	Cadena	Consulta información sobre Datastore.
   creado	Fecha y hora	(fecha actual)	✓
   listo	Booleano	Falso	✓

   La página de creación debería tener este aspecto:

   

6. Haz clic en Crear. En la consola se muestra la entidad Task que acabas de crear.

Acabas de almacenar datos en tu base de datos.

Ejecutar una consulta

Las bases de datos en modo Datastore admiten consultas de datos por tipo o por lenguaje de consulta de Google (GQL). En las instrucciones que se indican a continuación se explica cómo usar ambos métodos para consultar tu base de datos.

Ejecutar consultas de tipo

1. Haga clic en Consultar por tipo.
2. Selecciona Task como tipo.

Los resultados de la consulta muestran la entidad Task que has creado.

A continuación, añade una cláusula de consulta para restringir los resultados a las entidades que cumplan criterios específicos:

1. Haz clic en Añadir cláusula de consulta.
2. En las listas desplegables, selecciona WHERE, done, ==, booleano y falso.
3. Haz clic en Ejecutar. Los resultados muestran la entidad Task que has creado, ya que su valor done es false.
4. Ahora, cambia la cláusula de consulta a WHERE, done, ==, booleano y true. Haz clic en Ejecutar. Los resultados no incluyen la entidad Task que has creado porque su valor done no es true.

Ejecutar consultas de GQL

1. Haz clic en Consulta por GQL.
2. Introduce SELECT * FROM Task como consulta. Ten en cuenta que Task distingue entre mayúsculas y minúsculas.
3. Haz clic en Realizar una consulta.

Los resultados de la consulta muestran la entidad Task que has creado.

Añade un filtro de consulta para restringir los resultados a las entidades que cumplan criterios específicos:

1. Ejecuta una consulta como SELECT * FROM Task WHERE done=false. Ten en cuenta que Task y done distinguen entre mayúsculas y minúsculas. Los resultados muestran la entidad Task que has creado, ya que su valor done es false.
2. Ahora, ejecuta una consulta como SELECT * FROM Task WHERE done=true. Los resultados no incluyen la entidad Task que ha creado porque su valor done no es true.

Limpieza

1. Haz clic en Consultar por tipo y asegúrate de que Task sea el tipo seleccionado.
2. Haga clic en Borrar para quitar las cláusulas de consulta.
3. Seleccione la entidad Task que ha creado.
4. Haz clic en Eliminar y, a continuación, confirma que quieres eliminar la entidad Task. En función del tamaño de la ventana del navegador, es posible que la opción Eliminar se encuentre en el menú more_vert Más acciones. Una vez eliminada, la entidad se quitará permanentemente de tu base de datos.

¡Ya has completado esta guía de inicio rápido!

Siguientes pasos

• Consulta más información sobre las consultas de Datastore.
• Consulta más información sobre las bases de datos en modo Datastore.