stardog-admin tx replay Manual Page
NAME
stardog-admin tx replay —Replay the transaction log contents.
SYNOPSIS
stardog-admin [ --krb5 ] [ --krb5-disable-rdns ] [ --server <server url> ] tx replay [ --dry-run ] [ --from-time <mFromTime> ] [ --from-uuid <mFromUuid> ] [ {-p | --passwd} <password> ] [ {-P | --ask-password} ] [ --run-as <username> ] [ --skip-validate ] [ --to-time <mToTime> ] [ --to-uuid <mToUuid> ] [ --token <token> ] [ {-u | --username} <username> ] [ {-v | --verbose} ] [--] <database, log-file>...
OPTIONS
Preview what would be replayed without actually applying changes. Note: validation is performed at dry-run time; if other transactions commit before the actual replay, validation may fail.
Start time for filtering (ISO-8601 format, e.g., 2024-01-15T10:30:00Z)
Start replaying from this transaction UUID
Use the Kerberos environment.
Disable reverse DNS lookup for Kerberos clients.
-p <password>, --passwd <password>
User to impersonate when running the command
URL of Stardog Server. If this option isn't specified, it will be read from JVM argument 'stardog.default.cli.server'. If the JVM arg isn't set, the default value 'http://localhost:5820' is used. If server URL has no explicit port value, the default port value '5820' is used. Example: 'stardog-admin --server http://12.34.56.78:5820 server stop'
Skip validation of log continuity (not recommended)
End time for filtering (ISO-8601 format, e.g., 2024-01-15T10:30:00Z)
Replay up to this transaction UUID (inclusive)
-u <username>, --username <username>
Flag that can cause more detailed information to be printed such as errors and status. Exact output depends upon the command and options used.
This option can be used to separate command-line options from the list of argument, (useful when arguments might be mistaken for command-line options
Database name and transaction log file path
DISCUSSION
Replays transactions from a transaction log file onto an existing database. By default, validation ensures log continuity by checking that a transaction in the log matches the last committed transaction in the database (i.e., they share the same parent transaction UUID). UUID-based filtering requires both --from-uuid and --to-uuid to be specified (open-ended ranges are not supported). If --from-uuid does not match the last committed transaction in the database (or an earlier one) validation will fail.
EXAMPLES
Replay a local transaction log to the server (validates by default):
$ stardog-admin tx replay mydb /path/to/txlog.log
Replay without validation (not recommended):
$ stardog-admin tx replay --skip-validate mydb txlog.log
Preview replay without applying (dry-run):
$ stardog-admin tx replay --dry-run mydb txlog.log
Replay a specific UUID range (both bounds required):
$ stardog-admin tx replay --from-uuid a1b2c3d4-... --to-uuid f9e8d7c6-... mydb txlog.log
Replay a specific time range, use with great care to ensure continuity:
$ stardog-admin tx replay --skip-validate --from-time 2024-01-15T10:30:00Z --to-time 2024-01-16T10:30:00Z mydb txlog.log