• Tiếng Việt

      • MSSQL

      Nguồn dữ liệu: SQL Server bên ngoàiStandard Edition+

      Giới thiệu

      MSSQL (SQL Server) có thể được kết nối vào NocoBase dưới dạng cơ sở dữ liệu bên ngoài. Sau khi kết nối, NocoBase sẽ đọc các bảng, trường và chế độ xem trong SQL Server, đồng thời sử dụng chúng dưới dạng các bảng dữ liệu trong nguồn dữ liệu bên ngoài.

      Khác với cơ sở dữ liệu chính, cấu trúc bảng thực của MSSQL bên ngoài vẫn do hệ thống nghiệp vụ gốc, ứng dụng khách cơ sở dữ liệu hoặc tập lệnh di chuyển quản lý. NocoBase chịu trách nhiệm đọc cấu trúc, lưu siêu dữ liệu trường, cấu hình khối giao diện, quyền, quy trình làm việc và API.

      Mục cấu hìnhMô tả
      Phiên bản được hỗ trợSQL Server 2014-2019.
      Phiên bản thương mạiHỗ trợ các phiên bản Standard, Professional và Enterprise.
      Plugin tương ứng@nocobase/plugin-data-source-external-mssql.
      Tính năng kết nốiHỗ trợ cấu hình 「Encrypt connection」 và 「Trust server certificate」.

      Các tình huống phù hợp để sử dụng MSSQL bên ngoài:

      • Kết nối cơ sở dữ liệu SQL Server của các hệ thống nghiệp vụ hiện có như ERP, MES, WMS và CRM
      • Sử dụng NocoBase để xây dựng giao diện quản lý mà không cần di chuyển dữ liệu lịch sử
      • Thiết lập quyền, xử lý quy trình, điều chỉnh dữ liệu hoặc hiển thị báo cáo cho các bảng hiện có
      • Cấu trúc cơ sở dữ liệu tiếp tục do DBA, tập lệnh di chuyển hoặc hệ thống gốc quản lý
      Lưu ý

      MSSQL bên ngoài không phải là cơ sở dữ liệu hệ thống của NocoBase. NocoBase sẽ không tiếp quản việc sao lưu, khôi phục, di chuyển và thay đổi cấu trúc bảng của cơ sở dữ liệu này.

      Cài đặt plugin

      Đây là plugin thương mại. Để biết chi tiết về cách kích hoạt, hãy tham khảo: Hướng dẫn kích hoạt plugin thương mại

      Thêm nguồn dữ liệu

      Trong 「Quản lý nguồn dữ liệu」, nhấp vào 「Add new」, chọn MSSQL, sau đó nhập thông tin kết nối.

      20260709210022

      Các cấu hình kết nối thường dùng như sau:

      Cấu hìnhMô tả
      Data source nameTên định danh của nguồn dữ liệu, dùng để tham chiếu trong các khối giao diện, quyền, quy trình làm việc và API. Không thể thay đổi sau khi tạo.
      Data source display nameTên hiển thị của nguồn dữ liệu trong giao diện. Nên sử dụng tên dễ hiểu đối với nhân viên nghiệp vụ, chẳng hạn như 「ERP SQL Server」 hoặc 「Cơ sở dữ liệu tài chính」.
      Host / PortĐịa chỉ máy chủ và cổng của SQL Server. Cổng mặc định thường là 1433.
      DatabaseTên cơ sở dữ liệu SQL Server cần kết nối.
      Username / PasswordTài khoản và mật khẩu dùng để kết nối SQL Server. NocoBase chỉ có thể đọc các đối tượng mà tài khoản này có quyền truy cập, không cấp quyền hoặc đọc các đối tượng riêng tư của tài khoản khác.
      Table prefixTiền tố tên bảng. Sau khi cấu hình, NocoBase chỉ đọc các bảng và chế độ xem khớp với tiền tố này, đồng thời tạo tên bảng không có tiền tố trong NocoBase.
      Encrypt connectionCó bật kết nối mã hóa hay không. Bật khi cơ sở dữ liệu bắt buộc mã hóa hoặc đường truyền mạng cần được mã hóa.
      Trust server certificateCó tin cậy chứng chỉ máy chủ hay không. Có thể cần bật trong môi trường kiểm thử hoặc môi trường sử dụng chứng chỉ tự ký; trong môi trường sản xuất, nên sử dụng chứng chỉ đáng tin cậy.
      Collections / Add all collectionsKiểm soát phạm vi kết nối. Khi bật 「Add all collections」, NocoBase sẽ kết nối tất cả bảng và chế độ xem trong phạm vi hiện tại; khi tắt, chỉ kết nối các đối tượng được chọn trong 「Collections」.
      Enabled the data sourceCó bật nguồn dữ liệu này hay không. Sau khi tắt, cấu hình nguồn dữ liệu vẫn được giữ lại, nhưng các khối giao diện, quyền, quy trình làm việc và API sẽ không thể tiếp tục đọc dữ liệu từ nguồn này.
      Mẹo

      Nếu có nhiều đối tượng trong SQL Server, hãy ưu tiên thu hẹp phạm vi thông qua Database, Table prefix và 「Collections」. Chỉ kết nối các bảng và chế độ xem được ứng dụng hiện tại sử dụng để đơn giản hóa việc cấu hình quyền, xây dựng giao diện và bảo trì đồng bộ về sau.

      Chọn bảng dữ liệu

      Sau khi nhập thông tin kết nối, bạn có thể nhấp vào 「Load Collections」 để đọc các bảng dữ liệu và chế độ xem khả dụng trong SQL Server. Kết quả đọc sẽ chịu ảnh hưởng bởi tài khoản kết nối, Database, Table prefix và cấu hình 「Collections」.

      Theo mặc định, 「Add all collections」 sẽ được bật, nghĩa là kết nối tất cả bảng và chế độ xem trong phạm vi hiện tại. Nếu chỉ muốn kết nối một số đối tượng, bạn có thể tắt 「Add all collections」, sau đó chọn các bảng dữ liệu hoặc chế độ xem cần thiết trong danh sách.

      add_new_database_configure_load_collection

      Lưu ý

      Mỗi nguồn dữ liệu bên ngoài chỉ có thể kết nối tối đa 500 bảng dữ liệu hoặc chế độ xem trong một lần. Nếu có nhiều đối tượng trong SQL Server, bạn nên thu hẹp phạm vi trước thông qua Database, Table prefix hoặc 「Collections」.

      Đồng bộ và cấu hình trường

      Cấu trúc bảng của MSSQL bên ngoài do phía cơ sở dữ liệu quản lý. NocoBase sẽ không tạo trường, thay đổi kiểu trường hoặc xóa trường thực trong SQL Server bên ngoài.

      Khi cấu trúc bảng ở phía SQL Server thay đổi, bạn có thể thực hiện 「Sync from database」 trong nguồn dữ liệu để đọc lại siêu dữ liệu của bảng và trường. Quá trình đồng bộ sẽ cập nhật thông tin về bảng dữ liệu, trường, khóa chính, khóa duy nhất và ánh xạ kiểu trường được lưu trong NocoBase, nhưng sẽ không xóa bảng hoặc dữ liệu thực trong SQL Server.

      Sau khi đồng bộ trường, bạn có thể cấu hình tiêu đề trường, kiểu trường (Field type) và giao diện trường (Field interface) trong NocoBase. Nếu cần tạo trường quan hệ NocoBase, siêu dữ liệu quan hệ cũng được lưu trong NocoBase và sẽ không tự động thêm trường khóa ngoại thực vào bảng SQL Server.

      Ánh xạ kiểu trường

      NocoBase sẽ tự động ánh xạ kiểu trường SQL Server sang Field type và Field interface phù hợp. Bạn có thể điều chỉnh cách hiển thị giao diện trong cấu hình trường.

      Các ánh xạ phổ biến như sau:

      Kiểu trường SQL ServerNocoBase Field typeField interface khả dụng
      BITbitCheckbox、Switch.
      TINYINT、SMALLINTinteger、boolean、sortInteger、Sort、Checkbox、Switch、Select、Radio group.
      INTinteger、unixTimestamp、sortInteger、Sort、Unix timestamp、Select、Radio group.
      BIGINTbigInt、unixTimestamp、sortInteger、Sort、Unix timestamp、Created at、Updated at.
      DECIMAL、MONEY、SMALLMONEYdecimalNumber、Percent、Currency.
      NUMERIC、FLOAT、REALfloatNumber、Percent.
      CHAR、VARCHAR、NCHAR、NVARCHARstring、uuid、nanoidInput、Email、Phone、Password、Color、Icon、Select、Radio group、UUID、Nano ID.
      TEXT、NTEXTtextTextarea、Markdown、Vditor、Rich text、URL.
      DATEdateOnlyDate.
      TIMEtimeTime.
      DATETIME、DATETIME2datetimeNoTzDate、Time、Created at、Updated at.
      DATETIMEOFFSETdatetimeTzDate、Time、Created at、Updated at.
      UNIQUEIDENTIFIERuuid、stringUUID、Input.
      JSONjson、arrayJSON.
      Lưu ý

      Các kiểu trường SQL Server không được hỗ trợ sẽ được hiển thị riêng trong cấu hình trường. Cần phát triển khả năng tương thích cho các trường này trước khi có thể sử dụng chúng như các trường thông thường trong NocoBase.

      Khóa chính và định danh duy nhất của bản ghi

      Đối với các bảng dữ liệu dùng để hiển thị và chỉnh sửa trong các khối giao diện, nên có khóa chính hoặc trường duy nhất. NocoBase sẽ ưu tiên sử dụng khóa chính làm định danh duy nhất của bản ghi.

      Nếu kết nối chế độ xem, bảng không có khóa chính hoặc bảng có khóa chính kết hợp, cần thiết lập 「Record unique key」 thủ công trong cấu hình bảng dữ liệu. Khi không có định danh duy nhất khả dụng, các khối giao diện có thể không xem, chỉnh sửa hoặc xóa bản ghi chính xác.

      20260709210154 20260709210214

      Liên kết liên quan