knex-expo

knex.js

This is a port to Expo for react-native. Require Expo to be installed and configured first.

Because there are limited tools for the Expo platform, we only support "sqlite" driver.

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'
});

// 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)