# MySQL / MariaDB

> Nối MySQL, MariaDB (kể cả Amazon RDS, Aurora, Azure Database for MySQL, Cloud SQL) bằng người dùng chỉ đọc, chọn bảng, nạp toàn bộ hoặc tăng dần theo cột cập nhật.

MySQL / MariaDB cần gói Khởi đầu trở lên. DataxLand chép bảng bạn chọn về kho riêng của workspace qua một phiên **chỉ đọc**
(`SET SESSION TRANSACTION READ ONLY`), đọc theo luồng nên bảng lớn không làm đầy bộ nhớ; DataxLand không ghi vào database của
bạn. Dùng được với MySQL 5.7, 8.x, MariaDB 10.x, 11.x và các dịch vụ tương thích (Amazon RDS, Aurora MySQL, Azure Database
for MySQL, Google Cloud SQL).

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

Tạo một người dùng riêng cho DataxLand, chỉ có quyền đọc database cần nạp:

```sql
CREATE USER 'dataxland'@'%' IDENTIFIED BY '<mật khẩu mạnh>';
GRANT SELECT, SHOW VIEW ON ten_database.* TO 'dataxland'@'%';
```

- `SELECT` đủ để đọc bảng và liệt kê cột, khóa chính, khóa ngoại; `SHOW VIEW` để đọc view.
- Không cấp `INSERT`, `UPDATE`, `DELETE`, `FILE`, `PROCESS` hay `SUPER`: DataxLand không cần.
- Thay `'%'` bằng địa chỉ máy chủ DataxLand nếu muốn giới hạn nơi đăng nhập (hỏi đội hỗ trợ), và mở tường lửa cho địa chỉ đó.

## 2. Kết nối

1. **Nguồn dữ liệu → Thêm nguồn**, chọn **MySQL / MariaDB**.
2. Điền **Máy chủ**, **Cổng** (mặc định 3306), **Tên database**, **Người dùng**, **Mật khẩu**.
3. **SSL**:
   - **prefer** (mặc định): mã hóa nếu máy chủ hỗ trợ.
   - **require**: bắt buộc mã hóa, chấp nhận chứng chỉ tự ký; máy chủ chưa bật TLS thì báo lỗi, không gửi dữ liệu.
   - **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ủ (Azure, Cloud SQL có
     chứng chỉ công khai; Amazon RDS dùng CA riêng nên chọn require).
   - **disable**: không mã hóa, chỉ dùng trong mạng tin cậy.
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ộ

MySQL / MariaDB có **Toàn bộ** và **Tăng dần**. Tăng dần cần một cột con trỏ (DataxLand gợi ý cột như `updated_at`,
`modified_at`) và khóa chính để gộp dòng; mỗi lần làm mới đọc dòng có con trỏ mới hơn lần trước (lùi 10 phút cho an toàn).
Cột nên có `ON UPDATE CURRENT_TIMESTAMP` để mọi lần sửa đều đổi giá trị. Tăng dần không thấy dòng bị xóa; CDC đọc binlog 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

Dữ liệu vào kho nguyên trạng dưới dạng chữ; từ điển dữ liệu ghi kiểu để bước chuẩn hóa đọc đúng:

| Kiểu MySQL | Trong từ điển | Ghi chú |
| --- | --- | --- |
| `tinyint`, `smallint`, `int`, `bigint` (kể cả `unsigned`), `year` | BIGINT | |
| `decimal`, `float`, `double` | DECIMAL | giữ đủ chữ số thập phân |
| `bit(1)` | BOOLEAN | `true`/`false`; `bit(n)` khác đọc ra số |
| `date` | DATE | ngày `0000-00-00` thành rỗng |
| `datetime`, `timestamp` | DATETIME | `timestamp` đọc theo giờ Việt Nam |
| `time`, `char`, `varchar`, `text`, `enum`, `set`, `json` | VARCHAR | `time` dạng `HH:MM:SS` |
| `blob`, `binary` | (bỏ trống) | dữ liệu nhị phân không dùng |

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

Như PostgreSQL, 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 `EXPLAIN`);
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)
- [SQL Server / Azure SQL](/vi/docs/sources/mssql)
- [Bảo mật và quyền riêng tư](/vi/docs/security-privacy)
