Skip to content

public / sequelize

Go to a project

不要怂，就是干，撸起袖子干！

Switch branch/tag
datatypes.md 9.05 KB

Class DataTypes

View code A convenience class holding commonly used data types. The datatypes are used when defining a new model using Sequelize.define, like this:

sequelize.define('model', {
  column: DataTypes.INTEGER
})

When defining a model you can just as easily pass a string as type, but often using the types defined here is beneficial. For example, using DataTypes.BLOB, mean that that column will be returned as an instance of Buffer when being fetched by sequelize.

Some data types have special properties that can be accessed in order to change the data type. For example, to get an unsigned integer with zerofill you can do DataTypes.INTEGER.UNSIGNED.ZEROFILL. The order you access the properties in do not matter, so DataTypes.INTEGER.ZEROFILL.UNSIGNED is fine as well. The available properties are listed under each data type.

To provide a length for the data type, you can invoke it like a function: INTEGER(2)

Three of the values provided here (NOW, UUIDV1 and UUIDV4) are special default values, that should not be used to define types. Instead they are used as shorthands for defining default values. For example, to get a uuid field with a default value generated following v1 of the UUID standard:

sequelize.define('model', {
  uuid: {
    type: DataTypes.UUID,
    defaultValue: DataTypes.UUIDV1,
    primaryKey: true
  }
})

STRING()

View code A variable length string. Default length 255

Available properties: BINARY

CHAR()

View code A fixed length string. Default length 255

Available properties: BINARY

TEXT()

View code An (un)limited length text column. Available lengths: tiny, medium, long

INTEGER()

View code A 32 bit integer.

Available properties: UNSIGNED, ZEROFILL

BIGINT()

View code A 64 bit integer.

Available properties: UNSIGNED, ZEROFILL

FLOAT()

View code Floating point number (4-byte precision). Accepts one or two arguments for precision

Available properties: UNSIGNED, ZEROFILL

REAL()

View code Floating point number (4-byte precision). Accepts one or two arguments for precision

Available properties: UNSIGNED, ZEROFILL

DOUBLE()

View code Floating point number (8-byte precision). Accepts one or two arguments for precision

Available properties: UNSIGNED, ZEROFILL

DECIMAL()

View code Decimal number. Accepts one or two arguments for precision

Available properties: UNSIGNED, ZEROFILL

BOOLEAN()

View code A boolean / tinyint column, depending on dialect

TIME()

View code A time column

DATE()

View code A datetime column

DATEONLY()

View code A date only column

HSTORE()

View code A key / value column. Only available in postgres.

JSON()

View code A JSON string column. Only available in postgres.

JSONB()

View code A pre-processed JSON data column. Only available in postgres.

NOW()

View code A default value of the current timestamp

BLOB()

View code Binary storage. Available lengths: tiny, medium, long

RANGE()

View code Range types are data types representing a range of values of some element type (called the range's subtype). Only available in postgres. See {@link http://www.postgresql.org/docs/9.4/static/rangetypes.html|Postgres documentation} for more details

UUID()

View code A column storing a unique univeral identifier. Use with UUIDV1 or UUIDV4 for default values.

UUIDV1()

View code A default unique universal identifier generated following the UUID v1 standard

UUIDV4()

View code A default unique universal identifier generated following the UUID v2 standard

VIRTUAL()

View code A virtual value that is not stored in the DB. This could for example be useful if you want to provide a default value in your model that is returned to the user but not stored in the DB.

You could also use it to validate a value before permuting and storing it. Checking password length before hashing it for example:

sequelize.define('user', {
  password_hash: DataTypes.STRING,
  password: {
    type: DataTypes.VIRTUAL,
    set: function (val) {
       this.setDataValue('password', val); // Remember to set the data value, otherwise it won't be validated
       this.setDataValue('password_hash', this.salt + val);
     },
     validate: {
        isLongEnough: function (val) {
          if (val.length < 7) {
            throw new Error("Please choose a longer password")
         }
      }
    }
  }
})

VIRTUAL also takes a return type and dependency fields as arguments If a virtual attribute is present in attributes it will automatically pull in the extra fields aswell. Return type is mostly usefull for setups that rely on types like GraphQL.

{
  active: {
    type: new DataTypes.VIRTUAL(DataTypes.BOOLEAN, ['createdAt']),
    get: function() {
      return this.get('createdAt') > Date.now() - (7 * 24 * 60 * 60 * 1000) 
    }
  }
}

In the above code the password is stored plainly in the password field so it can be validated, but is never stored in the DB.
__Aliases:__ NONE

***

<a name="enum"></a>
## `ENUM()`
[View code](https://github.com/sequelize/sequelize/blob/95f8fc2783814cd61ec1a8d623b23cd6a7cd5e17/lib/data-types.js#L695)
An enumeration. `DataTypes.ENUM('value', 'another value')`.


***

<a name="array"></a>
## `ARRAY()`
[View code](https://github.com/sequelize/sequelize/blob/95f8fc2783814cd61ec1a8d623b23cd6a7cd5e17/lib/data-types.js#L719)
An array of `type`, e.g. `DataTypes.ARRAY(DataTypes.DECIMAL)`. Only available in postgres.

***

_This document is automatically generated based on source code comments. Please do not edit it directly, as your changes will be ignored. Please write on <a href="irc://irc.freenode.net/#sequelizejs">IRC</a>, open an issue or a create a pull request if you feel something can be improved. For help on how to write source code documentation see [JSDoc](http://usejsdoc.org) and [dox](https://github.com/tj/dox)_