@@ -28,7 +28,10 @@ CREATE DATABASE foo OPTIONS { seedURI:'s3://myBucket/myBackup.backup' }
2828======
2929=====
3030
31- Note that the `existingData` option is required in Cypher 5 and deprecated in Cypher 25.
31+ [NOTE]
32+ ====
33+ The `existingData` option is required in Cypher 5 and deprecated in Cypher 25.
34+ ====
3235
3336Download and validation of the seed is only performed as the new database is started.
3437If it fails, the database is not available and it has the `statusMessage`: `Unable to start database` of the `SHOW DATABASES` command.
@@ -88,7 +91,7 @@ The `URLConnectionSeedProvider` supports the following:
8891** `https:`
8992
9093Starting from Neo4j 2025.01, the `URLConnectionSeedProvider` does not support `file`.
91- // This is true for both Cypher 5 and Cypher 25.
94+ This is true for both Cypher 5 and Cypher 25.
9295
9396
9497[[cloud-seed-provider]]
@@ -174,76 +177,6 @@ CREATE DATABASE foo OPTIONS { seedURI: 'azb://myStorageAccount/myContainer/myBac
174177=====
175178
176179
177- ==== Support for seeding up to a date or a transaction ID
178-
179- Starting from Neo4j 2025.01, the `CloudSeedProvider` supports seeding up to a specific date or transaction ID using the `seedRestoreUntil` option.
180-
181-
182- Seed up to a specific date::
183-
184- To seed up to a specific date, provide the differential backup containing the data up to that date.
185- +
186- [.tabbed-example]
187- =====
188- [role=include-with-Cypher-5]
189- ======
190- [source,cypher5]
191- ----
192- CREATE DATABASE foo OPTIONS {
193- existingData: 'use',
194- seedURI: 's3://myBucket/myBackup.backup',
195- seedRestoreUntil: datetime('2019-06-01T18:40:32.142+0100')
196- }
197- ----
198- ======
199- [role=include-with-Cypher-25]
200- ======
201-
202- [source,cypher25]
203- ----
204- CREATE DATABASE foo OPTIONS {
205- seedURI: 's3://myBucket/myBackup.backup',
206- seedRestoreUntil: datetime('2019-06-01T18:40:32.142+0100')
207- }
208- ----
209- ======
210- =====
211- +
212- This will seed the database with transactions committed before the provided timestamp.
213-
214-
215- Seed up to a specific transaction ID::
216-
217- To seed up to a specific transaction ID, provide the differential backup containing the data up to that transaction ID.
218- +
219- [.tabbed-example]
220- =====
221- [role=include-with-Cypher-5]
222- ======
223- [source,cypher5]
224- ----
225- CREATE DATABASE foo OPTIONS {
226- existingData: 'use',
227- seedURI: 's3://myBucket/myBackup.backup',
228- seedRestoreUntil: 123
229- }
230- ----
231- ======
232- [role=include-with-Cypher-25]
233- ======
234- [source,cypher25]
235- ----
236- CREATE DATABASE foo OPTIONS {
237- seedURI: 's3://myBucket/myBackup.backup',
238- seedRestoreUntil: 123
239- }
240- ----
241- ======
242- =====
243- +
244- This will seed the database with transactions up to (but not including) transaction 123.
245-
246-
247180[role=label--deprecated label--cypher-5]
248181[[s3-seed-provider]]
249182=== S3SeedProvider
@@ -252,7 +185,7 @@ This will seed the database with transactions up to (but not including) transact
252185
253186The `S3SeedProvider` supports:
254187
255- ** `s3:` label:deprecated[Deprecated in 5.26]
188+ ** `s3:`
256189
257190
258191[NOTE]
@@ -330,3 +263,74 @@ Where `<accessKey>` and `<secretKey>` are provided by AWS.
330263| `CloudSeedProvider`
331264| `azb://mystorageaccount.blob/backupscontainer/backup1.backup`
332265|===
266+
267+
268+ [[seed-restore-until-option]]
269+ == Support for seeding up to a date or a transaction ID
270+
271+ Starting from Neo4j 2025.01, when creating a database you can seed up to a specific date or transaction ID via the `seedRestoreUntil` option.
272+
273+ The `seedRestoreUntil` option is supported by the `CloudSeedProvider` and the `FileSeedProvider`.
274+
275+ To seed up to a specific date, provide the differential backup containing the data up to that date.
276+ +
277+ [.tabbed-example]
278+ =====
279+ [role=include-with-Cypher-5]
280+ ======
281+ [source,cypher5]
282+ ----
283+ CREATE DATABASE foo OPTIONS {
284+ existingData: 'use',
285+ seedURI: 's3://myBucket/myBackup.backup',
286+ seedRestoreUntil: datetime('2019-06-01T18:40:32.142+0100')
287+ }
288+ ----
289+ ======
290+ [role=include-with-Cypher-25]
291+ ======
292+
293+ [source,cypher25]
294+ ----
295+ CREATE DATABASE foo OPTIONS {
296+ seedURI: 's3://myBucket/myBackup.backup',
297+ seedRestoreUntil: datetime('2019-06-01T18:40:32.142+0100')
298+ }
299+ ----
300+ ======
301+ =====
302+ +
303+ This will seed the database with transactions committed before the provided timestamp.
304+
305+
306+ Seed up to a specific transaction ID::
307+
308+ To seed up to a specific transaction ID, provide the differential backup containing the data up to that transaction ID.
309+ +
310+ [.tabbed-example]
311+ =====
312+ [role=include-with-Cypher-5]
313+ ======
314+ [source,cypher5]
315+ ----
316+ CREATE DATABASE foo OPTIONS {
317+ existingData: 'use',
318+ seedURI: 's3://myBucket/myBackup.backup',
319+ seedRestoreUntil: 123
320+ }
321+ ----
322+ ======
323+ [role=include-with-Cypher-25]
324+ ======
325+ [source,cypher25]
326+ ----
327+ CREATE DATABASE foo OPTIONS {
328+ seedURI: 's3://myBucket/myBackup.backup',
329+ seedRestoreUntil: 123
330+ }
331+ ----
332+ ======
333+ =====
334+ +
335+ This will seed the database with transactions up to (but not including) transaction 123.
336+
0 commit comments