# Si viết và chạy SQL/Python

> Với câu hỏi khám phá vượt quá chỉ số có sẵn (trung vị, phân vị, tương quan, nối hai bảng, biểu đồ tùy ý), Si tự viết SQL hoặc Python và chạy trong sandbox cách ly. Kết quả luôn ở mức Chưa xác nhận.

Phần lớn câu hỏi được Si trả lời bằng **chỉ số** và **lớp ngữ nghĩa** — số **Chuẩn** hoặc **Đã duyệt**, khớp với dashboard.
Khi câu hỏi vượt quá chỉ số có sẵn, Si có thể **tự viết SQL hoặc Python** và chạy trong **sandbox khám phá**. Đây là công cụ cho
người phân tích, không thay chỉ số chính thức.

## Khi nào Si dùng sandbox

| Câu hỏi | Si dùng |
| --- | --- |
| Doanh thu, lãi, số đơn, tỷ lệ hoàn; so kỳ trước; top N; "vì sao giảm" | Chỉ số và lớp ngữ nghĩa (số Chuẩn) |
| Trung vị, phân vị, phân phối giá trị đơn | Sandbox (SQL) |
| Tương quan chi phí quảng cáo và doanh thu theo ngày | Sandbox (SQL hoặc Python) |
| Nối hai bảng theo khóa chưa có sẵn trong mô hình | Sandbox (SQL) |
| Cohort theo tháng, hồi quy đơn giản, biểu đồ tùy ý | Sandbox (Python) |

Si luôn thử lớp ngữ nghĩa trước. Nó không dùng sandbox để tính lại một chỉ số đã có.

## Mức xác nhận: luôn "Chưa xác nhận"

Mọi số tính trong sandbox mang nhãn **Chưa xác nhận**: code do Si viết, chưa ai kiểm định nghĩa. Câu trả lời ghi rõ dòng
**Mức xác nhận** và dưới câu trả lời có thẻ cho từng lần chạy:

- nhãn **Chưa xác nhận**;
- **Xem code SQL / Python** (gập sẵn) — đọc để biết Si tính thế nào;
- bảng kết quả (tối đa 100 dòng), biểu đồ (tối đa 2), nội dung in ra.

Kết quả sandbox **không** ghim được thành ô dashboard và **không** lưu được thành "Câu trả lời đã xác nhận". Muốn dùng lâu dài:

1. **Lưu bản nháp vào kiến thức** (kèm code) để người duyệt đọc; hoặc
2. nhờ Si **lưu thành chỉ số** — Si tạo chỉ số nháp trên mô hình ngữ nghĩa, người duyệt kiểm số rồi bật
   (xem [Chỉ số của workspace](/vi/docs/metrics/workspace-metrics)).

## Sandbox được đọc gì

- Chỉ dữ liệu **đã publish** (cùng bản dashboard đang hiện), lớp **core** và **marts**. Không có dữ liệu thô (`raw`) hay lớp
  trung gian.
- **Không có thông tin cá nhân**: cột như số điện thoại, email, tên người mua, cột đã băm và mã định danh khách bị loại trước
  khi dữ liệu vào sandbox. Muốn đếm số khách, Si dùng lớp ngữ nghĩa.
- Bản sao chỉ đọc: code không ghi được vào dữ liệu, chỉ số hay cấu hình của workspace.

## An toàn

- Code chạy trong **dịch vụ sandbox riêng**, không có mạng, không đọc được file ngoài thư mục tạm của lần chạy, không có khóa hay
  mật khẩu nào. Mỗi lần chạy có giới hạn: 30 giây, bộ nhớ, 200 dòng kết quả cho Si.
- SQL chỉ được là **một câu đọc** (SELECT); câu ghi, đọc file, đổi cấu hình bị từ chối trước khi chạy.
- Mỗi lần chạy được ghi nhật ký kiểm toán: **code** và **số dòng** kết quả (không ghi giá trị dữ liệu).

## Ai dùng được

- Vai trò **Phân tích**, **Quản trị**, **Chủ sở hữu**. Vai trò **Xem** không có.
- Gói **Doanh nghiệp nhỏ** trở lên (xem [Gói và hạn mức](/vi/docs/billing/quotas)). Mỗi lần chạy tính thêm **1 câu hỏi cho Si**.
- Tối đa 4 lần chạy cho một câu hỏi, 20 lần mỗi phút mỗi người.
- Chỉ trong ứng dụng web. Hỏi qua Telegram, Slack, Teams không dùng sandbox.
- Qua MCP: chỉ token được cấp thêm quyền `explore:run` (mặc định không có), xem [MCP](/vi/docs/mcp).

## Câu hỏi thường gặp

**Vì sao số trong sandbox khác dashboard?** Code của Si có thể lọc hay gom khác định nghĩa chỉ số (ví dụ tính cả đơn hủy). Mở
"Xem code" để thấy cách tính; số chính thức vẫn là số trên dashboard.

**Si báo "Sandbox khám phá chưa bật"?** Máy chủ của bạn chưa chạy dịch vụ sandbox; liên hệ quản trị (bản tự triển khai).

**Si báo hết lượt?** Mỗi lần chạy tính vào câu hỏi cho Si trong tháng; mua thêm gói 500 câu hỏi hoặc nâng gói.
