Quickstart

This page shows you how to store and query data in Google Cloud Datastore using the Google Cloud Platform Console.

Before you begin

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.)
    Screenshot of the Select a location page

    The location applies to both Cloud Datastore and Google App Engine for your Google Cloud Platform project. You cannot change the location after it has been saved.
    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 Cloud Datastore
    created Date and time (today's date)
    done Boolean False
    Your creation page should now look like this:

    Screenshot of the entity creation window with properties set

  7. Click Create. The console displays the Task entity that you just created.

You just stored data in Cloud Datastore!

Run a query

Cloud Datastore supports 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. Screenshot of a kind query with a filter applied
  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. Screenshot of a GQL query with a filter applied
  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.

Clean up

  1. Click Query by kind and ensure Task is the selected kind.
  2. Click Clear filters.
  3. Select the Task entity that you created
  4. Click Delete, and then confirm you want to delete the Task entity. Once deleted, the entity is permanently removed from Cloud Datastore.

The Task entity that you previously created is deleted from Cloud Datastore.

That's it, you completed this quickstart!

What's next

Send feedback about...

Cloud Datastore Documentation