graphql-to-sql
v4.1.10
Published
Use GraphQL as the source of truth for schema. The SQL schema script is derived from the GraphQL type definitions.
Downloads
46
Readme
graphql-to-sql
Unify your SQL schema and your GraphQL schema. Manage schema from a single source of truth.
Example
node generate-sql.js
// generate-sql.js
import sqlDirective from 'graphql-to-sql'
import gql from 'graphql-tag'
const {
sqlDirectiveTypeDefs,
generateSql
} = sqlDirective('sql')
const typeDefs = gql`
directive @sql (
unicode: Boolean
auto: Boolean
default: String
index: Boolean
nullable: Boolean
primary: Boolean
type: String
unique: Boolean
generated: String
constraints: String
) on OBJECT | FIELD_DEFINITION
# See graphql-directive-private
directive @private on OBJECT | FIELD_DEFINITION
type User @sql(unicode: true) {
userId: String @sql(type: "BINARY(16)", primary: true)
uniqueColumn: Int @sql(unique: true)
databaseOnlyField: Int @sql @private
graphqlOnlyField: String
posts: [Post]
}
type Post {
postId: Int @sql(primary: true, auto: true)
userId: String @sql(type: "BINARY(16)", index: true)
content: String @sql(type: "VARCHAR(300)", unicode: true, nullable: true)
likes: Int @sql
dateCreated: String @sql(type: "TIMESTAMP", default: "CURRENT_TIMESTAMP")
}
type UserPair @sql(constraints: "UNIQUE(parentUserId, childUserId),\\n FOREIGN KEY (parentUserId) REFERENCES User(userId)") {
userPairId: String @sql(type: "BINARY(16)", primary: true)
parentUserId: String @sql(type: "BINARY(16)", index: true)
childUserId: String @sql(type: "BINARY(16)", index: true)
}
`
const sql = generateSql({typeDefs: [typeDefs, sqlDirectiveTypeDefs]}, {
databaseName: 'public', // for postgres, keeping public is recommended.
tablePrefix: 'test', // or test_
dbType: 'mysql' // or postgres
})
console.log('sql', sql)
The script above will produce this string:
CREATE TABLE IF NOT EXISTS `public`.`test_User` (
`userId` BINARY(16) NOT NULL,
`uniqueColumn` INT NOT NULL UNIQUE,
`databaseOnlyField` INT NOT NULL,
PRIMARY KEY (`userId`)
) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE TABLE IF NOT EXISTS `public`.`test_UserPair` (
`userPairId` BINARY(16) NOT NULL,
`parentUserId` BINARY(16) NOT NULL,
`childUserId` BINARY(16) NOT NULL,
PRIMARY KEY (`userPairId`),
INDEX `PARENTUSERIDINDEX` (`parentUserId` ASC),
INDEX `CHILDUSERIDINDEX` (`childUserId` ASC),
UNIQUE(parentUserId, childUserId),
FOREIGN KEY (parentUserId) REFERENCES User(userId)
);
CREATE TABLE IF NOT EXISTS `public`.`test_Post` (
`postId` INT NOT NULL AUTO_INCREMENT,
`userId` BINARY(16) NOT NULL,
`content` VARCHAR(300) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL,
`likes` INT NOT NULL,
`dateCreated` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (`postId`),
INDEX `USERIDINDEX` (`userId` ASC)
) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
Also see main-test.ts for a working example.
Arguments for @sql()
:
ON OBJECT:
- unicode
- Adds
CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci
as table_option.
- Adds
- constraints
- Any text written in here will be appended "as is" to the create_definition.
ON FIELD_DEFINITION:
- auto
- Marks a column as being AUTO_INCREMENT.
- Column with "auto" must have INT or SERIAL type.
- "default" is not allowed with "auto".
- "unicode" is not allowed with "auto".
- default
- Sets the DEFAULT clause.
- index
- Creates an index for the column.
- nullable
- Marks the column with NULL. By default, all columns are NOT NULL.
- primary
- Creates a PRIMARY KEY clause for the column.
- At least one column needs to be marked as "primary".
- "primary" is not allowed with "nullable".
- type
- Specify the column type.
- If type is not specified, the MySQL type will be inferred from the GraphQL type.
- GraphQLString types must be explicitly defined using "type".
- unicode
- If any column is marked with "unicode", then the table will have
CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci
.
- If any column is marked with "unicode", then the table will have
- unique
- Marks a column with the UNIQUE keyword.
- generated
- Marks a generated column.
- Example:
@sql(generated: "(data->>'$.test')")
. See main-test.ts for more examples.
SQL Features Supported:
- [x] Auto Increment
- [x] Default
- [x] Index
- [x] Not Null
- [x] Primary Key
- [x] Unicode
- [x] Unique
- [ ] Check
- [X] Constraints
- [X] Foreign Key (via @constraints)
- [x] Generated Columns
MySQL and PostgreSQL are supported.