79 lines
2.5 KiB
Markdown
Executable File
79 lines
2.5 KiB
Markdown
Executable File
# CI-Node-query
|
|
|
|
A node query builder for various SQL databases, based on [CodeIgniter](http://www.codeigniter.com/user_guide/database/query_builder.html)'s query builder.
|
|
|
|
[](https://jenkins.timshomepage.net/job/node-query/)
|
|
[](https://travis-ci.org/timw4mail/node-query)
|
|
[](https://codeclimate.com/github/timw4mail/node-query)
|
|
[](https://codeclimate.com/github/timw4mail/node-query/coverage)
|
|
|
|
### Features
|
|
* Callback and Promise API for making database calls.
|
|
|
|
### Supported databases
|
|
|
|
* Mysql (via `mysql2`)
|
|
* PostgreSQL (via `pg`)
|
|
* Sqlite (via `dblite`)
|
|
|
|
### Installation
|
|
|
|
npm install ci-node-query
|
|
|
|
[](https://nodei.co/npm/ci-node-query/)
|
|
|
|
### Basic use
|
|
```javascript
|
|
|
|
// Set the database connection details
|
|
const nodeQuery = require('ci-node-query')({
|
|
"driver": "mysql",
|
|
"connection": {
|
|
"host": "localhost",
|
|
"user": "test",
|
|
"password": "",
|
|
"database": "test"
|
|
}
|
|
});
|
|
|
|
// Get the query builder
|
|
const query = nodeQuery.getQuery();
|
|
|
|
query.select('foo')
|
|
.from('bar')
|
|
.where('x', 3)
|
|
.orWhere({y: 2})
|
|
.join('baz', 'baz.boo = bar.foo', 'left')
|
|
.orderBy('x', 'DESC')
|
|
.limit(2, 3)
|
|
.get(function(/* Adapter dependent arguments */) {
|
|
// Database module result handling
|
|
});
|
|
|
|
// As of version 3.1.0, you can also get promises
|
|
var queryPromise = query.select('foo')
|
|
.from('bar')
|
|
.where('x', 3)
|
|
.orWhere({y: 2})
|
|
.join('baz', 'baz.boo = bar.foo', 'left')
|
|
.orderBy('x', 'DESC')
|
|
.limit(2, 3)
|
|
.get();
|
|
|
|
queryPromise.then(function(res) {
|
|
// Handle query results
|
|
});
|
|
```
|
|
|
|
### Security notes
|
|
As of version 2, `where` and `having` type methods parse the values passed to look for function calls. While values passed are still passed as query parameters, take care to avoid passing these kinds of methods unfiltered input. SQL function arguments are not currently parsed, so they need to be properly escaped for the current database.
|
|
|
|
|
|
### Additional help
|
|
|
|
* Generated documentation is in the docs/ folder
|
|
* The API is documented in [API.md](./API.md)
|
|
* The `tests/adapters` folder contains examples of how to set up a connection for the appropriate database library
|
|
* The documentation generated for the latest dev build is also [Available](https://github.timshomepage.net/node-query/docs/)
|
|
|