sql-templar

A sql template module that takes a template based approach to mysql queries

Sql Templar

An alternative crusade to the knights of ORM Land.

Sql-Templar is a small abstraction over node-mysql that provides a similar api to that of rendering html templates, but for sql files. This gets the sql files out of concatenated strings and allows you to place them in a directory much like you place you jade or ejs templates for html. Here is some sample usage code:

Usage

/sql/customers.sql

select * from customers where name like ?

/index.js

var st = require('sql-templar')({
  templates: {
    dir: __dirname + '/sql',
    ext: 'sql'
  }, db: {
    host: 'localhost',
    port: 3306,
    database: 'test',
    user: 'root'
  }
});
 
st.exec('customers', ['A%'], function(errrows) {
  if (err) { console.log(err); }
  console.log(rows);
});
node index.js

Just like you use jade or ejs templates with sql-templar you can manage your sql in template files and utilize all of the conventions and sugar provided by node-mysql to perform proper escaping, etc. See the node-mysql readme for more details on the pattern matching.

/sql/customers-where.sql

select * from customers where ?;

Then call st.exec like this:

st.exec('customers-where', {patient_id: 1, priority: 'Beep'}, function(errrows) {
  if (err) { console.log(err); }
  console.log(rows);
});

This will make the customer-where.sql query look like this:

select * from customers where patient_id = '1' AND priority = 'Beep';

For a list of which where attributes are currently available, visit Where2

/sql/customers-where.sql

select * from customers where ?;

Then call st.exec like this:

 
st.exec('customers-where', {patient_id: 1, created_at: {'$gt': '2015-02-27 18:37:57'}}, function(errrows) {
  if (err) { console.log(err); }
  console.log(rows);
});

This will make the customer-where.sql query look like this:

select * from customers where patient_id = '1' AND created_at > '2015-02-27 18:37:57';

This module leverages connection pooling from the node-mysql library. You can pass in the pool through the config object so that you are free to set any of the options associated with the pool and also have many sql templar instances and just pass in one connection pool.

Ex

var mysql = require('mysql');
var sqlTemplar = require('sqlTemplar')
var pool = mysql.createPool({
  host: 'localhost',
  port: 4406,
  database: 'test',
  user: 'root',
  ssl: {
    ca: '..',
    pem: '..',
    key:'..',
  },
  acquireTimeout: 20000
});
 
var st = sqlTemplar({
  templates: {
    dir: __dirname + '/sql',
    ext: 'sql'
  }, pool: pool 
});
 
npm install sql-templar

Contributions are welcome, the goal of the project is to simply provide a template like engine on top of node-mysql, any contributions that keep within the context of this goal will be merged.

MIT

  • Would like to offer support for other SQL Drivers, SQLLite, Postgres, etc.

Thanks to Felixge and all the node-mysql contributors Thanks to Ryan Dahl, Issacs and all the NodeJS Contributors and Community!

Enjoy!