Edit an entity in the console

This page describes how to edit an entity using the Google Cloud console .

To learn how to modify an entity programmatically, see Updating an entity .

Before you begin

This page assumes you have already created an entity that is stored in Firestore in Datastore mode. You can create an entity through the Datastore API as described in Getting Started with the Datastore API , or through the entity editor in the Google Cloud console as described in the Quickstart .

Select an entity to edit

1. In the Google Cloud console, go to the Databasespage.

   Go to Databases

2. Select the required database from the list of databases.

3. In the navigation menu, click Datastore Studio.

4. Find the entity you want to edit by specifying the namespace, kind, and/or filters for property values. To learn how, see Run a query .

5. Click on the Name/IDof an entity. Your screen should look similar to the following:

   

Edit a property

1. Open the Edit Entitypage for an entity. Under Properties, click Edit edit for the property you want to edit.

2. In the Edit propertypane, modify the property's Name, Type, or Value. You can also modify whether the property is indexed. To learn about the impact of including or excluding a property from indexes, see Excluded properties .

   

3. Click Done. The Edit propertypane closes and the properties table now shows your changes. Changes are not committed to the database until you click Save. The properties table highlights uncommitted changes with a blue dot next to the property name.

4. Make additional changes to other properties. When you complete your edits, click Saveto commit your changes to the database.

   The console commits your changes and takes you back to the Datastore Studiopage.

Add a property

1. Open the Edit Entitypage for an entity. Click Add property.
2. In the Add a propertypane, specify a name for the property.
3. Select a type for the property's data type.
4. Specify a value for the property.

5. Specify whether the property is indexed. To learn about the impact of including or excluding a property from indexes, see Excluded properties .

   

6. Click Add. The Add a propertypane closes and the properties table now shows your changes. Changes are not committed to the database until you click Save. The properties table highlights uncommitted changes with a blue dot next to the property name.

7. Make additional changes to other properties. When you complete your edits, click Saveto commit your changes to the database.

   The console commits your changes and takes you back to the Datastore Studiopage.

Delete a property

1. Open the Edit Entitypage for an entity. Under Properties, click Delete delete for the property you want to delete.

   

2. The properties table now shows your changes. Changes are not committed to the database until you click Save. The properties table highlights uncommitted property deletions with crossed out names and property values.

   You can undo an uncommitted deletion by clicking Restorein the property's table row.

3. Make additional changes to other properties. When you complete your edits, click Saveto commit your changes to the database.

Complex properties

The entity editor supports properties with complex types such as Array and Embedded entity .

Array properties

When you add or modify the value of an Array property, provide a value in JSON format.

If you enter invalid JSON for the Valuefield you will receive an error message. You will not be able to add the property if the JSON is invalid.

Embedded entity properties

When you add or modify the value of an Embedded entity property, provide a value in JSON format.

If you enter invalid JSON for the Valuefield you will receive an error message. You will not be able to add the property if the JSON is invalid.

What's next

• Learn about best practices for entities .