This page shows you how to store and query data in Firestore in Datastore mode using the Google Cloud Console.
Before you begin
-
Sign in to your Google Account.
If you don't already have one, sign up for a new account.
-
In the Google Cloud Console, on the project selector page, select or create a Google Cloud project.
-
If you are not the project owner, your account requires the following permissions to complete this quickstart:
- Your account requires the
Datastore Owner role
which contains the
datastore.databases.create
permission needed to create a Datastore mode instance. - Datastore mode requires an active App Engine application.
If the project doesn't have an application, this quickstart creates one
for you. In that case, you require the
appengine.applications.create
permission. The project owner can assign this permission with an IAM custom role.
- Your account requires the
Datastore Owner role
which contains the
Create a database
To create a new database instance, open the Datastore section
in the Google Cloud Console:
Go to the Datastore page
Firestore: Native Mode or Datastore Mode
When you create a new Firestore database, you have the option to use Firestore in Native Mode or in Datastore mode.
Select from one of the database options:
-
Firestore in Native Mode
Use Firestore in Native mode for mobile and web apps. To get started with Firestore, continue in the Firestore Quickstart.
-
Firestore in Datastore Mode
Use Firestore in Datastore Mode for new server projects. Select Firestore in Datastore Mode to use the improved Firestore storage layer while keeping Datastore mode system behavior.
For more guidance on selecting a database mode and for a feature-by-feature comparison, see choosing between Native Mode and Datastore Mode.
Store data
- Go to the Datastore Entities page in the Google Cloud Console.
Go to the Datastore Entities page
This page allows you to store, query, update, and delete data. - Click Create entity.
If you see the following page, you need to select a location. (Go to the next step if you do not see this page.)
The location applies to both Datastore mode databases and App Engine apps for your Google Cloud project.
To save a location, select one of the location values and click Next.On the Create an entity page, use
[default]
for Namespace.Type
Task
for Kind.Under Properties use the Add property button to add these properties:
Name Type Value Indexed description String Learn Google Datastore mode created Date and time (today's date) ✓ done Boolean False ✓ Click Create. The console displays the
Task
entity that you just created.
You just stored data in your database!
Run a query
Datastore mode databases support querying data by kind or by Google Query Language (GQL); the instructions below walk you through the steps of doing both.
Run kind queries
- Click Query by kind.
- Select
Task
as the kind.
The query results show the Task
entity that you created.
Next, add a query filter to restrict the results to entities that meet specific criteria:
- Click Filter entities.
- In the dropdown lists, select
done
, is a boolean, and that is false. - Click Apply filters. The results show the
Task
entity that you created, since itsdone
value isfalse
. - Now try a query of
done
, is a boolean, and that is true. The results do not include theTask
entity that you created, because itsdone
value is nottrue
.
Run GQL queries
- Click Query by GQL.
- Enter
SELECT * FROM Task
as the query. Note thatTask
is case sensitive. - Click Run query.
The query results show the Task
entity that you created.
Again, add a query filter to restrict the results to entities that meet specific criteria:
- Run a query such as
SELECT * FROM Task WHERE done=false
. Note thatTask
anddone
are case sensitive. The results show theTask
entity that you created, since itsdone
value isfalse
. - Now run a query such as
SELECT * FROM Task WHERE done=true
. The results do not include theTask
entity that you created, because itsdone
value is nottrue
.
Clean up
- Click Query by kind and ensure
Task
is the selected kind. - Click Clear filters.
- Select the
Task
entity that you created - Click Delete, and then confirm you want to delete the
Task
entity. Once deleted, the entity is permanently removed from your database.
That's it, you completed this quickstart!
What's next
- Learn more about Datastore Queries.
- Learn more about Datastore mode databases.