Native Mode
Cloud Firestore Native Instance
There can only be one Datastore instance associated with a single project. The Cloud Firestore in Datastore instance is automatically created when you enable the API:
Enable API
Data Schema
Because Cloud Firestore is a NoSQL database, you do not need to explicitly create tables, define data schema, etc. Simply use the API to store new documents, and perform CRUD operations.
Spring Data Firestore
The easiest way to access Cloud Firestore is using Spring Cloud GCP's Spring Data Firestore starter. This starter provides full Spring Data support for Cloud Firestore while implementing idiomatic access patterns.
Dependency
Add the Spring Data Firestore starter:
Configuration
There is no explicit configuration required if you use the automatic authentication and project ID detection. I.e., if you already logged in locally with gcloud
command line, then it'll automatically use Datastore from the project you configured in gcloud
.
Notice that there is no explicit configuration for username/password. Cloud Firestore authentication uses the GCP credential (either your user credential, or Service Account credential), and authorization is configured via Identity Access Management (IAM).
ORM
Spring Data Cloud Firestore allows you to map domain POJOs to Datastore documents via annotations.
Because Firestore is a document-oriented NoSQL database, you can have nested structure and can establish parent-children relationships without complicated foreign keys.
Read the Spring Data Firestore reference documentation for more details.
Repository
Use Spring Data Reactive repository to quickly get CRUD access to the Cloud Firestore.
In a business logic service, you can utilize the repositories:
Samples
Last updated