The fix command converts SurrealDB version 1.x data into a format that can be used in SurrealDB 2.x.
BEFORE YOU STARTMake sure you’ve installed SurrealDB — it should only take a second!
Arguments | Description |
---|---|
| Sets the logging level during the command |
Arguments | Description |
---|---|
| Sets the path to the existing data to convert to 2.x storage format |
To perform a fix from SurrealDB 1.x to 2.x storage, run the surreal fix
command in a terminal with the path to the stored data.
surreal fix surrealkv://mydatabase.db surreal fix rocksdb:somedatabase
When using the surreal fix
command, you can also use environment variables to set the values for the command-line flags.
ImportantMost of the flags mentioned in the command output above also mention a corresponding environment variables.
For example, the
--log
flag can be configured with theSURREAL_LOG
environment variable instead.
For more on the environment variables available for CLI commands or SurrealDB instances in general, see the environment variables page.
To see the help information and usage instructions, in a terminal run the surreal fix --help
command without any further arguments. This command gives general information on the arguments, inputs, and additional options for the export command.
surreal fix --help
The output of the above command:
Fix database storage issues Usage: surreal fix [OPTIONS] [PATH] Arguments: [PATH] Database path used for storing data [env: SURREAL_PATH=] [default: memory] Options: -l, --log <LOG> The logging level for the command-line tool [env: SURREAL_LOG=] [default: info] [possible values: none, full, error, warn, info, debug, trace] -h, --help Print help