gvsafronov/fbx
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Григорий Сафронов 2025-04-02 18:04:11 +00:00
parent e4f9c27095
commit 2bafbe9b83
1 changed files with 54 additions and 54 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

108
README.md
View File

@ -1,15 +1,15 @@
# Redis Module for maintaining hash by simple SQL (Support csv import/export) # Valkeys Module for maintaining hash by simple SQL (Support csv import/export)
This module aims to provide simple DML to manipulate the hashes in REDIS for SQL users. It works as simple as you expected. It translates the input statement to a set of pure REDIS commands. It does not need nor generate any intermediate stuffs which occupied your storages. The target data is your hashes only. It also provides the CSV import and export function. This module aims to provide simple DML to manipulate the hashes in ValkeyS for SQL users. It works as simple as you expected. It translates the input statement to a set of pure ValkeyS commands. It does not need nor generate any intermediate stuffs which occupied your storages. The target data is your hashes only. It also provides the CSV import and export function.
## Usage ## Usage
```sql ```sql
$ redis-cli $ Valkeys-cli
127.0.0.1:6379> hmset phonebook:0001 name "Peter Nelson" tel "1-456-1246-3421" birth "2019-10-01" pos 3 gender "M" futriix:~> hmset phonebook:0001 name "Peter Nelson" tel "1-456-1246-3421" birth "2019-10-01" pos 3 gender "M"
127.0.0.1:6379> hmset phonebook:0002 name "Betty Joan" tel "1-444-9999-1112" birth "2019-12-01" pos 1 gender "F" futriix:~> hmset phonebook:0002 name "Betty Joan" tel "1-444-9999-1112" birth "2019-12-01" pos 1 gender "F"
127.0.0.1:6379> hmset phonebook:0003 name "Bloody Mary" tel "1-666-1234-9812" birth "2018-01-31" pos 2 gender "F" futriix:~> hmset phonebook:0003 name "Bloody Mary" tel "1-666-1234-9812" birth "2018-01-31" pos 2 gender "F"
127.0.0.1:6379> hmset phonebook:0004 name "Mattias Swensson" tel "1-888-3333-1412" birth "2017-06-30" pos 4 gender "M" futriix:~> hmset phonebook:0004 name "Mattias Swensson" tel "1-888-3333-1412" birth "2017-06-30" pos 4 gender "M"
127.0.0.1:6379> dbx select name,tel from phonebook where gender = "F" order by pos desc futriix:~> dbx select name,tel from phonebook where gender = "F" order by pos desc
1) 1) name 1) 1) name
2) "Bloody Mary" 2) "Bloody Mary"
3) tel 3) tel
@ -30,31 +30,31 @@ $ cd dbx/src && make
This plugin library is written in pure C. A file dbx.so is built after successfully compiled. This plugin library is written in pure C. A file dbx.so is built after successfully compiled.
### Load the module in redis (3 ways) ### Load the module in Valkeys (3 ways)
1. Load the module in CLI 1. Load the module in CLI
```sql ```sql
127.0.0.1:6379> module load /path/to/dbx.so futriix:~> module load /path/to/dbx.so
``` ```
2. Start the server with loadmodule argument 2. Start the server with loadmodule argument
```sql ```sql
$ redis-server --loadmodule /path/to/dbx.so $ Valkeys-server --loadmodule /path/to/dbx.so
``` ```
3. Adding the following line in the file redis.conf and then restart the server 3. Adding the following line in the file Valkeys.conf and then restart the server
```sql ```sql
loadmodule /path/to/dbx.so loadmodule /path/to/dbx.so
``` ```
If you still have problem in loading the module, please visit: https://redis.io/topics/modules-intro If you still have problem in loading the module, please visit: https://Valkeys.io/topics/modules-intro
## More Examples ## More Examples
### Select statement ### Select statement
You may specify multiple fields separated by comma You may specify multiple fields separated by comma
```sql ```sql
127.0.0.1:6379> dbx select name, gender, birth from phonebook futriix:~> dbx select name, gender, birth from phonebook
1) 1) name 1) 1) name
2) "Betty Joan" 2) "Betty Joan"
3) gender 3) gender
@ -83,7 +83,7 @@ You may specify multiple fields separated by comma
"*" is support "*" is support
```sql ```sql
127.0.0.1:6379> dbx select * from phonebook where birth > '2019-11-11' futriix:~> dbx select * from phonebook where birth > '2019-11-11'
1) 1) "name" 1) 1) "name"
2) "Betty Joan" 2) "Betty Joan"
3) "tel" 3) "tel"
@ -98,7 +98,7 @@ You may specify multiple fields separated by comma
If you want to show the exact keys, you may try rowid() If you want to show the exact keys, you may try rowid()
```sql ```sql
127.0.0.1:6379> dbx select rowid() from phonebook futriix:~> dbx select rowid() from phonebook
1) 1) rowid() 1) 1) rowid()
2) "phonebook:1588299191-764848276" 2) "phonebook:1588299191-764848276"
2) 1) rowid() 2) 1) rowid()
@ -109,26 +109,26 @@ If you want to show the exact keys, you may try rowid()
2) "phonebook:1588299196-2115347437" 2) "phonebook:1588299196-2115347437"
``` ```
The above is nearly like REDIS keys command The above is nearly like ValkeyS keys command
```sql ```sql
127.0.0.1:6379> keys phonebook* futriix:~> keys phonebook*
1) "phonebook:1588298418-551514504" 1) "phonebook:1588298418-551514504"
2) "phonebook:1588299196-2115347437" 2) "phonebook:1588299196-2115347437"
3) "phonebook:1588299202-1052597574" 3) "phonebook:1588299202-1052597574"
4) "phonebook:1588299191-764848276" 4) "phonebook:1588299191-764848276"
``` ```
Each record is exactly a hash, you could use raw REDIS commands ``hget, hmget or hgetall`` to retrieve the same content Each record is exactly a hash, you could use raw ValkeyS commands ``hget, hmget or hgetall`` to retrieve the same content
#### Where clause #### Where clause
Your could specify =, >, <, >=, <=, <>, != or like conditions in where clause. Now the module only support "and" to join multiple conditions. Your could specify =, >, <, >=, <=, <>, != or like conditions in where clause. Now the module only support "and" to join multiple conditions.
```sql ```sql
127.0.0.1:6379> dbx select tel from phonebook where name like Son futriix:~> dbx select tel from phonebook where name like Son
1) 1) tel 1) 1) tel
2) "1-888-3333-1412" 2) "1-888-3333-1412"
2) 1) tel 2) 1) tel
2) "1-456-1246-3421" 2) "1-456-1246-3421"
127.0.0.1:6379> dbx select tel from phonebook where name like Son and pos = 4 futriix:~> dbx select tel from phonebook where name like Son and pos = 4
1) 1) tel 1) 1) tel
2) "1-888-3333-1412" 2) "1-888-3333-1412"
``` ```
@ -136,7 +136,7 @@ Your could specify =, >, <, >=, <=, <>, != or like conditions in where clause. N
#### Order clause #### Order clause
Ordering can be ascending or descending. All sortings are alpha-sort. Ordering can be ascending or descending. All sortings are alpha-sort.
```sql ```sql
127.0.0.1:6379> dbx select name, pos from phonebook order by pos asc futriix:~> dbx select name, pos from phonebook order by pos asc
1) 1) name 1) 1) name
2) "Betty Joan" 2) "Betty Joan"
3) pos 3) pos
@ -153,7 +153,7 @@ Ordering can be ascending or descending. All sortings are alpha-sort.
2) "Mattias Swensson" 2) "Mattias Swensson"
3) pos 3) pos
4) "4" 4) "4"
127.0.0.1:6379> dbx select name from phonebook order by pos desc futriix:~> dbx select name from phonebook order by pos desc
1) 1) name 1) 1) name
2) "Mattias Swensson" 2) "Mattias Swensson"
2) 1) name 2) 1) name
@ -166,7 +166,7 @@ Ordering can be ascending or descending. All sortings are alpha-sort.
#### Top clause #### Top clause
```sql ```sql
127.0.0.1:6379> dbx select top 3 name, tel from phonebook order by pos desc futriix:~> dbx select top 3 name, tel from phonebook order by pos desc
1) 1) name 1) 1) name
2) "Mattias Swensson" 2) "Mattias Swensson"
3) tel 3) tel
@ -179,24 +179,24 @@ Ordering can be ascending or descending. All sortings are alpha-sort.
2) "Bloody Mary" 2) "Bloody Mary"
3) tel 3) tel
4) "1-666-1234-9812" 4) "1-666-1234-9812"
127.0.0.1:6379> dbx select top 0 * from phonebook futriix:~> dbx select top 0 * from phonebook
(empty list or set) (empty list or set)
``` ```
#### Into clause for copy hash table #### Into clause for copy hash table
You could create another hash table by into clause. You could create another hash table by into clause.
```sql ```sql
127.0.0.1:6379> dbx select * into testbook from phonebook futriix:~> dbx select * into testbook from phonebook
1) testbook:1588325407-1751904058 1) testbook:1588325407-1751904058
2) testbook:1588325407-1751904059 2) testbook:1588325407-1751904059
3) testbook:1588325407-1751904060 3) testbook:1588325407-1751904060
4) testbook:1588325407-1751904061 4) testbook:1588325407-1751904061
127.0.0.1:6379> keys testbook* futriix:~> keys testbook*
1) "testbook:1588325407-1751904061" 1) "testbook:1588325407-1751904061"
2) "testbook:1588325407-1751904059" 2) "testbook:1588325407-1751904059"
3) "testbook:1588325407-1751904058" 3) "testbook:1588325407-1751904058"
4) "testbook:1588325407-1751904060" 4) "testbook:1588325407-1751904060"
127.0.0.1:6379> dbx select * from testbook futriix:~> dbx select * from testbook
1) 1) "name" 1) 1) "name"
2) "Mattias Swensson" 2) "Mattias Swensson"
3) "tel" 3) "tel"
@ -241,10 +241,10 @@ You could create another hash table by into clause.
#### Into csv clause for exporting records in csv format #### Into csv clause for exporting records in csv format
```sql ```sql
127.0.0.1:6379> dbx select * into csv "/tmp/testbook.csv" from phonebook where pos > 2 futriix:~> dbx select * into csv "/tmp/testbook.csv" from phonebook where pos > 2
1) Kevin Louis,111-2123-1233,2009-12-31,6,F 1) Kevin Louis,111-2123-1233,2009-12-31,6,F
2) Kenneth Cheng,123-12134-123,2000-12-31,5,M 2) Kenneth Cheng,123-12134-123,2000-12-31,5,M
127.0.0.1:6379> quit futriix:~> quit
$ cat /tmp/testbook.csv $ cat /tmp/testbook.csv
Kevin Louis,111-2123-1233,2009-12-31,6,F Kevin Louis,111-2123-1233,2009-12-31,6,F
Kenneth Cheng,123-12134-123,2000-12-31,5,M Kenneth Cheng,123-12134-123,2000-12-31,5,M
@ -254,24 +254,24 @@ $
### Delete statement ### Delete statement
You may also use Insert and Delete statement to operate the hash. If you does not provide the where clause, it will delete all the records of the specified key prefix. (i.e. phonebook) You may also use Insert and Delete statement to operate the hash. If you does not provide the where clause, it will delete all the records of the specified key prefix. (i.e. phonebook)
```sql ```sql
127.0.0.1:6379> dbx delete from phonebook where gender = F futriix:~> dbx delete from phonebook where gender = F
(integer) 2 (integer) 2
127.0.0.1:6379> dbx delete from phonebook futriix:~> dbx delete from phonebook
(integer) 2 (integer) 2
``` ```
### Insert statement ### Insert statement
The module provides simple Insert statement which same as the function of the REDIS command hmset. It will append a random string to your provided key (i.e. phonebook). If operation is successful, it will return the key name. The module provides simple Insert statement which same as the function of the ValkeyS command hmset. It will append a random string to your provided key (i.e. phonebook). If operation is successful, it will return the key name.
```sql ```sql
127.0.0.1:6379> dbx insert into phonebook (name,tel,birth,pos,gender) values ('Peter Nelson' ,1-456-1246-3421, 2019-10-01, 3, M) futriix:~> dbx insert into phonebook (name,tel,birth,pos,gender) values ('Peter Nelson' ,1-456-1246-3421, 2019-10-01, 3, M)
"phonebook:1588298418-551514504" "phonebook:1588298418-551514504"
127.0.0.1:6379> dbx insert into phonebook (name,tel,birth,pos,gender) values ('Betty Joan' ,1-444-9999-1112, 2019-12-01, 1, F) futriix:~> dbx insert into phonebook (name,tel,birth,pos,gender) values ('Betty Joan' ,1-444-9999-1112, 2019-12-01, 1, F)
"phonebook:1588299191-764848276" "phonebook:1588299191-764848276"
127.0.0.1:6379> dbx insert into phonebook (name,tel,birth,pos,gender) values ('Bloody Mary' ,1-666-1234-9812, 2018-01-31, 2, F) futriix:~> dbx insert into phonebook (name,tel,birth,pos,gender) values ('Bloody Mary' ,1-666-1234-9812, 2018-01-31, 2, F)
"phonebook:1588299196-2115347437" "phonebook:1588299196-2115347437"
127.0.0.1:6379> dbx insert into phonebook (name,tel,birth,pos,gender) values ('Mattias Swensson' ,1-888-3333-1412, 2017-06-30, 4, M) futriix:~> dbx insert into phonebook (name,tel,birth,pos,gender) values ('Mattias Swensson' ,1-888-3333-1412, 2017-06-30, 4, M)
"phonebook:1588299202-1052597574" "phonebook:1588299202-1052597574"
127.0.0.1:6379> hgetall phonebook:1588298418-551514504 futriix:~> hgetall phonebook:1588298418-551514504
1) "name" 1) "name"
2) "Peter Nelson" 2) "Peter Nelson"
3) "tel" 3) "tel"
@ -282,42 +282,42 @@ The module provides simple Insert statement which same as the function of the RE
8) "3" 8) "3"
9) "gender" 9) "gender"
10) "M" 10) "M"
127.0.0.1:6379> futriix:~>
``` ```
Note that Redis requires at least one space after the single and double quoted arguments, otherwise you will get ``Invalid argument(s)`` error. If you don't want to take care of this, you could quote the whole SQL statement by double quote as below: Note that Valkeys requires at least one space after the single and double quoted arguments, otherwise you will get ``Invalid argument(s)`` error. If you don't want to take care of this, you could quote the whole SQL statement by double quote as below:
```sql ```sql
127.0.0.1:6379> dbx "insert into phonebook (name,tel,birth,pos,gender) values ('Peter Nelson','1-456-1246-3421','2019-10-01',3, 'M')" futriix:~> dbx "insert into phonebook (name,tel,birth,pos,gender) values ('Peter Nelson','1-456-1246-3421','2019-10-01',3, 'M')"
``` ```
#### From clause for importing CSV file #### From clause for importing CSV file
The module provides simple import function by specifying from clause in Insert statement. It only support comma deliminated. Please make sure that the specified import file can be accessed by Redis server. The module provides simple import function by specifying from clause in Insert statement. It only support comma deliminated. Please make sure that the specified import file can be accessed by Valkeys server.
```bash ```bash
$ cat > /tmp/test.csv << EOF $ cat > /tmp/test.csv << EOF
"Kenneth Cheng","123-12134-123","2000-12-31","5","M" "Kenneth Cheng","123-12134-123","2000-12-31","5","M"
"Kevin Louis","111-2123-1233","2009-12-31","6","F" "Kevin Louis","111-2123-1233","2009-12-31","6","F"
EOF EOF
$ redis-cli $ Valkeys-cli
127.0.0.1:6379> dbx insert into phonebook (name, tel, birth, pos, gender) from "/tmp/test.csv" futriix:~> dbx insert into phonebook (name, tel, birth, pos, gender) from "/tmp/test.csv"
1) "phonebook:1588509697-1579004777" 1) "phonebook:1588509697-1579004777"
2) "phonebook:1588509697-1579004778" 2) "phonebook:1588509697-1579004778"
127.0.0.1:6379> dbx select name from phonebook futriix:~> dbx select name from phonebook
1) 1) name 1) 1) name
2) "Kenneth Cheng" 2) "Kenneth Cheng"
2) 1) name 2) 1) name
2) "Kevin Louis" 2) "Kevin Louis"
127.0.0.1:6379> dbx delete from phonebook futriix:~> dbx delete from phonebook
(integer) 2 (integer) 2
127.0.0.1:6379> quit futriix:~> quit
$ cat > /tmp/testheader.csv << EOF $ cat > /tmp/testheader.csv << EOF
name,tel,birth,pos,gender name,tel,birth,pos,gender
"Kenneth Cheng","123-12134-123","2000-12-31","5","M" "Kenneth Cheng","123-12134-123","2000-12-31","5","M"
"Kevin Louis","111-2123-1233","2009-12-31","6","F" "Kevin Louis","111-2123-1233","2009-12-31","6","F"
EOF EOF
$ redis-cli $ Valkeys-cli
127.0.0.1:6379> dbx insert into phonebook from "/tmp/testheader.csv" futriix:~> dbx insert into phonebook from "/tmp/testheader.csv"
1) "phonebook:1588509697-1579004779" 1) "phonebook:1588509697-1579004779"
2) "phonebook:1588509697-1579004780" 2) "phonebook:1588509697-1579004780"
127.0.0.1:6379> dbx select name from phonebook futriix:~> dbx select name from phonebook
1) 1) name 1) 1) name
2) "Kenneth Cheng" 2) "Kenneth Cheng"
2) 1) name 2) 1) name
@ -326,7 +326,7 @@ $ redis-cli
### Issue command from BASH shell ### Issue command from BASH shell
```sql ```sql
$ redis-cli dbx select "*" from phonebook where gender = M order by pos desc $ Valkeys-cli dbx select "*" from phonebook where gender = M order by pos desc
1) 1) "name" 1) 1) "name"
2) "Mattias Swensson" 2) "Mattias Swensson"
3) "tel" 3) "tel"
@ -347,17 +347,17 @@ $ redis-cli dbx select "*" from phonebook where gender = M order by pos desc
8) "3" 8) "3"
9) "gender" 9) "gender"
10) "M" 10) "M"
$ redis-cli dbx select name from phonebook where tel like 9812 $ Valkeys-cli dbx select name from phonebook where tel like 9812
1) 1) name 1) 1) name
2) "Bloody Mary" 2) "Bloody Mary"
``` ```
Note that "*" requires double quoted otherwise it will pass all the filename in current directory. Of course you could quote the whole SQL statement. Note that "*" requires double quoted otherwise it will pass all the filename in current directory. Of course you could quote the whole SQL statement.
```sql ```sql
$ redis-cli dbx "select * from phonebook where gender = M order by pos desc" $ Valkeys-cli dbx "select * from phonebook where gender = M order by pos desc"
``` ```
## Compatibility ## Compatibility
REDIS v4.0 ValkeyS v4.0
## License ## License
MIT MIT