Abschnitt 12 · Lektion 6
Ändern und löschen
Ohne WHERE ändert ein UPDATE jede Zeile der Tabelle, und es fragt vorher nicht. Mit WHERE
trifft es vielleicht gar keine, auch das ohne Meldung. Beim Ändern und Löschen willst du deshalb vor
allem eins wissen, nämlich wie viele Zeilen eine Anweisung wirklich getroffen hat.
Ändern und löschen
export const AUFBAU = `CREATE TABLE buecher (
id INTEGER PRIMARY KEY,
titel TEXT NOT NULL,
jahr INTEGER,
ausgeliehen INTEGER NOT NULL DEFAULT 0
);
INSERT INTO buecher (titel, jahr) VALUES
('Node in der Praxis', 2020),
('JavaScript von vorn', 2019),
('HTTP verstehen', 2017),
('Datenbanken im Alltag', 2014),
('Die lange Nacht des Debuggens', 2022);`; import { DatabaseSync } from "node:sqlite";
import { AUFBAU } from "./bestand.js";
const db = new DatabaseSync(":memory:");
db.exec(AUFBAU);
const aendern = db.prepare("UPDATE buecher SET jahr = ? WHERE id = ?");
const loeschen = db.prepare("DELETE FROM buecher WHERE id = ?");
console.log("Jahr von Buch 3 ändern:", aendern.run(2018, 3).changes, "Zeile(n)");
console.log("Jahr von Buch 99 ändern:", aendern.run(2018, 99).changes, "Zeile(n)");
console.log("Buch 5 löschen:", loeschen.run(5).changes, "Zeile(n)");
console.log("Buch 99 löschen:", loeschen.run(99).changes, "Zeile(n)");
console.log("Bestand:", db.prepare("SELECT count(*) AS n FROM buecher").get().n); UPDATE buecher SET jahr = ? WHERE id = ? und DELETE FROM buecher WHERE id = ? sind gleich
aufgebaut. Vorn steht, was passieren soll, hinten, für welche Zeilen.
Beide laufen über run(), denn beide liefern keine Zeilen zurück, nur eine Bilanz.
changes ist die Antwort auf eine andere Frage
Die beiden Anweisungen zu Buch 99 treffen nichts, und trotzdem ist nichts abgestürzt. Eine Änderung, die keine Zeile trifft, ist in SQL kein Fehler. Die Anweisung war korrekt, sie hat nur nichts gefunden, worauf sie zutreffen könnte.
Den Unterschied zwischen den beiden Fällen erfährst du nur über changes. changes: 1 heißt
„gefunden und geändert“, changes: 0 heißt „gab es nicht“.
Damit hast du auch die Antwort auf die Frage aus Lektion 11.4, wie man beim Ändern und Löschen zu
einem ehrlichen 404 kommt. In Abschnitt 11 kamen dafür find und findIndex zum Einsatz, und man
hat nachgesehen, ob undefined oder -1 herauskam. Hier reicht changes === 0, ganz ohne zweite
Abfrage.
Ein vergessenes WHERE
export const AUFBAU = `CREATE TABLE buecher (
id INTEGER PRIMARY KEY,
titel TEXT NOT NULL,
jahr INTEGER,
ausgeliehen INTEGER NOT NULL DEFAULT 0
);
INSERT INTO buecher (titel, jahr) VALUES
('Node in der Praxis', 2020),
('JavaScript von vorn', 2019),
('HTTP verstehen', 2017),
('Datenbanken im Alltag', 2014),
('Die lange Nacht des Debuggens', 2022);`; import { DatabaseSync } from "node:sqlite";
import { AUFBAU } from "./bestand.js";
const db = new DatabaseSync(":memory:");
db.exec(AUFBAU);
const zeige = (was) =>
console.log(
was,
db.prepare("SELECT id, ausgeliehen FROM buecher ORDER BY id").all().map((z) => `${z.id}:${z.ausgeliehen}`).join(" "),
);
zeige("vorher: ");
// Gemeint war: dieses eine Buch. Getroffen sind alle.
const vergessen = db.prepare("UPDATE buecher SET ausgeliehen = 1");
console.log("betroffene Zeilen:", vergessen.run().changes);
zeige("nachher:"); Die Ausgabe meldet fünf betroffene Zeilen, gemeint war eine.
Ein UPDATE ohne WHERE gilt für die ganze Tabelle, und ein DELETE ohne WHERE leert sie.
Gewollt ist das manchmal, nur eben selten.
Drei Gewohnheiten schützen davor, und ich halte mich an alle drei.
- Ich schreibe die Anweisung von hinten, erst
WHERE id = ?, dann davorUPDATE … SET …. So kann dasWHEREgar nicht erst fehlen. - Ich sehe mir
changesan. Eine Zahl, die viel größer ist als erwartet, ist die Meldung, die sonst niemand gibt. - Bei allem, was sich nicht rückgängig machen lässt, schreibe ich erst ein
SELECTmit demselbenWHERE, sehe mir an, was es trifft, und ersetze dann dasSELECTdurch dasDELETE.
Nur die Felder setzen, die geschickt wurden
PUT ersetzt den ganzen Eintrag, PATCH ändert nur, was mitkommt. Auf der SQL-Seite heißt das,
dass in SET nur die Spalten stehen dürfen, für die auch ein Wert geschickt wurde.
Der naheliegende Weg ist ein UPDATE, das alle Spalten setzt und für die fehlenden den alten Wert
einträgt. Das braucht ein vorheriges Lesen und hat eine hässliche Lücke. Zwischen dem Lesen und dem
Schreiben kann jemand anders die Zeile geändert haben, und dessen Stand wird mit alten Werten wieder
überschrieben. Das ist derselbe verlorene Schreibvorgang wie bei den zwei Schreibern am Anfang des
Abschnitts, nur eine Etage höher.
Sauberer ist es, die SET-Liste aus den vorhandenen Feldern zusammenzusetzen und die Werte als
Parameter zu übergeben. Die Spaltennamen kommen dabei aus einer eigenen festen Liste und nie aus den
Schlüsseln des empfangenen Objekts, und so gilt weiterhin die Regel aus Lektion 12.5. Für die
Bücher-API entsteht das in der Synthese dieses Abschnitts.
Anlegen oder ändern in einem
import { DatabaseSync } from "node:sqlite";
const db = new DatabaseSync(":memory:");
db.exec(`CREATE TABLE zaehler (
seite TEXT PRIMARY KEY,
aufrufe INTEGER NOT NULL DEFAULT 0
)`);
// Anlegen, und falls es die Zeile schon gibt, stattdessen hochzaehlen.
const zaehle = db.prepare(`INSERT INTO zaehler (seite, aufrufe) VALUES (?, 1)
ON CONFLICT(seite) DO UPDATE SET aufrufe = aufrufe + 1`);
for (const seite of ["/start", "/kurse", "/start", "/start"]) zaehle.run(seite);
for (const zeile of db.prepare("SELECT seite, aufrufe FROM zaehler ORDER BY seite").all()) {
console.log(`${zeile.seite}: ${zeile.aufrufe}`);
} Manchmal weißt du nicht, ob es die Zeile schon gibt, und es ist dir auch egal. Etwa bei einem Zähler
je Seite oder bei den Einstellungen eines Nutzers. Für diesen Fall gibt es
ON CONFLICT … DO UPDATE, genannt UPSERT.
Anlegen und Ändern sind damit ein einziger Vorgang. Ein SELECT und danach je nach Ergebnis ein
INSERT oder UPDATE hätte wieder die Lücke dazwischen. Der UPSERT hat sie nicht.
Beim Ändern und Löschen in der Aufgabe meldet jede Funktion, ob es die Zeile gab.
Zum Mitnehmen
UPDATE und DELETE laufen über run, und changes sagt, ob es die Zeile gab. Kaum ein Fehler ist so leicht gemacht wie ein vergessenes WHERE, und dann trifft die Anweisung jede Zeile der Tabelle.
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.