Skip to main content

Setup bảng tạm trong CSDL

Mỗi bảng tạm yêu cầu phải có 4 cột sau (nếu dùng mọi option default):

Cột Kiểu Mục đích
RowCondition JSON (trong mariadb là LONGTEXT) Lưu phần where trong query, sử dụng 
ItemID VARCHAR/CHAR Dùng default làm id của từng hàng, không nhất thiết phải làm PRIMARY KEY nếu có ý định viết id động
ParentID VARCHAR/CHAR Dùng để xác định hàng cha của hàng con. Nếu không dùng các tính năng như sum tổng, 
Static TINYINT (1/0) Dùng để xác định các hàng có lấy dữ liệu từ bảng dữ liệu không

Đối với điều kiện cột hoặc viết trực tiếp điều kiện IF() trong các cột I1, I2, ... hoặc dùng ColumnConditions trong ReportFrame (có thể phối hợp với BeforeQuery)

RowCondition

Cách setup điều kiện RowCondition

Cột RowCondition hay còn gọi là điều kiện hàng, quyết định câu lệnh where cũng như 1 số thủ tục/phép toán trên bảng. Trước hết nó phải chuẩn đúng theo dạng JSON, nó xây dựng câu lệnh where giống với Mongoose (nhưng nên nhớ rằng bản chất của nó không phải là Mongoose). Cú pháp của nó thường là như sau:

{
  "<tên-cột>": {
    "$<toán-tử>": <giá-trị>
  },
  //các điều kiện khác
}

Thí dụ chẳng hạn: để xây câu lệnh WHERE Age >= 18 AND Country = "USA", Ta viết như sau:

{
   "Age": {
     "$gte": 18
   },
   "Country": {
     "$eq": "USA"
   }
}

Trong trường hợp của dấu '=', ta có thể bỏ "$eq" đi, do đó, câu lệnh trên có thể viết gọn thành

{
   "Age": {
     "$gte": 18
   },
   "Country": "USA"
}

Nhiều điều kiện dùng chung 1 cột có thể bỏ chung 1 chỗ, chẳng hạn câu lệnh WHERE Age BETWEEN 18 AND 26 Có thể viết thành

{
   "Age": {
     "$gte": 18,
     "$lte": 26
   }
}

Lưu ý: Các <tên-cột> đều lấy từ bảng dữ liệu, hãy rất cẩn thận khi viết tên cột từ bảng dữ liệu sang!

Hiện tại, chúng ta đang hỗ trợ các phép toán tử sau:

Toán tử Yêu cầu giá trị VD Câu lệnh sinh ra Note
$eq Số/Xâu WHERE AGE = val
$gte Số/Xâu WHERE AGE >= val
$lte Số/Xâu WHERE AGE <= val
$lt Số/Xâu WHERE AGE < val
$gt Số/Xâu WHERE AGE > val
$ne Số/Xâu WHERE AGE != val
$in Mảng giá trị WHERE AGE IN (1, 2, 3, ...)
$nin Mảng giá trị WHERE AGE NOT IN (1, 2, 3, ...)
$like Xâu WHERE AGE LIKE '%cond%'
$regex Xâu WHERE AGE REGEXP 'cond'
$exists Số (1/0) WHERE AGE IS NOT NULL Nếu giá trị = 1 thì yêu cầu cột khác null, 0 thì ngược lại 
$lein3 Mảng giá trị WHERE LEFT(AGE, 3) IN (1, 2, 3, ..) Bởi nhiều truy vấn yêu cầu tài khoản/khoản mục kiểm tra bắt đầu với abcxyz, các câu lệnh ở dưới đây được viết ngắn trc
$lein4 Mảng giá trị WHERE LEFT(AGE, 4) IN (1, 2, 3, ..)
$nlein3 Mảng giá trị WHERE LEFT(AGE, 3) NOT IN (1, 2, 3, ..)
$nlein4 Mảng giá trị WHERE LEFT(AGE, 4) NOT IN (1, 2, 3, ..)

Để có thể thêm các phép toán logic như OR hoặc NOT, Cú pháp của nó như sau:

{
  "$or": {
    //các điều kiện 1 (cond-1)
  },
  "$not": {
    //các điều kiện 2 (cond-2)
  },
  "$and": {
    //các điều kiện 3 (cond-3)
  }
}

Mặc định nếu không viết gì, thì điều kiện sẽ là AND, như vậy, câu lệnh trên sẽ được viết như sau:

WHERE (<cond-1> OR <cond-1> OR ...) AND NOT (<cond-2> ... ) AND (<cond-3> AND ....)

Trong trường hợp cần nest các điều AND và OR vào với nhau, ta dùng

{
  "$or": [
    {"$and": {<cond-1>}},
    {"$and": {<cond-1>}},
  ],
}

//tương tự như vậy
{
  "$and": [
    {"$or": {<cond-1>}},
    {"$or": {<cond-1>}},
  ],
}

Một ví dụ tổng thể tổ hợp của những gì ở trên:

{
    "$or": {
        "ECNo": {
            "$like": "2005101%"
        },
        "$and": {
            "ECNo": "2005207",
            "ECVal": {
                "$gte": 1,
                "$lte": 6
            }
        }
    },
    "AccountNo": {
        "$like": "632%"
    }
}

Câu lệnh WHERE mà nó sinh ra là:

WHERE 
( 
  `ECNo` LIKE '2005101%' 
   OR 
   (`ECNo` = 2005207 AND `ECVal` >= 1 AND `ECVal` <= 6)
) 
AND `AccountNo` LIKE '632%'
Các tính năng đặc biệt của RowCondition

1. $cascade và $>cascade

Trước hết, ReportFrame có hỗ trợ truyền điều kiện hàng cha xuống hàng con, để lấy ví dụ, xem đặc tả sau:

image.png

Theo quan sát: Các hàng dấu '+' đều yêu cầu: 
- PS Nợ 421x (tức PostType = 1 AND AccountNo LIKE '421%')
- Yêu cầu nó phải thuộc 1 trong 5 trong 5 năm ngày trên (tức PostDate IN ('YYYY-01-01',....))
ReportFrame hỗ trợ 2 cách truyền điều kiện từ cha đến con: $cascade và $>cascade, cú pháp của nó trong RowCondition như sau:

{
  "$cascade": {
    //các điều kiện truyền xuống  
  },
  //các điều kiện khác trong hàng
}

Sự khác biệt đơn giản giữa $cascade và $>cascade là sự trao đổi giữa sức mạnh và tốc độ giữa 2 cái: $cascade có thể điều kiện từ cha xuống cháu, trong khi $>cascade chỉ có thể điều kiện xuống con trực tiếp của nó:

image.png

Một vấn đề về tốc độ nghiễm nhiên xảy ra là khi $cascade sẽ lâu hơn $>cascade do phải xét từ đến cháu, hơn nữa $cascade truyền cho toàn bộ cây báo cáo nên phải cẩn thận khi gán ItemID và ReportID khi truyền điều kiện:

Note: $cascade và $>cascade hiện chưa mix được với nhau, nếu cả 2 cái cùng ở trong 1 RowCondition thì ngẫu nhiên cái nào đi trước sẽ được xét trước. Hơn nữa, cả 2 đều chỉ truyền điều kiện xuống cho con/cháu của nó chứ không phải chính bản thân nó. Do đó nếu như có quan hệ cha/con mà cả cha và con đều chung điều kiện X thì vẫn phải viết X trong cả $cascade và điều kiện ở hàng cha.

2. $eval và $evalAll

Để việc tính toán giữa các hàng dễ dàng và thuận tiện hơn RowCondition hỗ trợ thêm $eval và $evalAll

$eval 

Back to top