Go Academy · Lezione

Aprire una connessione

Connettersi a un database

Aprire una connessione è una lezione Go Academy 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 Go Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Go Academy include 4 lezioni in totale.

Il pacchetto database/sql

Il pacchetto standard di Go database/sql fornisce un'API generica e indipendente dal database. Lo si abbina a un driver per il database specifico, come PostgreSQL o MySQL.

Un'API per molti database
Pool di connessioni integrato
Query parametrizzate sicure

Importare un driver

Il driver si registra tramite un'importazione vuota. Il carattere di sottolineatura indica che lo si importa solo per il suo effetto collaterale, cioè la registrazione, e non per chiamarlo direttamente.

import (
    "database/sql"
    _ "github.com/lib/pq"
)

sql.Open

sql.Open accetta il nome di un driver e un data source name (DSN). Non stabilisce ancora una connessione: prepara semplicemente il pool.

db, err := sql.Open("postgres", "postgres://user:pass@localhost/mydb?sslmode=disable")
if err != nil {
    log.Fatal(err)
}

db è un pool

Il valore *sql.DB restituito non è una singola connessione, ma un pool di connessioni, sicuro da usare simultaneamente con molte goroutine. Lo apra una sola volta e lo condivida in tutta l'applicazione.

Verificare con Ping

Poiché Open è lazy, utilizzi Ping per stabilire effettivamente una connessione e verificare che il database sia raggiungibile e che le credenziali siano valide.

if err := db.Ping(); err != nil {
    log.Fatal("cannot reach db:", err)
}

Chiudere il pool

Inserisca db.Close() in un defer nella funzione main o di configurazione. Raramente si chiude il pool dopo ogni query: lo si fa solo quando l'intera applicazione viene arrestata.

defer db.Close()

Regolare il pool

Controlli il pool con SetMaxOpenConns, SetMaxIdleConns e SetConnMaxLifetime. Questi metodi impediscono di esaurire le risorse del database e ricreano periodicamente le connessioni obsolete.

db.SetMaxOpenConns(25)
db.SetMaxIdleConns(5)
db.SetConnMaxLifetime(5 * time.Minute)

Un esempio eseguibile in memoria

I driver reali richiedono un database di rete, quindi questo esempio eseguibile mostra lo stesso ciclo di vita con un'apertura e un ping simulati, utilizzando solo i tipi della libreria standard.

package main

import (
    "errors"
    "fmt"
)

type DB struct{ dsn string }

func Open(driver, dsn string) (*DB, error) {
    if dsn == "" {
        return nil, errors.New("empty dsn")
    }
    return &DB{dsn: dsn}, nil
}

func (db *DB) Ping() error { return nil }
func (db *DB) Close() error { return nil }

func main() {
    db, err := Open("postgres", "postgres://localhost/mydb")
    if err != nil {
        fmt.Println("open error:", err)
        return
    }
    defer db.Close()
    if err := db.Ping(); err != nil {
        fmt.Println("ping error:", err)
        return
    }
    fmt.Println("connected to", db.dsn)
}

Varianti consapevoli del context

Preferisca PingContext, QueryContext ed ExecContext, così le chiamate rispettano scadenze e annullamenti. Passare un context limita la durata del blocco causato da una chiamata al database che non risponde.

ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
defer cancel()
err := db.PingContext(ctx)

Il formato DSN

Ogni driver definisce il proprio DSN. PostgreSQL accetta un URL, mentre MySQL utilizza user:pass@tcp(host:3306)/dbname. Consulti sempre la documentazione dei driver ed eviti di codificare le credenziali direttamente nel codice.

Un solo pool, a lunga durata

Un errore comune consiste nel chiamare sql.Open per ogni richiesta. Questo annulla i vantaggi del pooling ed esaurisce le connessioni. Lo apra una volta all'avvio, conservi il valore *sql.DB e lo riutilizzi ovunque.

Verifica rapida

Verifichi la Sua conoscenza delle connessioni.

Riepilogo

Ha imparato ad aprire una connessione:

Importi un driver a vuoto e chiami sql.Open con driver e DSN
*sql.DB è un pool sicuro per l'uso concorrente, da aprire una sola volta
Ping verifica la connettività effettiva
Regoli il pool e utilizzi metodi consapevoli del context
Utilizzi defer db.Close() durante l'arresto

Domande Frequenti

La lezione «Aprire una connessione» è gratuita?

Sì — il testo completo di «Aprire una connessione» è 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 Go Academy, passa a CoddyKit PRO. Il corso Go Academy include 4 lezioni in totale.

Cosa imparerò in «Aprire una connessione»?

Connettersi a un database Eserciti Go Academy 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 Go Academy?

Non è richiesta alcuna esperienza precedente. Go Academy 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 «Aprire una connessione»?

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 Go Academy?

Sì. Ogni lezione Go Academy 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 Go Academy