PlainApp
API 參考

資料庫瀏覽

透過結構化操作瀏覽應用程式資料庫,不支援任意 SQL。所有資料庫操作均需啟用開發者模式,否則回傳 “No permission: developer mode is disabled”。

型別定義

graphql
type Mutation {
  createDbTableRow(table: String!, row: JSON!): Boolean!
  deleteDbTableRows(table: String!, ids: [String!]!): Boolean!
}

type Query {
  dbPath: String!
  dbTableRowCount(table: String!): Long!
  dbTableRows(table: String!, offset: Int!, limit: Int!): [JSON!]!
  dbTables: [DbTable!]!
}

enum DbColumnType {
	TEXT
	INTEGER
	REAL
	BLOB
	NUMERIC
	UNKNOWN
}

type DbTable {
	name: String!
	createSql: String!
	columns: [DbTableColumn!]!
}

type DbTableColumn {
	name: String!
	dataType: DbColumnType!
	notNull: Boolean!
	defaultValue: String
	primaryKey: Boolean!
}

scalar JSON

scalar Long

操作

mutation

createDbTableRow

直接使用 JSON 物件插入一列;需要開發者模式。非物件輸入會被拒絕,資料列無效時傳回 false。

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

deleteDbTableRows

依識別值刪除選取的資料表資料列,需要開發者模式。

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

dbPath

讀取應用程式 SQLite 資料庫路徑,需要開發人員模式。

graphql
query dbPath {
  dbPath
}
query

dbTableRowCount

統計資料表的資料列數,需要開發者模式。

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

dbTableRows

分頁讀取 JSON 物件陣列;需要開發者模式。儲存格值仍為字串或 null,無需 JSON.parse。

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

dbTables

列出應用程式資料庫中的資料表名稱,需要開發者模式。

graphql
query dbTables {
  dbTables { name createSql }
}