Guía de inicio rápido: 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 Google Cloud Console.

Antes de comenzar

  • Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  • En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  • En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  • 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.

Crear una base de datos

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

  2. Selecciona un modo de base de datos.

    Cuando creas una base de datos de Firestore nueva, 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 para seleccionar un modo de base de datos y acceder a una comparación de características, consulta cómo elegir entre el modo nativo y el modo Datastore.

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

    Una ubicación multirregional maximiza la disponibilidad y durabilidad. Las ubicaciones regionales ofrecen una latencia de escritura más baja. Para obtener más información sobre los tipos de ubicación, 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 para tu proyecto de Google Cloud.

    Haga clic en Crear base de datos. Una vez que la base de datos termina de inicializarse, Google Cloud Console te dirige a la página Entidades de Datastore.

Almacenar datos

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

    Ir a la página Entidades

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

  2. Haga 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 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 Más información sobre Datastore.
    creado Fecha y hora (la fecha de hoy)
    done Booleano Falso
    Ahora, su página de creación debería verse así:

    La ventana de creación de entidades con varias propiedades configuradas

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

Acabas de almacenar datos en tu base de datos.

Ejecute una consulta

Las bases de datos en modo Datastore admiten consultas de datos por tipo o mediante Google Query Language (GQL). En las siguientes instrucciones, se explica cómo usar ambas consultas en la base de datos.

Ejecuta consultas por categoría

  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. Haga clic en Agregar cláusula de consulta.
  2. En las listas desplegables, selecciona WHERE, done, ==, booleano y false.
  3. Haga clic en Ejecutar. Los resultados muestran la entidad Task que creaste, ya que su valor done es false. Una consulta de tipo con un filtro aplicado
  4. Ahora cambia la cláusula de consulta a WHERE, done, ==, booleana y true. Haga clic en Ejecutar. Los resultados no incluyen la entidad Task que creaste, porque su valor done no es true.

Ejecuta consultas de 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.

Agrega un filtro de consulta para restringir los resultados a entidades que cumplan con 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 creaste, ya que su valor done es false. Una consulta de GQL con un filtro aplicado
  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. Haga clic en Borrar para quitar cualquier cláusula de consulta.
  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 esté en el menú Más acciones . Una vez borrada, la entidad se quita de forma permanente de tu base de datos.

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

¿Qué sigue?