跳到主要内容

# 创建数据表 (LCC.db.create)

## 声明​

    ok, err = LCC.db.create(name, columns, timeout?)

## 参数​

- name
  字符串型，表名称，必须非空且不超过 256 字节
- columns
  表类型，列名称数组；每个列名都必须是非空合法 UTF-8，不能重复，也不能为 `id`
- timeout
  数值型，可选；请求超时时间（秒），默认 `60`

## 返回值​

- ok
  布尔型，创建成功返回 `true`；失败返回 `false`
- err
  字符串型或 `nil`，失败时的错误描述；表已存在时为 `'table already exists'`

## 说明​

> 新建表结构，所有用户列类型为 `TEXT`，并自动附带自增 `id`。
> 表名为空或超过 256 字节、列名不是合法 UTF-8 时，会触发 Lua 参数校验错误。
> 重复列名会返回错误信息。

## 示例​

    local ok, err = LCC.db.create("任务表", {"名称", "状态", "备注"})
    if not ok then
        error(err)
    end