Datenbank (Raw SQL)

API-Referenz

Low-Level-Lese-/Schreibzugriff auf die SQLite-Datenbank von PlainApp. Für Debugging gedacht — Missbrauch kann den App-Zustand korrumpieren.

Typdefinitionen

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.

Operationen

query

dbPath

Den absoluten Dateisystem-Pfad der PlainApp-SQLite-Datenbank abrufen.

bash

query GetDbPath {
  dbPath
}

query

dbTables

Alle Tabellennamen in der Datenbank auflisten.

bash

query GetDbTables {
  dbTables
}

query

dbTableInfo

Spalten-Metadaten einer Tabelle abrufen.

bash

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

query

dbTableRowCount

Zeilen in einer Tabelle zählen.

bash

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

query

dbTableRows

Zeilen aus einer Tabelle paginiert lesen. Jede Zeile wird als JSON-Objekt zurückgegeben, das Spaltennamen auf Werte abbildet.

bash

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

mutation

createDbTableRow

Eine Zeile in eine Tabelle einfügen. Das row-Argument ist ein JSON-String.

bash

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

mutation

deleteDbTableRows

Zeilen aus einer Tabelle anhand der Primärschlüssel-ID löschen.

bash

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