Learn Rust Coding · Lezione

Connessione a un database

Pool di sqlx

Connessione a un database è una lezione Learn Rust Coding gratuita su CoddyKit. Questa è la lezione 1 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.

Che cos'è sqlx?

sqlx è un toolkit SQL asincrono scritto interamente in Rust. Non è un ORM: si scrive SQL reale, ottenendo però controlli al momento della compilazione e risultati type-safe.

Supporta Postgres, MySQL e SQLite
Si basa su runtime asincroni come Tokio

Aggiungere sqlx

Dichiari sqlx con le funzionalità del runtime e del database necessarie. Questa operazione modifica Cargo.toml e viene eseguita nel terminale.

[dependencies]
sqlx = { version = "0.7", features = ["runtime-tokio", "postgres"] }
tokio = { version = "1", features = ["full"] }

Stringhe di connessione

Una stringa di connessione (DSN) indica a sqlx come raggiungere il database.

Postgres: postgres://user:pass@host:5432/dbname
SQLite: sqlite://app.db

Perché usare un pool di connessioni?

Aprire una connessione per ogni query è lento. Un pool mantiene un insieme di connessioni riutilizzabili, le assegna quando servono e poi le restituisce.

Limita la concorrenza
Ammortizza il costo delle connessioni

Creare un pool

Usi PgPoolOptions per configurare e connettere un pool. In genere questa operazione viene eseguita una sola volta all'avvio.

use sqlx::postgres::PgPoolOptions;

async fn connect() -> sqlx::Pool<sqlx::Postgres> {
    PgPoolOptions::new()
        .max_connections(5)
        .connect("postgres://user:pass@localhost/app")
        .await
        .unwrap()
}

Configurare il pool

Regoli il pool con opzioni come il numero massimo di connessioni e il timeout di acquisizione, in base al carico di lavoro.

use sqlx::postgres::PgPoolOptions;
use std::time::Duration;

fn options() -> PgPoolOptions {
    PgPoolOptions::new()
        .max_connections(10)
        .acquire_timeout(Duration::from_secs(3))
}

Una query semplice attraverso il pool

Passi il pool, o un riferimento a esso, come executor per eseguire una query. Il pool acquisisce automaticamente una connessione.

use sqlx::Pool;
use sqlx::Postgres;

async fn ping(pool: &Pool<Postgres>) -> i32 {
    let row: (i32,) = sqlx::query_as("SELECT 1")
        .fetch_one(pool)
        .await
        .unwrap();
    row.0
}

Rappresentare un pool in Rust puro

Concettualmente, un pool è una raccolta limitata di risorse riutilizzabili. Questo esempio eseguibile illustra l'acquisizione e la restituzione.

struct Pool { available: u32, max: u32 }

impl Pool {
    fn acquire(&mut self) -> bool {
        if self.available > 0 { self.available -= 1; true } else { false }
    }
    fn release(&mut self) { self.available += 1; }
}

fn main() {
    let mut p = Pool { available: 2, max: 2 };
    println!("{}", p.acquire());
    println!("{}", p.acquire());
    println!("{}", p.acquire());
    p.release();
    println!("{}", p.acquire());
}

Leggere il DSN dalle variabili d'ambiente

Tenga i segreti fuori dal codice sorgente. Legga DATABASE_URL dall'ambiente all'avvio.

use sqlx::postgres::PgPoolOptions;

async fn connect() -> sqlx::Pool<sqlx::Postgres> {
    let url = std::env::var("DATABASE_URL").unwrap();
    PgPoolOptions::new().connect(&url).await.unwrap()
}

Clonare è poco costoso

Pool usa internamente il conteggio dei riferimenti. Clonarlo condivide le stesse connessioni sottostanti, quindi può passare liberamente i cloni ai task.

use sqlx::{Pool, Postgres};

async fn spawn_work(pool: Pool<Postgres>) {
    let p2 = pool.clone();
    tokio::spawn(async move {
        let _ = sqlx::query("SELECT 1").execute(&p2).await;
    });
}

Chiudere il pool

Durante l'arresto, chiami close().await per esaurire gradualmente e chiudere tutte le connessioni.

use sqlx::{Pool, Postgres};

async fn shutdown(pool: Pool<Postgres>) {
    pool.close().await;
}

Verifica rapida

Verifichi la sua comprensione della connessione con sqlx.

Riepilogo

Ha imparato a connettersi con sqlx:

sqlx è un toolkit SQL asincrono e type-safe, non un ORM
Un DSN descrive la posizione del database
Usi PgPoolOptions per creare un pool con limiti e timeout
I pool sono economici da clonare e devono essere chiusi durante l'arresto

Prossimo argomento: query verificate al momento della compilazione.

Domande Frequenti

La lezione «Connessione a un database» è gratuita?

Sì — il testo completo di «Connessione a un database» è 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 «Connessione a un database»?

Pool di sqlx 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 1 di 4.

Quanto tempo richiede la lezione «Connessione a un database»?

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