loics2 loics2 - 3 years ago 302
Node.js Question

Associations in Sequelize migrations

My app currently uses the Sequelize

method to create the database, and I want to change it to use the migrations system.

One of my model has
associations with other models, and I don't really know how to make the initial migration code for these associations.

Do I have to manually create the foreign key with SQL queries, or is there some methods available?

Answer Source

Case 1: Database initialization

If your purpose is to add relations during initialization of database structure it is better to just use sync method instead of manually adding them using migrations. If your models are properly designed and have relations defined, they will be created automatically during execution of sync method.

Take a look at sequelize express example. In models directory you have three files:

  • index.js - which includes all models
  • task.js - task model
  • user.js - user model

Look at task.js content, starting from line 7 the following code creates a relation between User and Task models:

classMethods: {
  associate: function(models) {
    Task.belongsTo(models.User, {
      onDelete: "CASCADE",
      foreignKey: {
        allowNull: false

If you correctly prepare your relations in model files, sync will create the foreign keys for you. Migrations aren't necessary in this case.

I encourage you to read the whole express-example readme.md and browse repository files to see how the things work with express and sequelize.

Case 2: Database structure migration

In case you already have some data which you want to keep, you need to use migration script, because the only way for sync to restructure your database is to destroy it completely alongside with all its data.

You can read about basic migrations in the sequelize docs. Unfortunately docs do not cover creating a relation. Let's assume you want to create the following relation: User belongs to Group. To create column on the user side of relation, you may use addColumn method.

    type: Sequelize.INTEGER,
    allowNull: true

Unfortunately there isn't a nice function (yet) to create the foreign key constraint for you, but you can do it manually using sequelize query method. Postgresql example:

queryInterface.sequelize.query("ALTER TABLE user
  ADD CONSTRAINT user_group_id_fkey FOREIGN KEY (group_id)

Edit: Added database structure migration case

Recommended from our users: Dynamic Network Monitoring from WhatsUp Gold from IPSwitch. Free Download