# SQL Server / Azure SQL

> Nối Microsoft SQL Server, Azure SQL Database, Azure SQL Managed Instance, Amazon RDS for SQL Server bằng người dùng chỉ đọc, nạp toàn bộ hoặc tăng dần theo rowversion hay cột cập nhật.

SQL Server / Azure SQL cần gói Khởi đầu trở lên. DataxLand nói thẳng giao thức TDS (không cần cài ODBC driver), đọc theo luồng
và chép bảng bạn chọn về kho riêng của workspace; DataxLand chỉ chạy câu `SELECT`, không ghi vào database của bạn. Phiên đọc
đặt `DEADLOCK_PRIORITY LOW` và chờ khóa tối đa 60 giây để không cản ứng dụng đang chạy. Dùng được với SQL Server 2016 trở lên,
Azure SQL Database, Azure SQL Managed Instance và Amazon RDS for SQL Server.

## 1. Chuẩn bị người dùng

Tạo login và user riêng cho DataxLand, chỉ có quyền đọc:

```sql
-- trên master (Azure SQL Database: tạo "contained user" ngay trong database, bỏ dòng CREATE LOGIN)
CREATE LOGIN dataxland WITH PASSWORD = '<mật khẩu mạnh>';
-- trên database cần nạp
CREATE USER dataxland FOR LOGIN dataxland;      -- Azure SQL: CREATE USER dataxland WITH PASSWORD = '<mật khẩu mạnh>';
ALTER ROLE db_datareader ADD MEMBER dataxland;  -- hoặc: GRANT SELECT ON SCHEMA::dbo TO dataxland;
GRANT VIEW DEFINITION TO dataxland;             -- đọc khóa chính, khóa ngoại, mô tả cột
GRANT SHOWPLAN TO dataxland;                    -- ước tính chi phí câu SQL của Si (không bắt buộc)
```

Thiếu `SHOWPLAN` thì mọi câu SQL Si muốn chạy trên nguồn đều chờ người kỹ thuật xác nhận. Nếu database chỉ mở cho IP nhất
định (tường lửa Azure, security group), mở cho địa chỉ máy chủ DataxLand (hỏi đội hỗ trợ).

## 2. Kết nối

1. **Nguồn dữ liệu → Thêm nguồn**, chọn **SQL Server / Azure SQL**.
2. Điền **Máy chủ** (ví dụ `ten-may-chu.database.windows.net`; không kèm `\tên-instance` hay `,cổng`), **Cổng** (mặc định
   1433; instance có tên thì dùng cổng cố định của instance), **Tên database**, **Schema** (mặc định `dbo`), **Người dùng**,
   **Mật khẩu**.
3. **SSL**:
   - **require** (mặc định): bắt buộc mã hóa, chấp nhận chứng chỉ tự ký (như `TrustServerCertificate=yes`), hợp với SQL
     Server tự cài.
   - **verify-full**: bắt buộc mã hóa và kiểm chứng chỉ do CA công khai cấp, đúng tên máy chủ. Nên dùng cho Azure SQL.
   - **disable**: không mã hóa, chỉ dùng trong mạng tin cậy; máy chủ bắt buộc mã hóa thì sẽ từ chối.
4. Bấm **Kiểm tra kết nối**, chọn bảng (tùy chọn **Lọc theo ngày**), rồi thêm nguồn. Mật khẩu được mã hóa khi lưu và không
   hiển thị lại.

## 3. Cách đồng bộ

SQL Server có **Toàn bộ** và **Tăng dần**. Với tăng dần, cột con trỏ tốt nhất là một cột kiểu **`rowversion`**: SQL Server tự
tăng nó ở mọi lần thêm hoặc sửa dòng, nên không sót thay đổi nào kể cả khi ứng dụng quên cập nhật `updated_at`. DataxLand gợi ý
cột rowversion trước, rồi tới cột thời điểm như `updated_at`. Bảng chưa có thì thêm (không đổi dữ liệu cũ):

```sql
ALTER TABLE dbo.orders ADD row_version ROWVERSION;
```

Mốc rowversion không vượt qua giao dịch còn mở lúc bắt đầu đọc (`MIN_ACTIVE_ROWVERSION()`), nên dòng ghi xong muộn vẫn được
đọc ở lần sau. Với cột thời điểm, mỗi lần đọc lùi 10 phút cho an toàn. Tăng dần không thấy dòng bị xóa; Change Tracking / CDC
của SQL Server sẽ có sau. Xem [Cách đồng bộ và lịch làm mới](/vi/docs/concepts/sync-modes).

## Kiểu dữ liệu

| Kiểu SQL Server | Trong từ điển | Ghi chú |
| --- | --- | --- |
| `tinyint`, `smallint`, `int`, `bigint`, `rowversion` | BIGINT | rowversion đọc ra số |
| `decimal`, `numeric`, `money`, `smallmoney`, `float`, `real` | DECIMAL | |
| `bit` | BOOLEAN | `true`/`false` |
| `date` | DATE | |
| `datetime`, `datetime2`, `smalldatetime`, `datetimeoffset` | DATETIME | `datetimeoffset` đổi về giờ Việt Nam |
| `char`, `varchar`, `nchar`, `nvarchar`, `text`, `xml`, `uniqueidentifier`, `time` | VARCHAR | |
| `geography`, `geometry`, `hierarchyid` | VARCHAR | đọc ra chữ (WKT) |
| `binary`, `varbinary`, `image` | (bỏ trống) | dữ liệu nhị phân không dùng |

## Si điều tra bằng SQL

Si được chạy SQL chỉ đọc trên nguồn khi điều tra, trong giới hạn số câu và chi phí (ước tính bằng `SHOWPLAN_XML`, câu chưa
chạy); câu vượt giới hạn chờ người kỹ thuật xác nhận.

## Liên quan

- [PostgreSQL](/vi/docs/sources/postgres)
- [MySQL / MariaDB](/vi/docs/sources/mysql)
- [Bảo mật và quyền riêng tư](/vi/docs/security-privacy)
