Migrazioni
Evoluzione dello schema
Migrazioni è una lezione Learn Rust Coding gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Learn Rust Coding, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Learn Rust Coding include 4 lezioni in totale.
Perché usare le migrazioni?
Una migrazione è una modifica versionata allo schema del database, come l'aggiunta di una tabella o di una colonna. Le migrazioni consentono di far evolvere lo schema in modo sicuro e riproducibile.
- Vengono tracciate nel controllo versione
- Vengono applicate in ordine, esattamente una volta
Lo strumento sqlx-cli
sqlx include una CLI per gestire le migrazioni. La installi una sola volta con cargo.
cargo install sqlx-cli --no-default-features --features postgresCreare una migrazione
sqlx migrate add crea un file SQL con marca temporale nella cartella migrations/. La marca temporale definisce l'ordine.
sqlx migrate add create_usersScrivere l'SQL della migrazione
Ogni file di migrazione contiene l'SQL necessario per far avanzare lo schema. Mantenga una sola modifica logica per file.
CREATE TABLE users (
id SERIAL PRIMARY KEY,
name TEXT NOT NULL,
email TEXT
);Eseguire le migrazioni
sqlx migrate run applica tutte le migrazioni in sospeso usando DATABASE_URL e registra ciascuna in una tabella di tracciamento.
sqlx migrate runLa tabella di tracciamento
sqlx registra le migrazioni applicate in _sqlx_migrations, memorizzando la versione e un checksum, così non le applica nuovamente né le modifica silenziosamente.
Migrazioni reversibili
Aggiunga il flag -r per creare file up e down separati, così da poter eseguire il rollback. sqlx migrate revert esegue il file down più recente.
sqlx migrate add -r create_postsRappresentare il tracciamento delle migrazioni
Un esecutore di migrazioni applica solo le versioni più recenti dell'ultima versione applicata. Questo esempio eseguibile rappresenta tale decisione.
fn pending(all: &[u32], applied: u32) -> Vec<u32> {
all.iter().cloned().filter(|v| *v > applied).collect()
}
fn main() {
let migrations = [1, 2, 3, 4];
let last_applied = 2;
println!("{:?}", pending(&migrations, last_applied));
}Incorporare le migrazioni nel binario
La macro migrate! incorpora la cartella delle migrazioni nel binario, così l'app può applicarle all'avvio senza bisogno della CLI in produzione.
use sqlx::{Pool, Postgres};
async fn migrate(pool: &Pool<Postgres>) {
sqlx::migrate!("./migrations")
.run(pool)
.await
.unwrap();
}Checksum e immutabilità
Non modifichi mai una migrazione già eseguita. sqlx memorizza un checksum e si rifiuta di procedere se il contenuto di una migrazione precedente è cambiato. Aggiunga invece una nuova migrazione.
SQL idempotente
Protegga le istruzioni con IF NOT EXISTS, così rieseguirle in un ambiente vuoto sarà sicuro e prevedibile.
CREATE TABLE IF NOT EXISTS tags (
id SERIAL PRIMARY KEY,
name TEXT NOT NULL UNIQUE
);Verifica rapida
Verifichi la sua comprensione delle migrazioni.
Riepilogo
Ha imparato a gestire le migrazioni dello schema:
- Le migrazioni sono modifiche dello schema ordinate e versionate
sqlx migrate add/run/revertpermette di gestirle- Le versioni applicate e i checksum si trovano in
_sqlx_migrations migrate!le incorpora per applicarle all'avvio- Non modifichi mai una migrazione applicata; ne aggiunga una nuova
Ha completato il corso su sqlx.
Domande Frequenti
La lezione «Migrazioni» è gratuita?
Sì — il testo completo di «Migrazioni» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Learn Rust Coding, passa a CoddyKit PRO. Il corso Learn Rust Coding include 4 lezioni in totale.
Cosa imparerò in «Migrazioni»?
Evoluzione dello schema Eserciti Learn Rust Coding con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Learn Rust Coding?
Non è richiesta alcuna esperienza precedente. Learn Rust Coding su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.
Quanto tempo richiede la lezione «Migrazioni»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Learn Rust Coding?
Sì. Ogni lezione Learn Rust Coding include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.