← Alle Module · Daten & Formate

`sqlite`

Liest und verändert SQLite-Datenbanken direkt als Datei — ganz ohne Datenbank-Server. Damit lassen sich Stammdaten, Listen oder kleine Tabellen dauerhaft speichern, durchsuchen und pflegen.

Block-Einstellungen

Gelten für den ganzen Modul-Block (im Editor oben im Inspektor, in YAML direkt unter dem Modulnamen).

Feld	Typ	Pflicht	Beschreibung
datei	Text	ja	Pfad zur .db/.sqlite-Datei. Existiert sie nicht, wird sie automatisch angelegt (außer bei nur-lesen).
nur-lesen	Wahrheit	—	Standard false. Bei true werden alle schreibenden Aktionen gesperrt; die Datei muss bereits existieren.
transaktion	Wahrheit	—	Standard false. Bei true werden alle Block-Aktionen in eine Transaktion geklammert: Commit am Block-Ende, Rollback bei Fehler.

Aktionen

`abfrage`lesend

Führt ein SELECT aus und liefert alle Ergebniszeilen als Liste von Objekten zurück.

Eingaben

Feld	Typ	Pflicht	Beschreibung
sql	Text	ja	SQL-SELECT-Anweisung. Benannte Parameter mit $name oder @name.
parameter	Objekt	—	Benannte Werte für die Platzhalter im SQL (schützt vor SQL-Injection).

Ausgaben (über `ergebnis:`)

zeilen

Liste der Ergebniszeilen; jede Zeile ist ein Objekt aus Spaltenname und Wert.

`skalar`lesend

Führt eine Abfrage aus und liefert nur den ersten Wert der ersten Zeile (z.B. eine Summe oder Anzahl).

Eingaben

Feld	Typ	Pflicht	Beschreibung
sql	Text	ja	SQL-Anweisung, deren erster Wert zurückgegeben wird.
parameter	Objekt	—	Benannte Werte für die Platzhalter im SQL.

Ausgaben (über `ergebnis:`)

wert	Der erste Wert der ersten Ergebniszeile, oder leer wenn kein Ergebnis.

`ausführen`verändernd

Führt ein veränderndes Statement (INSERT/UPDATE/DELETE) aus und meldet die Anzahl betroffener Zeilen.

Eingaben

Feld	Typ	Pflicht	Beschreibung
sql	Text	ja	Veränderndes SQL-Statement.
parameter	Objekt	—	Benannte Werte für die Platzhalter im SQL.

Ausgaben (über `ergebnis:`)

betroffene

Anzahl der durch das Statement geänderten Zeilen.

`stapel-ausführen`verändernd

Führt mehrere SQL-Anweisungen hintereinander aus (z.B. ein ganzes Schema-Skript).

Eingaben

Feld	Typ	Pflicht	Beschreibung
sql	Text	ja	Eine oder mehrere SQL-Anweisungen, durch Semikolon getrennt.

`datensatz-anlegen`verändernd

Fügt einen neuen Datensatz in eine Tabelle ein (ohne SQL zu schreiben) und gibt die neue Zeilen-ID zurück.

Eingaben

Feld	Typ	Pflicht	Beschreibung
tabelle	Text	ja	Name der Zieltabelle.
felder	Objekt	ja	Spalte-zu-Wert-Zuordnung für den neuen Datensatz.

Ausgaben (über `ergebnis:`)

id	Die rowid des neu angelegten Datensatzes.

`datensatz-aktualisieren`verändernd

Aktualisiert vorhandene Datensätze, die der WHERE-Bedingung entsprechen, und meldet die Anzahl.

Eingaben

Feld	Typ	Pflicht	Beschreibung
tabelle	Text	ja	Name der Zieltabelle.
felder	Objekt	ja	Spalte-zu-Wert-Zuordnung der neuen Werte.
wo	Text	ja	WHERE-Klausel, die festlegt, welche Zeilen geändert werden. Parameter mit $name.
wo-parameter	Objekt	—	Benannte Werte für die Platzhalter in der wo-Klausel.

Ausgaben (über `ergebnis:`)

betroffene

Anzahl der aktualisierten Zeilen.

`datensatz-löschen`verändernd

Löscht alle Datensätze, die der WHERE-Bedingung entsprechen, und meldet die Anzahl.

Eingaben

Feld	Typ	Pflicht	Beschreibung
tabelle	Text	ja	Name der Zieltabelle.
wo	Text	ja	WHERE-Klausel, die festlegt, welche Zeilen gelöscht werden. Parameter mit $name.
wo-parameter	Objekt	—	Benannte Werte für die Platzhalter in der wo-Klausel.

Ausgaben (über `ergebnis:`)

betroffene

Anzahl der gelöschten Zeilen.

`zeilen-zählen`lesend

Zählt die Datensätze einer Tabelle, optional gefiltert durch eine WHERE-Bedingung.

Eingaben

Feld	Typ	Pflicht	Beschreibung
tabelle	Text	ja	Name der Tabelle.
wo	Text	—	Optionale WHERE-Klausel zum Filtern. Parameter mit $name.
wo-parameter	Objekt	—	Benannte Werte für die Platzhalter in der wo-Klausel.

Ausgaben (über `ergebnis:`)

anzahl

Anzahl der gezählten Zeilen.

`tabelle-erstellen`verändernd

Legt eine neue Tabelle mit den angegebenen Spalten und Spaltentypen an.

Eingaben

Feld	Typ	Pflicht	Beschreibung
tabelle	Text	ja	Name der zu erstellenden Tabelle.
spalten	Objekt	ja	Spaltenname-zu-Typdefinition (z.B. 'INTEGER PRIMARY KEY', 'TEXT NOT NULL').
wenn-nicht-vorhanden	Wahrheit	—	Standard false. Bei true wird die Tabelle nur angelegt, falls sie noch nicht existiert (IF NOT EXISTS).

`tabelle-löschen`verändernd

Entfernt eine Tabelle samt allen Daten aus der Datenbank (DROP TABLE).

Eingaben

Feld	Typ	Pflicht	Beschreibung
tabelle	Text	ja	Name der zu löschenden Tabelle.

`tabelle-existiert`lesend

Prüft, ob eine Tabelle in der Datenbank vorhanden ist.

Eingaben

Feld	Typ	Pflicht	Beschreibung
tabelle	Text	ja	Name der zu prüfenden Tabelle.

Ausgaben (über `ergebnis:`)

existiert

Wahr, wenn die Tabelle existiert, sonst falsch.

`tabellen-liste`lesend

Liefert die Namen aller Benutzertabellen der Datenbank (interne sqlite_-Tabellen ausgenommen).

Ausgaben (über `ergebnis:`)

tabellen

Alphabetisch sortierte Liste der Tabellennamen.

`spalten-liste`lesend

Liefert die Spaltendefinitionen einer Tabelle (Name, Typ, Pflichtfeld, Standardwert, Primärschlüssel).

Eingaben

Feld	Typ	Pflicht	Beschreibung
tabelle	Text	ja	Name der Tabelle, deren Spalten beschrieben werden sollen.

Ausgaben (über `ergebnis:`)

spalten

Liste von Objekten mit name, typ, pflicht, standard und primaerschluessel.

`vacuum`verändernd

Räumt die Datenbankdatei auf und gibt ungenutzten Speicherplatz frei (VACUUM).

Beispiele

Kundentabelle anlegen und Datensatz einfügen

Erstellt eine Tabelle 'kunden' (falls noch nicht vorhanden) und legt einen neuen Kunden an, dessen neue ID zurückgegeben wird.

sqlite

tabelle-erstellen

tabellekunden

spalten.idINTEGER PRIMARY KEY AUTOINCREMENT

spalten.nameTEXT NOT NULL

spalten.ortTEXT

wenn-nicht-vorhandenja

sqlite

datensatz-anlegen

tabellekunden

felder.nameAnna Müller

felder.ortBerlin

ergebnisneuer_kunde

- sqlite:
    datei: "C:\\Daten\\firma.db"
    aktionen:
      - tabelle-erstellen:
          tabelle: kunden
          spalten:
            id: "INTEGER PRIMARY KEY AUTOINCREMENT"
            name: "TEXT NOT NULL"
            ort: "TEXT"
          wenn-nicht-vorhanden: ja
      - datensatz-anlegen:
          tabelle: kunden
          felder:
            name: "Anna Müller"
            ort: "Berlin"
          ergebnis: neuer_kunde

Kunden aus Berlin abfragen und zählen

Liest alle Kunden aus Berlin parametrisiert aus und ermittelt zusätzlich deren Gesamtzahl.

sqlite

abfrage

sqlSELECT name FROM kunden WHERE ort = $stadt ORDER BY name

parameter.stadtBerlin

ergebnisberliner

sqlite

zeilen-zählen

tabellekunden

woort = $stadt

wo-parameter.stadtBerlin

ergebnisanzahl_berlin

- sqlite:
    datei: "C:\\Daten\\firma.db"
    nur-lesen: ja
    aktionen:
      - abfrage:
          sql: "SELECT name FROM kunden WHERE ort = $stadt ORDER BY name"
          parameter:
            stadt: "Berlin"
          ergebnis: berliner
      - zeilen-zählen:
          tabelle: kunden
          wo: "ort = $stadt"
          wo-parameter:
            stadt: "Berlin"
          ergebnis: anzahl_berlin

sqlite

Block-Einstellungen

Aktionen

abfragelesend

Eingaben

Ausgaben (über ergebnis:)

skalarlesend

Eingaben

Ausgaben (über ergebnis:)

ausführenverändernd

Eingaben

Ausgaben (über ergebnis:)

stapel-ausführenverändernd

Eingaben

datensatz-anlegenverändernd

Eingaben

Ausgaben (über ergebnis:)

datensatz-aktualisierenverändernd

Eingaben

Ausgaben (über ergebnis:)

datensatz-löschenverändernd

Eingaben

Ausgaben (über ergebnis:)

zeilen-zählenlesend

Eingaben

Ausgaben (über ergebnis:)

tabelle-erstellenverändernd

Eingaben

tabelle-löschenverändernd

Eingaben

tabelle-existiertlesend

Eingaben

Ausgaben (über ergebnis:)

tabellen-listelesend

Ausgaben (über ergebnis:)

spalten-listelesend

Eingaben

Ausgaben (über ergebnis:)

vacuumverändernd

Beispiele

Kundentabelle anlegen und Datensatz einfügen

Kunden aus Berlin abfragen und zählen

`sqlite`

`abfrage`lesend

Ausgaben (über `ergebnis:`)

`skalar`lesend

Ausgaben (über `ergebnis:`)

`ausführen`verändernd

Ausgaben (über `ergebnis:`)

`stapel-ausführen`verändernd

`datensatz-anlegen`verändernd

Ausgaben (über `ergebnis:`)

`datensatz-aktualisieren`verändernd

Ausgaben (über `ergebnis:`)

`datensatz-löschen`verändernd

Ausgaben (über `ergebnis:`)

`zeilen-zählen`lesend

Ausgaben (über `ergebnis:`)

`tabelle-erstellen`verändernd

`tabelle-löschen`verändernd

`tabelle-existiert`lesend

Ausgaben (über `ergebnis:`)

`tabellen-liste`lesend

Ausgaben (über `ergebnis:`)

`spalten-liste`lesend

Ausgaben (über `ergebnis:`)

`vacuum`verändernd