MySQL query builder to perform database operations
npm install fluent-mysql
!Image of version
!Image of version
fluent-mysql is a query builder for MySQL. It performs basic database operations using mysql library.
* It is ES5 compatible.
Inspired by Laravel Query Builder
- Installation
- Connection to Database
- Pooling connections
- Selections
- table()
- select()
- distinct()
- Retrieving Results
- get()
- first()
- find()
- query()
- Where Clauses
- where()
- orWhere()
- whereBetween()
- orWhereBetween()
- whereNotBetween()
- orWhereNotBetween()
- whereIn()
- orWhereIn()
- whereNotIn()
- orWhereNotIn()
- whereNull()
- orWhereNull()
- whereNotNull()
- orWhereNotNull()
- Ordering, Grouping, Limit & Offset
- orderBy()
- limit()
- offset
- groupBy() / having()
- Joins
- join()
- leftJoin()
- rightJoin()
- Aggregate Functions
- count()
- min()
- max()
- avg()
- sum()
- exists()
- Insert, Update & Delete
- insert()
- insertOrUpdate()
- update()
- delete()
- Combining Methods
- Contributing
- License
Use the node package manager npm to install fluent-mysql.
``bash`
npm install fluent-mysql
`js`
const DB = require('fluent-mysql');
`js
const DB = require('fluent-mysql');
let connection = DB.connect({
host : process.env.DB_HOST,
user : process.env.DB_USER,
password : process.env.DB_PASSWORD,
port : process.env.DB_PORT,
database : process.env.DB_DATABASE,
});
connection.then(result => {
console.log(result.message); // Connected to MySQL Database
if(result.success){
// ...
}
}).catch(err => console.log(err));
`
`js
const DB = require('fluent-mysql');
DB.createPool({
host : process.env.DB_HOST,
user : process.env.DB_USER,
password : process.env.DB_PASSWORD,
port : process.env.DB_PORT,
database : process.env.DB_DATABASE,
});
let query = DB.table('users').get();
query.then(results => {
//...
}
}).catch(err => console.log(err));
`
It is necessary to specify table in all queries except for writing your own query with query method.
`js
// Get all records from users table
let users = DB.table('users').get();
users.then( results => {
//...
});
`
Using the select method, you can specify a custom select clause for the query.
`js
let users = DB.table('users').select('name', 'phone', 'age').get();
users.then( results => {
//...
});
`$3
You can also use the distinct method to force the query to return distinct results.
`js
let users = DB.table('users').select('name').distinct().get();
users.then( results => {
//...
});
`
NOTE: All queries return Promise, for this reason use async/await or then() if you need query results immediately before any action.
get must be the last method in methods chain.
`js
let users = DB.table('users').get();
users.then( results => {
//...
});
`
`js
let users = DB.table('users').first();
users.then( result => {
//...
});
`
method:
`js
let users = DB.table('users').find(10);users.then( result => {
//...
});
`$3
You can also write your own query with
method.
`js
let users = DB.query(SELECT * FROM users WHERE name = "John");users.then( results => {
//...
});
`Where Clauses
$3
js
let users = DB.table('users').where('userName', '=', 'John' ).get();users.then( results => {
//...
});
`$3
js
let users = DB.table('users').where('userName', '=', 'John' ).orWhere('age', '>', 20 ).get();users.then( results => {
//...
});
`$3
js
// Get users whose ages between 20 and 30
let users = DB.table('users').whereBetween('age', 20, 40 ).get();users.then( results => {
//...
});
`$3
js
let users = DB.table('users').where('name', '=', 'John' ).orWhereBetween('age', 30, 40 ).get();users.then( results => {
//...
});
`$3
js
let users = DB.table('users').whereNotBetween('age', 50, 60 ).get();users.then( results => {
//...
});
`$3
js
let users = DB.table('users').whereBetween('salary', 1000, 2000 ).orWhereNotBetween('age', 50, 60 ).get();users.then( results => {
//...
});
`$3
js
let users = DB.table('users').whereIn('age', [25,35,45] ).get();users.then( results => {
//...
});
`
$3
js
let users = DB.table('users').where('userName', '=', 'John' ).orWhereIn('age', [25,35,45] ).get();users.then( results => {
//...
});
`
$3
js
let users = DB.table('users').whereNotIn('age', [25,35,45] ).get();users.then( results => {
//...
});
`
$3
js
let users = DB.table('users').where('userName', '=', 'John' ).orWhereNotIn('age', [20,30,40] ).get();users.then( results => {
//...
});
`
$3
js
let users = DB.table('users').whereNull('phone').get();users.then( results => {
//...
});
`
$3
js
let users = DB.table('users').whereNull('phone').orWhereNull('email').get();users.then( results => {
//...
});
`
$3
js
let users = DB.table('users').whereNotNull('phone' ).get();users.then( results => {
//...
});
`$3
js
let users = DB.table('users').where('age', '>', 25 ).orWhereNotNull('email').get();users.then( results => {
//...
});
`Ordering, Grouping, Limit & Offset
$3
The method allows you to sort the result of the query by a given column. The first argument to the orderBy method should be the column you wish to sort by, while the second argument controls the direction of the sort and may be either asc or desc.
`js
let users = DB.table('users').orderBy('name', 'ASC').get();users.then( results => {
//...
});
`$3
To limit the number of results returned from the query, you may use the method.`js
let users = DB.table('users').limit(20).get();users.then( results => {
//...
});
`$3
To skip a given number of results in the query, you may use the method.`js
let users = DB.table('users').limit(20).offset(10).get();users.then( results => {
//...
});
`$3
The
and having methods may be used to group the query results.`js
let authorBooks = DB.table('books')
.select('author', 'COUNT(bookID) AS totalBook')
.groupBy('author')
.having('totalBook', '>', 10)
.get();authorBooks.then( results => {
//...
});
`Joins
$3
The fluent-mysql may also be used to write join statements. The first argument passed to the join method is the name of the table you need to join to, while the remaining arguments specify the column constraints for the join. You can even join to multiple tables in a single query.
js
let users = DB.table('users')
.join('contacts', 'users.id', '=', 'contacts.user_id')
.join('orders', 'users.id', '=', 'orders.user_id')
.select('users.*', 'contacts.phone', 'orders.price')
.get();users.then( results => {
//...
});
`$3
js
let users = DB.table('users')
.leftJoin('contacts', 'users.id', '=', 'contacts.user_id')
.select('users.*', 'contacts.phone')
.get();users.then( results => {
//...
});
`$3
js
let users = DB.table('users')
.rightJoin('contacts', 'users.id', '=', 'contacts.user_id')
.select('users.*', 'contacts.phone')
.get();users.then( results => {
//...
});
`Aggregate Functions
You may call any of these methods after constructing your query.
, max, avg and sum methods take two parameters. First is the name of column in database. Second one is the column name after query. It may be anything you want. Second parameter is optional.$3
`js
let usersCount = DB.table('users').count();
`
$3
js
// SELECT MIN(age) AS minAge FROM users
let minAge = DB.table('users').min('age', 'minAge');
`$3
js
// SELECT MAX(age) AS maxAge FROM users
let maxAge = DB.table('users').max('age', 'maxAge');
`$3
js
// SELECT AVG(age) AS avgAge FROM users
let avgAge = DB.table('users').avg('age', 'avgAge');
`$3
js
// SELECT SUM(age) AS sumAge FROM users
let sumAge = DB.table('users').sum('age', 'sumAge');
`$3
Instead of using the
method to determine if any records exist that match your query's constraints, you may use the exists method.`js
let exists = DB.table('users').where('name', '=', 'John').exists();
`Insert, Update & Delete
$3
js
let insertion = DB.table('users')
.insert({id: 50, name: 'John', age:25});
insertion.then( result => {
// ...
});
`$3
This method updates a record, if not exists creates it.
js
let update = DB.table('users')
.insertOrUpdate({name: 'John', age:25});
insertion.then( result => {
// ...
});
`$3
js
let update = DB.table('users')
.update({id: 125, name: 'John', age:35});
insertion.then( result => {
// ..
});
`Also you can use
method in order to specify conditions.
(Be careful about putting where method before update.)`js
let update = DB.table('users')
.where('age', '>',40)
.update({salary : 5000});
insertion.then( result => {
// ..
});
`$3
js
let deletion = DB.table('users')
.where('name','=','John')
.delete();
deletion.then( result => {
// ..
});
`
Combining Methods
Example of using with multiple methods:
js
let users = DB.table('users')
.select('name','age')
.where('age', '>', 30)
.where('name', '=', 'John')
.limit(5)
.orderBy('age', 'DESC')
.get();users.then( results => {
// ...
});
`
As long as you use the last method correctly, you can change the order of methodsjs
//Both functions returns the same result
let users = DB.table('users').select('name','age').where('age', '>', 30).get();
let users = DB.where('age', '>', 30).select('name','age').table('users').get();
users.then( results => {
//...
});
``