> For the complete documentation index, see [llms.txt](https://docs.datasuite.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.datasuite.vn/khoi-dau-nhanh-voi-data-suite/ket-noi-data-warehouse.md).

# Kết nối Data Warehouse

Data Suite cung cấp 2 hình thức kết nối Data Warehouse (DWH): Shared DWH và Dedicated DWH

### Data Suite Shared DWH

Mặc định tài khoản cá nhân đăng ký sử dụng Data Suite sẽ được kết nối vào data warehouse chia sẻ (Shared DWH) do Data Suite cung cấp, mỗi Workspace sẽ tương ứng một Database (Schema) trên Shared DWH.

Shared DWH không hỗ trợ thực hiện các thao tác trực tiếp trên Database. Người dùng có thể upload file Excel/CSV để tạo thành Table nằm trong Database thuộc Shared DWH này, từ đó ánh xạ thành Dataset trên giao diện quản lý (menu Data Warehouse).

Share DWH cho phép người dùng bắt đầu sử dụng các tính năng BI ngay chỉ với file Excel/CSV mà chưa cần phải có DWH riêng.

### Dedicated DWH

Trường hợp khách hàng đã có sẵn DWH riêng, có thể cấu hình để app Data Suite kết nối trực tiếp đến DWH đó, từ đó dựng được báo cáo bằng dữ liệu thật của mình.

Hiện tại Data Suite hỗ trợ các dialect: **ClickHouse**, PostgreSQ (coming soon), MySQL (coming soon)

Yêu cầu: Người thao tác cần có quyền Owner trong Organization.

{% stepper %}
{% step %}

#### Thêm connection mới

Truy cập Manage Organization ⇒ Active Connection ⇒ Add Connection

<figure><img src="/files/uX1QL8QEsCWoDiwU4WYJ" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Điền thông tin kết nối

Thực hiện các bước như Wizard hướng dẫn:

Whitelist cho IP của Data Suite từ phía Database của khách hàng.

Tạo database user dành riêng cho Data Suite, với bộ phân quyền đã liệt kê.

<figure><img src="/files/OYf4ubcclZDB2wo7rQPW" alt=""><figcaption></figcaption></figure>

Nhập thông tin kết nối (dialect, host, port, username, password).

<figure><img src="/files/jNKteTk7iSSzKHDecGss" alt=""><figcaption></figcaption></figure>

Kiểm tra kết nối và quyền của database user.

<figure><img src="/files/Wv1VQV6inmAeQhNFVj6D" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Kích hoạt kết nối mới

Chọn "Make Active" tại connection vừa tạo và nhấn xác nhận.

<figure><img src="/files/X1x1adGIWFWBaKn7NRWy" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Kiểm tra cấu hình mapping Workspace - Schema

Khi chuyển từ Shared DWH sang Dedicated DWH hoặc giữa 2 Dedicated DWH khác nhau, Workspace trong Organization vẫn đang trỏ đến tên Schema cũ trên DWH cũ, nên khách hàng cần kiểm tra lại các Workspace đã trỏ đúng Schema hay chưa.

Ví dụ: "My Workspace" trước đây map với Schema cũ, sau khi đổi Connection, Schema cũ không tồn tại nữa (hệ thống tìm theo tên schema) nên Workspace rơi vào trạng thái thiếu Schema, cần chọn Schema mới cho Workspace này.

<figure><img src="/files/4gWOXl8Xmftw1yPbGY5S" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/M1d5w7TN3ScO64ctLfFq" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Sync Tables từ DWH mới lên App

Sau khi cấu hình map Workspace và Schema, khách hàng có thể truy cập trang Data Warehouse để đồng bộ các tables có trong Schema đó lên Workspace (hệ thống không tự động thực hiện).

<figure><img src="/files/kaEw5CDn4mJ9wVsNFp2X" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OMhGQbRUL5ekXYIu7UrG" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}