All in one CLI tool for the database | SQLite, libSQL, PostgreSQL, MySQL, MariaDB
Install/upgrade latest version
curl -sSfL https://raw.githubusercontent.com/gigagrug/schema/main/install.sh | sh -s
Install specific version
curl -sSfL https://raw.githubusercontent.com/gigagrug/schema/main/install.sh | sh -s 0.1.0
Init project (default: db=sqlite url=./schema/dev.db)
schema -i
Init project using another db and url
schema -i -db="postgres" -url="postgresql://postgres:postgres@localhost:5432/postgres"
Init project with different root directory
schema -i -rdir="schema2"
Nessesary if using existing database
schema -pull
Create a SQL file
schema -create="initschema"
Go to ./schema/migrations/1_initschema.sql (This SQL is for sqlite)
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY AUTOINCREMENT,
username TEXT NOT NULL UNIQUE,
email TEXT NOT NULL UNIQUE,
password TEXT NOT NULL,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
CREATE TABLE IF NOT EXISTS posts (
id INTEGER PRIMARY KEY AUTOINCREMENT,
user_id INTEGER REFERENCES users(id) ON DELETE CASCADE,
title TEXT NOT NULL,
content TEXT NOT NULL,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
-- schema rollback
DROP TABLE users;
DROP TABLE posts;
Migrates all the sql files not migrated
schema -migrate
Migrates specific sql file
schema -migrate="1_initschema"
Rollbacks last migrated file
schema -rollback
schema -rollback="1_initschema"
Removes if file not migrated
schema -remove="1_initschema"
Doesn't save in _schema_migrations table if not in migrations dir so they can be reused
schema -create="insertdata" -dir="inserts"
Insert based on the SQL schema above.
WITH RECURSIVE generate_users AS (
SELECT ABS(RANDOM() % 10000) AS random_number, 1 AS row_number
UNION ALL
SELECT ABS(RANDOM() % 10000), row_number + 1
FROM generate_users
WHERE row_number < 5
)
INSERT INTO users (username, email, password)
SELECT
'user_' || random_number,
'user_' || random_number || '@example.com',
'password'
FROM generate_users;
WITH RECURSIVE user_list AS (
SELECT id, ROW_NUMBER() OVER () AS rn
FROM users
ORDER BY RANDOM()
LIMIT 5
),
post_insert AS (
SELECT
'Post #' || ABS(RANDOM() % 10000) AS title,
'This is a post about random topic #' || ABS(RANDOM() % 10000) AS content,
id AS user_id
FROM user_list
)
INSERT INTO posts (user_id, title, content)
SELECT user_id, title, content FROM post_insert;
schema -sql="0_insertdata.sql" -dir="inserts"
schema -sql="SELECT * FROM users"
schema -studio
schema -lsp
v
: Shows current and latest version
i
: Initializes project
pull
: Pulls database schema
migrate
: Migrates pending migrations
rollback
: Rollbacks last migration
studio
: Launch SQL TUI Studio
lsp
: Connect to your editor
rollback="[filename]"
Rollback a specific migration
migrate="[filename under migrations/]"
Run a specific migration
sql="[filename or sql query]"
Run SQL directly or from a file
create="[filename]"
: Create a new migration file
remove="[filename]"
: Remove an unmigrated file from disk and db
db="[sqlite, libsql, postgres, mysql, mariadb]"
(default sqlite)
url="[database url]"
(default ./schema/dev.db)
dir="[dir under rdir]"
(default migration)
rdir="[root directory]"
(default schema)