const{Datastore}=require('@google-cloud/datastore');

constdatastore=newDatastore();

constdatastore=newDatastore({projectId:'your-project-id',keyFilename:'/path/to/keyfile.json'});

const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();// Records, called "entities" in Datastore, are retrieved by using a key. The// key is more than a numeric identifier, it is a complex data structure that// can be used to model relationships. The simplest key has a string `kind`// value, and either a numeric `id` value, or a string `name` value.//// A single record can be retrieved with {@link Datastore#key} and// {@link Datastore#get}.//-constkey=datastore.key(['Company','Google']);datastore.get(key,function(err,entity){// entity = The record.// entity[datastore.KEY] = The key for this entity.});//-//
Querying Records
//// Create a query with {@link Datastore#createQuery}.//-constquery=datastore.createQuery('Company');//-// Multiple records can be found that match criteria with// {@link Query#filter}.//-query.filter('location','CA');//-// Records can also be ordered with {@link Query#order}.//-query.order('name');//-// The number of records returned can be specified with// {@link Query#limit}.//-query.limit(5);//-// Records' key structures can also be queried with// {@link Query#hasAncestor}.//-constancestorKey=datastore.key(['ParentCompany','Alphabet']);query.hasAncestor(ancestorKey);//-// Run the query with {@link Datastore#runQuery}.//-datastore.runQuery(query,(err,entities)=>{// entities = An array of records.// Access the Key object for an entity.constfirstEntityKey=entities[0][datastore.KEY];});

// Imagine building a website that allows a user to sift through hundreds of// their contacts. You'll likely want to only display a subset of these at// once, so you set a limit.//-constexpress=require('express');constapp=express();constNUM_RESULTS_PER_PAGE=15;app.get('/contacts',(req,res)=>{constquery=datastore.createQuery('Contacts').limit(NUM_RESULTS_PER_PAGE);if(req.query.nextPageCursor){query.start(req.query.nextPageCursor);}datastore.runQuery(query,(err,entities,info)=>{if(err){// Error handling omitted.return;}// Respond to the front end with the contacts and the cursoring token// from the query we just ran.constfrontEndResponse={contacts:entities};// Check if  more results may exist.if(info.moreResults!==datastore.NO_MORE_RESULTS){frontEndResponse.nextPageCursor=info.endCursor;}res.render('contacts',frontEndResponse);});});

// New entities can be created and persisted with {@link Datastore#save}.// The entity must have a key to be saved. If you don't specify an// identifier for the key, one is generated for you.//// We will create a key with a `name` identifier, "Google".//-constkey=datastore.key(['Company','Google']);constdata={name:'Google',location:'CA'};datastore.save({key:key,data:data},(err)=>{if(!err){// Record saved successfully.}});//-// We can verify the data was saved by using {@link Datastore#get}.//-datastore.get(key,(err,entity)=>{// entity = {//   name: 'Google',//   location: 'CA'// }});//-// If we want to update this record, we can modify the data object and re-// save it.//-data.symbol='GOOG';datastore.save({key:key,// defined above (datastore.key(['Company', 'Google']))data:data},(err,entity)=>{if(!err){// Record updated successfully.}});

// Entities can be removed from Datastore by passing the entity's key object// to {@link Datastore#delete}.//-constkey=datastore.key(['Company','Google']);datastore.delete(key,(err)=>{if(!err){// Record deleted successfully.}});

// Complex logic can be wrapped in a transaction with// {@link Datastore#transaction}. All queries and updates run within// the transaction will be applied when the `done` function is called.//-consttransaction=datastore.transaction();transaction.run((err)=>{if(err){// Error handling omitted.}constkey=datastore.key(['Company','Google']);transaction.get(key,(err,entity)=>{if(err){// Error handling omitted.}entity.symbol='GOOG';transaction.save(entity);transaction.commit((err)=>{if(!err){// Transaction committed successfully.}});});});

const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();constcustomerId1=2993844;constcustomerId2=4993882;constcustomerKey1=datastore.key(['Customer',customerId1]);constcustomerKey2=datastore.key(['Customer',customerId2]);constcookieKey1=datastore.key(['Customer',customerId1,'Cookie','cookie28839']);// child entity const cookieKey2 =datastore.key(['Customer',customerId1,'Cookie','cookie78984']);// childentityconstcookieKey3=datastore.key(['Customer',customerId2,'Cookie','cookie93911']);// child entityconstentities=[];entities.push({key:customerKey1,data:{name:'Jane Doe',address:'4848 Liller'}});entities.push({key:customerKey2,data:{name:'John Smith',address:'4848 Pine'}});entities.push({key:cookieKey1,data:{cookieVal:'dj83kks88rkld'}});entities.push({key:cookieKey2,data:{cookieVal:'sj843ka99s'}});entities.push({key:cookieKey3,data:{cookieVal:'otk82k2kw'}});datastore.upsert(entities);constquery=datastore.createQuery().hasAncestor(customerKey1);datastore.runQuery(query,(err,entities)=>{for(letentityofentities){console.log(entity[datastore.KEY]);}});constquery2=datastore.createQuery().hasAncestor(customerKey2);datastore.runQuery(query2,(err,entities)=>{for(letentityofentities){console.log(entity[datastore.KEY]);}});datastore.runQuery(query2,(entities)=>{console.log(entities);});

const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();constquery=datastore.createQuery('Company');

const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();constthreeDouble=datastore.double(3.0);

const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();constcoordinates={latitude:40.6894,longitude:-74.0447};constgeoPoint=datastore.geoPoint(coordinates);//-// List all companies that are located at 40.123 latitude// and -74.0447 longitude.//-constquery=datastore.createQuery('Company');constcompanyQuery=query.filter('geoPoint.latitude',datastore.double(40.123)).filter('geoPoint.longitude',datastore.double(-74.0447));

const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();constsevenInteger=datastore.int(7);//-// Create an Int to support long Key IDs.//-constkey=datastore.key(['Kind',datastore.int('100000000000001234')]);

const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();datastore.isDouble(0.42);// falsedatastore.isDouble(datastore.double(0.42));// true

const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();constcoordinates={latitude:0,longitude:0};datastore.isGeoPoint(coordinates);// falsedatastore.isGeoPoint(datastore.geoPoint(coordinates));// true

const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();datastore.isInt(42);// falsedatastore.isInt(datastore.int(42));// true

const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();datastore.isKey({path:['Company',123]});// falsedatastore.isKey(datastore.key(['Company',123]));// true

Createanincompletekeywithakindvalueof`Company`.SincenoIdissupplied,Datastorewillgenerateoneonsave.const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();constkey=datastore.key('Company');

Createacompletekeywithakindvalueof`Company`andId`123`.const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();constkey=datastore.key(['Company',123]);

IftheIDintegerisoutsidetheboundsofaJavaScriptNumberobject,createanInt.const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();constkey=datastore.key(['Company',datastore.int('100000000000001234')]);

Createacompletekeywithakindvalueof`Company`andname`Google`.BecausethesuppliedIdisastring,Datastorewillprefixitwith"name=".HadthesuppliedIdbeennumeric,Datastorewouldprefixitwiththestandard,"id=".const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();constkey=datastore.key(['Company','Google']);

Createacompletekeyfromaprovidednamespaceandpath.const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();constkey=datastore.key({namespace:'My-NS',path:['Company',123]});

Createacompletekeythatspecifiesanancestor.ThiswillcreateaTeamentitywithanameof"Datastore",whichbelongstotheCompanywiththe"name=Google"key.const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();constkey=datastore.key(['Company','Google','Team','Datastore']);

Createaincompletekeythatspecifiesanancestor.ThiswillcreateanEmployeeentitywithanauto-generatedId,whichbelongstotheCompanywiththe"name=Google"key.const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();constkey=datastore.key(['Company','Google','Employee']);

const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();consturlSafeKey='ag9ncmFzcy1jbHVtcC00NzlyEwsSB0NvbXBhbnkiBkdvb2dsZQw';datastore.keyFromLegacyUrlsafe(key);

const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();constkey=datastore.key(['Company','Google']);datastore.keyToLegacyUrlSafe(key,(err,urlSafeKey)=>{if(err){// Error handling omitted.}console.log(urlSafeKey);});//-// Create a complete URL-safe key using a location prefix.//-constlocationPrefix='s~';datastore.keyToLegacyUrlSafe(key,locationPrefix,(err,urlSafeKey)=>{if(err){// Error handling omitted.}console.log(urlSafeKey);});//-// If the callback is omitted, we'll return a Promise.//-datastore.keyToLegacyUrlSafe(key).then((data)=>{consturlSafeKey=data[0];console.log(urlSafeKey);});

//-// Save a single entity.//// Notice that we are providing an incomplete key. After saving, the// original Key object used to save will be updated to contain the path// with its generated ID.//-constkey=datastore.key('Company');constentity={key:key,data:{rating:'10'}};datastore.save(entity,(err)=>{console.log(key.path);// [ 'Company', 5669468231434240 ]console.log(key.namespace);// undefined});//-// Save a single entity using a provided name instead of auto-generated ID.//// Here we are providing a key with name instead of an ID. After saving,// the original Key object used to save will be updated to contain the// path with the name instead of a generated ID.//-constkey=datastore.key(['Company','donutshack']);constentity={key:key,data:{name:'DonutShack',rating:8}};datastore.save(entity,(err)=>{console.log(key.path);// ['Company', 'donutshack']console.log(key.namespace);// undefined});//-// Save a single entity with a provided namespace. Namespaces allow for// multitenancy. To read more about this, see// [the Datastore docs on key concepts](https://goo.gl/M1LUAu).//// Here we are providing a key with namespace.//-constkey=datastore.key({namespace:'my-namespace',path:['Company','donutshack']});constentity={key:key,data:{name:'DonutShack',rating:8}};datastore.save(entity,(err)=>{console.log(key.path);// ['Company', 'donutshack']console.log(key.namespace);// 'my-namespace'});//-// Save different types of data, including ints, doubles, dates, booleans,// blobs, and lists.//// Notice that we are providing an incomplete key. After saving, the// original Key object used to save will be updated to contain the path// with its generated ID.//-constkey=datastore.key('Company');constentity={key:key,data:{name:'DonutShack',rating:datastore.int(10),worth:datastore.double(123456.78),location:datastore.geoPoint({latitude:40.6894,longitude:-74.0447}),numDonutsServed:45,founded:newDate('Tue May 12 2015 15:30:00 GMT-0400 (EDT)'),isStartup:true,donutEmoji:Buffer.from('\uD83C\uDF69'),keywords:['donut','coffee','yum']}};datastore.save(entity,(err,apiResponse)=>{});//-// Use an array, `excludeFromIndexes`, to exclude properties from indexing.// This will allow storing string values larger than 1500 bytes.//-constentity={key:datastore.key('Company'),excludeFromIndexes:['description','embeddedEntity.description','arrayValue[]','arrayValue[].description'],data:{description:'Long string (...)',embeddedEntity:{description:'Long string (...)'},arrayValue:['Long string (...)',{description:'Long string (...)'}]}};datastore.save(entity,(err,apiResponse)=>{});//-// Use boolean `excludeLargeProperties`, to auto exclude Large properties from indexing.// This will allow storing string values larger than 1500 bytes.//-constentity={key:datastore.key('Company'),data:{description:'Long string (...)',embeddedEntity:{description:'Long string (...)'},arrayValue:['Long string (...)',{description:'Long string (...)'}]},excludeLargeProperties:true};datastore.save(entity,(err,apiResponse)=>{});//-// Save multiple entities at once.//-constcompanyKey=datastore.key(['Company',123]);constproductKey=datastore.key(['Product','Computer']);constentities=[{key:companyKey,data:{HQ:'Dallas, TX'}},{key:productKey,data:{vendor:'Dell'}}];datastore.save(entities,(err,apiResponse)=>{});//-// Explicitly attempt to 'insert' a specific entity.//-constuserKey=datastore.key(['User','chilts']);constentity={key:userKey,method:'insert',data:{fullName:'Andrew Chilton'}};datastore.save(entity,(err,apiResponse)=>{});//-// Returns a Promise if callback is omitted.//-datastore.save(entity).then((data)=>{constapiResponse=data[0];});

const{Datastore}=require('@google-cloud/datastore');constdatastore=newDatastore();consttransaction=datastore.transaction();