조건에 따른 행 목록 조회 (LCC.db.list)

선언

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

매개변수

• name
  문자열 형태로, 테이블 이름이며 반드시 비어 있어서는 안 되고 256바이트를 초과할 수 없습니다.
• opts
  테이블 형태로, 선택 사항입니다. 조회에 사용되는 매개변수 테이블로, 다음 항목들을 포함합니다:
  • conditions: 키-값 쌍 형태의 동등성 필터 조건(AND 조합)
  • order_by: 문자열 형태로, 정렬에 사용되는 필드이며 기본값은 "id"입니다.
  • desc: 부울 형태로, 내림차순으로 정렬할지 여부를 나타내며 기본값은 false입니다.
  • limit: 정수 형태로, 반환될 행의 수를 제한합니다.
  • offset: 정수 형태로, 오프셋 값을 나타내며 기본값은 0입니다.
• timeout
  수치 형태로, 선택 사항입니다. 요청 시 발생할 수 있는 초과 시간(초)을 나타내며 기본값은 60입니다.

반환 값

• rows
  테이블 형태로, 조건을 만족하는 행들의 배열입니다. 실패할 경우 nil이 반환됩니다.
• err
  문자열 형태이거나 nil 형태로, 실패 시 발생하는 오류에 대한 설명을 나타내며 unknown column, unknown table와 같은 값이 포함될 수 있습니다.

설명

조건에 따라 행 목록을 조회하며, 모든 사용자 관련 열의 값은 문자열 형태입니다.
반환되는 객체 내의 사용자 관련 열도 문자열 형태이고, id는 수치 형태입니다.
opts를 전달하지 않을 경우 기본적으로 id에 따라 오름차순으로 정렬된 모든 데이터가 반환됩니다.

예시

local rows, err = LCC.db.list("작업 테이블", {
    conditions = { ["상태"] = "유휴" },
    order_by = "id",
    limit = 20
})
if rows then
    print("유휴 작업 수:", #rows)
end