knex-unsorted-keys

knex.js

A SQL query builder that is flexible, portable, and fun to use!

A batteries-included, multi-dialect (MSSQL, MySQL, PostgreSQL, SQLite3, Oracle(including Oracle Wallet Authentication), WebSQL) query builder for Node.js and the Browser, featuring:

• transactions
• connection pooling
• streaming queries
• both a promise and callback API
• a thorough test suite
• the ability to run in the Browser

Read the full documentation to get started!

For support and questions, join the #bookshelf channel on freenode IRC

For an Object Relational Mapper, see:

• http://bookshelfjs.org
• https://github.com/Vincit/objection.js

To see the SQL that Knex will generate for a given query, see: Knex Query Lab

Examples

We have several examples on the website. Here is the first one to get you started:

var knex = require('knex')({
  dialect: 'sqlite3',
  connection: {
    filename: './data.db'
  }
});

// Create a table
knex.schema.createTable('users', function(table) {
  table.increments('id');
  table.string('user_name');
})

// ...and another
.createTable('accounts', function(table) {
  table.increments('id');
  table.string('account_name');
  table.integer('user_id').unsigned().references('users.id');
})

// Then query the table...
.then(function() {
  return knex.insert({user_name: 'Tim'}).into('users');
})

// ...and using the insert id, insert into the other table.
.then(function(rows) {
  return knex.table('accounts').insert({account_name: 'knex', user_id: rows[0]});
})

// Query both of the rows.
.then(function() {
  return knex('users')
    .join('accounts', 'users.id', 'accounts.user_id')
    .select('users.user_name as user', 'accounts.account_name as account');
})

// .map over the results
.map(function(row) {
  console.log(row);
})

// Finally, add a .catch handler for the promise chain
.catch(function(e) {
  console.error(e);
});

Changelog

0.14.4 - 19 Feb, 2018

Bug fixes:

• containsUndefined only validate plain objects. Fixes #1898 (#2468)
• Add warning when using .returning() in sqlite3. Fixes #1660 (#2471)
• Throw an error if .update() results in an empty sql (#2472)
• Removed unnecessary createTableIfNotExist and replaced with createTable (#2473)

New Features:

• Allow calling lock procedures (such as forUpdate) outside of transaction. Fixes #2403. (#2475)
• Added test and documentation for Event 'start' (#2488)

Test / internal changes:

• Added stress test, which uses TCP proxy to simulate flaky connection #2460
• Removed old docker tests, new stress test setup (#2474)
• Removed unused property __cid on the base client (#2481)
• Changed rm to rimraf in 'npm run dev' (#2483)
• Changed babel preset and use latest node as target when running dev (#2484)