Truy vấn danh sách hàng theo điều kiện (LCC.db.list)

Khai báo

rows, err = LCC.db.list(name, opts?, timeout?)

Tham số

• name
  Kiểu chuỗi, tên bảng; phải khác rỗng và không dài quá 256 byte
• opts
  Kiểu bảng, tùy chọn; bảng tham số truy vấn:
  • conditions: điều kiện lọc bằng nhau ở dạng cặp khóa-giá trị (kết hợp bằng AND)
  • order_by: kiểu chuỗi, trường sắp xếp, mặc định là "id"
  • desc: kiểu boolean, có sắp xếp giảm dần hay không, mặc định là false
  • limit: kiểu số nguyên, giới hạn số hàng trả về
  • offset: kiểu số nguyên, độ lệch, mặc định là 0
• timeout
  Kiểu số, tùy chọn; thời gian chờ yêu cầu (giây), mặc định là 60

Giá trị trả về

• rows
  Kiểu bảng, mảng các hàng khớp điều kiện; khi thất bại trả về nil
• err
  Kiểu chuỗi hoặc nil, nội dung mô tả lỗi khi thất bại (chẳng hạn unknown column, unknown table)

Mô tả

Truy vấn danh sách hàng theo điều kiện; mọi giá trị cột do người dùng tạo đều là chuỗi.
Trong đối tượng trả về, cột do người dùng tạo là chuỗi còn id là số.
Nếu không truyền opts, mặc định trả về toàn bộ dữ liệu theo thứ tự id tăng dần.

Ví dụ

local rows, err = LCC.db.list("Bảng tác vụ", {
    conditions = { ["Trạng thái"] = "Đang rảnh" },
    order_by = "id",
    limit = 20
})
if rows then
    print("Số tác vụ đang rảnh:", #rows)
end