mitmario.dev

Ändern und löschen

Node.js Sandbox 3 Min Lesezeit 3 BeispieleLektion 6 von 9

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

Ändern, löschen, und was changes verrät
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

Ein vergessenes WHERE
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 davor UPDATE … SET …. So kann das WHERE gar nicht erst fehlen.
  • Ich sehe mir changes an. 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 SELECT mit demselben WHERE, sehe mir an, was es trifft, und ersetze dann das SELECT durch das DELETE.

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

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