Columns | qb

The Blueprint object has many column types available to construct your table schema. Additionally, you can modify the columns created with an additional set of methods and indexes.

bigIncrements

Create an auto-incrementing column using an unsigned BIGINT type. This column is also set as the primary key for the table.

Example:

SchemaBuilder

schema.create( "users", function( table ) {
    table.bigIncrements( "id" );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
    CONSTRAINT `pk_users_id` PRIMARY KEY (`id`)
)

bigInteger

Create a column using a BIGINT equivalent type for your database.

Example (no precision):

SchemaBuilder

schema.create( "users", function( table ) {
    table.bigInteger( "salary" );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `salary` BIGINT NOT NULL
)

Example (with precision):

SchemaBuilder

schema.create( "users", function( table ) {
    table.bigInteger( "salary", 5 );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `salary` BIGINT(5) NOT NULL
)

bit

Create a column using a BIT equivalent type for your database. The length can be specified as the second argument.

Example (default length):

SchemaBuilder

schema.create( "users", function( table ) {
    table.bit( "is_active" );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `is_active` BIT(1) NOT NULL
)

Example (custom length):

SchemaBuilder

schema.create( "users", function( table ) {
    table.bit( "is_active", 2 );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `is_active` BIT(2) NOT NULL
)

boolean

Create a column using a BOOLEAN equivalent type for your database.

Example:

SchemaBuilder

schema.create( "users", function( table ) {
    table.boolean( "is_subscribed" );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `is_subscribed` TINYINT(1) NOT NULL
)

char

Create a column using a CHAR equivalent type for your database.

Example (default length):

SchemaBuilder

schema.create( "students", function( table ) {
    table.char( "grade" );
} );

SQL (MySQL)

CREATE TABLE `students` (
    `grade` CHAR(1) NOT NULL
)

Example (custom length):

SchemaBuilder

schema.create( "users", function( table ) {
    table.char( "tshirt_size", 4 );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `tshirt_size` CHAR(4) NOT NULL
)

date

Create a column using a DATE equivalent type for your database.

Example:

SchemaBuilder

schema.create( "users", function( table ) {
    table.date( "birthday" );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `birthday` DATE NOT NULL
)

datetime

Create a column using a DATETIME equivalent type for your database.

Example:

SchemaBuilder

schema.create( "users", function( table ) {
    table.datetime( "hire_date" );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `hire_date` DATETIME NOT NULL
)

datetimeTz

Create a column using a timezone-specific DATETIME equivalent type for your database.

Some databases do not have the concept of a timezone-specific datetime. Those databases will use a normal DATETIME type.

Example:

SchemaBuilder

schema.create( "posts", function( table ) {
    table.datetimeTz( "posted_date" );
} );

SQL (SQL Server)

CREATE TABLE [posts] (
    [posted_date] DATETIMEOFFSET NOT NULL
)

decimal

Create a column using a DECIMAL equivalent type for your database. The length and precision can be specified as the second and third arguments.

Example (with defaults):

SchemaBuilder

schema.create( "weather", function( table ) {
    table.decimal( "temperature" );
} );

SQL (MySQL)

CREATE TABLE `weather` (
    `temperature` DECIMAL(10,0) NOT NULL
)

Example (with length):

SchemaBuilder

schema.create( "weather", function( table ) {
    table.decimal( "temperature", 4 );
} );

SQL (MySQL)

CREATE TABLE `weather` (
    `temperature` DECIMAL(4,0) NOT NULL
)

Example (with precision):

SchemaBuilder

schema.create( "weather", function( table ) {
    table.decimal( name = "temperature", precision = 2 );
} );

SQL (MySQL)

CREATE TABLE `weather` (
    `temperature` DECIMAL(10,2) NOT NULL
)

enum

Create a column using a ENUM equivalent type for your database.

Example:

SchemaBuilder

schema.create( "users", function( table ) {
    table.enum( "tshirt_size", [ "S", "M", "L", "XL", "XXL" ] );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `tshirt_size` ENUM(`S`, `M`, `L`, `XL`, `XXL`) NOT NULL
)

float

Create a column using a FLOAT equivalent type for your database. The length and precision can be specified as the second and third arguments.

Example (with defaults):

SchemaBuilder

schema.create( "weather", function( table ) {
    table.float( "temperature" );
} );

SQL (MySQL)

CREATE TABLE `weather` (
    `temperature` FLOAT(10,0) NOT NULL
)

Example (with length):

SchemaBuilder

schema.create( "weather", function( table ) {
    table.float( "temperature", 4 );
} );

SQL (MySQL)

CREATE TABLE `weather` (
    `temperature` FLOAT(4,0) NOT NULL
)

Example (with precision):

SchemaBuilder

schema.create( "weather", function( table ) {
    table.float( name = "temperature", precision = 2 );
} );

SQL (MySQL)

CREATE TABLE `weather` (
    `temperature` FLOAT(10,2) NOT NULL
)

guid

SQL Server: Create a column using a uniqueidentifier.

MySQL and Others: Create a column using a CHAR equivalent type for your database and a length of 36. Used in conjunction with the Lucee createGUID method or Java's java.util.UUID.randomUUID().

Example:

SchemaBuilder

schema.create( "users", function( table ) {
    table.guid( "id" ).primaryKey();
} );

MySQL (SQL Server)

CREATE TABLE `games` (
    `id` uniqueidentifier NOT NULL,
    CONSTRAINT `pk_games_id` PRIMARY KEY (`id`)
)

SQL (MySQL)

CREATE TABLE `games` (
    `id` VARCHAR(36) NOT NULL,
    CONSTRAINT `pk_games_id` PRIMARY KEY (`id`)
)

increments

Create an auto-incrementing column using an unsigned INTEGER type. This column is also set as the primary key for the table.

Example:

SchemaBuilder

schema.create( "users", function( table ) {
    table.increments( "id" );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `id` INTEGER UNSIGNED NOT NULL AUTO_INCREMENT,
    CONSTRAINT `pk_users_id` PRIMARY KEY (`id`)
)

integer

Create a column using a INTEGER equivalent type for your database.

Example (no precision):

SchemaBuilder

schema.create( "games", function( table ) {
    table.integer( "score" );
} );

SQL (MySQL)

CREATE TABLE `games` (
    `score` INTEGER NOT NULL
)

Example (with precision):

SchemaBuilder

schema.create( "games", function( table ) {
    table.integer( "score", 3 );
} );

SQL (MySQL)

CREATE TABLE `games` (
    `score` INTEGER(3) NOT NULL
)

json

Create a column using a JSON equivalent type for your database.

Example:

SchemaBuilder

schema.create( "users", function( table ) {
    table.json( "options" ).nullable();
} );

SQL (MySQL)

CREATE TABLE `users` (
    `options` JSON
)

lineString

Create a column using a LINESTRING equivalent type for your database.

Example:

SchemaBuilder

schema.create( "users", function( table ) {
    table.lineString( "positions" );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `positions` LINESTRING NOT NULL
)

longText

Create a column using a LONGTEXT equivalent type for your database.

Example:

SchemaBuilder

schema.create( "posts", function( table ) {
    table.longText( "body" );
} );

SQL (MySQL)

CREATE TABLE `posts` (
    `body` LONGTEXT NOT NULL
)

mediumIncrements

Create an auto-incrementing column using an unsigned MEDIUMINT type. This column is also set as the primary key for the table.

Example:

SchemaBuilder

schema.create( "users", function( table ) {
    table.mediumIncrements( "id" );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `id` MEDIUMINT UNSIGNED NOT NULL AUTO_INCREMENT,
    CONSTRAINT `pk_users_id` PRIMARY KEY (`id`)
)

mediumInteger

Create a column using a MEDIUMINT equivalent type for your database.

Example (no precision):

SchemaBuilder

schema.create( "games", function( table ) {
    table.mediumInteger( "score" );
} );

SQL (MySQL)

CREATE TABLE `games` (
    `score` MEDIUMINT NOT NULL
)

Example (with precision):

SchemaBuilder

schema.create( "games", function( table ) {
    table.mediumInteger( "score", 5 );
} );

SQL (MySQL)

CREATE TABLE `games` (
    `score` MEDIUMINT(5) NOT NULL
)

mediumText

Create a column using a MEDIUMTEXT equivalent type for your database. For databases that distinguish between unicode and non-unicode fields, creates a non-unicode field.

Example:

SchemaBuilder

schema.create( "posts", function( table ) {
    table.mediumText( "body" );
} );

SQL (MySQL)

CREATE TABLE `posts` (
    `body` MEDIUMTEXT NOT NULL
)

SQL (MSSQL)

CREATE TABLE `posts` (
    `body` VARCHAR(MAX) NOT NULL
)

money

Create a column using a MONEY equivalent type for your database.

Example:

SchemaBuilder

schema.create( "transactions", function( table ) {
    table.money( "amount" );
} );

SQL (MySQL)

CREATE TABLE `transactions` (
    `amount` INTEGER NOT NULL
)

SQL (MSSQL)

CREATE TABLE [transactions] (
    [amount] MONEY NOT NULL
)

morphs

Creates the necessary columns for a polymorphic relationship. It takes the name provided and creates an _id and an _type column.

If you want different names for your polymorphic relationship columns, feel free to call other schema builder methods individually.

Example:

SchemaBuilder

schema.create( "tags", function( table ) {
    table.morphs( "taggable" );
} );

SQL (MySQL)

CREATE TABLE `tags` (
    `taggable_id` INTEGER UNSIGNED NOT NULL,
    `taggable_type` VARCHAR(255) NOT NULL,
    INDEX `taggable_index` (`taggable_id`, `taggable_type`)
)

nullableMorphs

Creates the necessary columns for a polymorphic relationship. It takes the name provided and creates an _id and an _type column. The only difference between this method and morphs is that the columns created here are nullable.

If you want different names for your polymorphic relationship columns, feel free to call other schema builder methods individually.

Example:

SchemaBuilder

schema.create( "tags", function( table ) {
    table.nullableMorphs( "taggable" );
} );

SQL (MySQL)

CREATE TABLE `tags` (
    `taggable_id` INTEGER UNSIGNED,
    `taggable_type` VARCHAR(255),
    INDEX `taggable_index` (`taggable_id`, `taggable_type`)
)

nullableTimestamps

Creates the createdDate and modifiedDate TIMESTAMP columns. It creates the columns as nullable.

If you want different names for your timestamp columns, feel free to call other schema builder methods individually.

Example:

SchemaBuilder

schema.create( "posts", function( table ) {
    table.nullableTimestamps();
} );

SQL (MySQL)

CREATE TABLE `posts` (
    `createdDate` TIMESTAMP,
    `modifiedDate` TIMESTAMP
)

point

Create a column using a POINT equivalent type for your database.

Example:

SchemaBuilder

schema.create( "users", function( table ) {
    table.point( "position" );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `position` POINT NOT NULL
)

polygon

Create a column using a POLYGON equivalent type for your database.

Example:

SchemaBuilder

schema.create( "users", function( table ) {
    table.polygon( "positions" );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `positions` POLYGON NOT NULL
)

raw

An escape hatch to directly insert any sql in to the statement.

Example:

SchemaBuilder

schema.create( "users", function( table ) {
    table.raw( "`profile_image` BLOB NOT NULL" );
} );

SQL (MySQL)

CREATE TABLE `users` (
    `profile_image` BLOB NOT NULL
)

smallIncrements

Create an auto-incrementing column using an unsigned SMALLINT type. This column is also set as the primary key for the table.

Example:

SchemaBuilder