Skip to content

Firestore

Important

To save data to Firestore install garf-io with Firestore support

pip install garf-io[firestore]

firestore writer allows you to publish GarfReport to a Firestore collection.

garf query.sql --source API_SOURCE \
  --output firestore
from garf.core import report
from garf.io.writers import firestore_writer

# Create example report
sample_report = report.GarfReport(results=[[1]], column_names=['one'])

writer = firestore_writer.FirestoreWriter()
writer.write(sample_report, 'collection_name')

Parameters

project

By default it takes project name from GOOGLE_CLOUD_PROJECT env variable. You can overwrite it with project parameter.

garf query.sql --source API_SOURCE \
  --output firestore \
  --firestore.project=my-project
from garf.core import report
from garf.io.writers import firestore_writer

# Create example report
sample_report = report.GarfReport(results=[[1]], column_names=['one'])

writer = firestore_writer.FirestoreWriter(project='my-project')
writer.write(sample_report, 'collection_name')

db

By default it writes data to (default) db. You can overwrite it with db parameter.

garf query.sql --source API_SOURCE \
  --output firestore \
  --firestore.db=garf_db
from garf.core import report
from garf.io.writers import firestore_writer

# Create example report
sample_report = report.GarfReport(results=[[1]], column_names=['one'])

writer = firestore_writer.FirestoreWriter(db="garf_db")
writer.write(sample_report, 'collection_name')