Guía de inicio rápido

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

Antes de comenzar

  • Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  • Select or create a Google Cloud Platform project.

    Go to the Manage resources page

  • 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 Cloud Datastore, la cual contiene el permiso datastore.databases.create necesario para crear una instancia de Cloud Datastore.
    • Cloud Datastore requiere una aplicación de App Engine activa. 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 asignarlo con una función de IAM personalizada.

Selecciona 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 de Cloud Datastore

Cloud Firestore o Cloud Datastore

Cuando creas una base de datos nueva en Cloud Datastore, tienes la opción de seguir usándolo o de actualizar a Cloud Firestore. Cloud Firestore es la nueva versión de Cloud Datastore, la cual incluye varias mejoras y funciones nuevas. Cloud Firestore es un superconjunto de Cloud Datastore y puede ejecutarse en un modo Datastore compatible con versiones anteriores.

Selecciona una de las opciones de bases de datos:

  • Cloud Firestore en modo nativo

    Si no tienes inconvenientes con utilizar un producto en versión Beta, te recomendamos Cloud Firestore en modo nativo para aplicaciones web y móviles. Para comenzar con Cloud Firestore, continúa en la Guía de inicio rápido de Cloud Firestore.

  • Cloud Firestore en modo Datastore

    Si no tienes inconvenientes en usar un producto en versión Beta, usa Cloud Firestore en modo Datastore para los proyectos de servidor nuevos. Selecciona Cloud Firestore en modo Datastore para aprovechar su capa de almacenamiento mejorada y mantener el comportamiento del sistema de Cloud Datastore.

  • Cloud Datastore

    Si tu aplicación requiere un Acuerdo de Nivel de Servicio (ANS), elige Cloud Datastore.

Para obtener más información sobre cómo seleccionar una base de datos y acceder a una comparación de características, consulta cómo elegir entre Cloud Firestore y Cloud Datastore.

Almacena datos

  1. Ve a la página de entidades de Datastore en Google Cloud Platform Console.
    Ve a la página de entidades de Datastore
    Esta página te permite almacenar, consultar, actualizar y borrar datos.
  2. Haz clic en Crear entidad.
  3. Si ves la página siguiente, debes seleccionar una ubicación. (Ve al siguiente paso si no ves esta página).

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

    La ubicación se aplica a Cloud Datastore y a App Engine para tu proyecto de Google Cloud Platform.
    Para guardar una ubicación, selecciona uno de los valores y haz clic en Siguiente.

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

  5. Escribe Task en Categoría.

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

    Nombre Tipo Valor Indexado
    description String Aprender Google Cloud Datastore
    created Date and time (la fecha de hoy)
    done Boolean 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. La consola muestra la entidad Task que acabas de crear.

Ya almacenaste datos en Cloud Datastore.

Ejecuta una consulta

Cloud Datastore permite 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 tipo

  1. Haz clic en Consulta por tipo.
  2. Selecciona el tipo Task.

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.
  2. En las listas desplegables, selecciona done, es un booleano y que es falso.
  3. Haz clic en Aplicar filtros. Los resultados muestran la entidad Task que creaste, ya que su valor done es false. Captura de pantalla de una consulta de tipo con un filtro aplicado
  4. Ahora, intenta con una consulta con done, es un booleano y que es verdadero. Los resultados no incluyen la entidad Task que creaste, ya que su valor done no es true.

Ejecuta consultas de GQL

  1. Haz clic en Consulta por 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, ya que su valor done no es true.

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 luego confirma que deseas borrar la entidad Task. Una vez borrada, la entidad se quita de Cloud Datastore de forma permanente.

La entidad Task que creaste antes se borra de Cloud Datastore.

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

¿Qué sigue?

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación de Cloud Datastore