Usar o driver de banco de dados/SQL do Spanner

Go database/sql é uma interface genérica em torno de bancos de dados SQL (ou semelhantes a SQL) para a linguagem de programação Go. Para usar database/sql com seu aplicativo, use o driver database/sql do Spanner.

Instale o driver de banco de dados/SQL do Spanner.

Para usar o driver de banco de dados/SQL do Spanner no seu aplicativo, adicione o seguinte módulo ao arquivo go.mod:

  github.com/googleapis/go-sql-spanner

Usar o driver SQL/de banco de dados do Spanner

Para criar uma conexão de banco de dados/SQL com um banco de dados do Spanner, use spanner como o nome do driver e um nome de banco de dados totalmente qualificado como a string de conexão:

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 mais informações, consulte o repositório do GitHub do driver SQL/banco de dados do Spanner.

Recursos compatíveis

O diretório de código de exemplos de banco de dados/SQL do Spanner Go contém exemplos prontos para execução de recursos do Spanner usados com frequência.

Dicas de desempenho

Para ter a melhor performance possível ao usar o driver database/sql do Spanner, siga estas práticas recomendadas:

• Parâmetros de consulta: use parâmetros de consulta em vez de valores inline em instruções SQL. Isso permite que o Spanner armazene em cache e reutilize o plano de execução para instruções SQL usadas com frequência.
• Linguagem de definição de dados (DDL): agrupe várias instruções DDL em um lote em vez de executá-las uma por uma.
• Linguagem de manipulação de dados (DML): agrupe várias instruções DML em um lote em vez de executá-las uma por uma.
• Transações somente leitura: use transações somente leitura para cargas de trabalho que apenas leem dados. As transações somente leitura não são bloqueadas.
• Tags: use tags de solicitação e de transação para resolver problemas.

A seguir

• Saiba mais sobre como usar o Spanner com o driver database/sql exemplos de código.
• Saiba mais sobre database/sql.
• Usar o GORM com o Spanner.
• Registre um problema no GitHub para relatar uma solicitação de recurso ou um bug, ou para fazer uma pergunta sobre o driver SQL/de banco de dados do Spanner.