mysql - GitLite

KO | EN

gitlite — search

#python #typescript #llm #android #machine-learning #linux #docker #nodejs #awesome #kubernetes #awesome-list #pytorch #security #mcp

mysql

(★ 15,269)

Go MySQL Driver는 Go(golang)의 database/sql 패키지를 위한 MySQL 드라이버입니다.

파일 탐색기

최종 버전 다운로드 (.zip)

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/go-sql-driver/mysql

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd mysql

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Go

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Go Go 언어 컴파일러 및 도구 모음입니다.

go build ./...

Go 프로그램을 컴파일해 실행 파일을 만듭니다.

go run .

따로 빌드하지 않고 바로 Go 프로그램을 실행합니다.

✅ 빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Go-MySQL-Driver
[![DeepWiki](https://img.shields.io/badge/DeepWiki-go--sql--driver%2Fmysql-blue.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXMGeK/AIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06/uv1saEDv4O3n3dV60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzoSNAhwACAoJSpIQAAGoG4GACkK8EwY828b8n568rW6L71yX7aZ+lO9kX7dZ60RfP947Mm9/SQc0ICFQgzfc4CJzOG9wAAAAASUVORK5CYII=)](https://deepwiki.com/go-sql-driver/mysql)
Go의 [database/sql](https://golang.org/pkg/database/sql/) 패키지를 위한 MySQL 드라이버입니다.
![Go-MySQL-Driver logo](https://raw.github.com/wiki/go-sql-driver/mysql/gomysql\_m.png "Golang Gopher holding the MySQL Dolphin")
---------------------------------------
\* [기능](#features)
\* [요구 사항](#requirements)
\* [설치](#installation)
\* [사용법](#usage)
\* [DSN (Data Source Name)](#dsn-data-source-name)
\* [비밀번호](#password)
\* [프로토콜](#protocol)
\* [주소](#address)
\* [매개변수](#parameters)
\* [예제](#examples)
\* [연결 풀 및 타임아웃](#connection-pool-and-timeouts)
\* [context.Context 지원](#contextcontext-support)
\* [ColumnType 지원](#columntype-support)
\* [LOAD DATA LOCAL INFILE 지원](#load-data-local-infile-support)
\* [time.Time 지원](#timetime-support)
\* [유니코드 지원](#unicode-support)
\* [테스트 / 개발](#testing--development)
\* [라이선스](#license)
---------------------------------------
## Features
\* 가볍고 [빠릅니다](https://github.com/go-sql-driver/sql-benchmark "golang MySQL-Driver performance").
\* 순수 Go 구현. C 바인딩이 없으며 완전한 Go로 작성되었습니다.
\* TCP/IPv4, TCP/IPv6, 유닉스 도메인 소켓 또는 [커스텀 프로토콜](https://godoc.org/github.com/go-sql-driver/mysql#DialFunc)을 통한 연결
\* 끊어진 연결 자동 복구
\* 자동 연결 풀링 \*(database/sql 패키지에서 제공)\*
\* 16MB보다 큰 쿼리 지원
\* 전체 [`sql.RawBytes`](https://golang.org/pkg/database/sql/#RawBytes) 지원
\* Prepared statement에서 지능적인 `LONG DATA` 처리
\* 파일 화이트리스트 및 `io.Reader`를 지원하는 안전한 `LOAD DATA LOCAL INFILE` 지원
\* 선택적 `time.Time` 파싱
\* 선택적 플레이스홀더 보간(interpolation)
\* zlib 압축 지원
## Requirements
\* Go 1.24 이상. 최신 Go 버전 3개를 지원하는 것을 목표로 합니다.
\* MySQL (5.7+) 및 MariaDB (10.5+)는 메인스트림 관리자에 의해 지원됩니다.
\* [TiDB](https://github.com/pingcap/tidb)는 PingCAP에서 지원합니다.
\* 이슈 트래커나 포럼에 TiDB 관련 질문을 올리지 마세요.
\* [문서](https://docs.pingcap.com/tidb/v6.1/dev-guide-sample-application-golang)
\* [포럼](https://ask.pingcap.com/)
\* go-mysql은 Percona Server, Google CloudSQL 또는 Sphinx (2.2.3+)에서도 동작합니다.
\* 메인스트림 관리자는 이들을 지원하지 않습니다. 관리자가 직접 이슈를 조사하고 해결해 줄 것을 기대하지 마세요.
\* 직접 이슈를 조사하고 해결을 위한 풀 리퀘스트(pull request)를 보내주시기 바랍니다.
---------------------------------------
## Installation
[go 툴](https://github.com/golang/go/wiki/GOPATH "GOPATH")을 사용하여 [$GOPATH](https://github.com/golang/go/wiki/GOPATH "GOPATH")에 패키지를 간단히 설치할 수 있습니다.

/golang.org/cmd/go/ "go command") 셸에서 실행:
```bash
go get -u github.com/go-sql-driver/mysql
```
컴퓨터에 [Git이 설치되어 있고](https://git-scm.com/downloads) 시스템의 `PATH`에 등록되어 있는지 확인하세요.
## 사용법
\_Go MySQL Driver\_는 Go의 `database/sql/driver` 인터페이스 구현체입니다. 드라이버를 임포트하기만 하면 전체 [`database/sql`](https://golang.org/pkg/database/sql/) API를 사용할 수 있습니다.
`driverName`으로 `mysql`을 사용하고, 유효한 [DSN](#dsn-data-source-name)을 `dataSourceName`으로 사용하세요:
```go
import (
"database/sql"
"time"
\_ "github.com/go-sql-driver/mysql"
)
// ...
db, err := sql.Open("mysql", "user:password@/dbname")
if err != nil {
panic(err)
}
// "중요 설정" 섹션을참조하세요.
db.SetConnMaxLifetime(time.Minute \* 3)
db.SetMaxOpenConns(10)
db.SetMaxIdleConns(10)
```
[예제는 위키에서 확인하실 수 있습니다](https://github.com/go-sql-driver/mysql/wiki/Examples "Go-MySQL-Driver Examples").
### 중요 설정
MySQL 서버, OS 또는 기타 미들웨어에 의해 연결이 종료되기 전에 드라이버가 안전하게 연결을 닫도록 하려면 `db.SetConnMaxLifetime()`이 필요합니다. 일부 미들웨어는 5분이 지나면 유휴 연결을 닫기 때문에, 5분보다 짧은 타임아웃을 권장합니다. 이 설정은 부하 분산 및 시스템 변수 변경에도 도움이 됩니다.
애플리케이션에서 사용하는 연결 수를 제한하기 위해 `db.SetMaxOpenConns()`를 강력히 권장합니다. 애플리케이션과 MySQL 서버에 따라 다르므로 권장되는 제한 숫자는 따로 없습니다.
`db.SetMaxIdleConns()`는 `db.SetMaxOpenConns()`와 동일하게 설정하는 것이 좋습니다. `SetMaxOpenConns()`보다 작게 설정하면, 예상보다 훨씬 더 자주 연결이 열리고 닫힐 수 있습니다. 유휴 연결은 `db.SetConnMaxLifetime()`에 의해 닫힐 수 있습니다. 유휴 연결을 더 빠르게 닫으려면 Go 1.15부터 제공되는 `db.SetConnMaxIdleTime()`을 사용할 수 있습니다.
### DSN (Data Source Name)
Data Source Name은 [PEAR DB](http://pear.php.net/manual/en/package.database.db.intro-dsn.php) 등에서 사용하는 것과 같은 일반적인 형식을 따르지만, 타입 접두사가 없습니다(선택적 부분은 대괄호로 표시됨):
```
[username[:password]@][protocol[(address)]]/dbname[?param1=value1&...&paramN=valueN]
```
가장 완전한 형태의 DSN:
```
username:password@protocol(address)/dbname?param=value
```
데이터베이스 이름을 제외한 모든 값은 선택 사항입니다. 따라서 최소한의 DSN은 다음과 같습니다:
```
/dbname
```
데이터베이스를 미리 선택하지 않으려면 `dbname`을 비워둡니다:
```
/
```
이는 빈 DSN 문자열과 동일한 효과를 줍니다:
```
```
`dbname`은 v1.8.0부터 [PathEscape()](https://pkg.go.dev/net/url#PathEscape)에 의해 이스케이프 처리됩니다. 데이터베이스 이름이 `dbname/withslash`인 경우 다음과 같이 변경됩니다:
```
/dbname%2Fwithslash
```
 또는 [Config.FormatDSN](https://godoc.org/github.com/go-sql-driver/mysql#Config.FormatDSN)을 사용하여 구조체를 채우는 방식으로 DSN 문자열을 생성할 수 있습니다.
#### 비밀번호
비밀번호는 모든 문자로 구성될 수 있습니다. 이스케이프 처리는 \*\*필요하지 않습니다\*\*.
#### 프로토콜
사용 가능한 네트워크에 대한 자세한 내용은 [net.Dial](https://golang.org/pkg/net/#Dial)을 참조하세요.
일반적으로 최고의 성능을 위해 가능하면 유닉스 도메인 소켓을 사용하고, 그렇지 않은 경우 TCP를 사용해야 합니다.
#### 주소
TCP 및 UDP 네트워크의 경우, 주소는 `host[:port]` 형식을 가집니다.
`port`를 생략하면 기본 포트가 사용됩니다.
`host`가 리터럴 IPv6 주소인 경우, 대괄호로 묶어야 합니다.
[net.JoinHostPort](https://golang.org/pkg/net/#JoinHostPort) 및 [net.SplitHostPort](https://golang.org/pkg/net/#JoinHostPort) 함수는 이 형식의 주소를 조작합니다.
유닉스 도메인 소켓의 경우 주소는 MySQL 서버 소켓의 절대 경로입니다(예: `/var/run/mysqld/mysqld.sock` 또는 `/tmp/mysql.sock`).
#### 매개변수
\*매개변수는 대소문자를 구분합니다!\*
`true`, `TRUE`, `True` 또는 `1` 중 하나는 참인 불리언 값으로 인식됩니다. 당연히 거짓은 `false`, `FALSE`, `False` 또는 `0` 중 하나로 지정할 수 있습니다.
##### `allowAllFiles`
```
Type: bool
Valid Values: true, false
Default: false
```
`allowAllFiles=true`는 파일 알

`LOAD DATA LOCAL INFILE`에 대한 `lowlist`이며 \*모든\* 파일을 허용합니다.
[\*안전하지 않을 수 있습니다!\*](https://dev.mysql.com/doc/refman/8.0/en/load-data.html#load-data-local)
##### `allowCleartextPasswords`
```
Type: bool
Valid Values: true, false
Default: false
```
`allowCleartextPasswords=true`는 [PAM authentication plugin](http://dev.mysql.com/doc/en/pam-authentication-plugin.html)으로 정의된 계정과 같이 계정에서 요구하는 경우 [cleartext client side plugin](https://dev.mysql.com/doc/en/cleartext-pluggable-authentication.html) 사용을 허용합니다. 평문으로 비밀번호를 전송하는 것은 일부 설정에서 보안 문제가 될 수 있습니다. 비밀번호가 가로채일 가능성이 조금이라도 있는 경우 문제를 방지하기 위해 클라이언트는 비밀번호를 보호하는 방법을 사용하여 MySQL Server에 연결해야 합니다. 가능한 방법으로는 [TLS / SSL](#tls), IPsec 또는 사설망이 있습니다.
##### `allowFallbackToPlaintext`
```
Type: bool
Valid Values: true, false
Default: false
```
`allowFallbackToPlaintext=true`는 [Command Options for Connecting to the Server](https://dev.mysql.com/doc/refman/5.7/en/connection-options.html#option\_general\_ssl-mode)에 설명된 `--ssl-mode=PREFERRED` MySQL 클라이언트처럼 작동합니다.
##### `allowNativePasswords`
```
Type: bool
Valid Values: true, false
Default: true
```
`allowNativePasswords=false`는 MySQL 네이티브 비밀번호 방식의 사용을 금지합니다.
##### `allowOldPasswords`
```
Type: bool
Valid Values: true, false
Default: false
```
`allowOldPasswords=true`는 안전하지 않은 이전 비밀번호 방식의 사용을 허용합니다. 이는 피해야 하지만 경우에 따라 필요합니다. [old\_passwords 위키 페이지](https://github.com/go-sql-driver/mysql/wiki/old\_passwords)도 참고하세요.
##### `charset`
```
Type: string
Valid Values: 
Default: none
```
클라이언트-서버 간 상호작용에 사용되는 문자셋(`"SET NAMES "`)을 설정합니다. 여러 문자셋이 (쉼표로 구분되어) 설정된 경우, 문자셋 설정에 실패하면 다음 문자셋이 사용됩니다. 이를 통해 예를 들어 이전 서버용 `utf8`로 대체(`charset=utf8mb4,utf8`)하는 [MySQL 5.5.3에 도입된](http://dev.mysql.com/doc/refman/5.5/en/charset-unicode-utf8mb4.html) `utf8mb4` 지원을 활성화할 수 있습니다.
[Unicode Support](#unicode-support)도 참고하세요.
##### `checkConnLiveness`
```
Type: bool
Valid Values: true, false
Default: true
```
지원되는 플랫폼에서는 커넥션 풀에서 가져온 연결을 사용하기 전에 활성 상태(liveness)를 확인합니다. 확인에 실패하면 해당 연결은 불량으로 표시되며 다른 연결로 쿼리가 재시도됩니다.
`checkConnLiveness=false`는 이러한 연결의 활성 상태 확인을 비활성화합니다.
##### `collation`
```
Type: string
Valid Values: 
Default: utf8mb4\_general\_ci
```
연결 시 클라이언트-서버 간 상호작용에 사용되는 콜레이션을 설정합니다. `charset`과 달리 `collation`은 추가 쿼리를 실행하지 않습니다. 대상 서버에서 지정된 콜레이션을 사용할 수 없는 경우 연결이 실패합니다.
서버에서 사용 가능한 유효한 콜레이션 목록은 `SHOW COLLATION`으로 확인할 수 있습니다.
기본 콜레이션(`utf8mb4\_general\_ci`)은 MySQL 5.5부터 지원됩니다. 이전 MySQL의 경우 더 오래된 콜레이션(예: `utf8\_general\_ci`)을 사용해야 합니다.
"ucs2", "utf16", "utf16le", "utf32" 문자셋의 콜레이션은 사용할 수 없습니다 ([참고](https://dev.mysql.com/doc/refman/5.7/en/charset-connection.html#charset-connection-impermissible-client-charset)).
[Unicode Support](#unicode-support)도 참고하세요.
##### `clientFoundRows`
```
Type: bool
Valid Values: true, false
Default: false
```
`clientFoundRows=true`는 UPDATE가 변경된 행의 수 대신 일치하는 행의 수를 반환하도록 합니다.
##### `columnsWithAlias`
```
Type: bool
Valid Values: true, false
Default: false
```
`columnsWithAlias`가 참(true)인 경우, `sql.Rows.Columns()` 호출은 테이블 별칭과 컬럼 이름을 점(dot)으로 구분하여 반환합니다. 예를 들면:
```
SELECT u.id FROM users as u
```
는 `columnsWithAlias=true`인 경우 `id` 대신 `u.id`를 반환합니다.
##### `compress`
```
Type: bool
Valid Values: true, false
Default: false
```
zlib 압축을 켜고 끕니다.

on. 기본값은 false입니다.
##### `interpolateParams`
```
Type: bool
Valid Values: true, false
Default: false
```
`interpolateParams`가 true인 경우, `db.Query()` 및 `db.Exec()` 호출에 사용된 플레이스홀더(`?`)가 주어진 파라미터들과 함께 하나의 쿼리 문자열로 보간(interpolate)됩니다. `interpolateParams=false`일 때는 드라이버가 구문(statement)을 준비(prepare)하고, 주어진 파라미터로 실행한 뒤 다시 구문을 닫아야 하므로, 이를 통해 라운드트립 횟수를 줄일 수 있습니다.
\*이 기능은 BIG5, CP932, GB2312, GBK 또는 SJIS 멀티바이트 인코딩과 함께 사용할 수 없습니다. 이 인코딩들은 [SQL 인젝션 취약점을 유발할 수 있으므로](http://stackoverflow.com/a/12118602/3430118) 거부됩니다!\*
##### `loc`
```
Type: string
Valid Values: 
Default: UTC
```
time.Time 값의 로케이션을 설정합니다(`parseTime=true`를 사용하는 경우). \*"Local"\*은 시스템의 로케이션을 설정합니다. 자세한 내용은 [time.LoadLocation](https://golang.org/pkg/time/#LoadLocation)을 참조하세요.
이 설정은 time.Time 값의 로케이션을 설정하지만 MySQL의 [time\_zone 설정](https://dev.mysql.com/doc/refman/5.5/en/time-zone-support.html)은 변경하지 않습니다. 이를 변경하려면 DSN 파라미터로도 설정할 수 있는 [time\_zone 시스템 변수](#system-variables)를 참조하세요.
파라미터 값은 반드시 [url.QueryEscape](https://golang.org/pkg/net/url/#QueryEscape) 처리가 되어 있어야 하므로 주의하세요. 또는 `/`를 `%2F`로 직접 바꿀 수도 있습니다. 예를 들어 `US/Pacific`은 `loc=US%2FPacific`이 됩니다.
##### `timeTruncate`
```
Type: duration
Default: 0
```
[시간 값](https://pkg.go.dev/time#Duration.Truncate)을 지정된 duration으로 자릅니다(truncate). 값은 \*"30s"\*, \*"0.5m"\*, \*"1m30s"\*와 같이 단위 접미사(\*"ms"\*, \*"s"\*, \*"m"\*, \*"h"\*)가 붙은 십진수여야 합니다.
##### `maxAllowedPacket`
```
Type: decimal number
Default: 64\*1024\*1024
```
허용되는 최대 패킷 크기(바이트 단위). 기본값은 64 MiB이며 서버 설정에 맞게 조정해야 합니다. `maxAllowedPacket=0`을 사용하면 \*모든 연결 시\* 서버로부터 `max\_allowed\_packet` 변수를 자동으로 가져올 수 있습니다.
##### `multiStatements`
```
Type: bool
Valid Values: true, false
Default: false
```
하나의 쿼리에서 여러 문장을 허용합니다. 이를 통해 여러 쿼리를 일괄 처리(batch)할 수 있습니다. 두 번째 및 그 이후의 쿼리 결과를 얻으려면 [Rows.NextResultSet()](https://pkg.go.dev/database/sql#Rows.NextResultSet)을 사용하세요.
`multiStatements`를 사용할 때 `?` 파라미터는 첫 번째 문장에만 사용해야 합니다. 명시적 Prepared Statement를 사용하지 않는 한, [interpolateParams](#interpolateparams)를 사용하여 이 제한을 우회할 수 있습니다.
`sql.Conn.Raw()`와 `mysql.Result`를 사용하면 여러 문장에 대해 마지막으로 삽입된 ID(last inserted ID)와 영향받은 행의 수에 접근할 수 있습니다. 예시:
```go
conn, \_ := db.Conn(ctx)
conn.Raw(func(conn any) error {
ex := conn.(driver.Execer)
res, err := ex.Exec(`
UPDATE point SET x = 1 WHERE y = 2;
UPDATE point SET x = 2 WHERE y = 3;
`, nil)
// 두 슬라이스 모두 2개의 원소를 가집니다.
log.Print(res.(mysql.Result).AllRowsAffected())
log.Print(res.(mysql.Result).AllLastInsertIds())
})
```
##### `parseTime`
```
Type: bool
Valid Values: true, false
Default: false
```
`parseTime=true`는 `DATE` 및 `DATETIME` 값의 출력 타입을 `[]byte` / `string` 대신 `time.Time`으로 변경합니다.
`0000-00-00 00:00:00`과 같은 날짜 또는 날짜-시간은 `time.Time`의 제로 값(zero value)으로 변환됩니다.
##### `readTimeout`
```
Type: duration
Default: 0
```
I/O 읽기 타임아웃. 값은 \*"30s"\*, \*"0.5m"\*, \*"1m30s"\*와 같이 단위 접미사(\*"ms"\*, \*"s"\*, \*"m"\*, \*"h"\*)가 붙은 십진수여야 합니다.
##### `rejectReadOnly`
```
Type: bool
Valid Values: true, false
Default: false
```
`rejectReadOnly=true`는 드라이버가 읽기 전용(read-only) 연결을 거부하도록 만듭니다. 이는
자동 장애 조치(failover) 중에 발생할 수 있는 경쟁 상태(race condition)를 위한 것으로, 장애 조치 후에 mysql
클라이언트가 읽기 전용 복제본(replica)에 연결되는 상황을 방지합니다.
자동 장애 조치는 일반적으로
주 서버(primary)가 다운되었을 때 발생하며, 주 서버가 다시 복구되어 돌아오지 않는 한 경쟁 상태는 발생하지 않으므로, 이 경우는 비교적 드문 사례입니다.

failover가 시작되면 온라인 상태가 됩니다. 반면에 이 경우, MySQL 애플리케이션은 재시작되기 전까지 읽기 전용(read-only) 연결에 멈춰있을 수 있습니다. 하지만 이는 예를 들어 AWS Aurora의 MySQL 호환 클러스터에서 수동 failover를 사용하는 등의 방법으로 비교적 쉽게 재현할 수 있습니다.
발생해서는 안 되는 쓰기 작업을 거부하기 위해 읽기 전용 트랜잭션에 의존하지 않는 경우, 일부 MySQL 공급자(예: AWS Aurora)에서 이 옵션을 설정하는 것이 failover 시 더 안전합니다.
`read-only` 서버에 대해 ERROR 1290이 반환될 수 있으며, 이 옵션은 해당 오류에 대해 재시도를 발생시킵니다. 그러나 동일한 오류 번호가 다른 일부 경우에도 사용됩니다. 이 옵션을 활성화할 때는 `read-only` 모드 외에는 애플리케이션이 절대 ERROR 1290을 발생시키지 않도록 해야 합니다.

##### `serverPubKey`
```
Type: string
Valid Values: 
Default: none
```
서버 공개 키는 [`mysql.RegisterServerPubKey`](https://godoc.org/github.com/go-sql-driver/mysql#RegisterServerPubKey)에 등록할 수 있으며, 이후 DSN에서 지정된 이름을 통해 사용할 수 있습니다.
공개 키는 인증 등 암호화된 데이터를 전송하는 데 사용됩니다.
서버의 공개 키를 알고 있는 경우, 필요할 때마다 서버에서 클라이언트로 공개 키를 전송하는 비용이 크고 잠재적으로 안전하지 않은 전송을 피하기 위해 수동으로 설정해야 합니다.

##### `timeout`
```
Type: duration
Default: OS default
```
연결 수립을 위한 타임아웃, 즉 다이얼 타임아웃(dial timeout)입니다. 값은 단위 접미사(\*"ms"\*, \*"s"\*, \*"m"\*, \*"h"\*)가 포함된 십진수여야 하며, 예를 들어 \*"30s"\*, \*"0.5m"\*, \*"1m30s"\* 등이 있습니다.

##### `tls`
```
Type: bool / string
Valid Values: true, false, skip-verify, preferred, 
Default: false
```
`tls=true`는 서버와의 TLS / SSL 암호화 연결을 활성화합니다. 자체 서명되었거나 유효하지 않은 인증서(서버 측)를 사용하려면 `skip-verify`를 사용하고, 서버에서 지원할 때만 TLS를 사용하려면 `preferred`를 사용하세요. 이는 `skip-verify`와 유사하지만, 추가로 암호화되지 않은 연결로의 폴백(fallback)을 허용합니다. `skip-verify`와 `preferred` 모두 신뢰할 수 있는 보안을 제공하지는 않습니다. [`mysql.RegisterTLSConfig`](https://godoc.org/github.com/go-sql-driver/mysql#RegisterTLSConfig)에 등록한 후 커스텀 TLS 설정을 사용할 수 있습니다.

##### `writeTimeout`
```
Type: duration
Default: 0
```
I/O 쓰기 타임아웃입니다. 값은 단위 접미사(\*"ms"\*, \*"s"\*, \*"m"\*, \*"h"\*)가 포함된 십진수여야 하며, 예를 들어 \*"30s"\*, \*"0.5m"\*, \*"1m30s"\* 등이 있습니다.

##### `connectionAttributes`
```
Type: comma-delimited string of user-defined "key:value" pairs
Valid Values: (:,:,...)
Default: none
```
[연결 속성(Connection attributes)](https://dev.mysql.com/doc/refman/8.0/en/performance-schema-connection-attribute-tables.html)은 애플리케이션 프로그램이 연결 시점에 서버로 전달할 수 있는 키-값 쌍입니다.

##### 시스템 변수
기타 모든 매개변수는 시스템 변수로 해석됩니다:
\* `=`: `SET =`
\* `=`: `SET =`
\* `=%27%27`: `SET =''`

규칙:
\* 문자열 변수의 값은 `'`로 감싸야 합니다.
\* 값 또한 [url.QueryEscape](http://golang.org/pkg/net/url/#QueryEscape) 처리가 되어야 합니다!
(이는 문자열 변수의 값이 `%27`로 감싸져야 함을 의미합니다).

예시:
\* `autocommit=1`: `SET autocommit=1`
\* [`time\_zone=%27Europe%2FParis%27`](https://dev.mysql.com/doc/refman/5.5/en/time-zone-support.html): `SET time\_zone='Europe/Paris'`
\* [`transaction\_isolation=%27REPEATABLE-READ%27`](https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar\_transaction\_isolation): `SET transaction\_isolation='REPEATABLE-READ'`

#### 예시
```
user@unix(/path/to/socket)/dbname
```
```
root:pw@unix(/tmp/mysql.sock)/myDatabase?loc=Local
```
```
user:password@tcp(localhost:5555)/dbname?tls=skip-verify&autocommit=true
```

시스템 변수 [`sql\_mode`](https://dev.mysql.com/doc/refman/5.7/en/sql-mode.html)를 설정하여 경고를 오류로 처리합니다:
```
user:password@/dbname?sql\_mode=TRADITIONAL
```

IPv6를 통한 TCP:
```
user:password@tcp([de:ad:be:ef::ca:fe]:80)/dbname?timeout=90s&collation=utf8mb4\_unicode\_ci
```

i
```
TCP on a remote host, e.g. Amazon RDS:
```
id:password@tcp(your-amazonaws-uri.com:3306)/dbname
```
Google Cloud SQL on App Engine:
```
user:password@unix(/cloudsql/project-id:region-name:instance-name)/dbname
```
기본 포트(3306)를 사용하는 localhost의 TCP:
```
user:password@tcp/dbname?charset=utf8mb4,utf8&sys\_var=esc%40ped
```
기본 프로토콜(tcp) 및 호스트(localhost:3306) 사용:
```
user:password@/dbname
```
사전 선택된 데이터베이스 없음:
```
user:password@/
```
### 커넥션 풀 및 타임아웃
커넥션 풀은 Go의 database/sql 패키지에 의해 관리됩니다. 풀의 크기를 설정하는 방법과 커넥션이 풀에 유지되는 시간에 대한 자세한 내용은 [database/sql 문서](https://golang.org/pkg/database/sql/)의 `\*DB.SetMaxOpenConns`, `\*DB.SetMaxIdleConns`, `\*DB.SetConnMaxLifetime`을 참조하세요. 개별 커넥션의 읽기, 쓰기, 다이얼(dial) 타임아웃은 각각 DSN 매개변수인 [`readTimeout`](#readtimeout), [`writeTimeout`](#writetimeout), [`timeout`](#timeout)으로 설정합니다.
## `ColumnType` 지원
이 드라이버는 현재 지원되지 않는 [`ColumnType.Length()`](https://golang.org/pkg/database/sql/#ColumnType.Length)를 제외하고 Go 1.8에 도입된 [`ColumnType` 인터페이스](https://golang.org/pkg/database/sql/#ColumnType)를 지원합니다. 모든 Unsigned 데이터베이스 타입 이름은 `INT`, `TINYINT`, `SMALLINT`, `MEDIUMINT`, `BIGINT`와 함께 `UNSIGNED `로 반환됩니다.
## `context.Context` 지원
Go 1.8에서는 `context.Context`에 대한 `database/sql` 지원이 추가되었습니다. 이 드라이버는 컨텍스트를 통한 쿼리 타임아웃 및 취소를 지원합니다.
자세한 내용은 [database/sql 패키지의 컨텍스트 지원](https://golang.org/doc/go1.8#database\_sql)을 참조하세요.
> [!IMPORTANT]
> `database/sql`에서 제공하는 `QueryContext`, `ExecContext` 등의 변형 함수는 결과가 드라이버에 수신되기 전에 제공된 컨텍스트가 취소되거나 타임아웃될 경우 커넥션이 닫히도록 만듭니다.
### `LOAD DATA LOCAL INFILE` 지원
이 기능을 사용하려면 패키지에 직접 접근해야 합니다. 따라서 import 경로를 변경해야 합니다 (`\_` 없음):
```go
import "github.com/go-sql-driver/mysql"
```
파일은 `mysql.RegisterLocalFile(filepath)`를 사용하여 명시적으로 등록해야 하거나(권장) DSN 매개변수 `allowAllFiles=true`를 사용하여 allowlist 검사를 비활성화해야 합니다([*안전하지 않을 수 있습니다!*](https://dev.mysql.com/doc/refman/8.0/en/load-data.html#load-data-local)).
`io.Reader`를 사용하려면 `io.Reader` 또는 `io.ReadCloser`를 반환하는 `mysql.RegisterReaderHandler(name, handler)`를 통해 핸들러 함수를 등록해야 합니다. 그러면 `Reader::` 파일 경로로 Reader를 사용할 수 있습니다. 서로 다른 핸들러에는 다른 이름을 선택하고 더 이상 필요하지 않을 때는 `DeregisterReaderHandler`를 호출하세요.
자세한 내용은 [Go-MySQL-Driver godoc](https://godoc.org/github.com/go-sql-driver/mysql "golang mysql driver documentation")을 참조하세요.
### `time.Time` 지원
MySQL `DATE` 및 `DATETIME` 값의 기본 내부 출력 타입은 `[]byte`이며, 이를 통해 프로그램에서 값을 `[]byte`, `string` 또는 `sql.RawBytes` 변수로 스캔할 수 있습니다.
그러나 많은 사용자가 MySQL의 `DATE` 및 `DATETIME`에 Go에서의 논리적 동등물인 `time.Time` 변수로 MySQL `DATE` 및 `DATETIME` 값을 스캔하기를 원합니다. DSN 매개변수 `parseTime=true`를 사용하여 내부 출력 타입을 `[]byte`에서 `time.Time`으로 변경하면 됩니다. 기본 [`time.Time` 위치](https://golang.org/pkg/time/#Location)는 `loc` DSN 매개변수로 설정할 수 있습니다.
\*\*주의:\*\* Go 1.1부터 이 설정은 `DATE` 및 `DATETIME` 값을 스캔할 수 있는 유일한 변수 타입으로 `time.Time`을 만듭니다. 이로 인해 예를 들어 [`sql.RawBytes` 지원](https://github.com/go-sql-driver/mysql/wiki/Examples#rawbytes)이 동작하지 않게 됩니다.
### 유니코드 지원
버전 1.5부터 Go-MySQL-Driver는 기본적으로 `utf8mb4\_general\_ci` 콜레이션을 자동으로 사용합니다.
다른 문자셋 / 콜레이션은 [`charset`](#charset) 또는 [`collation`](#collation) DSN 매개변수를 사용하여 설정할 수 있습니다.
- `charset`만 지정된 경우

cified, the `SET NAMES ` query is sent and the server's default collation is used.
- `charset`과 `collation`이 둘 다 지정된 경우, `SET NAMES  COLLATE ` 쿼리가 전송됩니다.
- `collation`만 지정된 경우, 프로토콜 핸드셰이크에서 콜레이션이 지정되며 `SET NAMES` 쿼리는 전송되지 않습니다. 이렇게 하면 왕복(roundtrip)을 한 번 절약할 수 있지만, 서버가 지정된 콜레이션을 조용히 무시하고 대신 서버의 기본 문자셋(charset)/콜레이션을 사용할 수 있으니 주의하세요.
MySQL의 유니코드 지원에 대한 자세한 내용은 http://dev.mysql.com/doc/refman/8.0/en/charset-unicode.html을 참조하세요.
## 테스트 / 개발
드라이버 테스트를 실행하려면 설정을 조정해야 할 수 있습니다. 자세한 내용은 [Testing Wiki-Page](https://github.com/go-sql-driver/mysql/wiki/Testing "Testing")를 참조하세요.
Go-MySQL-Driver는 아직 모든 기능이 구현되지 않았습니다. 여러분의 많은 도움을 부탁드립니다.
기여하고 싶으시다면 [open issue](https://github.com/go-sql-driver/mysql/issues?state=open)를 해결하거나 [pull request](https://github.com/go-sql-driver/mysql/pulls)를 검토해 주세요.
자세한 내용은 [Contribution Guidelines](https://github.com/go-sql-driver/mysql/blob/master/.github/CONTRIBUTING.md)을 참조하세요.
---------------------------------------
## 라이선스
Go-MySQL-Driver는 [Mozilla Public License Version 2.0](https://raw.github.com/go-sql-driver/mysql/master/LICENSE) 라이선스 하에 배포됩니다.
Mozilla는 라이선스 범위를 다음과 같이 요약합니다.
> MPL: 카피레프트(copyleft)는 MPL 코드가 포함된 모든 파일에 적용됩니다.
즉, 다음을 의미합니다.
\* 변경되지 않은 소스 코드는 개인적 용도와 상업적 용도 모두로 \*\*사용\*\*할 수 있습니다.
\* 배포 시, MPL 2.0으로 라이선스가 부여된 \*\*변경되거나 수정된 파일\*\*의 소스 코드는 a) MPL 2.0 자체 또는 b) 호환되는 라이선스(예: GPL 3.0 또는 Apache License 2.0)로 \*\*공개해야 합니다\*\*.
\* MPL 2.0으로 라이선스가 부여된 파일이 \*\*변경되지 않은 상태\*\*라면 라이브러리의 소스 코드를 \*\*공개할 필요가 없습니다\*\*.
라이선스와 관련하여 추가 질문이 있는 경우 [MPL 2.0 FAQ](https://www.mozilla.org/en-US/MPL/2.0/FAQ/)를 읽어보세요.
전체 약관은 여기에서 확인할 수 있습니다: [LICENSE](https://raw.github.com/go-sql-driver/mysql/master/LICENSE).
![Go Gopher and MySQL Dolphin](https://raw.github.com/wiki/go-sql-driver/mysql/go-mysql-driver\_m.jpg "Golang Gopher transporting the MySQL Dolphin in a wheelbarrow")