Ouvrir une connexion
Se connecter à une base de données
Ouvrir une connexion est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Go Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Go Academy comprend 4 leçons au total.
Le paquet database/sql
Le paquet standard de Go, database/sql, fournit une API générique indépendante de la base de données. Vous l'associez à un pilote pour votre base de données, comme PostgreSQL ou MySQL.
- Une API pour de nombreuses bases de données
- Mise en commun intégrée des connexions
- Requêtes paramétrées sécurisées
Importer un pilote
Le pilote s'enregistre au moyen d'une importation vide. Le caractère de soulignement signifie que vous l'importez uniquement pour son effet secondaire, l'enregistrement, et non pour l'appeler directement.
import (
"database/sql"
_ "github.com/lib/pq"
)sql.Open
sql.Open prend un nom de pilote et un nom de source de données (DSN). Il n'établit pas encore réellement de connexion : il prépare simplement le groupe de connexions.
db, err := sql.Open("postgres", "postgres://user:pass@localhost/mydb?sslmode=disable")
if err != nil {
log.Fatal(err)
}db est un groupe de connexions
Le *sql.DB renvoyé n'est pas une connexion unique, mais un groupe de connexions utilisable en toute sécurité par de nombreuses goroutines simultanées. Ouvrez-le une fois et partagez-le dans toute votre application.
Vérifier avec Ping
Comme Open établit la connexion à la demande, utilisez Ping pour établir réellement une connexion et confirmer que la base de données est accessible et que les identifiants sont valides.
if err := db.Ping(); err != nil {
log.Fatal("cannot reach db:", err)
}Fermer le groupe de connexions
Utilisez db.Close() dans un defer dans votre fonction main ou de configuration. Vous fermez rarement le groupe après chaque requête : faites-le uniquement lorsque toute l'application s'arrête.
defer db.Close()Réglage du groupe de connexions
Contrôlez le groupe avec SetMaxOpenConns, SetMaxIdleConns et SetConnMaxLifetime. Ces réglages évitent d'épuiser la base de données et renouvellent les connexions obsolètes.
db.SetMaxOpenConns(25)
db.SetMaxIdleConns(5)
db.SetConnMaxLifetime(5 * time.Minute)Un exemple exécutable en mémoire
Les vrais pilotes nécessitent une base de données réseau. Cet exemple exécutable montre donc le même cycle de vie avec une ouverture et un ping simulés, en utilisant uniquement les types de la bibliothèque 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)
}Variantes compatibles avec le contexte
Préférez PingContext, QueryContext et ExecContext afin que les appels respectent les échéances et l'annulation. La transmission d'un contexte limite la durée pendant laquelle un appel à la base de données bloqué peut rester en attente.
ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
defer cancel()
err := db.PingContext(ctx)Le format DSN
Chaque pilote définit son propre DSN. PostgreSQL accepte une URL, tandis que MySQL utilise user:pass@tcp(host:3306)/dbname. Consultez toujours la documentation des pilotes et évitez d'inscrire les identifiants en dur.
Un seul groupe, sur le long terme
Une erreur courante consiste à appeler sql.Open pour chaque requête. Cela annule les avantages du groupe de connexions et épuise les connexions disponibles. Ouvrez-le au démarrage, stockez le *sql.DB et réutilisez-le partout.
Vérification rapide
Testez vos connaissances sur les connexions.
Récapitulatif
Vous avez appris à ouvrir une connexion :
- Importez un pilote vide, puis appelez sql.Open avec le pilote et le DSN
- *sql.DB est un groupe de connexions sûr en situation de concurrence, ouvert une seule fois
- Ping vérifie la connectivité réelle
- Réglez le groupe et utilisez des méthodes compatibles avec le contexte
- Utilisez defer db.Close() à l'arrêt
Questions Fréquemment Posées
La leçon « Ouvrir une connexion » est-elle gratuite ?
Oui — le texte complet de « Ouvrir une connexion » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Go Academy, passe à CoddyKit PRO. Le cours Go Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Ouvrir une connexion » ?
Se connecter à une base de données Tu pratiques Go Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Go Academy ?
Aucune expérience préalable n'est requise. Go Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.
Combien de temps prend la leçon « Ouvrir une connexion » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Go Academy ?
Oui. Chaque leçon Go Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Ouvrir une connexion
- Interroger des lignes
- Instructions préparées
- Transactions