GORM là gì?

1. GORM là gì?

GORM (Go Object Relational Mapping) là một thư viện ORM dành cho ngôn ngữ lập trình Go, giúp ánh xạ các struct trong Go với dữ liệu trong cơ sở dữ liệu quan hệ như PostgreSQL, MySQL và SQLite.

Thay vì phải tự viết SQL cho mọi thao tác truy vấn hoặc cập nhật dữ liệu, lập trình viên có thể sử dụng các phương thức của GORM để thực hiện những thao tác phổ biến như tạo, đọc, cập nhật và xóa dữ liệu (CRUD).

Ví dụ, thay vì tự viết câu lệnh SQL để thêm một người dùng vào database, ta có thể định nghĩa một struct User và sử dụng db.Create() để lưu đối tượng đó.

Tuy nhiên, GORM không thay thế hoàn toàn SQL. Nó là lớp thư viện hỗ trợ làm việc với database; lập trình viên vẫn cần hiểu SQL, cấu trúc dữ liệu và cách database thực thi truy vấn để xây dựng ứng dụng hiệu quả.

2. ORM và GORM khác nhau như thế nào?

ORM (Object-Relational Mapping) là kỹ thuật ánh xạ giữa mô hình đối tượng trong chương trình và mô hình dữ liệu quan hệ trong database.

GORM là một thư viện cụ thể triển khai kỹ thuật ORM cho Go.

Có thể phân biệt như sau:

• ORM: Khái niệm và kỹ thuật ánh xạ đối tượng với dữ liệu quan hệ.
• GORM: Thư viện ORM dành cho Go.
• PostgreSQL: Hệ quản trị cơ sở dữ liệu lưu trữ và xử lý dữ liệu.
• SQL: Ngôn ngữ được sử dụng để truy vấn và thao tác với dữ liệu trong database.

GORM giúp giảm lượng SQL phải viết thủ công, nhưng các câu lệnh SQL vẫn được thực thi bởi database thông qua cơ chế kết nối tương ứng.

3. Cài đặt và kết nối GORM với PostgreSQL

Để sử dụng GORM với PostgreSQL, trước tiên cần cài đặt GORM và PostgreSQL driver.

go get gorm.io/gorm
go get gorm.io/driver/postgres

Sau đó, tạo kết nối đến database:

package main

import (
    "log"

    "gorm.io/driver/postgres"
    "gorm.io/gorm"
)

func main() {
    dsn := "host=localhost user=postgres password=your_password dbname=ten_database port=5432 sslmode=disable"

    db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{})
    if err != nil {
        log.Fatal("Không thể kết nối database:", err)
    }

    log.Println("Kết nối database thành công")

    _ = db
}

Trong ví dụ trên, gorm.Open() khởi tạo đối tượng GORM sử dụng PostgreSQL driver.

Một số thành phần trong DSN:

• host: Địa chỉ máy chủ database.
• user: Tên người dùng database.
• password: Mật khẩu.
• dbname: Tên database.
• port: Cổng kết nối.
• sslmode: Cấu hình SSL/TLS của kết nối PostgreSQL.

Thông tin kết nối trong ví dụ chỉ mang tính minh họa. Trong ứng dụng thực tế, nên lấy thông tin nhạy cảm từ biến môi trường hoặc hệ thống quản lý cấu hình phù hợp.

Cần lưu ý rằng gorm.Open() không nhất thiết xác nhận database đã sẵn sàng nhận truy vấn. Nếu cần kiểm tra kết nối thực tế, có thể lấy đối tượng sql.DB bên dưới GORM và gọi Ping().

sqlDB, err := db.DB()
if err != nil {
    log.Fatal(err)
}

if err := sqlDB.Ping(); err != nil {
    log.Fatal("Database không phản hồi:", err)
}

4. Model trong GORM là gì?

Model là struct Go được GORM sử dụng để ánh xạ dữ liệu với bảng trong database.

Ví dụ:

type User struct {
    ID    uint   `gorm:"primaryKey"`
    Name  string
    Email string `gorm:"uniqueIndex"`
}

Trong ví dụ này:

• User là model.
• ID là khóa chính.
• Name là trường lưu tên người dùng.
• Email có cấu hình unique index thông qua struct tag.

Theo quy tắc mặc định, GORM thường ánh xạ struct User sang bảng users, còn các trường như Name và Email được ánh xạ sang các cột tương ứng.

GORM cung cấp các quy ước mặc định để giảm lượng cấu hình cần viết. Tuy nhiên, có thể tùy chỉnh tên bảng, tên cột, khóa chính và những thuộc tính khác khi cần.

Model có phải là Entity không?

Hai khái niệm này có liên quan nhưng không hoàn toàn đồng nghĩa.

Trong GORM, model là kiểu dữ liệu dùng để ánh xạ và thao tác với dữ liệu database. Trong thiết kế phần mềm, Entity có thể mang ý nghĩa rộng hơn, chẳng hạn một đối tượng nghiệp vụ có định danh và vòng đời riêng.

Một dự án nhỏ có thể sử dụng cùng một struct cho cả model database và dữ liệu nghiệp vụ. Trong dự án lớn hơn, có thể tách riêng Domain Model, DTO và model dùng cho persistence để giảm sự phụ thuộc giữa các lớp.

5. AutoMigrate là gì?

GORM dùng AutoMigrate() để điều chỉnh cấu trúc database dựa trên model được định nghĩa trong code Go.

Ví dụ:

if err := db.AutoMigrate(&User{}); err != nil {
    log.Fatal(err)
}

Lệnh này yêu cầu GORM kiểm tra và thực hiện các thay đổi schema mà AutoMigrate hỗ trợ để phù hợp hơn với model User.

Tuy nhiên, AutoMigrate() không phải hệ thống migration đầy đủ cho mọi tình huống. Nó không tự động xóa các cột không còn được sử dụng và không thay thế hoàn toàn việc quản lý migration có phiên bản.

Trong môi trường phát triển, AutoMigrate() có thể hữu ích khi thử nghiệm model. Với dự án cần kiểm soát schema chặt chẽ, nên cân nhắc công cụ migration chuyên dụng và quản lý thay đổi database một cách có chủ đích.

6. CRUD trong GORM

CRUD là viết tắt của Create, Read, Update và Delete — bốn thao tác cơ bản để làm việc với dữ liệu.

6.1. Create — Tạo dữ liệu

user := User{
    Name:  "Nguyen Van A",
    Email: "[email protected]",
}

result := db.Create(&user)
if result.Error != nil {
    log.Fatal(result.Error)
}

db.Create(&user) yêu cầu GORM thêm một bản ghi mới vào database.

Đối tượng được truyền bằng con trỏ để GORM có thể cập nhật những trường phù hợp, chẳng hạn ID được database hoặc GORM sinh ra.

Kết quả truy vấn được trả về trong đối tượng result, trong đó Error chứa lỗi nếu thao tác thất bại và RowsAffected cho biết số dòng bị ảnh hưởng.

6.2. Read — Đọc dữ liệu

Tìm người dùng theo khóa chính:

var user User

result := db.First(&user, 1)
if result.Error != nil {
    log.Fatal(result.Error)
}

First() tìm bản ghi đầu tiên theo thứ tự khóa chính mặc định. Nếu không tìm thấy bản ghi, GORM trả về lỗi gorm.ErrRecordNotFound.

Có thể truy vấn theo điều kiện:

var user User

result := db.Where("email = ?", "[email protected]").First(&user)
if result.Error != nil {
    log.Fatal(result.Error)
}

Dấu ? là placeholder cho giá trị tham số. Cách truyền giá trị riêng biệt này giúp tránh ghép trực tiếp dữ liệu đầu vào vào câu SQL, từ đó giảm nguy cơ SQL injection.

6.3. Update — Cập nhật dữ liệu

Cập nhật tên của một người dùng:

result := db.Model(&User{}).
    Where("id = ?", 1).
    Update("name", "Tran Van B")

if result.Error != nil {
    log.Fatal(result.Error)
}

GORM xây dựng truy vấn cập nhật theo model và điều kiện được chỉ định.

Cần chú ý rằng Update() với một trường có thể cập nhật giá trị zero như 0, false hoặc chuỗi rỗng. Ngược lại, Updates() với struct mặc định thường bỏ qua các trường có giá trị zero. Nếu cần cập nhật những giá trị này, phải lựa chọn cách truyền dữ liệu phù hợp, chẳng hạn dùng map.

6.4. Delete — Xóa dữ liệu

result := db.Delete(&User{}, 1)
if result.Error != nil {
    log.Fatal(result.Error)
}

Lệnh này yêu cầu GORM xóa bản ghi có khóa chính bằng 1.

Nếu model có trường gorm.DeletedAt, GORM thường thực hiện xóa mềm (soft delete): bản ghi được đánh dấu đã xóa thay vì bị loại bỏ vật lý khỏi bảng.

Nếu không có cơ chế xóa mềm, thao tác thường là xóa bản ghi thực sự. Vì vậy, cần hiểu rõ model và cấu hình trước khi sử dụng Delete().

7. Query dữ liệu trong GORM

Ngoài CRUD cơ bản, GORM hỗ trợ xây dựng truy vấn thông qua các phương thức như Where(), Select(), Order(), Limit() và Find().

Ví dụ, lấy danh sách người dùng có tên chứa chuỗi Nguyen, sắp xếp theo tên và giới hạn 10 kết quả:

var users []User

result := db.
    Where("name LIKE ?", "%Nguyen%").
    Order("name ASC").
    Limit(10).
    Find(&users)

if result.Error != nil {
    log.Fatal(result.Error)
}

GORM kết hợp các điều kiện này để xây dựng truy vấn SQL tương ứng.

Trong thực tế, cần lưu ý:

• Chỉ chọn những cột cần thiết khi dữ liệu trả về lớn.
• Dùng điều kiện truy vấn phù hợp để tránh đọc quá nhiều bản ghi.
• Không ghép trực tiếp dữ liệu đầu vào vào chuỗi SQL.
• Kiểm tra truy vấn được sinh ra khi cần tối ưu hiệu năng.

8. Relationships — Quan hệ giữa các model

GORM hỗ trợ mô hình hóa những quan hệ phổ biến trong database quan hệ:

• Belongs To: Một model tham chiếu đến model khác.
• Has One: Một model có một model liên quan.
• Has Many: Một model có nhiều model liên quan.
• Many To Many: Nhiều model liên kết với nhiều model thông qua bảng trung gian.

Ví dụ, một người dùng có thể có nhiều bài viết:

type User struct {
    ID    uint
    Name  string
    Posts []Post
}

type Post struct {
    ID     uint
    Title  string
    UserID uint
}

Trong ví dụ này, User có quan hệ một-nhiều với Post. Trường UserID trong Post đóng vai trò khóa ngoại theo quy ước mặc định.

Để lấy người dùng cùng các bài viết liên quan, có thể dùng:

var user User

result := db.Preload("Posts").First(&user, 1)
if result.Error != nil {
    log.Fatal(result.Error)
}

Preload() giúp tải dữ liệu của quan hệ được chỉ định. Với cách preload thông thường, GORM thường thực hiện truy vấn riêng để lấy các bản ghi liên quan thay vì luôn dùng một câu JOIN duy nhất.

9. Transactions — Giao dịch trong GORM

Transaction cho phép nhóm nhiều thao tác database thành một đơn vị xử lý. Nếu một thao tác thất bại, ứng dụng có thể rollback để tránh giữ lại trạng thái dữ liệu không nhất quán.

Ví dụ:

err := db.Transaction(func(tx *gorm.DB) error {
    if err := tx.Create(&user).Error; err != nil {
        return err
    }

    if err := tx.Create(&post).Error; err != nil {
        return err
    }

    return nil
})

if err != nil {
    log.Fatal(err)
}

Nếu callback trả về lỗi, GORM rollback transaction. Nếu callback kết thúc thành công, GORM commit transaction.

Trong ví dụ này, việc tạo người dùng và bài viết được đặt trong cùng một transaction. Nếu tạo bài viết thất bại, thao tác tạo người dùng cũng được rollback, miễn là cả hai thao tác được thực hiện trên cùng transaction và không có cơ chế bên ngoài làm thay đổi kết quả.

Transaction đặc biệt hữu ích trong những nghiệp vụ cần nhiều thay đổi dữ liệu phải thành công cùng nhau, chẳng hạn tạo đơn hàng và các dòng chi tiết đơn hàng.

10. GORM và vấn đề N+1 Query

N+1 Query Problem xảy ra khi ứng dụng thực hiện một truy vấn để lấy danh sách bản ghi, sau đó tiếp tục thực hiện thêm một truy vấn cho từng bản ghi để lấy dữ liệu liên quan.

Ví dụ, ứng dụng lấy 100 người dùng rồi truy vấn bài viết của từng người. Khi đó, số lượng truy vấn có thể tăng thành một truy vấn lấy người dùng và 100 truy vấn lấy bài viết.

GORM không tự động loại bỏ mọi trường hợp N+1. Nếu lập trình viên truy vấn quan hệ lặp đi lặp lại trong vòng lặp, vấn đề vẫn có thể xảy ra.

Một giải pháp là sử dụng Preload() khi phù hợp:

var users []User

result := db.Preload("Posts").Find(&users)
if result.Error != nil {
    log.Fatal(result.Error)
}

Cách này thường giúp giảm số truy vấn so với việc tải quan hệ riêng cho từng người dùng. Tuy nhiên, cần đo lường và kiểm tra SQL thực tế để chọn chiến lược phù hợp với kích thước dữ liệu và yêu cầu của ứng dụng.

11. GORM trong kiến trúc Backend

Trong một ứng dụng Go sử dụng Gin và PostgreSQL, GORM thường được đặt ở lớp truy cập dữ liệu.

Một cách tổ chức phổ biến:

1. Handler: Nhận HTTP request và trả HTTP response.
2. Service: Xử lý quy tắc nghiệp vụ.
3. Repository: Tổ chức các thao tác truy vấn và lưu trữ dữ liệu.
4. GORM: Thực hiện ánh xạ và hỗ trợ thao tác với database.
5. PostgreSQL: Lưu trữ và xử lý dữ liệu.

Ví dụ, khi client gửi yêu cầu tạo người dùng:

• Handler nhận dữ liệu đầu vào.
• Service kiểm tra các quy tắc nghiệp vụ.
• Repository gọi GORM để lưu dữ liệu.
• GORM thực hiện thao tác thông qua PostgreSQL driver.
• PostgreSQL xử lý câu SQL và trả kết quả.

Đây là cách phân lớp phổ biến, không phải cấu trúc bắt buộc. Với ứng dụng nhỏ, có thể gọi GORM trực tiếp từ handler; với ứng dụng lớn hơn, tách Service và Repository thường giúp dễ kiểm thử, bảo trì và thay đổi cách lưu trữ dữ liệu.

12. Ưu điểm và hạn chế của GORM

Ưu điểm

• Giảm lượng SQL phải viết cho các thao tác CRUD thông thường.
• Hỗ trợ ánh xạ struct với bảng và cột trong database.
• Cung cấp API truy vấn, quan hệ và transaction.
• Hỗ trợ nhiều hệ quản trị cơ sở dữ liệu thông qua driver tương ứng.
• Giúp mã nguồn Go dễ đọc hơn trong nhiều trường hợp.

Hạn chế

• Không loại bỏ nhu cầu hiểu SQL và thiết kế database.
• Truy vấn phức tạp có thể khó biểu diễn hoặc khó tối ưu hơn SQL trực tiếp.
• Có thể phát sinh vấn đề hiệu năng nếu dùng quan hệ và truy vấn không hợp lý.
• Cần hiểu rõ hành vi cập nhật, xóa mềm, migration và transaction.
• Việc dùng ORM không tự động bảo đảm dữ liệu hợp lệ hoặc an toàn.

Kết luận

GORM là một thư viện ORM giúp lập trình viên Go thao tác với cơ sở dữ liệu quan hệ thông qua struct và các phương thức Go. Thư viện cung cấp nhiều tính năng để làm việc với model, CRUD, query, relationships, transactions và schema.

Tuy nhiên, sử dụng GORM hiệu quả không chỉ là ghi nhớ các phương thức như Create(), Find(), Updates() hay Delete(). Điều quan trọng là hiểu các thao tác đó tương ứng với dữ liệu và câu SQL như thế nào, cách database thực thi truy vấn, cũng như những vấn đề về tính toàn vẹn và hiệu năng.

Mục tiêu không phải là để GORM viết SQL thay bạn trong mọi tình huống, mà là biết khi nào nên tận dụng ORM và khi nào cần chủ động kiểm soát truy vấn database.

Nguồn tham khảo

• Sử dụng Gorm trong Go

• Giới thiệu Gorm- thư viện ORM tuyệt vời dành cho Golang

Thanh Tan

Xem tất cả bài viết của tác giả

Bài viết khác

Use AWS to deploy your applications and services

Amazon Web Services (AWS) is a cloud computing platform that provides a wide range of services to help businesses and individuals build and deploy applications in the cloud. AWS offers a variety of services such as compute, storage, databases, networking, security, and more. In this guide, we will walk through the steps to get started […]

Đọc thêm

Use docker to run go project

Docker is a powerful tool that enables developers to create, deploy and run applications in a containerized environment. Using Docker to run Go projects has many advantages, including the ability to isolate your application from the underlying operating system, simplifying the deployment process, and allowing for greater scalability and flexibility. In this guide, we will […]

Đọc thêm

Install WSL for windows 10

1/ Enable feature Windows Subsystem for Linux Head to Control Panel > Programs > Turn Windows Features On Or Off. Enable the “Windows Subsystem for Linux” option in the list, and then click the “OK” button. Restart computer Now you can type on console: wsl –help 2/ Download ubuntu 18 from Microsoft Store or open […]

Đọc thêm

Make a binary file or script file run on startup on ubuntu

To make a binary file run on boot, you can create a startup script that will run the binary file when the operating system starts. The exact process for creating a startup script depends on the operating system you’re using. Here’s an example for a Linux operating system using the systemd init system: Create a […]

Đọc thêm

Explicit ssl bumping with Squid

To perform explicit SSL bumping with Squid, you need to perform the following steps: Generate a SSL certificate and key: You can either generate a self-signed certificate or obtain one from a certificate authority. The certificate and key will be used by Squid to encrypt and decrypt the traffic. Install and configure Squid: Squid is […]

Đọc thêm

Explicit ssl bumping with HAProxy

Basic guide About Explicit SSL bumping Explicit SSL bumping also known as “SSL interception,” is a feature of some reverse proxies and security appliances that allows the proxy to decrypt, inspect, and re-encrypt SSL/TLS encrypted traffic. The proxy acts as a man-in-the-middle, decrypting incoming SSL/TLS traffic and re-encrypting it before forwarding it to the destination […]

Đọc thêm