https://github.com/heapwolf/level-sql
sql for nosql [a work in progress, contributors welcome!]
https://github.com/heapwolf/level-sql
Last synced: about 1 month ago
JSON representation
sql for nosql [a work in progress, contributors welcome!]
- Host: GitHub
- URL: https://github.com/heapwolf/level-sql
- Owner: heapwolf
- License: mit
- Created: 2013-10-27T06:53:25.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2013-10-28T01:03:13.000Z (over 11 years ago)
- Last Synced: 2025-03-29T19:34:30.324Z (about 2 months ago)
- Language: JavaScript
- Homepage:
- Size: 199 KB
- Stars: 19
- Watchers: 3
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# MOTIVATION
So you are happy with your very small, very fast key value store.
But now for some reason you think you need SQL. Ok, fine. Here is
a module.
# USAGE
Given the following key/values
```
key1 { a: 0, b: 1 }
key2 { a: 2, b: 3 }
```
And some boilerplate
```js
var level = require('level');
var sql = require('level-sql');
var db = level('./db', { valueEncoding: 'json' });
sql(db);
```
### Select Any
Given a table T, the query `SELECT * FROM T` will result in all
the elements of all the rows of the table being shown.
```js
var stream1 = db.query('SELECT * from table1');
```
```json
{ "key": "key1", "value": { "a": 0, "b": 1 } }
{ "key": "key2", "value": { "a": 2, "b": 3 } }
```
### Select Specific
With the same table, the query `SELECT K FROM T` will result in
the elements from the key `K` of all the rows of the table being
shown.
```js
var stream1 = db.query('SELECT a from table1');
```
```json
{ "key": "key1", "value": { "a": 0 } }
{ "key": "key2", "value": { "a": 2 } }
```
### Where Clauses
With the same table, the query `SELECT * FROM T WHERE K1 = 2` will
result in all the elements of all the rows where the value of column
`K1` is `2` being shown — in Relational algebra terms, a selection
will be performed, because of the `WHERE` clause. This is also known
as a Horizontal Partition, restricting rows output by a query
according to specified conditions. There can be as many conditions
as you want separated by `and` or `or`.
```js
var stream1 = db.query('SELECT a from table1 WHERE a = 2 and a <> 1');
```
```json
{ "key": "key2", "value": { "a": 2 } }
```
# TODO
This is a work in progress, and I don't plan to give it a ton
of attention, if you like this idea ping me and I will add you
as a contributor.