# Kết nối dữ liệu

> Các loại nguồn DataxLand nhận — file Excel, sàn thương mại điện tử, PostgreSQL, BigQuery, REST API và thư viện connector — và cách thêm nguồn vào workspace.

Dữ liệu từ mọi nguồn được **chép về kho riêng của workspace**; dashboard không truy vấn trực tiếp vào nguồn của bạn.

## Loại nguồn

| Loại | Cách nối | Hướng dẫn |
| --- | --- | --- |
| File Excel (.xlsx) | Tải lên, mỗi sheet một bảng, kèm sheet `data_dictionary` | [File Excel](/vi/docs/sources/excel) |
| PostgreSQL | Thông tin kết nối chỉ đọc; toàn bộ, tăng dần hoặc CDC | [PostgreSQL](/vi/docs/sources/postgres) |
| BigQuery | Khóa service account; nạp tăng dần, có giới hạn dung lượng quét | [BigQuery](/vi/docs/sources/bigquery) |
| Shopee, TikTok Shop, Lazada | Đăng nhập trên trang của sàn (OAuth), không dán mật khẩu | [Shopee](/vi/docs/sources/shopee), [TikTok Shop](/vi/docs/sources/tiktok-shop), [Lazada](/vi/docs/sources/lazada) |
| Phần mềm có REST API trả JSON (POS, CRM, kho, ERP nội bộ) | Khai báo địa chỉ, xác thực, endpoint, phân trang | [REST API tùy biến](/vi/docs/sources/rest-api) |
| Quảng cáo, CRM, thanh toán, phân tích… | Hơn 560 connector trong thư viện | [Thư viện connector](/vi/docs/sources/connector-library) |

Gói **Miễn phí** chỉ nhận một file Excel. Các gói trả phí nhận mọi loại nguồn và làm mới theo lịch. Xem [Gói và hạn mức](/vi/docs/billing/quotas).

## Nguồn đầu tiên: khi tạo workspace

Trang **Tạo workspace** hiện thư viện nguồn ngay từ đầu. Chọn nguồn, nhập **Tên workspace** rồi bấm **Tạo workspace và đọc dữ liệu**. Các bước tiếp theo nằm ở [Bắt đầu nhanh](/vi/docs/quickstart).

## Thêm nguồn vào workspace đã có

1. Vào **Nguồn dữ liệu** (nhóm **Dữ liệu và kết nối**). Cần vai trò Quản trị hoặc Chủ sở hữu.
2. Ở thẻ **Các nguồn của workspace**, bấm **Thêm nguồn**. **Thư viện nguồn dữ liệu** mở ra.
3. Tìm trong ô **Tìm connector** hoặc lọc theo nhóm. Bấm **Chọn** trên một hay nhiều connector rồi **Tiếp tục**.
4. Điền từng form. Đặt **Tên nguồn** (chữ thường không dấu, số, dấu gạch dưới; bắt đầu bằng chữ; tối đa 16 ký tự). Nếu nguồn mới liên quan tới nguồn đã có, đánh dấu **Nguồn mới có liên quan đến nguồn đã có**.
5. Bấm **Kiểm tra kết nối**; thấy **Kết nối được** là đúng.
6. Ở **Xem lại trước khi thêm**, bấm **Thêm N nguồn**. Sàn thương mại điện tử được kết nối sau cùng, trên trang của sàn.
7. Sau khi đọc, bạn xác nhận lại cột thông tin cá nhân rồi Si đề xuất lại. Dashboard hiện tại vẫn xem được trong lúc đó.

Mỗi workspace có tối đa 8 nguồn (gói Khởi đầu: 3). Bấm **Bỏ** để gỡ một nguồn; DataxLand đọc lại dữ liệu và đưa workspace về bước chọn cột cần che.

## Trang Nguồn dữ liệu

| Thẻ | Dùng để |
| --- | --- |
| Các nguồn của workspace | Thêm, gỡ nguồn; khai báo quan hệ giữa nguồn |
| Lịch làm mới dữ liệu | Đặt tần suất làm mới tự động, xem [Cách đồng bộ](/vi/docs/concepts/sync-modes) |
| Cách đồng bộ | Toàn bộ, tăng dần hoặc CDC theo từng bảng |
| Thay file | Với Excel: tải file mới và làm mới |
| Kết nối và bảng | Với PostgreSQL, BigQuery: sửa kết nối, chọn bảng |

Nút **Làm mới dữ liệu** ở đầu trang chạy làm mới ngay.

## Mật khẩu và khóa

Ô mật khẩu được mã hóa khi lưu và không hiển thị lại. Thẻ nguồn ghi **Đã lưu mật khẩu** hoặc **Chưa lưu mật khẩu**. Thông tin cá nhân trong dữ liệu được che và băm, xem [Che thông tin cá nhân](/vi/docs/review/pii).

## Liên quan

- [Cách đồng bộ và lịch làm mới](/vi/docs/concepts/sync-modes)
- [Duyệt đề xuất và build](/vi/docs/review/mapping)
- [Danh mục connector](/vi/connectors)
