Import command
The import command imports a SurrealQL script file into a local or remote SurrealDB database server.
BEFORE YOU START : Make sure you’ve installed SurrealDB — it should only take a second!
Command options
| Arguments | Description |
|---|---|
| Sets the url of the database server to connect to |
| Sets master username for the database |
| Sets master password for the database |
--ns | Sets the desired namespace in which to import data |
--db | Sets the desired database into which to import data |
Positional argument
| Arguments | Description |
|---|---|
file | Sets the the path to the file which should be imported |
Example usage
To perform a SurrealQL database import from a local file, in a terminal run the surreal import command with the required arguments.
surreal import --conn http://localhost:8000 --user root --pass root --ns test --db test downloads/surreal_deal_v1.surql
Command help
To see the help information and usage instructions, in a terminal run the surreal import --help command without any further arguments. This command gives general information on the arguments, inputs, and additional options for the import command.
surreal import --help
The output of the above command :
Import a SurrealQL script into an existing database
USAGE:
surreal import [OPTIONS] <file>
ARGS:
<file> Path to the sql file to import
OPTIONS:
-e, --endpoint, --conn <conn> Remote database server URL to connect to
[default: https://cloud.surrealdb.com]
--db <db> The database to import the data into
-h, --help Print help information
--ns <ns> The namespace to import the data into
-p, --pass <pass> Database authentication password to use when connecting
[default: root]
-u, --user <user> Database authentication username to use when connecting [default: root]