You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: firestore-bigquery-export/POSTINSTALL.md
+2-4
Original file line number
Diff line number
Diff line change
@@ -101,14 +101,12 @@ For PowerShell script:
101
101
102
102
### _(Optional)_ Import existing documents
103
103
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.
105
105
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.
107
107
108
108
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`.
109
109
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
-
112
110
**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.
113
111
114
112
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).
Copy file name to clipboardexpand all lines: firestore-bigquery-export/PREINSTALL.md
+2-6
Original file line number
Diff line number
Diff line change
@@ -37,15 +37,11 @@ Before installing this extension, you'll need to:
37
37
38
38
#### Import existing documents
39
39
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).
45
41
46
42
**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.
47
43
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.
Copy file name to clipboardexpand all lines: firestore-bigquery-export/README.md
+3-7
Original file line number
Diff line number
Diff line change
@@ -45,15 +45,11 @@ Before installing this extension, you'll need to:
45
45
46
46
#### Import existing documents
47
47
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).
53
49
54
50
**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.
55
51
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.
57
53
58
54
#### Transform function
59
55
@@ -281,7 +277,7 @@ essential for the script to insert data into an already partitioned table.)
281
277
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.
282
278
Available schema extensions table fields for clustering include: `document_id, document_name, timestamp, event_id, operation, data`.
283
279
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.
285
281
286
282
* 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.
0 commit comments