Skip to content

SQLite 表 ​

菜单:数据库 → SQLite 表
深链:/_Admin/database/sqlite-table?SiteId={站点GUID}

SQLite 表管理当前站点内置 SQLite 数据库中的表:可在后台 创建表、维护列与数据,并支持 CSV 导入 / 导出。无需单独配置连接字符串;脚本侧使用 k.DB.sqlite 执行 SQL 或访问表对象。

权限

与 IndexedDB 表 相同:database(查看)、database·edit、database·delete。

与 IndexedDB 表的区别

SQLite 表IndexedDB 表
引擎站点 SQLite 文件站点 IndexedDB 动态表
配置开箱即用开箱即用
列设置无 主键 / 唯一 列(界面)、无数字 自增 项可设主键、唯一、自增
数据页有 导入数据(CSV)无 CSV 导入
脚本k.DB.sqlite.query / execute / getTablek.DB.indexedDb.{表名}
表关系不支持 表关系(仅 IndexedDB)支持

列编辑、数据浏览与 IndexedDB 共用路由,但须带查询参数 dbType=Sqlite,左侧菜单高亮 SQLite 表。

如何打开 ​

  1. 在 编辑菜单 中勾选 数据库 → SQLite 表。
  2. 左侧 数据库 → SQLite 表。
SQLite 表列表

表列表 ​

界面与 IndexedDB 表 相同:创建表、点击 名称 进数据、设置 进列定义、多选删除。

SQLite 表工具栏SQLite 表列表

创建表弹窗 ​

表名规则与 IndexedDB 相同:1~50 字符、字母或数字开头、仅字母数字、站点内唯一。创建后在 SQLite 中生成物理表,并登记后台列结构(Schema)。

创建 SQLite 表弹窗

列设置 ​

路径示例:

text
/_Admin/database/table/columns?SiteId={站点GUID}&table={表名}&dbType=Sqlite

从 SQLite 列表进入时,地址栏会自动带上 dbType=Sqlite。

与 IndexedDB 列设置差异说明
列表列显示 列名、控件类型、索引;不显示主键 / 唯一列
列编辑弹窗无 长度(文本)、无 自增、无 主键 / 唯一 勾选项
保存更新 SQLite 表结构及后台 Schema 映射

控件类型(文本框、多行文本、富文本、选项、布尔、日期时间、数字等)与 IndexedDB 一致,决定后台 编辑数据 表单样式。

SQLite 列设置SQLite 列编辑弹窗

表数据 ​

路径示例:

text
/_Admin/database/table/data?SiteId={站点GUID}&table={表名}&dbType=Sqlite

工具栏 ​

按钮权限说明
新建数据database·edit进入编辑页新建行
导出数据database(查看)导出 CSV(当前排序下;大量数据时导出会使用较大分页抓取)
导入数据database·edit打开 CSV 导入
设置—跳转列设置
SQLite 表数据工具栏

数据表格 ​

分页默认 30 条/页,列头可排序(排序偏好保存在浏览器本地),行末 编辑、多选 删除。列表隐藏 _id 等内部列时的展示规则与 IndexedDB 数据页一致。

SQLite 表数据

CSV 导入 ​

步骤 / 字段说明
跳过行数文件开头跳过的行数(如 CSV 表头占 1 行则填 1)
文件选择 .csv 上传,服务端解析列与样例行
字段映射将 数据库字段 映射到 CSV 列;可勾选 必填、唯一
覆盖当存在 唯一 映射且命中已有行时,可开启覆盖更新

确认 开始 后批量写入;完成后刷新数据表。

SQLite CSV 导入

编辑数据 ​

路径示例:

text
/_Admin/database/table/edit-data?SiteId={站点GUID}&table={表名}&dbType=Sqlite

按列 控件类型 渲染表单;保存 / 取消 后返回表数据列表。新建时不带 id 查询参数。

脚本访问(开发) ​

SQLite 以 SQL 与 表对象 为主,例如:

typescript
k.DB.sqlite.execute(
  "CREATE TABLE IF NOT EXISTS logs (id INTEGER PRIMARY KEY, msg TEXT)"
)
const rows = k.DB.sqlite.query("SELECT * FROM logs WHERE id = @id", { id: 1 })
const table = k.DB.sqlite.getTable("logs")

详见 k.DB.sqlite。在 Code 中 execute / query 创建的表,刷新 SQLite 表 列表后也可在后台维护(须符合表名规则)。

SQL 日志

执行 SQL 产生的记录可在 SQL 日志 中查看(需站点开启相关日志)。

典型工作流 ​

  1. 创建表 或在脚本中 CREATE TABLE 后于本页 同步 看到表名。
  2. 设置 中定义列(或依赖脚本建表时的 SQL 列)。
  3. 新建数据、导入 CSV 或脚本 INSERT 写入。
  4. 排障时结合 SQL 日志 与 k.DB.sqlite.query。

相关 ​

文档说明
IndexedDB 表动态表与对象 API
k.DB.sqliteSQL 与 getTable
SQL 日志执行记录
数据库概述菜单总览