Giao diện
@digiforce-nc/plugin-data-source-external-mssql
Plugin kết nối Microsoft SQL Server bên ngoài làm data source — biến bảng SQL Server thành collection để thao tác CRUD từ giao diện Digiforce.
Plugin này làm gì?
Nhiều hệ thống doanh nghiệp sử dụng Microsoft SQL Server. Plugin này đăng ký loại data source mssql vào data-source-manager factory, kết nối đến SQL Server, introspect schema và map bảng thành collection.
Cơ chế hoạt động
Tính năng chính
| # | Tính năng | Mô tả |
|---|---|---|
| 1 | Kết nối SQL Server | Cấu hình host, port, instance name, credentials |
| 2 | Windows Auth | Hỗ trợ SQL Auth và Windows Authentication |
| 3 | Schema selector | Chọn schema cụ thể (dbo, custom schema) |
| 4 | Auto-detect tables | Phát hiện bảng, cột, kiểu dữ liệu tự động |
| 5 | CRUD qua UI | Thao tác dữ liệu trực tiếp từ giao diện |
| 6 | TLS encryption | Mã hóa kết nối cho production |
Cấu hình kết nối
| Tham số | Bắt buộc | Mô tả | Ví dụ |
|---|---|---|---|
host | Có | Địa chỉ server | 192.168.1.100 |
port | Không | Cổng (mặc định 1433) | 1433 |
instanceName | Không | Tên instance (named instance) | SQLEXPRESS |
database | Có | Tên database | ERP_Production |
username | Có | Tên đăng nhập | sa |
password | Có | Mật khẩu | *** |
schema | Không | Schema (mặc định dbo) | sales |
encrypt | Không | Mã hóa kết nối | true |
Kiến trúc nội bộ
| Thành phần | Vai trò |
|---|---|
| Register | Đăng ký mssql type vào factory registry |
| Factory | Tạo kết nối với SQL Server qua TDS protocol |
| Introspector | Query sys.tables/sys.columns để map bảng → collection |
| Sync | Đồng bộ metadata vào CollectionManager |
Thành phần client
| Thành phần | Mô tả |
|---|---|
MSSQLConnectionForm | Form cấu hình kết nối SQL Server |
InstanceSelector | Chọn named instance |
SchemaSelector | Chọn schema (dbo, custom) |
ConnectionTest | Nút kiểm tra kết nối |
Dependencies
| Package | Vai trò |
|---|---|
@digiforce-nc/server | Server framework |
@digiforce-nc/database | Database abstraction layer (mssql dialect) |
@digiforce-nc/client | Client UI framework |
@digiforce-nc/data-source-manager | Registry quản lý data source |
tedious | TDS protocol driver cho SQL Server |
Lưu ý triển khai
- SQL Server cần bật TCP/IP protocol và mở port (mặc định 1433)
- Named instance cần SQL Server Browser service đang chạy
- Hỗ trợ SQL Server 2016 trở lên và Azure SQL Database
- Nên dùng SQL Authentication thay Windows Auth khi server ở khác domain