sequelize là gì
Sequelize là một ORM Node.js hỗ trợ liên kết với các database như Postgres, MySQL, MariaDB, SQLite và Microsoft SQL Server. Trong bài viết này mình sẽ cùng các bạn tạo model, migrations và seed với sequelize-cli. Bắt đầu thôi nào 
Cài đặt
trước hết chúng ta cần phải cài đặt sequelize, mình dùng yarn để cài sequelize nếu bạn nào chưa cài yarn thì có thể xem ở đây https://classic.yarnpkg.com/en/docs/install/#debian-stable.
1 Cài đặt sequelize:
1 2 | yarn add sequelize |
2 Cài hệ quản trị cở sở dữ liệu:
1 2 | yarn add mysql |
ở đây mình sử dụng mysql, các bạn có thể sử dụng các hệ quản trị cơ sở dữ liệu khác như sau :
1 2 3 4 | yarn add mariadb yarn add sqlite3 yarn add tedious |
3 Cài sequelize-cli:
1 2 | yarn global add sequelize-cli |
Tiếp theo chúng ta sẽ tạo Project với lệnh
1 2 | npx sequelize-cli init |
Chạy lệnh trên sẽ tạo ra 4 folders như sau :
- config: chứa file caais hình cho CLI biết cách kết nối với cơ sở dữ liệu.
- migrations: chứa tất cả các file migration.
- models: chứa tất cả các model của project
- seeder: chứa tất cả các file seeds
Trước khi tạo model chúng ta cần phải cấu hình lại một chút để CLI biết cách kết nối với cơ sở dữ liệu, bằng cách mở file: config.js/config
Bạn cần thay đổi username với password sao cho đúng với username password trong hệ quản trị cơ sở dữ liệu của bạn. Một số lưu ý nhỏ là diaclect Sequelize CLI mặc định là mysql vì thế khi bản sử dụng hệ cơ sở dữ liệu khác bạn cần phải đổi lại cho phù hợp, nếu bạn chưa tạo cơ sở dữ liệu thì bạn cần chạy thêm lệnh sequelize db:create để tạo cơ sở dữ liệu được chỉ định trong file config.js. Được rồi bây giờ chúng ta sẽ bắt đầu tạo migration luôn nhé 
Tạo Model (và Migration)
Chúng ta chỉ cần chạy lệnh:
1 2 | npx sequelize-cli model:generate --name Contact --attributes realName:string,address:string |
Ở đây chúng ta chỉ cần chú ý đến :
- name: tên của model
- attributes: danh sách các thuộc tính
Ở trên sau khi chạy lệnh sẽ tạo ra 1 model có tên là Contact với thuộc tính là realName, address trong thư mục model, và một file 20200305015249-create-contact.js trong thư mục migration
Đây là file contact.js:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | <span class="token keyword">const</span> createModel <span class="token operator">=</span> <span class="token punctuation">(</span>sequelize<span class="token punctuation">,</span> DataTypes<span class="token punctuation">)</span> <span class="token operator">=</span><span class="token operator">></span> <span class="token punctuation">{</span> <span class="token keyword">const</span> Contact <span class="token operator">=</span> sequelize<span class="token punctuation">.</span><span class="token function">define</span><span class="token punctuation">(</span><span class="token single-quoted-string string">'Contact'</span><span class="token punctuation">,</span> <span class="token punctuation">{</span> eventId<span class="token punctuation">:</span> DataTypes<span class="token punctuation">.</span><span class="token constant">INTEGER</span><span class="token punctuation">,</span> realName<span class="token punctuation">:</span> DataTypes<span class="token punctuation">.</span><span class="token constant">STRING</span><span class="token punctuation">,</span> address<span class="token punctuation">:</span> DataTypes<span class="token punctuation">.</span><span class="token constant">STRING</span><span class="token punctuation">,</span> phone<span class="token punctuation">:</span> DataTypes<span class="token punctuation">.</span><span class="token constant">STRING</span><span class="token punctuation">,</span> birthday<span class="token punctuation">:</span> DataTypes<span class="token punctuation">.</span><span class="token constant">DATE</span><span class="token punctuation">,</span> <span class="token punctuation">}</span><span class="token punctuation">,</span> <span class="token punctuation">{</span><span class="token punctuation">}</span><span class="token punctuation">)</span> Contact<span class="token punctuation">.</span>associate <span class="token operator">=</span> <span class="token keyword">function</span> <span class="token punctuation">(</span>models<span class="token punctuation">)</span> <span class="token punctuation">{</span> Contact<span class="token punctuation">.</span><span class="token function">belongsTo</span><span class="token punctuation">(</span>models<span class="token punctuation">.</span>Event<span class="token punctuation">,</span> <span class="token punctuation">{</span> foreignKey<span class="token punctuation">:</span> <span class="token single-quoted-string string">'eventId'</span><span class="token punctuation">,</span> <span class="token keyword">as</span><span class="token punctuation">:</span> <span class="token single-quoted-string string">'event'</span> <span class="token punctuation">}</span><span class="token punctuation">)</span> <span class="token punctuation">}</span> <span class="token keyword">return</span> Contact <span class="token punctuation">}</span> export <span class="token keyword">default</span> createModel |
Ở đây tôi có thêm các attributes như là phone,brithhday…
Tương tự tôi cũng tạo thêm một model nữa có tên là Event. Ở đây tôi xác định mối quan hệ giữa Event và Contact là 1-n vì thế chúng ta cần khai báo trong phần Contact.associate tôi phải xét quan hệ cho nó với Event là belongTo với khóa ngoại là eventId. Tương tự bên Event tôi cũng có :
1 2 3 4 5 6 | Event<span class="token punctuation">.</span>associate <span class="token operator">=</span> <span class="token keyword">function</span> <span class="token punctuation">(</span>models<span class="token punctuation">)</span> <span class="token punctuation">{</span> Event<span class="token punctuation">.</span><span class="token function">hasMany</span><span class="token punctuation">(</span>models<span class="token punctuation">.</span>Contact<span class="token punctuation">,</span> <span class="token punctuation">{</span> foreignKey<span class="token punctuation">:</span> <span class="token single-quoted-string string">'eventId'</span><span class="token punctuation">,</span> <span class="token keyword">as</span><span class="token punctuation">:</span> <span class="token single-quoted-string string">'contact'</span> <span class="token punctuation">}</span><span class="token punctuation">)</span> <span class="token punctuation">}</span> |
Tiếp theo là chạy migration:
Chạy Migration
Chạy migration với lệnh :
1 2 | npx sequelize-cli db:migrate |
Lệnh này sẽ thực thi các bước :
- Gọi đến bảng SequelizeMeta trong cơ sở dữ liệu, bảng này có nhiêm vụ lưu lại những migration đã chạy trên cơ sở dữ liệu hiện tại
- Tiếp theo là tìm kiếm các file trong mucj migration nào chưa được chạy nhờ vào bảng SequelizeMeta ở trên và chạy chúng
- Cuối cùng là tạo ra một bảng có tên và các thuộc tính như trong file migration
Tạo seed
Để tạo seed chúng ta chạy câu lệnh :
1 2 | npx sequelize-cli seed:generate --name seed-event |
ở lệnh trên tôi đã tạo ra một seed có tên là seed-event vào bảng Event. bây giờ hãy vào thư mục seeders để chỉnh sửa nó nhé ))
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 | export <span class="token keyword">default</span> <span class="token punctuation">{</span> up<span class="token punctuation">:</span> <span class="token punctuation">(</span>queryInterface<span class="token punctuation">,</span> Sequelize<span class="token punctuation">)</span> <span class="token operator">=</span><span class="token operator">></span> <span class="token punctuation">{</span> <span class="token keyword">return</span> queryInterface<span class="token punctuation">.</span><span class="token function">bulkInsert</span><span class="token punctuation">(</span> <span class="token single-quoted-string string">'Events'</span><span class="token punctuation">,</span> <span class="token punctuation">[</span> <span class="token punctuation">{</span> title<span class="token punctuation">:</span> <span class="token single-quoted-string string">'year end party'</span><span class="token punctuation">,</span> numberOfSubscribers<span class="token punctuation">:</span> <span class="token number">814</span><span class="token punctuation">,</span> numberOfParticipants<span class="token punctuation">:</span> <span class="token number">670</span><span class="token punctuation">,</span> startTime<span class="token punctuation">:</span> <span class="token keyword">new</span> <span class="token class-name">Date</span><span class="token punctuation">(</span><span class="token single-quoted-string string">'2020-05-01T00:00:00.000Z'</span><span class="token punctuation">)</span><span class="token punctuation">,</span> endTime<span class="token punctuation">:</span> <span class="token keyword">new</span> <span class="token class-name">Date</span><span class="token punctuation">(</span><span class="token single-quoted-string string">'2020-06-01T00:00:00.000Z'</span><span class="token punctuation">)</span><span class="token punctuation">,</span> createdAt<span class="token punctuation">:</span> <span class="token keyword">new</span> <span class="token class-name">Date</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">,</span> updatedAt<span class="token punctuation">:</span> <span class="token keyword">new</span> <span class="token class-name">Date</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">}</span><span class="token punctuation">,</span> <span class="token punctuation">]</span><span class="token punctuation">,</span> <span class="token punctuation">{</span><span class="token punctuation">}</span><span class="token punctuation">)</span> <span class="token punctuation">}</span><span class="token punctuation">,</span> down<span class="token punctuation">:</span> <span class="token punctuation">(</span>queryInterface<span class="token punctuation">,</span> Sequelize<span class="token punctuation">)</span> <span class="token operator">=</span><span class="token operator">></span> <span class="token punctuation">{</span> <span class="token keyword">return</span> queryInterface<span class="token punctuation">.</span><span class="token function">bulkDelete</span><span class="token punctuation">(</span><span class="token single-quoted-string string">'People'</span><span class="token punctuation">,</span> <span class="token keyword">null</span><span class="token punctuation">,</span> <span class="token punctuation">{</span><span class="token punctuation">}</span><span class="token punctuation">)</span> <span class="token punctuation">}</span> <span class="token punctuation">}</span> |
Đây là file seed sau khi đã chỉnh sửa. việc còn lại là chạy nó lên thôi )))
chạy seed
Để chạy seed chúng ta chỉ cần thực hiện lệnh
1 2 | npx sequelize-cli db:seed:all |
Lệnh này sẽ thực thi tất cả các seed. Có một lưu ý nhỏ đó là seeder không giống migration đó là lịch sử thực hiện của nó không được lưu lại vì thế bạn muốn thay đổi seed thì chỉ cần vào file chỉnh sửa rồi chạy lại là được còn đối với migration khi bạn muốn thực hiện thay đổi thì bạn cần phải tạo một file migration mới.
kết luận
Vậy là mình đã cùng các bạn thực hiện cài đặt sequelize và tạo model, migration, với seed , ở bài biết này mình mới chỉ thực hiện tạo mà chưa sử dụng các lệnh undo, và tạo seed bằng tay chưa sử dụng facker, tạo nhiều record cho một bảng. vì thế các bạn hãy ủng hộ mình để mình có thêm động lực ra phần tiếp theo nhé 
. Bài viết còn nhiều thiếu xót rất mong được sự đóng góp của mọi người, mọi thắc mắc các bạn vui lòng comments bên dưới để mình và mọi người cùng giải đáp nhé. Cảm ơn các bạn đã đón đọc.
Tài liệu tham khảo :