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 Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.create permission.Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.create permission.Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

• If you arenot the project owner, your account requires the following permissions to complete this quickstart:

  • Your account requires theDatastore Owner role which contains thedatastore.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 theappengine.applications.create permission. The project owner can assign this permission with anIAM custom role.

Create a database

1. To create a new database instance, open the Datastore sectionin the Google Cloud console:
   Go to the Datastore page

2. Select a database mode.

   When you create a new Firestore database, you have the option to useFirestore in either Native Mode or Datastore mode. You can't use bothmodes in the same project.

   Select from one of the database options:

   • Firestore in Native Mode

     Recommended for mobile and web apps. To get started with Firestore, continue in theFirestore Quickstart.

   • Firestore in Datastore Mode

     Recommended for app architectures with backend servers.

   For more guidance on selecting a database mode and for a feature-by-featurecomparison, seechoosing between Native Mode and Datastore Mode.

3. Select a database location. Datastore mode supports multi-regionand regional locations.

   A multi-region location maximizes availability and durability. Regionallocations offer lower write latency. To learn more about location types,seeDatastore mode locations.The location applies to both Datastore mode databases and App Engine apps foryour Google Cloud project.

   Warning: Once you create your database, you cannot change the location.

   ClickCreate database. After your database finishes initializing, theGoogle Cloud console directs you to the Datastore Entities page.

Store data

1. Go to the Datastore Entities page in the Google Cloud console.

   Go to the Entities page

   This page lets you store, query, update, and delete data.

2. ClickCreate entity.

3. On theCreate an entity page, use[default] forNamespace.

4. TypeTask in theKind field. LeaveKey identifier set to thedefault value ofNumeric ID (auto-generated).

5. UnderProperties, use theAdd property button to add these properties:

   Name	Type	Value	Indexed
   description	String	Learn about Datastore.
   created	Date and time	(today's date)	✓
   done	Boolean	False	✓

   Your creation page should now look like this:

   

6. ClickCreate. The console displays theTask entity that you just created.

You just stored data in your database!

Run a query

Datastore mode databases support querying data by kind or byGoogle Query Language (GQL). The instructions below walk you through using bothto query your database.

Run kind queries

1. ClickQuery by kind.
2. SelectTask as the kind.

The query results show theTask entity that you created.

Next, add a query clause to restrict the results to entities that meet specificcriteria:

1. ClickAdd query clause.
2. In the dropdown lists, selectWHERE,done,==,boolean, andfalse.
3. ClickRun. The results show theTask entity that youcreated since itsdone value isfalse.
4. Now change the query clause toWHERE,done,==,boolean, andtrue. ClickRun. The results do not include theTask entity that youcreated, because itsdone value is nottrue.

Run GQL queries

1. ClickQuery by GQL.
2. EnterSELECT * FROM Task as the query. Note thatTask is case sensitive.
3. ClickRun query.

The query results show theTask entity that you created.

Clean up

1. ClickQuery by kind and ensureTask is the selected kind.
2. ClickClear to remove any query clauses.
3. Select theTask entity that you created.
4. ClickDelete, and then confirm you want to delete theTask entity.Depending on the size of the browser window,Delete might be under themore_vertMore actions menu. Oncedeleted, the entity is permanently removed from your database.

That's it, you completed this quickstart!

What's next

• Learn more aboutDatastore Queries.
• Learn more aboutDatastore mode databases.