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.
Si todavía no tienes una cuenta, regístrate para obtener una nueva.
-
En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.
-
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.
- Tu cuenta requiere la función de propietario de Datastore, que contiene el permiso
Crea una base de datos
Para crear una instancia de base de datos nueva, abre la sección Datastore en Google Cloud Console:
Ir a la página Datastore
Firestore: modo nativo o modo Datastore
Cuando creas una nueva base de datos de Firestore, tienes la opción de usar Firestore en modo nativo o en modo Datastore.
Selecciona una de las opciones de bases de datos:
-
Firestore en modo nativo
Usa Firestore en modo nativo para aplicaciones web y móviles nuevas. Para comenzar con Firestore, continúa en la Guía de inicio rápido de Firestore.
-
Firestore en modo Datastore
Usa Firestore en modo Datastore para nuevos proyectos de servidor. Selecciona Firestore en modo Datastore para usar la capa de almacenamiento de Firestore mejorada y, al mismo tiempo, 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.
Almacene los datos
- Ve a la página Entidades de Datastore en Google Cloud Console.
Ir a la página Entidades de Datastore
Esta página te permite almacenar, consultar, actualizar y borrar datos. - Haz clic en Crear entidad (Create an entity).
Si ves la página siguiente, debes seleccionar una ubicación. (Continúa con el paso siguiente si no ves esta página).
La ubicación se aplica a las bases de datos del modo Datastore y a las apps de App Engine de tu proyecto de Google Cloud.
A fin de guardar una ubicación, selecciona uno de los valores de ubicación y haz clic en Next (Siguiente).En la página Create an entity (Crear una entidad), usa
[default]
en Namespace (Espacio de nombres).Escribe
Task
en Categoría (Kind).En Properties (Propiedades), usa el botón Add property (Agregar propiedad) para agregar estas propiedades:
Nombre Tipo Valor Indexado description String Aprende sobre el modo Google Datastore creado Fecha y hora (la fecha de hoy) ✓ done Booleano Falso ✓ 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:
- Haz clic en Consulta por tipo (Query by kind).
- 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:
- Haz clic en Filter entities (Filtrar entidades).
- En las listas desplegables, selecciona
done
, es booleano (is a boolean) y que es falso (that is false). - Haz clic en Aplicar filtros (Apply filters). Los resultados muestran la entidad
Task
que creaste, ya que su valordone
esfalse
. - Ahora, intenta realizar una consulta con
done
, is a boolean (es un booleano) y that is true (que es verdadero). Los resultados no incluyen la entidadTask
que creaste, porque su valordone
no estrue
.
Ejecuta consultas de GQL
- Haz clic en Consulta por GQL (Query by GQL).
- Ingresa
SELECT * FROM Task
como la consulta. Ten en cuenta queTask
distingue entre mayúsculas y minúsculas. - Haz clic en Ejecutar consulta (Run query).
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:
- Ejecuta una consulta como
SELECT * FROM Task WHERE done=false
. Ten en cuenta queTask
ydone
distinguen entre mayúsculas y minúsculas. Los resultados muestran la entidadTask
que creaste, ya que su valordone
esfalse
. - Ahora, ejecuta una consulta como
SELECT * FROM Task WHERE done=true
. Los resultados no incluyen la entidadTask
que creaste, porque su valordone
no estrue
.
Realiza una limpieza
- Haz clic en Consulta por categoría (Query by kind) y asegúrate de que
Task
sea la categoría seleccionada. - Haz clic en Borrar filtros.
- Selecciona la entidad
Task
que creaste - 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.
¿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 .