You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
87 lines
1.8 KiB
Markdown
87 lines
1.8 KiB
Markdown
# rqlite
|
|
|
|
`rqlite` is a command line tool for connecting to a rqlited node. Consult the [SQLite query language documentation](https://www.sqlite.org/lang.html) for full details on the supported SQL syntax.
|
|
|
|
- [Usage](#usage)
|
|
- [Example](#example)
|
|
- [Build](#example)
|
|
|
|
## Usage
|
|
|
|
```sh
|
|
$> rqlite -h
|
|
Options:
|
|
|
|
-h, --help
|
|
display help information
|
|
|
|
-a, --alternatives
|
|
comma separated list of 'host:port' pairs to use as fallback
|
|
|
|
-s, --scheme[=http]
|
|
protocol scheme (http or https)
|
|
|
|
-H, --host[=127.0.0.1]
|
|
rqlited host address
|
|
|
|
-p, --port[=4001]
|
|
rqlited host port
|
|
|
|
-P, --prefix[=/]
|
|
rqlited HTTP URL prefix
|
|
|
|
-i, --insecure[=false]
|
|
do not verify rqlited HTTPS certificate
|
|
|
|
-c, --ca-cert
|
|
path to trusted X.509 root CA certificate
|
|
|
|
-u, --user
|
|
set basic auth credentials in form username:password
|
|
|
|
-v, --version
|
|
display CLI version
|
|
```
|
|
|
|
## Example
|
|
Connecting to a host running locally:
|
|
```sh
|
|
$ rqlite
|
|
127.0.0.1:4001> CREATE TABLE foo (id INTEGER NOT NULL PRIMARY KEY, name TEXT)
|
|
0 row affected (0.000362 sec)
|
|
127.0.0.1:4001> .tables
|
|
+------+
|
|
| name |
|
|
+------+
|
|
| foo |
|
|
+------+
|
|
127.0.0.1:4001> .schema
|
|
+---------------------------------------------------------------+
|
|
| sql |
|
|
+---------------------------------------------------------------+
|
|
| CREATE TABLE foo (id INTEGER NOT NULL PRIMARY KEY, name TEXT) |
|
|
+---------------------------------------------------------------+
|
|
127.0.0.1:4001> INSERT INTO foo(name) VALUES("fiona")
|
|
1 row affected (0.000117 sec)
|
|
127.0.0.1:4001> SELECT * FROM foo
|
|
+----+-------+
|
|
| id | name |
|
|
+----+-------+
|
|
| 1 | fiona |
|
|
+----+-------+
|
|
127.0.0.1:4001> quit
|
|
bye~
|
|
```
|
|
Connecting to a host running somewhere else on the network:
|
|
```
|
|
$ rqlite -H localhost -p 8493
|
|
locahost:8493>
|
|
```
|
|
|
|
## Build
|
|
|
|
```sh
|
|
go build -o rqlite
|
|
```
|
|
|