Files
wehub-resource-sync e04ed9c211
CF: Deploy Dev Docs / deploy (push) Has been cancelled
Sync Labels / build (push) Has been cancelled
tests / unit tests (macos-latest) (push) Has been cancelled
tests / unit tests (windows-latest) (push) Has been cancelled
tests / unit tests (ubuntu-latest) (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 13:32:45 +08:00

3.5 KiB

title, linkTitle, type, weight, description, no_list
title linkTitle type weight description no_list
Firestore Source Source docs 1 Firestore is a NoSQL document database built for automatic scaling, high performance, and ease of application development. It's a fully managed, serverless database that supports mobile, web, and server development. true

About

Firestore is a NoSQL document database built for automatic scaling, high performance, and ease of application development. While the Firestore interface has many of the same features as traditional databases, as a NoSQL database it differs from them in the way it describes relationships between data objects.

If you are new to Firestore, you can create a database and learn the basics.

Available Tools

{{< list-tools >}}

Requirements

IAM Permissions

Firestore uses Identity and Access Management (IAM) to control user and group access to Firestore resources. Toolbox will use your Application Default Credentials (ADC) to authorize and authenticate when interacting with Firestore.

In addition to setting the ADC for your server, you need to ensure the IAM identity has been given the correct IAM permissions for accessing Firestore. Common roles include:

  • roles/datastore.user - Read and write access to Firestore
  • roles/datastore.viewer - Read-only access to Firestore
  • roles/firebaserules.admin - Full management of Firebase Security Rules for Firestore. This role is required for operations that involve creating, updating, or managing Firestore security rules (see Firebase Security Rules roles)

See Firestore access control for more information on applying IAM permissions and roles to an identity.

Database Selection

Firestore allows you to create multiple databases within a single project. Each database is isolated from the others and has its own set of documents and collections. If you don't specify a database in your configuration, the default database named (default) will be used.

Example

kind: source
name: my-firestore-source
type: "firestore"
project: "my-project-id"
# database: "my-database"  # Optional, defaults to "(default)"

Reference

field type required description
type string true Must be "firestore".
project string true Id of the GCP project that contains the Firestore database (e.g. "my-project-id").
database string false Name of the Firestore database to connect to. Defaults to "(default)" if not specified.