Estrarre una singola tabella da un dump MySQL

Non ogni lavoro richiede l'intero database. Quando sviluppi una funzionalità in locale, raramente vuoi un dump di produzione completo che riempie il disco e impiega un'ora a importarsi. Vuoi la manciata di tabelle che la funzionalità tocca davvero.

Lo stesso vale quando stai facendo il debug di una singola tabella — riprodurre un problema sui dati in orders non richiede le altre 126 tabelle — o durante una migrazione parziale, in cui solo poche tabelle passano a un nuovo servizio. In tutti questi casi la domanda è la stessa: come estraggo solo queste tabelle da un dump gigantesco, in modo pulito e veloce?

L'approccio con sed/grep e perché si rompe

La risposta classica è affettare il file con sed tra le intestazioni di sezione che mysqldump scrive per ogni tabella:

# estrai la tabella users da un file mysqldump
sed -n '/-- Table structure for table `users`/,/-- Table structure for table/p' dump.sql > users.sql

Sembra ingegnoso, e su un dump piccolo e ordinato potrebbe persino funzionare una volta. Su un vero file da 7 GB va in pezzi in tanti modi sottili:

• INSERT multiriga. Una singola INSERT INTO ... VALUES può estendersi su migliaia di righe. Gli strumenti orientati alle righe come sed e grep tagliano quelle righe a metà e producono un file che non viene analizzato.
• Backtick e caratteri speciali. I valori delle colonne contengono --, punti e virgola, backtick, virgolette e a capo dentro le stringhe. Il tuo pattern corrisponde a testo dentro i dati che non doveva mai fare da delimitatore.
• Nomi di tabella come sottostringhe. Estrarre user prende anche user_roles, user_sessions e password_user, perché il nome compare come sottostringa di altri.
• Commenti e intestazioni che cambiano. Il testo esatto dei commenti varia tra le versioni di MySQL, MariaDB e PostgreSQL, e pg_dump non usa affatto le stesse intestazioni — così lo stesso comando restituisce silenziosamente niente.
• Nessuna consapevolezza delle chiavi esterne. Anche se affetti orders alla perfezione, le sue righe fanno riferimento a users. sed non ne ha idea, quindi l'estratto non si importa a causa di un errore di chiave esterna.

Finisci per accatastare awk su grep su sed, testando su sottoinsiemi, senza comunque fidarti del risultato. C'è un modo migliore.

Estrarre le tabelle con DumpCleaner

DumpCleaner analizza il dump come si deve — comprende i confini delle istruzioni, le INSERT multiriga, i backtick e i commenti — quindi taglia sempre sulle righe giuste. Estrarre le tabelle che ti servono richiede quattro passaggi:

1. Trascina dentro il tuo dump .sql. DumpCleaner scorre il file in streaming, quindi un dump da 7 GB si apre con memoria costante invece di caricare tutto.
2. Leggi l'elenco delle tabelle rilevato automaticamente. Ogni tabella viene analizzata ed elencata con il suo numero di righe e la sua dimensione — niente scorrere milioni di righe per trovare cosa c'è.
3. Scegli le tabelle che vuoi. Spunta users, orders e products, oppure digita una regex / un pattern di esclusione come *_logs per eliminare interi gruppi in un colpo solo.
4. Includi le tabelle padre delle chiavi esterne ed esporta. Facoltativamente includi automaticamente le tabelle padre referenziate, poi esporta un file pulito e importabile.

Alcune cose rendono tutto molto meno macchinoso rispetto agli strumenti da shell:

• I pattern di esclusione come *_logs o *_sessions eliminano il rumore di audit e sessione senza togliere la spunta a decine di tabelle a mano.
• I filtri regex ti permettono di abbinare per prefisso, suffisso o qualsiasi pattern — tieni tutto ciò che corrisponde a shop_*, per esempio.
• Un'anteprima in tempo reale mostra esattamente quali tabelle finiranno nell'output mentre modifichi la selezione.
• Una dimensione di output stimata ti dice quanto sarà grande l'estratto prima di esportare, così sai che entrerà in locale.
• Le dipendenze di chiave esterna possono essere incluse automaticamente, così scegliere orders porta con sé silenziosamente users e l'estratto si importa senza errori di vincolo.

Domande frequenti