跳到主要内容

# 按 ID 获取单行 (LCC.db.get)

## 声明​

    row, err = LCC.db.get(name, id, timeout?)

## 参数​

- name
  字符串型，表名称，必须非空且不超过 256 字节
- id
  数值型，要查询的行 `id`，必须是大于等于 1 的整数值
- timeout
  数值型，可选；请求超时时间（秒），默认 `60`

## 返回值​

- row
  表类型，对应 `id` 的行对象；未找到时为 `nil`
- err
  字符串型或 `nil`，未找到时返回 `'not found'`，表不存在时返回 `'unknown table'`

## 说明​

> 按 `id` 获取单行数据，常用于编辑表单回填。
> 返回对象中的用户列为字符串，`id` 为数值。
> `id` 不是大于等于 1 的整数值时，会触发 Lua 参数校验错误。

## 示例​

    local row, err = LCC.db.get("任务表", 42)
    if row then
        print("任务详情", row.名称, row.状态)
    end