lzhz2012 / google-cloud-datastore

Low-level, Protobuf-based Java and Python client libraries for Cloud Datastore. Check out google-cloud-java and google-cloud-python first!

Google Cloud Datastore

Note: This repository contains low-level Java and Python client libraries for Google Cloud Datastore. For more idiomatic and usable client libraries in these languages, please visit the Google Cloud Client Libraries for Java and Google Cloud Client Libraries for Python repositories. You can also find the full list of supported client libraries in a variety of languages on the Client Libraries page of Cloud Datastore.

Cloud Datastore is a highly-scalable NoSQL database for your applications. Cloud Datastore automatically handles sharding and replication, providing you with a highly available and durable database that scales automatically to handle your applications' load. Cloud Datastore provides a myriad of capabilities such as ACID transactions, SQL-like queries, indexes and much more. For more information, see the Cloud Datastore documentation.

This repository contains clients that are deliberately low-level and map directly to the underlying Datastore RPC model. They're designed to provide more flexibility to developers and higher level library implementers.

• Python Proto Client Library and Samples
• Java Proto Client Library and Samples
• RPC API Reference

Samples

Proto

• Python
• Java

Client Libraries

You can learn more about client libraries for Cloud Datastore here.

• Python:

pip install googledatastore

• Java (Maven):

<dependency>
  <groupId>com.google.api.grpc</groupId>
  <artifactId>proto-google-cloud-datastore-v1</artifactId>
  <version>0.1.27</version>
</dependency>
<dependency>
  <groupId>com.google.cloud.datastore</groupId>
  <artifactId>datastore-v1-proto-client</artifactId>
  <version>1.6.1</version>
</dependency>

Documentation

For more information, see the Cloud Datastore documentation.

Filing Issues

1. For production issues and support options, see Cloud Datastore support.
2. For bugs or feature requests, please first look at existing issues.
3. When applicable, create a new report. Note that this repo exclusively covers the low-level, Protobuf-based clients. If you're using com.google.cloud.google-cloud-datastore (Java) or google-cloud-datastore (Python), please file your issue in the appropriate repo, google-cloud-java or google-cloud-python. If you file an issue with either of those client libraries here, we will (gently) redirect you to the right repo and close the issue in this one.
4. For bugs, detail the steps to reproduce the problem and the affected version number.
5. For feature requests, articulate the use case you are trying solve and describe any current workaround(s).

Contributing changes

• See CONTRIB.md

Licensing

• See LICENSE