• Tiếng Việt

      • UUID

      Giới thiệu

      Trong NocoBase, UUID (UUID) được dùng để tạo mã định danh duy nhất UUID.

      UUID phù hợp với các kịch bản đồng bộ hóa giữa các hệ thống, định danh cho API công khai, nhập xuất dữ liệu, v.v. So với ID tự tăng, UUID ít làm lộ quy mô dữ liệu hơn.

      Nếu chỉ cần khóa chính mặc định trong nội bộ NocoBase, Snowflake ID thường là đủ. Nếu cần mã ngắn, hãy chọn Nano ID hoặcSequence.

      Các kịch bản áp dụng

      UUID phù hợp với các kịch bản nghiệp vụ sau:

      • ID đồng bộ với hệ thống bên ngoài
      • Định danh API công khai
      • Định danh bản ghi khi di chuyển giữa các cơ sở dữ liệu
      • ID bản ghi không muốn để lộ quy luật tăng dần

      Tạo cấu hình

      Trên trang 「Configure fields」 của bảng dữ liệu, nhấp vào 「Add field」 rồi chọn 「UUID」 để tạo trường UUID.

      20240512173354

      Cấu hìnhMô tả
      Field interfaceLoại giao diện của trường. UUID tương ứng với uuid, quyết định cách nhập và hiển thị trên trang.
      Field display nameTên hiển thị của trường trên giao diện, chẳng hạn như 「UUID」「Định danh bên ngoài」「ID công khai」. Nên sử dụng tên mà nhân viên nghiệp vụ có thể hiểu trực tiếp.
      Field nameTên định danh của trường, dùng để tham chiếu nội bộ trong API, trường quan hệ, quyền hạn, quy trình làm việc, v.v. Sau khi tạo thường không nên thay đổi; chỉ hỗ trợ chữ cái, chữ số và dấu gạch dưới, đồng thời phải bắt đầu bằng chữ cái.
      Field typeKiểu của trường ở tầng dữ liệu. Trường UUID mặc định là uuid.
      Default valueGiá trị mặc định. Khi thêm bản ghi, nếu người dùng không nhập, hệ thống có thể tự động điền giá trị mặc định.
      Validation rulesThường do hệ thống tự động tạo, không cần kiểm tra thủ công.
      DescriptionMô tả trường. Phù hợp để ghi ý nghĩa của trường, yêu cầu nhập liệu, nguồn dữ liệu hoặc người phụ trách.
      Lưu ý

      Tên trường sẽ được các khối trang, quyền hạn, quy trình làm việc và API tham chiếu sau khi tạo. Hãy xác nhận cách đặt tên trước khi tạo để tránh phát sinh chi phí điều chỉnh cấu hình về sau.

      Đặc điểm của trường

      Hành vi mặc định của trường UUID như sau:

      Đặc điểmMô tả
      Field interface mặc địnhuuid.
      Field type mặc địnhuuid.
      Field type tùy chọnuuid.
      Thành phần trangThường được tự động tạo, không cần nhập thủ công.
      Bộ lọcHỗ trợ truy vấn chính xác theo UUID.
      Sắp xếpHỗ trợ sắp xếp, nhưng thông thường không dùng UUID để sắp xếp nghiệp vụ.
      Kiểm traThường được tự động tạo và duy trì tính duy nhất.

      Chỉnh sửa cấu hình

      Sau khi tạo, nhấp vào 「Edit」 ở bên phải trường để chỉnh sửa cấu hình trường UUID. Việc chỉnh sửa trường chủ yếu dùng để điều chỉnh cách trường được hiển thị và sử dụng trong NocoBase, chẳng hạn như thay đổi tên hiển thị, mô tả, giá trị mặc định, quy tắc kiểm tra hoặc cấu hình riêng của trường.

      Nếu trường đến từ một bảng đã được đồng bộ trong cơ sở dữ liệu chính, việc chỉnh sửa thường là ánh xạ trường — ánh xạ trường cơ sở dữ liệu với Field type và Field interface của NocoBase.

      Cấu hìnhCho phép chỉnh sửaMô tả
      Field display nameCóThay đổi tên hiển thị của trường trên giao diện, không thay đổi tên định danh của trường.
      Field nameKhôngTên định danh của trường thường không thể chỉnh sửa trong biểu mẫu chỉnh sửa sau khi tạo.
      Field interfaceHỗ trợ có điều kiệnCó thể điều chỉnh khi ánh xạ trường cơ sở dữ liệu chính hoặc trường đồng bộ. Sau khi điều chỉnh, cách nhập, hiển thị và kiểm tra trên trang sẽ bị ảnh hưởng.
      Field typeHỗ trợ có điều kiệnCó thể điều chỉnh khi ánh xạ trường cơ sở dữ liệu chính hoặc trường đồng bộ. Trước khi điều chỉnh, cần xác nhận dữ liệu hiện có có thể được sử dụng theo kiểu mới hay không.
      Default valueCóĐiều chỉnh giá trị mặc định khi thêm bản ghi.
      Validation rulesCóĐiều chỉnh quy tắc kiểm tra trường.
      DescriptionCóBổ sung ý nghĩa của trường, yêu cầu nhập liệu, nguồn dữ liệu hoặc người phụ trách.
      Lưu ý

      Việc chuyển đổi Field type hoặc Field interface không chỉ đơn giản là thay đổi tên hiển thị. Thao tác này sẽ ảnh hưởng đến cách lưu trữ trường, thành phần nhập liệu, quy tắc kiểm tra, điều kiện lọc và cách sử dụng biến trong quy trình làm việc. Khi có nhiều dữ liệu hiện có, hãy xác nhận trước định dạng dữ liệu có tương thích hay không.

      Xóa trường

      Nhấp vào 「Delete」 ở bên phải trường để xóa trường UUID. Trong cơ sở dữ liệu chính, bạn cũng có thể chọn nhiều trường rồi xóa hàng loạt.

      Khi xóa trường UUID được tạo mới trong cơ sở dữ liệu chính, thông thường cột thực tương ứng trong cơ sở dữ liệu và dữ liệu hiện có trong cột đó cũng sẽ bị xóa. Khi xóa trường được đồng bộ từ cơ sở dữ liệu hoặc ánh xạ từ nguồn dữ liệu bên ngoài, phạm vi ảnh hưởng tùy thuộc vào nguồn dữ liệu và nguồn gốc của trường tương ứng.

      Cảnh báo

      Xóa trường có thể ảnh hưởng đến các khối trang, biểu mẫu, bộ lọc, quyền hạn, quy trình làm việc, API, chức năng nhập xuất và dữ liệu hiện có. Hãy xác nhận trước khi xóa liệu trường này còn được các cấu hình nghiệp vụ tham chiếu hay không.

      Sử dụng trong cấu hình trang

      Trường UUID phù hợp để sử dụng trong các kịch bản tích hợp và định danh công khai. 20260710145759

      Kịch bảnCông dụng
      Tạo bảngDùng làm khóa chính hoặc mã định danh duy nhất.
      APIDùng làm mã định danh bản ghi công khai.
      Đồng bộ dữ liệuĐồng bộ bản ghi giữa các hệ thống.
      Nhập xuất dữ liệuDuy trì tính duy nhất của bản ghi.

      Liên kết liên quan

      • Trường — Tìm hiểu vai trò, phân loại và logic ánh xạ của trường
      • Bảng thông thường — Tạo và quản lý trường trong bảng thông thường
      • Snowflake ID — Sử dụng Snowflake ID mặc định
      • Nano ID — Sử dụng ID ngẫu nhiên ngắn