Spanner 데이터베이스/SQL 드라이버 사용

Go database/sql은 Go 프로그래밍 언어용 SQL (또는 SQL과 유사한) 데이터베이스를 둘러싼 일반 인터페이스입니다. 애플리케이션에서 database/sql을 사용하려면 Spanner database/sql 드라이버를 사용하세요.

참고: PostgreSQL 언어 데이터베이스에서는 database/sql을 사용할 수 없습니다. 대신 PostgreSQL pgx 드라이버를 사용할 수 있습니다.

Spanner 데이터베이스/SQL 드라이버 설치

애플리케이션에서 Spanner 데이터베이스/SQL 드라이버를 사용하려면 다음 모듈을 go.mod 파일에 추가합니다.

  github.com/googleapis/go-sql-spanner

Spanner 데이터베이스/SQL 드라이버 사용

Spanner 데이터베이스에 대한 데이터베이스/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 문을 하나씩 실행하는 대신 여러 DDL 문을 하나의 일괄 처리로 그룹화합니다.
• 데이터 조작 언어 (DML): DML 문을 하나씩 실행하는 대신 여러 DML 문을 하나의 일괄 처리로 그룹화합니다.
• 읽기 전용 트랜잭션: 데이터만 읽는 워크로드에는 읽기 전용 트랜잭션을 사용합니다. 읽기 전용 트랜잭션은 잠금을 사용하지 않습니다.
• 태그: 요청 및 트랜잭션 태그를 사용하여 문제를 해결합니다.

다음 단계

• 데이터베이스/SQL 드라이버와 함께 Spanner를 사용하는 방법을 코드 예시에서 자세히 알아보세요.
• database/sql에 대해 자세히 알아보기
• Spanner와 함께 GORM을 사용하세요.
• 기능 요청이나 버그를 신고하거나 Spanner 데이터베이스/SQL 드라이버에 관해 질문하려면 GitHub 문제를 제출하세요.