> ## Documentation Index
> Fetch the complete documentation index at: https://huongdan.luklak.com/llms.txt
> Use this file to discover all available pages before exploring further.

# UQL Cơ bản: Viết truy vấn đầu tiên

> Cú pháp cốt lõi — field, operator, value — và cách kết hợp tiêu chí với AND/OR.

## Từ câu hỏi đến câu trả lời

UQL giống câu hỏi bằng ngôn ngữ tự nhiên, nhưng đủ mạnh để tìm chính xác thứ bạn cần.

## Cấu trúc cốt lõi: `field` `operator` `value`

1. **Field:** Trường dữ liệu cần kiểm tra (VD: `status`, `priority`, `deal_value`).
2. **Operator:** Phép so sánh (VD: `=`, `!=`, `>`, `<`).
3. **Value:** Giá trị so sánh (VD: `"DONE"`, `"HIGH"`, `5000`).

VD: `priority = "HIGH"`

<Info>
  **Cú pháp:** Text phải nằm trong dấu ngoặc kép (`" "`). Số không cần. Tên trạng thái phân biệt hoa thường.
</Info>

## Bảng Operator cơ bản

| Operator       | Ý nghĩa               | Ví dụ                                      |
| :------------- | :-------------------- | :----------------------------------------- |
| `=`            | Bằng                  | `status = "DONE"`                          |
| `!=`           | Khác                  | `assignee != "John Doe"`                   |
| `>`            | Lớn hơn               | `deal_value > 10000`                       |
| `<`            | Nhỏ hơn               | `risk_score < 5`                           |
| `>=`           | Lớn hơn hoặc bằng     | `story_points >= 8`                        |
| `<=`           | Nhỏ hơn hoặc bằng     | `tasks_completed <= 10`                    |
| `in`           | Thuộc danh sách       | `priority in ("HIGH", "URGENT")`           |
| `not in`       | Không thuộc danh sách | `category not in ("Internal", "Archived")` |
| `is empty`     | Trường trống          | `description is empty`                     |
| `is not empty` | Trường có giá trị     | `assignee is not empty`                    |

## Kết hợp tiêu chí: `AND` & `OR`

* **`AND`:** Tất cả đều phải đúng.
  * `status = "OPEN" AND priority = "HIGH"`
* **`OR`:** Ít nhất một đúng.
  * `assignee = "currentUser()" OR supervisor = "currentUser()"`
* **Ngoặc `( )`:** Nhóm logic phức tạp.
  * `status = "OPEN" AND (priority = "HIGH" OR due_date < "today")`

***

## Đọc tiếp

* [Tạo Bộ lọc](/02-platform/platform-overview/filter-and-uql/bo-loc)
* [Quay lại Tổng quan UQL](/02-platform/platform-overview/filter-and-uql/index)