Learn Rust Coding · Lezione

Operazioni CRUD

Interrogazione ed esecuzione

Operazioni CRUD è una lezione Learn Rust Coding gratuita su CoddyKit. Questa è la lezione 3 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.

CRUD con sqlx

CRUD significa Create, Read, Update, Delete, ovvero creazione, lettura, aggiornamento ed eliminazione. sqlx divide queste operazioni in due modalità di esecuzione:

fetch_* per le query che restituiscono righe
execute per le istruzioni che modificano i dati

Create (INSERT)

Inserisca una riga con parametri associati ed esegua l'operazione tramite execute. Usi RETURNING per ottenere nuovamente l'id generato.

use sqlx::{Pool, Postgres};

async fn create(pool: &Pool<Postgres>, name: &str) -> i32 {
    let rec = sqlx::query!(
        "INSERT INTO users (name) VALUES ($1) RETURNING id",
        name
    ).fetch_one(pool).await.unwrap();
    rec.id
}

Leggere una riga

fetch_one si aspetta esattamente una riga e restituisce un errore altrimenti. Usi fetch_optional quando la riga potrebbe non esistere.

use sqlx::{Pool, Postgres};

async fn find(pool: &Pool<Postgres>, id: i32) -> Option<String> {
    let rec = sqlx::query!("SELECT name FROM users WHERE id = $1", id)
        .fetch_optional(pool)
        .await
        .unwrap();
    rec.map(|r| r.name)
}

Leggere più righe

fetch_all restituisce un Vec contenente tutte le righe corrispondenti.

use sqlx::{Pool, Postgres};

async fn all_names(pool: &Pool<Postgres>) -> Vec<String> {
    let rows = sqlx::query!("SELECT name FROM users ORDER BY id")
        .fetch_all(pool)
        .await
        .unwrap();
    rows.into_iter().map(|r| r.name).collect()
}

Aggiornare

Le istruzioni UPDATE usano execute, che restituisce un risultato contenente il numero di righe interessate.

use sqlx::{Pool, Postgres};

async fn rename(pool: &Pool<Postgres>, id: i32, name: &str) -> u64 {
    let res = sqlx::query!("UPDATE users SET name = $1 WHERE id = $2", name, id)
        .execute(pool)
        .await
        .unwrap();
    res.rows_affected()
}

Eliminare

Anche DELETE usa execute. Controlli rows_affected() per sapere se è stato rimosso qualcosa.

use sqlx::{Pool, Postgres};

async fn delete(pool: &Pool<Postgres>, id: i32) -> bool {
    let res = sqlx::query!("DELETE FROM users WHERE id = $1", id)
        .execute(pool)
        .await
        .unwrap();
    res.rows_affected() > 0
}

Rappresentare il CRUD in Rust puro

Il CRUD su una mappa in memoria rispecchia le stesse operazioni che sqlx esegue su una tabella.

use std::collections::HashMap;

fn main() {
    let mut users: HashMap<i32, String> = HashMap::new();
    users.insert(1, "Alice".to_string());      // create
    println!("{:?}", users.get(&1));            // read
    users.insert(1, "Alicia".to_string());      // update
    println!("{:?}", users.get(&1));
    users.remove(&1);                            // delete
    println!("{:?}", users.get(&1));
}

Transazioni

Raggruppi più istruzioni in modo atomico usando una transazione. O tutte riescono con commit, oppure nessuna viene applicata.

use sqlx::{Pool, Postgres};

async fn transfer(pool: &Pool<Postgres>) {
    let mut tx = pool.begin().await.unwrap();
    sqlx::query!("UPDATE acct SET bal = bal - 10 WHERE id = 1")
        .execute(&mut *tx).await.unwrap();
    sqlx::query!("UPDATE acct SET bal = bal + 10 WHERE id = 2")
        .execute(&mut *tx).await.unwrap();
    tx.commit().await.unwrap();
}

Eseguire il rollback

Se una guardia di transazione viene eliminata senza commit, sqlx esegue automaticamente il rollback. Può anche chiamare esplicitamente rollback.

use sqlx::{Pool, Postgres};

async fn maybe(pool: &Pool<Postgres>, ok: bool) {
    let mut tx = pool.begin().await.unwrap();
    sqlx::query!("INSERT INTO log (msg) VALUES ('x')").execute(&mut *tx).await.unwrap();
    if ok { tx.commit().await.unwrap(); } else { tx.rollback().await.unwrap(); }
}

Leggere grandi quantità di dati in streaming

Per insiemi di risultati molto grandi, fetch restituisce uno stream, così può elaborare le righe senza caricarle tutte in memoria.

use sqlx::{Pool, Postgres};
use futures::TryStreamExt;

async fn stream(pool: &Pool<Postgres>) {
    let mut rows = sqlx::query!("SELECT id FROM big_table").fetch(pool);
    while let Some(row) = rows.try_next().await.unwrap() {
        println!("id {}", row.id);
    }
}

Gestire gli errori

Le chiamate al database restituiscono Result. Propaghi l'errore con ? nelle funzioni che restituiscono Result<_, sqlx::Error>, invece di usare unwrap.

use sqlx::{Pool, Postgres};

async fn count(pool: &Pool<Postgres>) -> Result<i64, sqlx::Error> {
    let rec = sqlx::query!("SELECT COUNT(*) as n FROM users")
        .fetch_one(pool)
        .await?;
    Ok(rec.n.unwrap_or(0))
}

Verifica rapida

Verifichi la sua comprensione delle operazioni CRUD.

Riepilogo

Ha imparato a usare il CRUD con sqlx:

fetch_one, fetch_optional e fetch_all leggono le righe
execute modifica i dati e restituisce rows_affected()
RETURNING recupera i valori generati
Le transazioni con begin/commit/rollback garantiscono l'atomicità

Prossimo argomento: le migrazioni per far evolvere lo schema.

Domande Frequenti

La lezione «Operazioni CRUD» è gratuita?

Sì — il testo completo di «Operazioni CRUD» è 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 «Operazioni CRUD»?

Interrogazione ed esecuzione 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 3 di 4.

Quanto tempo richiede la lezione «Operazioni CRUD»?

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.

Tutte le lezioni di questo corso

← Torna a Learn Rust Coding