Viết Table/Column COMMENT Cho Khách Hàng Nhật Và Cách Verify Bằng SQL
5:00 read
Giới Thiệu
Làm dự án offshore cho khách hàng Nhật, sớm hay muộn bạn sẽ nhận một ticket kiểu này:
テーブル・カラムに論理名のコメントを設定してください。
(Hãy đặt COMMENT tên logic cho các table và column.)
Nghe thì đơn giản: chạy vài câu ALTER TABLE ... COMMENT. Nhưng khi làm thật, bạn sẽ gặp những câu hỏi như:
- Tên logic lấy từ đâu? Màn hình, tài liệu cũ hay tự dịch?
JANコードhayJANコード? Khách Nhật để ý chuyện này.- Sửa COMMENT trên DB rồi, nhưng chạy lại migration thì mất hết?
- Làm sao chứng minh cho khách là đã xong 100%, không sót cột nào?
Bài này đi qua toàn bộ quy trình, dựa trên một task thật: đặt COMMENT cho 12 bảng của hệ thống quản lý sản phẩm, deploy lên hai môi trường dev và demo, rồi báo cáo kèm SQL để khách tự kiểm tra. Bạn sẽ học được:
- Vì sao khách Nhật coi COMMENT và テーブル定義書 (tài liệu định nghĩa bảng) là deliverable chính thức
- Quy tắc viết 論理名 (tên logic): nguồn lấy tên, half-width/full-width, thuật ngữ thống nhất
- Cách sửa COMMENT an toàn trong MySQL/MariaDB và giữ đồng bộ với Laravel migration
- Bộ SQL verify trên
INFORMATION_SCHEMA: phát hiện cột trống, ký tự full-width, thuật ngữ không thống nhất, lệch giữa các môi trường - Cách viết báo cáo hoàn thành song ngữ Việt/Nhật mà khách tự verify được
Yêu Cầu
- MySQL 8.0+ hoặc MariaDB 10.5+, database dùng
utf8mb4 - Biết
ALTER TABLEvà truy vấnINFORMATION_SCHEMAcơ bản (xem bài Information Schema) - Không cần biết tiếng Nhật, nhưng cần phân biệt được hiragana, katakana, kanji và ký tự full-width
Yêu cầu đăng nhập
Vui lòng đăng nhập để truy cập nội dung này
Additional Resources
Course Guide
Comprehensive PDF guide with examples
GitHub Repository
Example code for all lessons
Discussion
Have a question about this lesson? Post it here and get answers from instructors and peers.
