Add seedRestoreUntil

Author: jackwaudby

modules/ROOT/pages/clustering/databases.adoc

@@ -526,8 +526,8 @@ The `CloudSeedProvider` supports:
 ** `gs:` 
 ** `azb:`
 
-The `CloudSeedProvider` supports using xref:backup-restore/modes.adoc#differential-backup[differential backup] files as seeds.
-With the provided differential backup file, the `CloudSeedProvider` searches the directory containing differential backup files for a xref:backup-restore/online-backup.adoc#backup-chain[backup chain] ending at the specified differential backup, and then seeds using this backup chain.
+The `CloudSeedProvider` supports using xref:backup-restore/modes.adoc#differential-backup[differential backups] as seeds.
+With the provided differential backup, the `CloudSeedProvider` searches the directory containing differential backups for a xref:backup-restore/online-backup.adoc#backup-chain[backup chain] ending at the specified differential backup, and then seeds using this backup chain.
 
 [.tabbed-example]
 =====
@@ -572,6 +572,30 @@ CREATE DATABASE foo OPTIONS { existingData: 'use', seedURI: 'azb://myStorageAcco
 ======
 =====
 
+The `CloudSeedProvider` supports seeding up to a specific date or transaction ID using the `seedRestoreUntil` option.
+
+==== Seed up to a specific date
+
+In order to seed up to a specific date you need to pass the differential backup that contains the data up to that date.
+
+[source,shell]
+----
+CREATE DATABASE foo OPTIONS { existingData: 'use', seedURI: 's3:/myBucket/myBackup.backup', seedRestoreUntil: datetime("2019-06-01T18:40:32.142+0100") }
+----
+
+This will seed the database with transactions committed before the provided timestamp.
+
+==== Seed up to a specific transaction ID
+
+In order to seed up to a specific transaction ID you need to pass the differential backup that contains the data up to that transaction ID.
+
+[source,shell]
+----
+CREATE DATABASE foo OPTIONS { existingData: 'use', seedURI: 's3:/myBucket/myBackup.backup', seedRestoreUntil: 123 }
+----
+
+This will seed the database with transactions up to, but not including, the transaction 123.
+
 ==== Seed provider reference
 
 [cols="1,2,2",options="header"]