Usa el controlador de SQL o la base de datos de Spanner

Go database/sql es una interfaz genérica para bases de datos SQL (o similares a SQL) para el lenguaje de programación Go. Para usar database/sql con tu aplicación, usa el controlador database/sql de Spanner.

Nota: No puedes usar database/sql con tus bases de datos de dialecto PostgreSQL. En su lugar, puedes usar el controlador pgx de PostgreSQL.

Instala el controlador de base de datos o SQL de Spanner

Para usar el controlador database/sql de Spanner en tu aplicación, agrega el siguiente módulo a tu archivo go.mod:

  github.com/googleapis/go-sql-spanner

Usa el controlador de base de datos o SQL de Spanner

Para crear una conexión de base de datos o SQL a una base de datos de Spanner, usa spanner como nombre del controlador y un nombre de base de datos completamente calificado como la cadena de conexión:

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
}

Para obtener más información, consulta el repositorio de GitHub del controlador de SQL y de la base de datos de Spanner.

Funciones admitidas

El directorio de código de ejemplos de base de datos/sql de Spanner Go contiene ejemplos listos para ejecutar de las funciones de Spanner que se usan con frecuencia.

Sugerencias para un mejor rendimiento

Para obtener el mejor rendimiento posible cuando uses el controlador database/sql de Spanner, sigue estas prácticas recomendadas:

• Parámetros de consulta: Usa parámetros de consulta en lugar de valores intercalados en las instrucciones de SQL. Esto permite que Spanner almacene en caché y reutilice el plan de ejecución para las instrucciones de SQL que se usan con frecuencia.
• Lenguaje de definición de datos (DDL): Agrupa varias declaraciones de DDL en un lote en lugar de ejecutarlas una por una.
• Lenguaje de manipulación de datos (DML): Agrupa varias sentencias DML en un lote en lugar de ejecutarlas una por una.
• Transacciones de solo lectura: Usa transacciones de solo lectura para cargas de trabajo que solo leen datos. Las transacciones de solo lectura no aceptan bloqueos.
• Etiquetas: Usa etiquetas de solicitud y transacción para solucionar problemas.

¿Qué sigue?

• Obtén más información para usar Spanner con los ejemplos de código del controlador database/sql.
• Obtén más información sobre database/sql.
• Usa GORM con Spanner.
• Presenta un problema en GitHub para informar un error o solicitar una función, o bien para hacer una pregunta sobre el controlador database/sql de Spanner.