Database (Raw SQL)

API 参考

对 PlainApp 的 SQLite 数据库进行低级读写访问。用于调试——误用可能导致应用状态损坏。

类型定义

bash

type DbTableInfo {
  # Column metadata for a single table.
  # Platform-dependent; see PlainApp source for the full list of fields.
}

# dbTableRows returns an array of JSON objects (one per row).
# Each object maps column name to value.
# dbTables and dbTableRowCount return plain scalars.

操作

query

dbPath

获取 PlainApp SQLite 数据库的绝对文件系统路径。

bash

query GetDbPath {
  dbPath
}

query

dbTables

列出数据库中的所有表名。

bash

query GetDbTables {
  dbTables
}

query

dbTableInfo

获取表的列元数据。

bash

query GetDbTableInfo($table: String!) {
  dbTableInfo(table: $table) { name type notNull defaultValue primaryKey }
}

query

dbTableRowCount

统计表中的行数。

bash

query GetDbTableRowCount($table: String!) {
  dbTableRowCount(table: $table)
}

query

dbTableRows

分页读取表中的行。每行作为映射列名到值的 JSON 对象返回。

bash

query GetDbTableRows($table: String!, $offset: Int!, $limit: Int!) {
  dbTableRows(table: $table, offset: $offset, limit: $limit)
}

mutation

createDbTableRow

向表中插入一行。row 参数为 JSON 字符串。

bash

mutation CreateDbTableRow($table: String!, $row: String!) {
  createDbTableRow(table: $table, row: $row)
}

mutation

deleteDbTableRows

按主键 id 删除表中的行。

bash

mutation DeleteDbTableRows($table: String!, $ids: [String!]!) {
  deleteDbTableRows(table: $table, ids: $ids)
}