Abschnitt 12 · Lektion 2
Die erste Tabelle
Ein Server, dessen Daten in einem Array im Prozess liegen, fängt nach jedem Neustart wieder bei
seinen vier Büchern an. Mit node:sqlite ist eine Datenbank, die den Neustart überlebt, nur eine
Zeile entfernt. Eine Tabelle darin ist eine Anweisung mehr.
Eine Datei, eine Tabelle
import { DatabaseSync } from "node:sqlite";
import { mkdirSync, rmSync, statSync } from "node:fs";
// Jeder Lauf des Beispiels faengt mit einer frischen Datei an.
mkdirSync("daten", { recursive: true });
rmSync("daten/bibliothek.db", { force: true });
// Die Datei ist das einzige Argument. Gibt es sie noch nicht, entsteht
// sie. Den Ordner darum legt sie allerdings nicht an, deshalb die Zeile
// darueber.
const db = new DatabaseSync("daten/bibliothek.db");
db.exec(`CREATE TABLE IF NOT EXISTS buecher (
id INTEGER PRIMARY KEY,
titel TEXT NOT NULL,
jahr INTEGER,
ausgeliehen INTEGER NOT NULL DEFAULT 0
)`);
db.exec("INSERT INTO buecher (titel, jahr) VALUES ('Node in der Praxis', 2020)");
// Das Lesen ist der Stoff von 12.4, hier steht es nur, um die Zeile
// zeigen zu koennen, die eben entstanden ist.
const buch = db.prepare("SELECT id, titel, jahr, ausgeliehen FROM buecher").get();
db.close();
console.log("Datei:", statSync("daten/bibliothek.db").size, "Bytes");
console.log("Zeile:", JSON.stringify(buch)); DatabaseSync nimmt einen Dateipfad. Gibt es die Datei noch nicht, legt SQLite sie an. Den Ordner
darum legt es nicht an. Fehlt daten/, kommt Error: unable to open database file, und bei dieser
Meldung sucht man leicht erst an der falschen Stelle. Deshalb steht das mkdirSync davor.
db.exec() schickt SQL zur Datenbank und gibt nichts zurück. Das passt für alles, was etwas tut
statt etwas zu liefern, etwa eine Tabelle anlegen oder eine Transaktion öffnen. Alles, wo Zeilen
zurückkommen sollen, läuft ab der nächsten Lektion über db.prepare().
Dass die Datenbank wirklich nur eine Datei ist, siehst du im Terminal. Nach dem Lauf steht bei
ls -l daten/ die Datei bibliothek.db mit ihrer Größe. head -c 15 daten/bibliothek.db gibt die
ersten fünfzehn Zeichen aus, SQLite format 3. So fängt jede SQLite-Datei an, und daran erkennt sie
auch ein Programm, dem niemand den Dateinamen verraten hat. Die ganze Datei mit cat auszugeben
lohnt dagegen nicht, denn dahinter kommen Bytes und keine Zeichen.
Was in einer Spalte stehen darf
SQLite kennt fünf Typen: INTEGER für ganze Zahlen, REAL für Kommazahlen, TEXT für Text, BLOB
für rohe Bytes und NULL für „hier steht nichts“.
Ein Datum gibt es nicht. Man speichert es als TEXT im Format 2026-08-09 oder als INTEGER mit
den Sekunden seit 1970. Beides ist üblich. Das erste kann man lesen, mit dem zweiten rechnet es sich
leichter.
SQLite nimmt diese Typen nicht ganz so ernst wie andere Datenbanken. Schreibst du
"zweitausend" in eine INTEGER-Spalte, bekommst du keinen Fehler. Der Text steht danach einfach
in der Spalte. Der Typ ist eher eine Absichtserklärung als eine Schranke. Ich gebe die Typen
trotzdem an, weil man daran sieht, was in die Spalte gehört. Den Unsinn hält ohnehin die Prüfung an
der Tür draußen, die die Bücher-API schon hat.
Die drei Zusätze, die man von Anfang an benutzt
PRIMARY KEYmacht eine Spalte zur Kennung der Zeile. Mitid INTEGER PRIMARY KEYsind die Werte eindeutig, und ohne Angabe beim Einfügen zählt SQLite selbst hoch. Den Zähler, den die Bücher-API von Hand geführt hat, gibt es hier also fertig, und er überlebt den Neustart.NOT NULLheißt, dass die Spalte nicht leer bleiben darf. Ein Buch ohne Titel ist kein Buch, also gehörtNOT NULLzum Titel. Ein Buch ohne Jahr ist dagegen denkbar, und deshalb steht beijahrnichts.DEFAULTliefert den Wert, wenn beim Einfügen keiner mitkommt.ausgeliehen INTEGER NOT NULL DEFAULT 0heißt, die Spalte ist Pflicht, muss aber nie mitgeschickt werden. Ohne die Vorgabe scheiterte jedes Einfügen ohneausgeliehenmitError: NOT NULL constraint failed: buecher.ausgeliehen.
Der zweite Start
import { DatabaseSync } from "node:sqlite";
import { mkdirSync } from "node:fs";
mkdirSync("daten", { recursive: true });
const db = new DatabaseSync("daten/bibliothek.db");
db.exec(`CREATE TABLE IF NOT EXISTS buecher (
id INTEGER PRIMARY KEY,
titel TEXT NOT NULL
)`);
db.exec("INSERT INTO buecher (titel) VALUES ('Ein Buch')");
const anzahl = db.prepare("SELECT count(*) AS n FROM buecher").get().n;
db.close();
console.log(`Zeilen in buecher: ${anzahl}`); import { execSync } from "node:child_process";
import { rmSync } from "node:fs";
// Das Beispiel selbst faengt jedes Mal mit einer frischen Datei an.
rmSync("daten/bibliothek.db", { force: true });
// Zweimal derselbe Prozess. Bei einem Array im Speicher waere der zweite
// Lauf wieder bei null.
for (const lauf of [1, 2]) {
console.log(`Lauf ${lauf}: ${execSync("node anlegen.js", { encoding: "utf8" }).trim()}`);
} Nach dem zweiten Lauf stehen zwei Zeilen in der Tabelle, denn er findet die Zeile des ersten noch vor.
Das Anlegen der Tabelle steht in jedem Lauf, und so gehört es sich. Eine Anwendung weiß beim Start nicht, ob sie zum ersten oder zum tausendsten Mal hochfährt, und sie soll in beiden Fällen laufen.
Ohne IF NOT EXISTS
import { DatabaseSync } from "node:sqlite";
import { mkdirSync } from "node:fs";
mkdirSync("daten", { recursive: true });
const db = new DatabaseSync("daten/ohne-schutz.db");
// Kein IF NOT EXISTS. Beim ersten Start geht das gut.
db.exec(`CREATE TABLE buecher (
id INTEGER PRIMARY KEY,
titel TEXT NOT NULL
)`);
db.close();
console.log("Tabelle angelegt"); import { execSync } from "node:child_process";
import { rmSync } from "node:fs";
// Das Beispiel selbst faengt jedes Mal mit einer frischen Datei an.
rmSync("daten/ohne-schutz.db", { force: true });
// stdio: der Fehlerkanal des Kindes wird abgefangen statt durchgereicht,
// sonst stuende hier gleich der ganze Stacktrace.
const starte = () =>
execSync("node ohne-schutz.js", { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
for (const lauf of [1, 2]) {
try {
console.log(`Lauf ${lauf}: ${starte().trim()}`);
} catch (fehler) {
const zeile = fehler.stderr.split("\n").find((z) => z.startsWith("Error:"));
console.log(`Lauf ${lauf}: gescheitert, ${zeile}`);
}
} CREATE TABLE ohne den Zusatz heißt „leg diese Tabelle an, und wenn es sie schon gibt, ist das ein
Fehler“. Beim ersten Start merkt man davon nichts. Ab dem zweiten kommt die Anwendung nicht mehr
hoch, mit Error: table buecher already exists.
Löschst du zwischendurch immer wieder die Datei, rutscht das leicht durch. Du siehst dann nur den ersten Start, und der geht gut.
Alles hier ist synchron
node:sqlite arbeitet synchron, und damit gilt alles über blockierenden Code aus Lektion 6.5. Es
gibt kein await. Jede Abfrage hält die Event Loop an, bis sie fertig ist.
Für kleine Abfragen ist das in Ordnung und sogar schnell, denn die Datei liegt direkt daneben, und
es fällt weder eine Netzwerkrunde an noch ein Wechsel in einen anderen Prozess. Eine Abfrage über
eine Million Zeilen ist etwas anderes. Solange sie läuft, nimmt der Server keine einzige andere
Anfrage an, so wie damals der Timer hinter den zwanzig readFileSync warten musste.
DatabaseSync heißt so, weil es auch ein asynchrones Gegenstück geben könnte. Diese Klasse
Database bringt erst Node 26 mit.
Die Funktion aufsetzen() im Reiter Praxis soll zwei Tabellen anlegen, und sie läuft beim Start
zweimal.
Zum Mitnehmen
Eine SQLite-Datenbank ist eine Datei, die new DatabaseSync anlegt, nur den Ordner darum nicht. Tabellen entstehen beim Start mit CREATE TABLE IF NOT EXISTS, damit auch der zweite Start durchläuft, und jede Abfrage läuft synchron.
Jetzt du
Basis Konto, kostenlosZu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.
Was in dieser Lektion steckt
-
Artikel mit 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.