Site logo

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コード hay JANコード? 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 TABLE và truy vấn INFORMATION_SCHEMA cơ 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.