Almacena y consulta datos en Firestore en modo Datastore

Almacena y consulta datos en Firestore en modo Datastore

En esta página, se muestra cómo almacenar y consultar datos en Firestore en modo Datastore con la consola de Google Cloud .

Antes de comenzar

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

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

  • Tu cuenta requiere la función de propietario de Datastore, que contiene el permiso datastore.databases.create necesario para crear una instancia de Datastore.
  • El modo Datastore requiere una aplicación activa de App Engine. Si el proyecto no tiene una aplicación, esta guía de inicio rápido crea una para ti. En ese caso, necesitas el permiso appengine.applications.create. El propietario del proyecto puede asignar este permiso con una función de IAM personalizada.

Crea una base de datos

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

2. Selecciona un modo de base de datos.

   Cuando creas una nueva base de datos de Firestore, tienes la opción de usar Firestore en modo nativo o en modo Datastore. No puedes usar ambos modos en el mismo proyecto.

   Selecciona una de las opciones de bases de datos:

   • Firestore en modo nativo

     Se recomienda para aplicaciones web y para dispositivos móviles. Para comenzar con Firestore, continúa en la Guía de inicio rápido de Firestore.

   • Firestore en modo Datastore

     Se recomienda para arquitecturas de apps con servidores de backend.

   Si quieres obtener más orientación acerca de cómo seleccionar un modo de bases de datos y ver una comparación entre características, consulta la página sobre las consideraciones para elegir entre el modo nativo y el modo Datastore.

3. Selecciona una ubicación para 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 a las bases de datos del modo Datastore y a las apps de App Engine de tu Google Cloud proyecto.

   Advertencia: Una vez que crees tu base de datos, no podrás cambiar la ubicación.

   Haz clic en Crear base de datos. Una vez que finalice la inicialización de la base de datos, la consolaGoogle Cloud te redireccionará a la página Entidades de Datastore.

Almacenar datos

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

   Ir a la página Entidades

   Esta página te permite almacenar, consultar, actualizar y borrar datos.

2. Haz clic en Create entity.

3. En la página Create an entity (Crear una entidad), usa [default] en Namespace (Espacio de nombres).

4. Escribe Task en el campo Kind. Deja el identificador de clave establecido en el valor predeterminado de Numeric ID (auto-generated).

5. En Propiedades, usa el botón Agregar propiedad para agregar estas propiedades:

   Nombre	Tipo	Valor	Indexado
   description	String	Obtén más información sobre Datastore.
   created	Fecha y hora	(la fecha de hoy)	✓
   done	Booleano	Falso	✓

   Ahora tu página de creación debería verse así:

   

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

Acabas de almacenar datos en tu base de datos.

Ejecuta una consulta

Las bases de datos en modo Datastore permiten consultar datos por tipo o mediante Google Query Language (GQL). Las instrucciones que se indican a continuación te guiarán para usar ambos métodos y consultar tu base de datos.

Ejecuta consultas por tipo

1. Haz clic en Consulta por tipo (Query by kind).
2. Selecciona Task como el tipo.

Los resultados de la consulta muestran la entidad Task que creaste.

A continuación, agrega una cláusula de consulta para restringir los resultados a entidades que cumplan con ciertos criterios:

1. Haz clic en Agregar 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 creaste, ya que su valor done es false.
4. Ahora cambia la cláusula de consulta a WHERE, done, ==, boolean y true. Haz clic en Ejecutar. Los resultados no incluyen la entidad Task que creaste, porque su valor done no es true.

Ejecuta consultas en GQL

1. Haz clic en Consulta por GQL (Query by GQL).
2. Ingresa SELECT * FROM Task como la consulta. Ten en cuenta que Task distingue entre mayúsculas y minúsculas.
3. Haz clic en Ejecutar consulta (Run query).

Los resultados de la consulta muestran la entidad Task que creaste.

Sugerencia

El editor de consultas de GQL es compatible con la función de autocompletado de categorías. Cuando necesites escribir el nombre de una categoría, presiona Ctrl + Espacio para ver una lista de las categorías disponibles. En la lista, pueden mostrarse hasta 300 categorías en orden alfabético. Para obtener mejores resultados, escribe uno o más caracteres.

Agrega un filtro de consulta para restringir los resultados a entidades que cumplan con ciertos criterios:

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 creaste, 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 creaste, porque su valor done no es true.

Realiza una limpieza

1. Haz clic en Consulta por categoría (Query by kind) y asegúrate de que Task sea la categoría seleccionada.
2. Haz clic en Borrar para quitar las cláusulas de búsqueda.
3. Selecciona la entidad Task que creaste.
4. Haz clic en Borrar y confirma que deseas borrar la entidad Task. Según el tamaño de la ventana del navegador, es posible que Borrar se encuentre en el menú Más acciones de . Una vez borrada, la entidad se quita de forma permanente de la base de datos.

Eso es todo, finalizaste la guía de inicio rápido.

¿Qué sigue?

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