mitmario.dev

Die erste Tabelle

Node.js Sandbox 4 Min Lesezeit 3 BeispieleLektion 2 von 9

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

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 KEY macht eine Spalte zur Kennung der Zeile. Mit id INTEGER PRIMARY KEY sind 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 NULL heißt, dass die Spalte nicht leer bleiben darf. Ein Buch ohne Titel ist kein Buch, also gehört NOT NULL zum Titel. Ein Buch ohne Jahr ist dagegen denkbar, und deshalb steht bei jahr nichts.
  • DEFAULT liefert den Wert, wenn beim Einfügen keiner mitkommt. ausgeliehen INTEGER NOT NULL DEFAULT 0 heißt, die Spalte ist Pflicht, muss aber nie mitgeschickt werden. Ohne die Vorgabe scheiterte jedes Einfügen ohne ausgeliehen mit Error: NOT NULL constraint failed: buecher.ausgeliehen.

Der zweite Start

Zweimal gestartet
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

Dasselbe ohne IF NOT EXISTS
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, kostenlos

Zu 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.