Quickstart

Create a database

To create a new database instance, open the Cloud Datastore section in the Google Cloud Platform Console:
Go to the Cloud Datastore page

Cloud Firestore: Native Mode or Datastore Mode

When you create a new Cloud Firestore database, you have the option to use Cloud Firestore in Native Mode or in Datastore mode.

Select from one of the database options:

• Cloud Firestore in Native Mode

  Use Cloud Firestore in Native mode for mobile and web apps. To get started with Cloud Firestore, continue in the Cloud Firestore Quickstart.

• Cloud Firestore in Datastore Mode

  Use Cloud Firestore in Datastore Mode for new server projects. Select Cloud Firestore in Datastore Mode to use the improved Cloud 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

1. Go to the Datastore Entities page in the Google Cloud Platform Console.
   Go to the Datastore Entities page
   This page allows you to store, query, update, and delete data.
2. Click Create entity.

3. 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 Platform project.
   To save a location, select one of the location values and click Next.

4. On the Create an entity page, use [default] for Namespace.

5. Type Task for Kind.

6. 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	✓

   Your creation page should now look like this:

   

7. 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

1. Click Query by kind.
2. 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:

1. Click Filter entities.
2. In the dropdown lists, select done, is a boolean, and that is false.
3. Click Apply filters. The results show the Task entity that you created, since its done value is false.
4. Now try a query of done, is a boolean, and that is true. The results do not include the Task entity that you created, because its done value is not true.

Run GQL queries

1. Click Query by GQL.
2. Enter SELECT * FROM Task as the query. Note that Task is case sensitive.
3. 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:

1. Run a query such as SELECT * FROM Task WHERE done=false. Note that Task and done are case sensitive. The results show the Task entity that you created, since its done value is false.
2. Now run a query such as SELECT * FROM Task WHERE done=true. The results do not include the Task entity that you created, because its done value is not true.