Upsert

Use an upsert.

Explore further

For detailed documentation that includes this code sample, see the following:

Entities, Properties, and Keys

Code sample

C#

To learn how to install and use the client library for Datastore mode, see Datastore mode client libraries . For more information, see the Datastore mode C# API reference documentation .

To authenticate to Datastore mode, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .

  _db 
 . 
 Upsert 
 ( 
 _sampleTask 
 );

Go

To learn how to install and use the client library for Datastore mode, see Datastore mode client libraries . For more information, see the Datastore mode Go API reference documentation .

To authenticate to Datastore mode, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .

  key 
  
 := 
  
 datastore 
 . 
 IncompleteKey 
 ( 
 "Task" 
 , 
  
 nil 
 ) 
 key 
 , 
  
 err 
  
 := 
  
 client 
 . 
 Put 
 ( 
 ctx 
 , 
  
 key 
 , 
  
 task 
 )

Java

To learn how to install and use the client library for Datastore mode, see Datastore mode client libraries . For more information, see the Datastore mode Java API reference documentation .

To authenticate to Datastore mode, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .

  Entity 
  
 task 
  
 = 
  
 Entity 
 . 
 newBuilder 
 ( 
 keyFactory 
 . 
 newKey 
 ( 
 "sampleTask" 
 )). 
 build 
 (); 
 datastore 
 . 
 put 
 ( 
 task 
 );

Node.js

To learn how to install and use the client library for Datastore mode, see Datastore mode client libraries . For more information, see the Datastore mode Node.js API reference documentation .

To authenticate to Datastore mode, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .

  const 
  
 taskKey 
  
 = 
  
 datastore 
 . 
 key 
 ( 
 'Task' 
 ); 
 const 
  
 task 
  
 = 
  
 { 
  
 category 
 : 
  
 'Personal' 
 , 
  
 done 
 : 
  
 false 
 , 
  
 priority 
 : 
  
 4 
 , 
  
 description 
 : 
  
 'Learn Cloud Datastore' 
 , 
 }; 
 const 
  
 entity 
  
 = 
  
 { 
  
 key 
 : 
  
 taskKey 
 , 
  
 data 
 : 
  
 task 
 , 
 }; 
 await 
  
 datastore 
 . 
 upsert 
 ( 
 entity 
 ); 
 // Task inserted successfully.

PHP

To learn how to install and use the client library for Datastore mode, see Datastore mode client libraries . For more information, see the Datastore mode PHP API reference documentation .

To authenticate to Datastore mode, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .

  $key = $datastore->key('Task', 'sampleTask'); 
 $task = $datastore->entity($key, [ 
 'category' => 'Personal', 
 'done' => false, 
 'priority' => 4, 
 'description' => 'Learn Cloud Datastore' 
 ]); 
 $datastore->upsert($task);

Python

To learn how to install and use the client library for Datastore mode, see Datastore mode client libraries . For more information, see the Datastore mode Python API reference documentation .

To authenticate to Datastore mode, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .

  from 
  
 google.cloud 
  
 import 
  datastore 
 
 # For help authenticating your client, visit 
 # https://cloud.google.com/docs/authentication/getting-started 
 client 
 = 
  datastore 
 
 . 
  Client 
 
 () 
 complete_key 
 = 
 client 
 . 
  key 
 
 ( 
 "Task" 
 , 
 "sampleTask" 
 ) 
 task 
 = 
  datastore 
 
 . 
  Entity 
 
 ( 
 key 
 = 
 complete_key 
 ) 
 task 
 . 
 update 
 ( 
 { 
 "category" 
 : 
 "Personal" 
 , 
 "done" 
 : 
 False 
 , 
 "priority" 
 : 
 4 
 , 
 "description" 
 : 
 "Learn Cloud Datastore" 
 , 
 } 
 ) 
 client 
 . 
  put 
 
 ( 
 task 
 )

Ruby

To learn how to install and use the client library for Datastore mode, see Datastore mode client libraries . For more information, see the Datastore mode Ruby API reference documentation .

To authenticate to Datastore mode, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .

  # task_name = "sampleTask" 
 task 
  
 = 
  
 datastore 
 . 
 entity 
  
 "Task" 
 , 
  
 task_name 
  
 do 
  
 | 
 t 
 | 
  
 t 
 [ 
 "category" 
 ] 
  
 = 
  
 "Personal" 
  
 t 
 [ 
 "done" 
 ] 
  
 = 
  
 false 
  
 t 
 [ 
 "priority" 
 ] 
  
 = 
  
 4 
  
 t 
 [ 
 "description" 
 ] 
  
 = 
  
 "Learn Cloud Datastore" 
 end 
 datastore 
 . 
 save 
  
 task

What's next

To search and filter code samples for other Google Cloud products, see the Google Cloud sample browser .

Upsert Stay organized with collections Save and categorize content based on your preferences.

Explore further

Code sample

C#

Go

Java

Node.js

PHP

Python

Ruby

What's next

Upsert