Programmieren lernen mit Python – das Praxis-Tutorial

DELETE in Python: Datensätze aus MySQL-Datenbank löschen

Alle Videos des Tutorials Programmieren lernen mit Python – das Praxis-Tutorial
Jan Brinkmann
Von Jan Brinkmann Zuletzt aktualisiert am Gezeigt mit: Python 3.6

Stell dir vor, deine Bücherdatenbank ist auf mehrere hundert Einträge angewachsen, und ein Datensatz davon ist doppelt vorhanden oder schlicht veraltet. Genau dann brauchst du eine Möglichkeit, Einträge gezielt zu entfernen. In diesem Tutorial lernst du, wie du mit dem SQL-Befehl DELETE in Python einen Datensatz über seinen Primärschlüssel löschst, wie du das Ergebnis überprüfst und wie du die Änderung dauerhaft in der Datenbank speicherst.

Programmieren mit Python – 15.9 DELETE: Einträge entfernen

Das Video wird erst beim Abspielen von YouTube geladen – dabei werden Daten (u. a. deine IP-Adresse) an YouTube bzw. Google übertragen. Mehr dazu in der Datenschutzerklärung

Grundlage ist die Klasse aus den vorherigen Lektionen, die bereits eine Verbindung zur Datenbank besitzt und Methoden zum Einfügen von Büchern enthält. Ergänzt du diese Klasse um eine Methode namens deletebook, erhältst du eine saubere Schnittstelle für das Löschen.

Wichtigste Erkenntnisse

  • Ein Datensatz wird über seinen eindeutigen Primärschlüssel, in diesem Fall die ID, gelöscht.
  • Die SQL-Anweisung lautet DELETE FROM books WHERE id = %s.
  • Bei numerischen Werten wie der ID sind keine Anführungszeichen nötig.
  • Ohne commit() bleibt die Löschung nur temporär bestehen.
  • Der Rückgabewert rowcount zeigt dir, wie viele Zeilen tatsächlich betroffen waren.

Schritt-für-Schritt-Anleitung

Schritt 1: Methode deletebook anlegen

Lege in deiner Klasse eine neue Methode an und übergib ihr die ID des Buchs, das entfernt werden soll. Die ID eignet sich hervorragend, weil sie als Primärschlüssel jeden Datensatz eindeutig identifiziert. So stellst du sicher, dass genau ein Buch betroffen ist und nicht versehentlich mehrere Einträge verschwinden.

DELETE in Python: Datensätze aus MySQL-Datenbank löschen

Schritt 2: Das SQL-Statement vorbereiten

Der Befehl DELETE FROM books löscht Einträge aus der Tabelle books. Mit WHERE legst du fest, welche Zeilen gemeint sind. Als Bedingung verwendest du id = gefolgt von einem Platzhalter. Speichere die Abfrage am besten in einer Variablen, damit der Code übersichtlich bleibt:

def deletebook(self, id):
    sql = "DELETE FROM books WHERE id = %s"
DELETE in Python: Datensätze aus MySQL-Datenbank löschen

Schritt 3: Datentyp beachten

Bei numerischen Werten wie der ID brauchst du keine Anführungszeichen um den Platzhalter. Anführungszeichen sind nur bei Textwerten erforderlich, da SQL dort Zeichenketten erwartet. Der Platzhalter %s wird beim Ausführen durch den übergebenen Wert ersetzt. Dieses Vorgehen schützt dich außerdem vor SQL-Injection, weil die Werte getrennt von der Abfrage übergeben werden.

Schritt 4: Statement mit dem Cursor ausführen

Ohne einen Cursor kannst du keine Anweisung an die Datenbank senden. Hole dir ihn mit self.connection.cursor() und führe das Statement mit cursor.execute(sql, (id,)) aus. Achte auf das Komma hinter id: Python benötigt es, damit aus der Klammer ein Tupel mit einem Element entsteht, und genau dieses Tupel erwartet die Datenbankschnittstelle.

DELETE in Python: Datensätze aus MySQL-Datenbank löschen

Schritt 5: Änderung mit commit bestätigen

Ein DELETE wird erst dann dauerhaft wirksam, wenn du commit() aufrufst. Das gilt genauso wie beim Einfügen neuer Bücher. Ohne diesen Schritt sieht die Löschung nur in deiner aktuellen Verbindung aus, in der Datenbank selbst bleibt der Eintrag bestehen. Rufe deshalb self.connection.commit() direkt nach der Ausführung auf.

Schritt 6: Rückgabe mit rowcount prüfen

Damit du weißt, ob die Löschung überhaupt etwas bewirkt hat, gibst du cursor.rowcount zurück. Dieser Wert entspricht den sogenannten affected rows, die du aus phpMyAdmin kennst. Bei einer eindeutigen ID solltest du eine 1 erhalten. Steht dort eine 0, existierte der Datensatz nicht oder wurde bereits entfernt. Diesen Mechanismus kannst du später übrigens genauso bei UPDATE-Anweisungen einsetzen, um ein erfolgreiches Update von einem wirkungslosen zu unterscheiden.

        self.connection.commit()
        return cursor.rowcount
DELETE in Python: Datensätze aus MySQL-Datenbank löschen

Schritt 7: Löschen im Hauptprogramm testen

Rufe die Methode nun im Hauptprogramm auf. Lass dir zuvor die komplette Liste der Bücher ausgeben, damit du den Stand vor dem Löschen siehst. Übergib anschließend die ID des zuletzt eingefügten Buchs an deletebook. Für den Test eignet sich ein Datensatz, den du ohnehin nicht mehr benötigst, sodass deine übrigen Daten unberührt bleiben.

DELETE in Python: Datensätze aus MySQL-Datenbank löschen

Schritt 8: Betroffene Zeilen ausgeben

Speichere den Rückgabewert in einer Variablen, zum Beispiel affected, und gib ihn mit print aus. Starte das Programm und vergleiche die Ausgabe mit der Bücherliste. Wenn du das Skript mehrfach ausführst, wird bei jedem Durchlauf der zuletzt angelegte Eintrag entfernt, und du siehst die Änderung unmittelbar in der Ausgabe.

DELETE in Python: Datensätze aus MySQL-Datenbank löschen

Schritt 9: Ausblick auf das Auslesen einzelner Datensätze

Im nächsten Schritt kannst du gezielt einen einzelnen Datensatz auslesen, etwa das Buch mit der ID 3, um dessen Daten separat weiterzuverarbeiten. Die Vorgehensweise ähnelt dem bisherigen Auslesen aller Einträge, allerdings ergänzt du wieder eine WHERE-Bedingung. Dieses Thema behandeln wir im Anschluss an diese Lektion.

DELETE in Python: Datensätze aus MySQL-Datenbank löschen

Zusammenfassung – DELETE in Python: Einträge aus der Datenbank entfernen

Mit einer eigenen Methode deletebook entfernst du Datensätze zuverlässig über ihre ID. Entscheidend sind drei Bausteine: die präzise Bedingung im SQL-Statement, der commit()-Aufruf für die dauerhafte Speicherung und der Rückgabewert rowcount, mit dem du die Wirkung kontrollierst. Wenn du diese Muster verinnerlichst, lassen sich auch Änderungen per UPDATE sauber umsetzen.

FAQ

Was passiert, wenn ich eine ID übergebe, die es nicht gibt?Die Abfrage läuft ohne Fehler durch, aber rowcount liefert 0 zurück, da keine Zeile gelöscht wurde.

Warum brauche ich bei der ID keine Anführungszeichen?Die ID ist ein numerischer Datentyp, und Anführungszeichen würden sie als Text behandeln, was bei einem Vergleich mit einer Zahlenspalte zu Problemen führen kann.

Muss ich commit() immer aufrufen?Ja, bei Änderungen wie DELETE, INSERT oder UPDATE musst du commit() ausführen, damit die Änderung dauerhaft in der Datenbank gespeichert wird.

Kann ich mit DELETE auch mehrere Datensätze auf einmal löschen?Ja, du kannst eine andere Bedingung als die ID verwenden, etwa einen Titel oder einen Autor. Dann können jedoch auch mehrere Zeilen betroffen sein, weshalb der Rückgabewert rowcount besonders wichtig wird.

Was bedeutet affected rows?Affected rows gibt an, wie viele Zeilen durch die letzte Anweisung verändert oder gelöscht wurden.

Warum sollte ich Platzhalter wie %s verwenden, statt Werte direkt in den Text zu schreiben?Platzhalter trennen die Daten von der SQL-Abfrage und schützen so vor SQL-Injection, einem häufigen Sicherheitsproblem.

Jan Brinkmann
Trainer Über Jan Brinkmann Webentwicklung mit Leidenschaft! Jan ist seit über 15 Jahren Entwickler. Alle Kurse von Jan Brinkmann