Trình tạo sơ đồ ER Mermaid

Bạn thấy gì

Vẽ được, nhãn bị cắt cụt, và trong sơ đồ xuất hiện những thực thể bạn không hề viết

Vì sao

Nhãn liên kết có khoảng trắng mà không có dấu nháy. Đây là lỗi gây phiền nhất với tiếng Việt, vì tiếng Việt viết rời từng âm tiết nên hầu như mọi động từ quan hệ đều nhiều chữ: «đặt hàng», «thuộc về», «xuất hiện trong». Đã đo: `KHACH_HANG ||--o{ DON_HANG : đặt hàng` không báo lỗi nào, rút nhãn còn «đặt» và tạo ra một thực thể rỗng tên «hàng». Với ba chữ thì sinh ra hai thực thể ma. Hai bảng vẽ thành bốn hình chữ nhật và không có gì cảnh báo bạn — ngoài việc viewBox nhảy từ 128 lên 398 pixel.

Cách sửa

Đặt dấu nháy quanh mọi nhãn có khoảng trắng. Với tiếng Việt điều đó gần như luôn đúng; coi nó là quy tắc thì dễ hơn là cân nhắc từng lần.

erDiagram
    KHACH_HANG ||--o{ DON_HANG : đặt hàng

erDiagram
    KHACH_HANG ||--o{ DON_HANG : "đặt hàng"

Bạn thấy gì

Parse error, kết thúc bằng: Expecting 'COLON', 'STYLE_SEPARATOR', got 'NEWLINE'

Vì sao

Liên kết không có nhãn. Khác với cạnh của lưu đồ, dấu hai chấm và nhãn là bắt buộc: thiếu chúng thì dòng đơn giản là kết thúc quá sớm.

Cách sửa

Thêm dấu hai chấm và một cụm động từ, đặt trong dấu nháy nếu có khoảng trắng.

erDiagram
    KHACH_HANG ||--o{ DON_HANG

erDiagram
    KHACH_HANG ||--o{ DON_HANG : "đặt"

Bạn thấy gì

Parse error, kết thúc bằng: got 'UNICODE_TEXT'

Vì sao

Ký hiệu bội số không hợp lệ. Chỉ có `||`, `o|`, `}|` và `}o` là đúng (cùng dạng đối xứng của chúng); mọi thứ khác đều đổ. `oo` là lỗi gõ kinh điển, xuất phát từ giả định rằng ký pháp này đối xứng.

Cách sửa

Dùng một trong bốn cặp. `||--o{` — đúng một tới không hoặc nhiều — bao được phần lớn khóa ngoại.

erDiagram
    KHACH_HANG ||--oo{ DON_HANG : "đặt"

erDiagram
    KHACH_HANG ||--o{ DON_HANG : "đặt"

Bạn thấy gì

Parse error, kết thúc bằng: Expecting 'ATTRIBUTE_WORD', got 'BLOCK_STOP'

Vì sao

Một thuộc tính có tên nhưng không có kiểu. Thuộc tính ER viết theo dạng `kiểu tên`, và kiểu không phải tùy chọn — điều này làm những người quen với cơ sở dữ liệu không lược đồ bất ngờ.

Cách sửa

Cho mỗi thuộc tính một kiểu. Cứ đặt ra nếu lược đồ thật không có: `string`, `int`, `json`.

erDiagram
    KHACH_HANG {
        email
    }

erDiagram
    KHACH_HANG {
        string email
    }

Bạn thấy gì

Parse error, kết thúc bằng: Expecting 'NON_IDENTIFYING', 'IDENTIFYING', got 'UNICODE_TEXT'

Vì sao

Đường nối giữa hai ký hiệu bội số bị sai. Nó phải dài đúng hai ký tự: `--` cho liên kết định danh hoặc `..` cho liên kết không định danh. Một dấu gạch ngang đơn không phải dạng rút gọn của `--`, đó là lỗi cú pháp.

Cách sửa

Viết `--` hoặc `..` giữa hai cặp bội số.

erDiagram
    KHACH_HANG ||-o{ DON_HANG : "đặt"

erDiagram
    KHACH_HANG ||--o{ DON_HANG : "đặt"

Bạn thấy gì

Bội số vẽ ra được, nhưng lại mô tả ràng buộc ngược lại

Vì sao

Hai ký hiệu gần một thực thể nhất thuộc về đúng thực thể đó, và đọc ngược chúng thì rất dễ. `KHACH_HANG ||--o{ DON_HANG` nói rằng một khách hàng có không hoặc nhiều đơn hàng. Lật thành `KHACH_HANG }o--|| DON_HANG` là bạn đang khẳng định mỗi khách hàng thuộc về đúng một đơn hàng, điều chẳng có nghĩa gì — và nó vẽ ra không một lời phản đối.

Cách sửa

Đọc từ trong ra ngoài: những ký hiệu chạm vào KHACH_HANG mô tả có bao nhiêu khách hàng, chứ không phải bao nhiêu đơn hàng.

erDiagram
    KHACH_HANG }o--|| DON_HANG : "đặt"

erDiagram
    KHACH_HANG ||--o{ DON_HANG : "đặt"