使用 Spanner 資料庫/SQL 驅動程式

Go database/sql 是 Go 程式設計語言的 SQL (或類似 SQL) 資料庫通用介面。如要在應用程式中使用 database/sql，請使用 Spanner database/sql 驅動程式。

Spannerdatabase/sql 驅動程式同時支援 GoogleSQL 方言資料庫和 PostgreSQL 方言資料庫。

安裝 Spanner 資料庫/SQL 驅動程式

如要在應用程式中使用 Spanner 資料庫/SQL 驅動程式，請將下列模組新增至 go.mod 檔案：

  github.com/googleapis/go-sql-spanner

使用 Spanner 資料庫/SQL 驅動程式

如要建立與 Spanner 資料庫的資料庫/SQL 連線，請使用 spanner 做為驅動程式名稱，並使用完整資料庫名稱做為連線字串：

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 @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
}

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
}

詳情請參閱 Spanner 資料庫/SQL 驅動程式 GitHub 存放區。

支援功能

Spanner Go 資料庫/SQL 範例程式碼目錄包含常用 Spanner 功能的執行範例。

效能提示

使用 Spanner 資料庫/SQL 驅動程式時，請遵循下列最佳做法，盡可能獲得最佳成效：

• 查詢參數：在 SQL 陳述式中使用查詢參數，而非內嵌值。這樣一來，Spanner 就能快取並重複使用常用 SQL 陳述式的執行計畫。
• 資料庫定義語言 (DDL)：將多個 DDL 陳述式分組為一個批次，而非逐一執行。
• 資料操縱語言 (DML)：將多個 DML 陳述式分組為一個批次，而不是逐一執行。
• 唯讀交易：如要處理只讀取資料的工作負載，請使用唯讀交易。唯讀交易不會採用鎖定。
• 代碼：使用要求和交易代碼排解問題。

後續步驟

• 進一步瞭解如何搭配使用 Spanner 與 database/sql 驅動程式 程式碼範例。
• 進一步瞭解 database/sql。
• 搭配使用 GORM 與 Spanner。
• 提出 GitHub 問題，回報功能要求或錯誤，或詢問有關 Spanner 資料庫/SQL 驅動程式的問題。