whatisgithub

What is nquery?

windyrobin/nquery — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2013-04-16

1JavaScriptAudience · developerComplexity · 3/5DormantSetup · moderate

In one sentence

nQuery lets you query databases, key-value stores, and web APIs with one SQL-like language instead of learning a different tool for each data source.

Mindmap

mindmap
  root((repo))
    What it does
      SQL-like queries
      Works across data sources
      Joins across sources
    Tech stack
      JavaScript
      Node.js
    Use cases
      Add SQL to web services
      Check SQL syntax
      Consolidate multiple databases
    Audience
      Developers
      Backend engineers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Write one SQL-like query that joins data from a key-value store and a MySQL database.

USE CASE 2

Add SQL-style query support to an existing web service via a custom adapter.

USE CASE 3

Validate SQL syntax before sending it to another system.

USE CASE 4

Consolidate data pulled from multiple databases without writing custom glue code.

What is it built with?

JavaScriptNode.jsSQL

How does it compare?

windyrobin/nquery0xmukesh/docusaurus-tutoriala15n/andrewscheuermann
Stars111
LanguageJavaScriptJavaScriptJavaScript
Last pushed2013-04-162021-12-272015-01-11
MaintenanceDormantDormantDormant
Setup difficultymoderateeasymoderate
Complexity3/52/51/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Built for older Node.js versions and needs a custom adapter written per data source.

So what is it?

nQuery is a SQL engine that lets you query different types of data sources, databases, key-value stores, and web services, using a unified SQL-like language. Instead of learning different tools or APIs for each data source, you write SQL-like commands that nQuery translates and executes across whatever you're connecting to. Think of it as a translator. You tell nQuery what you want in SQL, and it figures out how to fetch that data from your actual storage system, whether that's a traditional database like MySQL, a simpler key-value store like HBase, or even an HTTP API. The main benefit is convenience: one query language works everywhere, and you can even join data across multiple sources in a single command, pulling user records from a key-value store and shop records from MySQL in one go. The engine does this by letting you plug in your own "adapter" or "loader" for each data source. You tell nQuery how to talk to your storage system (things like "here's how to fetch a single record" or "here's how to find records in a range"), and nQuery handles the rest. It also includes some procedural programming features, you can store intermediate results in variables and build complex multi-step queries, including concurrent or sequential execution depending on whether steps depend on each other. The README mentions this would be useful for scenarios like adding SQL support to your existing web services, checking SQL syntax before sending it elsewhere, or consolidating data from multiple databases without writing custom code. The project is relatively young (low star count, written for older Node.js versions), so it's more of a proof of concept or starting point than a production-ready tool, but it shows an interesting approach to making different data sources queryable through a common language.

Copy-paste prompts

Prompt 1
Help me write an nQuery adapter that lets it fetch records from my custom web API.
Prompt 2
Show me how to write an nQuery statement that joins a key-value store and a MySQL table.
Prompt 3
Explain how nQuery's procedural variables work for building multi-step queries.
Prompt 4
Walk me through getting nQuery running against an older Node.js version.

Frequently asked questions

What is nquery?

nQuery lets you query databases, key-value stores, and web APIs with one SQL-like language instead of learning a different tool for each data source.

What language is nquery written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, SQL.

Is nquery actively maintained?

Dormant — no commits in 2+ years (last push 2013-04-16).

How hard is nquery to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is nquery for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.