Projekt PyMySQL obsahuje uživatelskou příručku . Najít tuto příručku není tak snadné (neexistují žádné zřejmé odkazy) a ke zmatku je třeba dodat, že název modulu neodpovídá názvu balíčku. Chcete-li jej použít, potřebujete:
import MySQLdb
MySQLdb
modul implementuje PEP 249 – specifikace API databáze Python
pro přístup k databázím. Při použití tohoto API by měl být kód Pythonu lépe přenosný napříč různými systémy správy relačních databází.
Nedoporučuje se používat _mysql
modul (který je také součástí tohoto balíčku). Není přenosný a funguje na nižší úrovni abstrakce (implementuje MySQL C API).
Zde jsou dva návody, které by se vám mohly hodit. Použil jsem je s původním balíčkem MySQLdb v Pythonu 2, ale API je stejné (jak je definováno v PEP-249). Oba obsahují praktické příklady přístupu k databázi (čtení a zápis dat) a zjistil jsem, že jsou pro začátek s API lepší než oficiální dokumentace.