https://github.com/florents-tselai/litejq

jq extension for SQLite.
https://github.com/florents-tselai/litejq

databases dsl jq json sqlite

Last synced: about 13 hours ago
JSON representation

jq extension for SQLite.

• Host: GitHub
• URL: https://github.com/florents-tselai/litejq
• Owner: Florents-Tselai
• License: mit
• Created: 2024-02-22T17:29:42.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-07-08T07:18:36.000Z (4 months ago)
• Last Synced: 2024-10-28T05:33:01.803Z (18 days ago)
• Topics: databases, dsl, jq, json, sqlite
• Language: C
• Homepage: https://tselai.com/litejq.html
• Size: 215 KB
• Stars: 90
• Watchers: 3
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# liteJQ: jq support in SQLite













**liteJQ** is an SQLite extension, written in C, that brings `jq` support to SQLite.

It uses vanilla `libjq`.

*Note*: If you like the idea, but you're more into Postgres, check out: [pgJQ: jq extension for Postgres](https://github.com/Florents-Tselai/pgJQ)

## Motivation

SQLite has been supporting JSON for years.

Complex queries, however, involving JSON can be more cumbersome to write and understand,

especially when compared to more complex systems like PostgreSQL.

**liteJQ** attempts to alleviate that by bringing the expressive power of jq into SQLite.

## Installation

```sh

make

```

This produces a `litejq` binary object, which should be loaded in SQLite at runtime.

Verify the installation.

```sh

sqlite3 :memory: < 1980');

```

The above query is equivalent to this one

```sql

select jq(d, '{title: .title, year: .year}')

from movies

where jq(d, '.year') > 1980;

```

**Extract Movies with Specific Keywords in Extract**

```sql

select jq(d, '.extract')

from movies

where jq(d, '.extract | contains("silent")');

```

**Filter movies by a specific genre (e.g., Drama)**

```sql

select jq(d, '{title: .title, year: .year, genres: .genres}')

from movies

where jq(d, '.genres[] == "Drama"');

```

**Filter movies where "Joan Lorring" and "John Dall" played together**

```sql

select jq(d, '{title: .title, year: .year, cast: .cast}')

from movies

where jq(d, '.cast | contains(["Joan Lorring", "John Dall"])');

```

**Group by movies by release year**

```sql

select jq(d, '.year'), count(*)

from movies

group by jq(d, '.year')

```

## Notes On Installation

For this to work, you'll need development files for both SQLite and jq.

### MacOS

```sh

brew install jq sqlite3

make all

```

I've found that `brew` installs header files auomatically for you,

so there's nothing else you have to do

Verify installation

```sh

sqlite3 :memory: <