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.

Le pilote Spannerdatabase/sql est compatible avec les bases de données utilisant les dialectes GoogleSQL et PostgreSQL.

Installer le pilote Spanner database/sql

Pour utiliser le pilote Spanner database/sql dans votre application, ajoutez le module suivant à votre fichier go.mod :

  github.com/googleapis/go-sql-spanner

Utiliser le pilote Spanner database/sql

Pour créer une connexion database/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 :

GoogleSQL

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 cast(@greeting as string)", "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
}

PostgreSQL

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)
	// The Spanner database/sql driver supports both PostgreSQL-style query
	// parameters ($1, $2, ...) and positional query parameters (?, ?, ...).
	// This example uses PostgreSQL-style parameters.
	row := db.QueryRowContext(ctx, "select $1", "Hello from Spanner PostgreSQL")
	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 Spanner database/sql.

Fonctionnalités compatibles

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

Conseils relatifs aux performances

Pour obtenir les meilleures performances possibles lorsque vous utilisez le pilote Spanner database/sql, 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 des tags de requête et de transaction pour résoudre les problèmes.

Étape suivante

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