loading...
Cover image for AlaSQL in Action: The JavaScript SQL Database
HarperDB

AlaSQL in Action: The JavaScript SQL Database

margo_hdb profile image Margo McCabe Updated on ・3 min read

What’s AlaSQL?

For starters, this open source project garners 11k weekly downloads off npm and has over 5K stars on GitHub.

I was surprised to see that there aren’t more posts about this popular lightweight client-side in-memory SQL database on dev.to, apart from this awesome article I found. However, AlaSQL’s website gets straight to the point:

  • JavaScript SQL database for browser and Node.js.
  • Handles both traditional relational tables and nested JSON data (NoSQL).
  • Export, store, and import data from localStorage, IndexedDB, or Excel.

What’s not to love? AlaSQL was designed to work in browser and Node.js, is fast, and super easy to use. Some say that when you need to find data fast, and want a better alternative to a full database or Redis, check out AlaSQL.

We love AlaSQL too.

HarperDB has had the pleasure of using AlaSQL for its backend SQL functionality. We chose to use AlaSQL because it has extensive language support, is well supported and extensible, has the ability to execute SQL against data sets (JSON or Arrays) and the ability to generate reusable functions. AlaSQL enables us to convert SQL language into an Abstract Syntax Tree (AST) that we can programmatically interpret into our data model. We are able to feed data into a processor that can perform the calculations native to SQL, using the functions defined in the library throughout our project as APIs and not just in the context of a SQL call.

AlaSQL is extensible and allows us to create custom functions. For example, we created a custom function called SEARCH_JSON that allows HarperDB users to search and transform nested documents. This function wraps a popular npm package called JSONata. With AlaSQL we were able to embed another open source package as a simple function call. Our implementation was as easy as defining the function (Note this is sample code):

const jsonata = require('jsonata');
/**
 * wrapper function that implements the JSONata library, which performs searches, transforms, etc... on JSON
 * @param {String} jsonata_expression - the JSONata expression to execute
 * @param {any} data - data which will be evaluated
 * @returns {any}
 */
function searchJSON(jsonata_expression, data){
    if(typeof jsonata_expression !== 'string' || jsonata_expression.length === 0){
        throw new Error('search json expression must be a non-empty string');
    }

    let alias = '__' + jsonata_expression + '__';

    if(hdb_utils.isEmpty(this.__ala__.res)){
        this.__ala__.res = {};
    }

    if(hdb_utils.isEmpty(this.__ala__.res[alias])) {
        let expression = jsonata(jsonata_expression);
        this.__ala__.res[alias] = expression;
    }
    return this.__ala__.res[alias].evaluate(data);
}
//Then define a custom function in AlaSQL:
const alasql = require('alasql');
alasql.fn.search_json = alasql.fn.SEARCH_JSON = searchJSON;


Clearly we are happy with our decision to use AlaSQL to interpret SQL into our data model and run performant queries against as much SQL as possible. That’s why we hosted the creators of AlaSQL on June 16th for a showcase to get an inside look at how AlaSQL was created, how it grew in popularity, and real world use cases and products. It was awesome to hear from AlaSQL creators Mathias Rangel Wulff and Andrey Gershun. After Q&A on AlaSQL, our CTO Kyle Bernhardy shared more about using AlaSQL as HarperDB’s engine to interpret and parse complex SQL into our data model and perform simple to complex SQL CRUD operations, as well as exposing other libraries like Turf.js, JSONata and more.



Looking for more resources on this innovative client-side in-memory SQL database? Check out this JavaScript library designed for:

  • Fast in-memory SQL data processing for BI and ERP applications on fat clients
  • Easy ETL and options for persistence by data import / manipulation / export of several formats
  • All major browsers, Node.js, and mobile applications

Posted on by:

margo_hdb profile

Margo McCabe

@margo_hdb

On the innovative team @ HarperDB.

HarperDB

HarperDB is a distributed database focused on making data management easy. It has an easy to use REST API, and supports NoSQL and SQL including joins. HarperDB leverages standard interfaces, and users can be up and running in minutes.

Discussion

markdown guide