Eén enkele tabel uit een MySQL-dump halen

Niet elke klus heeft de hele database nodig. Als je lokaal een feature bouwt, wil je zelden een volledige productiedump die je schijf volzet en een uur nodig heeft om te importeren. Je wilt de handvol tabellen die de feature daadwerkelijk raakt.

Hetzelfde geldt wanneer je één enkele tabel debugt — een dataprobleem in orders reproduceren vereist niet de andere 126 tabellen — of een gedeeltelijke migratie doet, waarbij slechts een paar tabellen naar een nieuwe service verhuizen. In al deze gevallen is de vraag dezelfde: hoe krijg ik alleen deze tabellen uit een gigantische dump, schoon en snel?

De sed/grep-aanpak en waarom die breekt

Het klassieke antwoord is om het bestand met sed te knippen tussen de sectiekoppen die mysqldump voor elke tabel schrijft:

# haal de users-tabel uit een mysqldump-bestand
sed -n '/-- Table structure for table `users`/,/-- Table structure for table/p' dump.sql > users.sql

Het ziet er slim uit, en op een kleine, nette dump werkt het misschien zelfs één keer. Op een echt bestand van 7 GB valt het op talloze subtiele manieren uit elkaar:

• Meerregelige INSERTs. Eén enkele INSERT INTO ... VALUES kan duizenden regels beslaan. Regelgeoriënteerde tools als sed en grep snijden die rijen doormidden en produceren een bestand dat niet parseert.
• Backticks en speciale tekens. Kolomwaarden bevatten --, puntkomma's, backticks, aanhalingstekens en newlines binnen strings. Je patroon matcht tekst binnen de data die nooit als scheidingsteken bedoeld was.
• Tabelnamen als deelstrings. user extraheren pakt ook user_roles, user_sessions en password_user mee, omdat de naam als deelstring van andere voorkomt.
• Commentaar en koppen verschuiven. De exacte commentaartekst verschilt tussen MySQL-, MariaDB- en PostgreSQL-versies, en pg_dump gebruikt helemaal niet dezelfde koppen — zo geeft hetzelfde commando stilzwijgend niets terug.
• Geen besef van foreign keys. Zelfs als je orders perfect knipt, verwijzen de rijen naar users. sed heeft geen idee, dus de extractie faalt bij het importeren met een foreign key-fout.

Je eindigt met awk op grep op sed gestapeld, test op deelverzamelingen, en vertrouwt het resultaat nog steeds niet. Er is een betere manier.

Tabellen extraheren met DumpCleaner

DumpCleaner parseert de dump netjes — het begrijpt statementgrenzen, meerregelige INSERTs, backticks en commentaar — dus het knipt altijd op de juiste regels. De tabellen die je nodig hebt extraheren gaat in vier stappen:

1. Sleep je .sql-dump erin. DumpCleaner streamt het bestand, dus een dump van 7 GB opent met constant geheugengebruik in plaats van het geheel te laden.
2. Lees de automatisch gedetecteerde tabellenlijst. Elke tabel wordt uitgeparseerd en getoond met zijn rij-aantal en grootte — geen gescroll door miljoenen regels om te vinden wat erin zit.
3. Kies de tabellen die je wilt. Vink users, orders en products aan, of typ een regex- / uitsluitpatroon zoals *_logs om hele groepen in één keer te laten vallen.
4. Neem foreign key-parents mee en exporteer. Haal desgewenst de tabellen waarnaar wordt verwezen automatisch erbij, en exporteer dan een schoon, importeerbaar bestand.

Een paar dingen maken dit een stuk minder gepriegel dan shell-tools:

• Uitsluitpatronen zoals *_logs of *_sessions filteren audit- en sessie-ruis eruit zonder tientallen tabellen met de hand uit te vinken.
• Regex-filters laten je matchen op prefix, suffix of elk patroon — behoud bijvoorbeeld alles wat matcht met shop_*.
• Een live voorbeeld toont precies welke tabellen in de uitvoer belanden terwijl je de selectie aanpast.
• Een geschatte uitvoergrootte vertelt je hoe groot de extractie wordt vóór je exporteert, zodat je weet dat die lokaal past.
• Foreign key-afhankelijkheden kunnen automatisch worden meegenomen, zodat het kiezen van orders stilletjes users meebrengt en de extractie zonder constraint-fouten importeert.

Veelgestelde vragen