使用 Spanner 数据库/SQL 驱动程序

Go database/sql 是 Go 编程语言专用的 SQL（或类似 SQL）数据库通用接口。如需将 database/sql 与应用搭配使用，请使用 Spanner database/sql 驱动程序。

注意 ：您无法将 database/sql 与 PostgreSQL 方言数据库搭配使用。不过，您可以使用 PostgreSQL pgx 驱动程序。

安装 Spanner 数据库/SQL 驱动程序

如需在应用中使用 Spanner 数据库/SQL 驱动程序，请将以下模块添加到 go.mod 文件中：

  github.com/googleapis/go-sql-spanner

使用 Spanner 数据库/SQL 驱动程序

如需创建与 Spanner 数据库的 database/sql 连接，请将 spanner 用作驱动程序名称，并将完全限定的数据库名称用作连接字符串：

import (
	"database/sql"
	"fmt"

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

func connect(projectId, instanceId, databaseId string) error {
	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)

	return nil
}

如需了解详情，请参阅 Spanner 数据库/SQL 驱动程序 GitHub 代码库。

支持的功能

Spanner Go 数据库/SQL 示例代码目录包含适用于常用 Spanner 功能的随时可运行示例。

性能提示

如需在使用 Spanner 数据库/SQL 驱动程序时获得最佳性能，请遵循以下最佳实践：

• 查询参数：在 SQL 语句中使用查询参数，而不是内嵌值。这样，Spanner 就可以缓存和重复使用常用 SQL 语句的执行计划。
• 数据库定义语言 (DDL)：将多个 DDL 语句分组到一个批次，而不是逐个执行。
• 数据操纵语言 (DML)：将多个 DML 语句分组到一个批处理中，而不是逐个执行。
• 只读事务：对于仅读取数据的工作负载，请使用只读事务。只读事务不会锁定。
• 代码：使用请求代码和事务代码进行问题排查。

后续步骤

• 如需详细了解如何将 Spanner 与数据库/SQL 驱动程序搭配使用，请参阅代码示例。
• 详细了解 database/sql。
• 将 GORM 与 Spanner 搭配使用。
• 提交 GitHub 问题以报告功能请求或 bug，或提出有关 Spanner 数据库/SQL 驱动程序的问题。