Guía de inicio rápido

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

Antes de comenzar

  • Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  • Selecciona o crea un proyecto de GCP.

    Ir a la página Administrar recursos

  • 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 Propietario de Cloud Datastore, que contiene el permiso datastore.databases.create necesario para crear una instancia en modo 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 asignarla con una función de IAM personalizada.

Crea una base de datos

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

Cloud Firestore: modo nativo o modo Datastore

Cuando creas una nueva base de datos de Cloud Firestore, tienes la opción de usar Cloud Firestore en modo nativo o en modo Datastore.

Selecciona una de las opciones de bases de datos:

  • Cloud Firestore en modo nativo

    Usa Cloud Firestore en modo nativo para apps móviles y web. Para comenzar con Cloud Firestore, continúa con la guía de inicio rápido de Cloud Firestore.

  • Cloud Firestore en modo Datastore

    Usa Cloud Firestore en modo Datastore para proyectos de servidor nuevos. Selecciona Cloud Firestore en modo Datastore para usar la capa de almacenamiento de Cloud Firestore mejorada y mantener el comportamiento del sistema en modo Datastore.

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.

Almacena datos

  1. Dirígete a la página Entidades de Datastore en Google Cloud Platform Console.
    Ir a la página Entidades de Datastore
    Esta página te permite almacenar, consultar, actualizar y borrar datos.
  2. Haz clic en Crear entidad (Create an entity).
  3. Si ves la página siguiente, debes seleccionar una ubicación. (Continúa con el paso siguiente si no ves esta página).

    Captura de pantalla de la página Seleccionar una ubicación

    La ubicación se aplica tanto a las bases de datos en modo Datastore, como a las apps de App Engine para tu proyecto de Google Cloud Platform.
    Para guardar una ubicación, selecciona uno de los valores de ubicación y haz clic en Siguiente (Next).

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

  5. Escribe Task en Categoría (Kind).

  6. En Propiedades (Properties), usa el botón Agregar propiedad (Agregar propiedad) para agregar estas propiedades:

    Nombre Tipo Valor Indexado
    description String Aprende sobre el modo Google Datastore
    created Fecha y hora (la fecha de hoy)
    done Booleano Falso
    Ahora, tu página de creación debería verse así:

    Captura de pantalla de la ventana de creación de entidades con las propiedades definidas

  7. Haz clic en Crear (Create). 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 categoría o mediante Google Query Language (GQL). Las siguientes instrucciones te indicarán los pasos necesarios para realizar ambos procesos.

Ejecuta consultas por categoría

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

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

A continuación, agrega un filtro de consulta para restringir los resultados a entidades que cumplan con ciertos criterios:

  1. Haz clic en Filtrar entidades (Filter entities).
  2. En las listas desplegables, selecciona done, es booleano (is a boolean) y que es falso (that is false).
  3. Haz clic en Aplicar filtros (Apply filters). Los resultados muestran la entidad Task que creaste, ya que su valor done es false. Captura de pantalla de una consulta de categoría con un filtro aplicado
  4. Ahora, intenta realizar una consulta con done, es booleano y que es verdadero. 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.

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

De nuevo, 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. Captura de pantalla de 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 y asegúrate de que Task sea la categoría seleccionada.
  2. Haz clic en Borrar filtros.
  3. Selecciona la entidad Task que creaste
  4. Haz clic en Borrar y confirma que deseas borrar la entidad Task. 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.

Próximos pasos

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Documentación de Cloud Datastore