sqlite-jsonschema

一个使用JSON Schema验证JSON对象的SQLite扩展。基于sqlite-loadable-rs和jsonschema crate。

如果您的公司或组织认为这个库很有用，请考虑支持我的工作！

用法

.load ./jsonschema0
select jsonschema_matches('{"maxLength": 5}', json_quote('alex'));

与SQLite的CHECK约束一起使用，在将数据插入表中之前验证JSON列。

create table students(
  -- ensure that JSON objects stored in the data column have "firstName" strings,
  -- "lastName" strings, and "age" integers that are greater than 0.
  data json check (
    jsonschema_matches(
      json('
        {
          "type": "object",
          "properties": {
            "firstName": {
              "type": "string"
            },
            "lastName": {
              "type": "string"
            },
            "age": {
              "type": "integer",
              "minimum": 0
            }
          }
        }
        '),
      data
    )
  )
);

insert into students(data)
  values ('{"firstName": "Alex", "lastName": "Garcia", "age": 100}');
-- ✓


insert into students(data)
  values ('{"firstName": "Alex", "lastName": "Garcia", "age": -1}');
-- Runtime error: CHECK constraint failed: jsonschema_matches

找到所有不符合JSON Schema的列值。

select
  rowid,
  jsonschema_matches(
    '{
      "type": "array",
      "items": {
        "type": "number"
      }
    }',
    foo
  ) as valid
from bar
where not valid;

安装

语言	安装
Python	pip install sqlite-jsonschema
Datasette	datasette install datasette-sqlite-jsonschema
Node.js	npm install sqlite-jsonschema
Deno	deno.land/x/sqlite_jsonschema
Ruby	gem install sqlite-jsonschema
Github发布
Rust	cargoadd sqlite-jsonschema

sqlite-jsonschema为Python、Node.js和Deno程序员提供在pip、npm和https://docs.deno.org.cn/x上的分发。还有适用于其他环境的预构建扩展可用。

Python

对于Python开发者，使用sqlite-jsonschema Python包

pip install sqlite-jsonschema

然后可以将sqlite-jsonschema扩展加载到sqlite3连接对象中。

import sqlite3
import sqlite_jsonschema

db = sqlite3.connect(':memory:')
sqlite_jsonschema.load(db)
db.execute('select jsonschema_version(), jsonschema()').fetchone()

有关使用Python的详细信息，请参阅使用sqlite-jsonschema与Python。

Node.js

对于Node.js开发者，使用sqlite-jsonschema NPM包

npm install sqlite-jsonschema

然后可以将sqlite-jsonschema扩展加载到better-sqlite3或node-sqlite3连接中。

import Database from "better-sqlite3";
import * as sqlite_jsonschema from "sqlite-jsonschema";

const db = new Database(":memory:");

db.loadExtension(sqlite_jsonschema.getLoadablePath());

const version = db.prepare("select jsonschema_version()").pluck().get();
console.log(version); // "v0.2.0"

有关使用Node.js的详细信息，请参阅使用sqlite-jsonschema与Node.js。

Deno

对于 Deno 开发者，请使用 x/sqlite_jsonschema Deno 模块，与 x/sqlite3 一起。

import { Database } from "https://docs.deno.org.cn/x/[email protected]/mod.ts";
import * as sqlite_jsonschema from "https://docs.deno.org.cn/x/sqlite_jsonschema/mod.ts";

const db = new Database(":memory:");

db.enableLoadExtension = true;
db.loadExtension(sqlite_jsonschema.getLoadablePath());

const [version] = db
  .prepare("select jsonschema_version()")
  .value<[string]>()!;

console.log(version);

有关详情，请参阅 在 Deno 中使用 sqlite-jsonschema。

Datasette

对于 Datasette，请使用 datasette-sqlite-jsonschema 插件，将 sqlite-jsonschema 函数添加到您的 Datasette 实例中。

datasette install datasette-sqlite-jsonschema

有关详情，请参阅 在 Datasette 中使用 sqlite-jsonschema。

.load ./jsonschema0
select jsonschema_version();
'v0.2.1'

git clone https://github.com/asg017/sqlite-jsonschema.git
cd sqlite-jsonschema
make loadable-release