MariaDB-Kurs / Python mit MariaDB verbinden und parametrisierte Abfragen verwenden
Übergeben Sie beim Python-Zugriff auf MariaDB den SQL-Text und Benutzereingaben getrennt an die Treiberschnittstelle. Parametrisierte Abfragen halten Werte aus dem selbst zusammengesetzten SQL heraus. Ein begrenztes Konto und ausdrücklich gewählte COMMIT- oder ROLLBACK-Grenzen kontrollieren die Datenänderungen.
Umgebung und Anwendungskonto vorbereiten
Dieses Beispiel verwendet Python 3, PyMySQL 1.1.2 und eine lokale TCP-Verbindung zu MariaDB. Das Kernverhalten wurde mit Python 3.12 und MariaDB 12.3.3 geprüft. PyMySQL ist der Datenbanktreiber für die Kommunikation aus Python. Seine Wertplatzhalter sind hier %s; ersetzen Sie diese nicht durch die Fragezeichensyntax eines anderen Treibers.
Führen Sie den Aufbau über eine Verwaltungsverbindung aus. Ersetzen Sie den öffentlichen Platzhalter Replace_With_Your_Own_Lab_Password durch Ihr Übungspasswort. CREATE USER dient der ersten Einrichtung. Prüfen Sie vorhandene Konten und Tabellen, bevor Sie den Block wiederholen. Stellen Sie bei bestehendem appops_lab sicher, dass es zu diesen Übungen gehört. Die Anleitung zu MariaDB-Konten und Rechten unterscheidet die Verantwortlichkeiten.
CREATE DATABASE IF NOT EXISTS appops_lab
CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE appops_lab;
CREATE TABLE app_notes (
note_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
note_name VARCHAR(80) NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE USER 'appops_app'@'127.0.0.1'
IDENTIFIED BY 'Replace_With_Your_Own_Lab_Password';
GRANT SELECT, INSERT ON appops_lab.app_notes TO 'appops_app'@'127.0.0.1';
Der Kontenhost 127.0.0.1 setzt TCP-Zugriff auf einen direkt lokal laufenden Server voraus. Ein Container oder entfernter Server kann eine andere Clientherkunft sehen. Prüfen Sie Kontenzuordnung und Verbindungswege, statt zur Fehlerbehebung Verwaltungszugriff von beliebigen Hosts zu erlauben.
Ein getrenntes Projekt und das vollständige Programm erstellen
Erstellen Sie einen neuen Projektordner und öffnen Sie PowerShell darin. Python muss installiert und als python verfügbar sein. Legen Sie die virtuelle Umgebung an und installieren Sie die im Beispiel verwendete Treiberversion:
python -m venv .venv
.venv\Scripts\python.exe -m pip install PyMySQL==1.1.2
Der direkte Aufruf des Umgebungspythons benötigt keine Änderung der PowerShell-Ausführungsrichtlinie für Aktivierungsskripte. Verwenden Sie unter Linux oder macOS python3 -m venv .venv und anschließend .venv/bin/python -m pip install PyMySQL==1.1.2. Speichern Sie das folgende vollständige Programm als UTF-8-Datei notes_app.py im Projektordner:
import argparse
import getpass
import os
import pymysql
def save_and_find(conn, name, sort_key="id"):
if not name or len(name) > 80:
raise ValueError("Name must contain 1 to 80 characters")
columns = {"id": "note_id", "name": "note_name, note_id"}
if sort_key not in columns:
raise ValueError("Unknown sort key")
with conn.cursor() as cur:
cur.execute("INSERT INTO app_notes (note_name) VALUES (%s)", (name,))
cur.execute(
"SELECT note_id, note_name FROM app_notes "
"WHERE note_name = %s ORDER BY " + columns[sort_key],
(name,),
)
return cur.fetchall()
def main():
parser = argparse.ArgumentParser()
parser.add_argument("--name", default="O'Reilly")
parser.add_argument("--sort", choices=("id", "name"), default="id")
args = parser.parse_args()
password = getpass.getpass("Database password: ")
conn = pymysql.connect(
host=os.getenv("DB_HOST", "127.0.0.1"),
port=int(os.getenv("DB_PORT", "3306")),
user=os.getenv("DB_USER", "appops_app"),
password=password,
database="appops_lab",
charset="utf8mb4", autocommit=False,
connect_timeout=5, read_timeout=10, write_timeout=10,
)
try:
rows = save_and_find(conn, args.name, args.sort)
conn.commit()
for note_id, note_name in rows:
print(note_id, note_name)
except Exception:
conn.rollback()
raise
finally:
conn.close()
if __name__ == "__main__":
main()
Das Programm fragt das Passwort beim Start über getpass ab, statt es im Quelltext oder SQL zu speichern. Es legt Zeitlimits für Verbindung, Lesen und Schreiben fest und verwendet utf8mb4 für Unicode. Database password: ist die Aufforderung zur Eingabe des Datenbankpassworts.
Der Aufbau ist für die lokale Übung vorgesehen. Über andere Netzwerke benötigen Sie zusätzlich Transport Layer Security (TLS), die Verschlüsselung der Verbindung, mit Prüfung des Serverzertifikats. Ein Passwort allein schützt die Übertragung nicht.
Gewöhnliche Namen und Apostrophe ausprobieren
Führen Sie im Ordner von notes_app.py beide Befehle als getrennte Programmstarts aus:
.venv\Scripts\python.exe notes_app.py --name "Notebook"
.venv\Scripts\python.exe notes_app.py --name "O'Reilly" --sort name
Geben Sie bei jedem Start das Passwort ein. Der erste Aufruf speichert Notebook, der zweite O'Reilly einschließlich Apostroph. Danach suchen beide nach Zeilen mit demselben Namen. In einer neuen Tabelle liefert jeder einmal ausgeführte Aufruf seine passende Zeile. Erwarten Sie keine feste AUTO_INCREMENT-Kennung: Frühere Daten und zurückgenommene Einfügungen können die Nummerierung beeinflussen.
Ein erneuter Aufruf mit demselben Namen fügt eine weitere Zeile ein und liefert alle passenden Zeilen. Namen sind in diesem Beispiel nicht eindeutig. Benötigt der fachliche Ablauf eine Dublettenvermeidung, definieren Sie die Identität einer Notiz und die zugehörige Datenbankbedingung ausdrücklich.
Werte und SQL-Syntax getrennt behandeln
Der entscheidende Aufruf ist cur.execute(sql, (name,)). SQL und Wertetupel sind getrennte Argumente; das Komma erzeugt ein Tupel mit einem Element. Setzen Sie keine eigenen SQL-Anführungszeichen um %s. Interpolieren Sie Benutzereingaben weder mit dem Python-%-Operator noch durch f-Strings oder Verkettung. Die offiziellen PyMySQL-Beispiele zeigen die getrennte Übergabe.
Ein Name wie x' OR 1=1 -- muss ein einzelner gespeicherter und wörtlich gesuchter Wert bleiben. Er darf keine Bedingung werden, die sämtliche Zeilen auswählt. „Parametrisierte Abfrage“ bezeichnet hier die Treiberschnittstelle. Daraus folgt keine allgemeine Aussage über die Verwendung des serverseitigen Prepared-Statement-Protokolls.
Bezeichner und SQL-Schlüsselwörter, etwa Spaltennamen sowie ASC und DESC, lassen sich nicht durch gewöhnliche Wertparameter ersetzen. Der ORDER-BY-Abschnitt stammt ausschließlich aus dem entwicklerseitig festgelegten Wörterbuch columns. Sowohl argparse als auch die Funktion prüfen die Auswahl. Dadurch muss sich auch ein anderer Funktionsaufrufer an die erlaubten Sortierschlüssel halten. Die Cursor.execute-Referenz beschreibt die Argumente.
Transaktionen und Rechte gemeinsam überprüfen
Bei autocommit=False speichert ein erfolgreich beendetes save_and_find die Einfügung noch nicht dauerhaft. main bestätigt erst nach erfolgreichem INSERT und SELECT, nimmt bei einer Ausnahme zurück und schließt die Verbindung in finally. Unterscheiden Sie die Bestätigung von der Sichtbarkeit in einer anderen Verbindung. Die Anleitung zu InnoDB, COMMIT und ROLLBACK erklärt die Grenzen.
Die Funktion lehnt einen leeren Namen, mehr als 80 Zeichen und unbekannte Sortierschlüssel vor der Einfügung ab. Name must contain 1 to 80 characters und Unknown sort key melden diese Prüfungsfehler. Tritt nach INSERT und vor COMMIT eine Ausnahme auf, muss ROLLBACK verhindern, dass die eingefügte Zeile erhalten bleibt.
Das Anwendungskonto hat ausschließlich SELECT und INSERT für app_notes. Das Programm erstellt oder entfernt keine Tabellen und benötigt daher weder CREATE noch DROP. Begrenzte Rechte ergänzen die korrekte Parameterbehandlung und reduzieren mögliche Operationen bei anderen Programmfehlern. Die PyMySQL-Verbindungsreferenz erläutert autocommit und Zeitlimits.
Fehler diagnostizieren und die Übung bereinigen
| Symptom | Prüfung |
|---|---|
| ModuleNotFoundError | Mit demselben .venv-Python ausführen, mit dem PyMySQL installiert wurde |
| Access denied | Benutzer, Passwort, Kontenhost und vom Server gesehene Clientadresse |
| Verbindung abgelehnt oder Zeitüberschreitung | Serverzustand, DB_HOST, DB_PORT, Firewall und tatsächlicher Netzwerkweg |
| Nach Verarbeitung fehlt die Zeile | Ausnahme mit ROLLBACK sowie richtige Datenbank und bestätigten Zustand prüfen |
| Fehler nur bei Apostrophen | Manuelle Interpolation anstelle getrennter Wertübergabe an execute suchen |
Nicht geheime Verbindungseinstellungen können in PowerShell beispielsweise mit $env:DB_PORT = "3307" überschrieben werden. Behalten Sie die Passwortabfrage bei. Entfernen Sie einen nicht mehr benötigten Portwert mit Remove-Item Env:DB_PORT oder stellen Sie einen zuvor vorhandenen Wert wieder her.
Beenden Sie am Schluss das Programm. Lassen Sie die Administration bestätigen, dass die folgenden Konten- und Tabellennamen ausschließlich die zu entfernenden Übungsobjekte bezeichnen:
DROP USER 'appops_app'@'127.0.0.1';
DROP TABLE appops_lab.app_notes;
Verwenden Sie keine Geschäftskonten oder Geschäftstabellen in dieser Bereinigung. Sie ist nicht mit einem gewöhnlichen ROLLBACK rückgängig zu machen. Sichern Sie benötigte Inhalte vorher.




