Skip to content

Commit ebfc016

Browse files
cabljacCorieW
andauthored
Release 11/03/2025 (#2324)
* docs(firestore-bigquery-export): remove references to lifecycle backfill (#2315) * fix(firestore-translate-text): disable backfill (#2314) chore(firestore-translate-text): update changelog * docs(firestore-bigquery-export): fix small typo in max dispatches param (#2317) * feat: gen-schema-view updates (#2326) * fix(gen-schema-view): run npm audit fix * refactor(gen-schema-view): extract config parsing to its own module * feat(gen-schema-views): add gemini gen schema Co-authored-by: Corie Watson <[email protected]> * chore(gen-schema-views): bump version * chore(gen-schema-views): add license headers * docs(gen-schema-views): update gemini docs * refactor(gen-schema-view): allow specifying of schema file name * fix(gen-schema-view): fix schema directory option in non-interactive, and update docs * docs(gen-schema-views): update guide --------- Co-authored-by: Corie Watson <[email protected]> * chore(firestore-translate-text): fully remove backfill resources (#2328) --------- Co-authored-by: Corie Watson <[email protected]>
1 parent 797d012 commit ebfc016

33 files changed

+5516
-2488
lines changed

firestore-bigquery-export/CHANGELOG.md

+7-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
1+
## Version 0.1.59
2+
3+
docs - remove references to lifecycle backfill feature.
4+
5+
docs - correct typo in maximum dispatches per second.
6+
17
## Version 0.1.58
28

3-
feat - move to Node.js 20 runtimes
9+
feat - move to Node.js 20 runtimes.
410

511
## Version 0.1.57
612

firestore-bigquery-export/POSTINSTALL.md

+2-4
Original file line numberDiff line numberDiff line change
@@ -101,14 +101,12 @@ For PowerShell script:
101101

102102
### _(Optional)_ Import existing documents
103103

104-
If you chose _not_ to automatically import existing documents when you installed this extension, you can backfill your BigQuery dataset with all the documents in your collection using the import script.
104+
You can backfill your BigQuery dataset with all the documents in your collection using the import script.
105105

106-
If you don't either enable automatic import or run the import script, the extension only exports the content of documents that are created or changed after installation.
106+
If you don't run the import script, the extension only exports the content of documents that are created or changed after installation.
107107

108108
The import script can read all existing documents in a Cloud Firestore collection and insert them into the raw changelog table created by this extension. The script adds a special changelog for each document with the operation of `IMPORT` and the timestamp of epoch. This is to ensure that any operation on an imported document supersedes the `IMPORT`.
109109

110-
**Warning:** Make sure to not run the import script if you enabled automatic backfill during the extension installation, as it might result in data loss.
111-
112110
**Important:** Run the import script over the entire collection _after_ installing this extension, otherwise all writes to your database during the import might be lost.
113111

114112
Learn more about using the import script to [backfill your existing collection](https://github.com/firebase/extensions/blob/master/firestore-bigquery-export/guides/IMPORT_EXISTING_DOCUMENTS.md).

firestore-bigquery-export/PREINSTALL.md

+2-6
Original file line numberDiff line numberDiff line change
@@ -37,15 +37,11 @@ Before installing this extension, you'll need to:
3737

3838
#### Import existing documents
3939

40-
There are two ways to import existing Firestore documents into BigQuery - the backfill feature and the import script.
41-
42-
To import documents that already exist at installation time into BigQuery, answer **Yes** when the installer asks "Import existing Firestore documents into BigQuery?" The extension will export existing documents as part of the installation and update processes.
43-
44-
Alternatively, you can run the external [import script](https://github.com/firebase/extensions/blob/master/firestore-bigquery-export/guides/IMPORT_EXISTING_DOCUMENTS.md) to backfill existing documents. If you plan to use this script, answer **No** when prompted to import existing documents.
40+
To import existing documents you can run the external [import script](https://github.com/firebase/extensions/blob/master/firestore-bigquery-export/guides/IMPORT_EXISTING_DOCUMENTS.md).
4541

4642
**Important:** Run the external import script over the entire collection _after_ installing this extension, otherwise all writes to your database during the import might be lost.
4743

48-
If you don't either enable automatic import or run the import script, the extension only exports the content of documents that are created or changed after installation.
44+
Without use of this import script, the extension only exports the content of documents that are created or changed after installation.
4945

5046
#### Transform function
5147

firestore-bigquery-export/README.md

+3-7
Original file line numberDiff line numberDiff line change
@@ -45,15 +45,11 @@ Before installing this extension, you'll need to:
4545

4646
#### Import existing documents
4747

48-
There are two ways to import existing Firestore documents into BigQuery - the backfill feature and the import script.
49-
50-
To import documents that already exist at installation time into BigQuery, answer **Yes** when the installer asks "Import existing Firestore documents into BigQuery?" The extension will export existing documents as part of the installation and update processes.
51-
52-
Alternatively, you can run the external [import script](https://github.com/firebase/extensions/blob/master/firestore-bigquery-export/guides/IMPORT_EXISTING_DOCUMENTS.md) to backfill existing documents. If you plan to use this script, answer **No** when prompted to import existing documents.
48+
To import existing documents you can run the external [import script](https://github.com/firebase/extensions/blob/master/firestore-bigquery-export/guides/IMPORT_EXISTING_DOCUMENTS.md).
5349

5450
**Important:** Run the external import script over the entire collection _after_ installing this extension, otherwise all writes to your database during the import might be lost.
5551

56-
If you don't either enable automatic import or run the import script, the extension only exports the content of documents that are created or changed after installation.
52+
Without use of this import script, the extension only exports the content of documents that are created or changed after installation.
5753

5854
#### Transform function
5955

@@ -281,7 +277,7 @@ essential for the script to insert data into an already partitioned table.)
281277
Note: Cluster columns must be top-level, non-repeated columns of one of the following types: BIGNUMERIC, BOOL, DATE, DATETIME, GEOGRAPHY, INT64, NUMERIC, RANGE, STRING, TIMESTAMP. Clustering will not be added if a field with an invalid type is present in this parameter.
282278
Available schema extensions table fields for clustering include: `document_id, document_name, timestamp, event_id, operation, data`.
283279

284-
* Maximum number of synced documents per second: This parameter will set the maximum number of syncronised documents per second with BQ. Please note, any other external updates to a Big Query table will be included within this quota. Ensure that you have a set a low enough number to compensate. Defaults to 10.
280+
* Maximum number of synced documents per second: This parameter will set the maximum number of syncronised documents per second with BQ. Please note, any other external updates to a Big Query table will be included within this quota. Ensure that you have a set a low enough number to compensate. Defaults to 100.
285281

286282
* View Type: Select the type of view to create in BigQuery. A regular view is a virtual table defined by a SQL query. A materialized view persists the results of a query for faster access, with either incremental or non-incremental updates. Please note that materialized views in this extension come with several important caveats and limitations - carefully review the pre-install documentation before selecting these options to ensure they are appropriate for your use case.
287283

firestore-bigquery-export/extension.yaml

+2-2
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
# limitations under the License.
1414

1515
name: firestore-bigquery-export
16-
version: 0.1.58
16+
version: 0.1.59
1717
specVersion: v1beta
1818

1919
displayName: Stream Firestore to BigQuery
@@ -339,7 +339,7 @@ params:
339339
This parameter will set the maximum number of syncronised documents per
340340
second with BQ. Please note, any other external updates to a Big Query
341341
table will be included within this quota. Ensure that you have a set a low
342-
enough number to compensate. Defaults to 10.
342+
enough number to compensate. Defaults to 100.
343343
type: string
344344
validationRegex: ^([1-9]|[1-9][0-9]|[1-4][0-9]{2}|500)$
345345
validationErrorMessage: Please select a number between 1 and 500

0 commit comments

Comments
 (0)