Utiliser le pilote de base de données/SQL Spanner

Go database/sql est une interface générique autour des bases de données SQL (ou de type SQL) pour le langage de programmation Go. Pour utiliser database/sql avec votre application, utilisez le pilote Spanner database/sql.

Remarque : Vous ne pouvez pas utiliser database/sql avec vos bases de données utilisant le dialecte PostgreSQL. Vous pouvez utiliser le pilote PostgreSQL pgx.

Installer le pilote de base de données/SQL Spanner

Pour utiliser le pilote de base de données/SQL Spanner dans votre application, ajoutez le module suivant à votre fichier go.mod :

  github.com/googleapis/go-sql-spanner

Utiliser le pilote de base de données/SQL Spanner

Pour créer une connexion de base de données/SQL à une base de données Spanner, utilisez spanner comme nom de pilote et un nom de base de données complet comme chaîne de connexion :

import (
	"context"
	"database/sql"
	"fmt"

	_ "github.com/googleapis/go-sql-spanner"
)

func connect(projectId, instanceId, databaseId string) error {
	ctx := context.Background()
	dsn := fmt.Sprintf("projects/%s/instances/%s/databases/%s",
		projectId, instanceId, databaseId)
	db, err := sql.Open("spanner", dsn)
	if err != nil {
		return fmt.Errorf("failed to open database connection: %v", err)
	}
	defer func() { _ = db.Close() }()

	fmt.Printf("Connected to %s\n", dsn)
	row := db.QueryRowContext(ctx, "select @greeting", "Hello from Spanner")
	var greeting string
	if err := row.Scan(&greeting); err != nil {
		return fmt.Errorf("failed to get greeting: %v", err)
	}
	fmt.Printf("Greeting: %s\n", greeting)

	return nil
}

Pour en savoir plus, consultez le dépôt GitHub du pilote SQL/de base de données Spanner.

Fonctionnalités compatibles

Le répertoire de code des exemples database/sql Go de Spanner contient des exemples prêts à l'emploi pour les fonctionnalités Spanner courantes.

Conseils relatifs aux performances

Pour obtenir les meilleures performances possibles lorsque vous utilisez le pilote SQL/de base de données Spanner, suivez ces bonnes pratiques :

• Paramètres de requête : utilisez des paramètres de requête au lieu de valeurs intégrées dans les instructions SQL. Cela permet à Spanner de mettre en cache et de réutiliser le plan d'exécution pour les instructions SQL fréquemment utilisées.
• Langage de définition de données (LDD) : regroupez plusieurs instructions LDD dans un seul lot au lieu de les exécuter une par une.
• Langage de manipulation de données (LMD) : regroupez plusieurs instructions LMD dans un seul lot au lieu de les exécuter une par une.
• Transactions en lecture seule : utilisez des transactions en lecture seule pour les charges de travail qui ne font que lire des données. Les transactions en lecture seule ne peuvent pas être verrouillées.
• Tags : Utilisez les tags de requête et de transaction pour résoudre les problèmes.

Étapes suivantes

• Découvrez comment utiliser Spanner avec le pilote database/sql dans les exemples de code.
• En savoir plus sur database/sql
• Utilisez GORM avec Spanner.
• Ouvrez une demande sur GitHub pour signaler une demande de fonctionnalité ou un bug, ou pour poser une question sur le pilote SQL/de base de données Spanner.