Fibjs SQL DDL Synchronization

NOTICE: This is node-sql-ddl-sync's fibjs version, thx a lot to node-sql-ddl-sync's author : )

Install

1npm install @fxjs/sql-ddl-sync

Dialects

• MySQL
• SQLite

About

Originally, this module is part of @fxjs/orm. It's used synchronize model tables in supported dialects.

But now, it could run without @fxjs/orm, just install @fxjs/db-driver instead 🚀 Sorry there is no API documentation for now but there are a couple of tests you can read and find out how to use it if you want.

Version Match

sql-ddl-sync Version	required orm Version
sql-ddl-sync <= 0.3.x	orm < 1.10.3
sql-ddl-sync = 0.4.x	orm >= 1.10.3
sql-ddl-sync >= 0.5.x	don't need!

Example

Install @fxjs/db-driver. Create a file with the contents below and change insert your database credentials. Run once and you'll see table ddl_sync_test appear in your database. Then make some changes to it (add/drop/change columns) and run the code again. Your table should always return to the same structure.

1const DBDriver   = require("@fxjs/db-driver");
2const mysql = require("mysql");
3const Sync  = require("@fxjs/sql-ddl-sync").Sync;
4
5const dbdriver = DBDriver.create("mysql://username:password@localhost/database");
6
7const sync = new Sync({
8	dbdriver: dbdriver,
9	debug   : function (text) {
10		console.log("> %s", text);
11	}
12});
13
14sync.defineCollection("ddl_sync_test", {
15	id     : { type: "serial", key: true, serial: true },
16	name   : { type: "text", required: true },
17	age    : { type: "integer" },
18	male   : { type: "boolean" },
19	born   : { type: "date", time: true },
20	born2  : { type: "date" },
21	int2   : { type: "integer", size: 2 },
22	int4   : { type: "integer", size: 4 },
23	int8   : { type: "integer", size: 8 },
24	float4 : { type: "number",  size: 4 },
25	float8 : { type: "number",  size: 8 },
26	photo  : { type: "binary" }
27});
28
29try {
30	sync.sync()
31	console.log("> Sync Done");
32} catch (err) {
33	if (err) {
34		console.log("> Sync Error");
35		console.log(err);
36	}
37}
38
39process.exit(0);

Test

To test, first make sure you have development dependencies installed. Go to the root folder and do:

1npm install

Then, just run the tests.

1npm test

If you have a supported database server and want to test against it, first install the module:

And then run:

1URI=mysql://username:password@localhost/database fibjs test/run-db

Credits

This repo is checked out from Diogo Resende's node-sql-ddl-sync, which is one part of orm, and orm is the original source of @fxjs/orm. Thx a lot to him and his partner.