연결 열기
데이터베이스에 연결하기
연결 열기은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
database/sql 패키지
Go의 표준 database/sql 패키지는 일반적이며 데이터베이스에 종속되지 않는 API를 제공합니다. PostgreSQL이나 MySQL처럼 특정 데이터베이스에 맞는 드라이버와 함께 사용합니다.
- 하나의 API로 여러 데이터베이스를 사용합니다
- 연결 풀링이 내장되어 있습니다
- 매개변수화된 쿼리를 안전하게 사용할 수 있습니다
드라이버 가져오기
드라이버는 빈 가져오기를 통해 스스로 등록합니다. 밑줄은 드라이버를 직접 호출하기 위해서가 아니라 등록이라는 부수 효과만을 위해 가져온다는 뜻입니다.
import (
"database/sql"
_ "github.com/lib/pq"
)sql.Open
sql.Open은 드라이버 이름과 데이터 원본 이름(DSN)을 받습니다. 아직 실제로 연결하지 않고, 연결 풀을 준비하기만 합니다.
db, err := sql.Open("postgres", "postgres://user:pass@localhost/mydb?sslmode=disable")
if err != nil {
log.Fatal(err)
}db는 풀입니다
반환되는 *sql.DB는 단일 연결이 아니라 여러 고루틴이 동시에 안전하게 사용할 수 있는 연결 풀입니다. 한 번만 열고 애플리케이션 전체에서 공유하십시오.
Ping으로 확인하기
Open은 지연 방식으로 동작하므로 Ping을 사용해 실제로 연결을 설정하고 데이터베이스에 접근할 수 있는지와 자격 증명이 유효한지를 확인하십시오.
if err := db.Ping(); err != nil {
log.Fatal("cannot reach db:", err)
}풀 닫기
main 또는 설정 함수에서 db.Close()를 defer로 호출하십시오. 쿼리마다 닫는 일은 거의 없으며, 전체 애플리케이션이 종료될 때만 닫습니다.
defer db.Close()풀 조정
SetMaxOpenConns, SetMaxIdleConns, SetConnMaxLifetime으로 풀을 제어하십시오. 이 설정들은 데이터베이스의 리소스 고갈을 방지하고 오래된 연결을 교체합니다.
db.SetMaxOpenConns(25)
db.SetMaxIdleConns(5)
db.SetConnMaxLifetime(5 * time.Minute)실행 가능한 메모리 내 예제
실제 드라이버에는 네트워크 데이터베이스가 필요하므로, 이 실행 가능한 예제에서는 표준 라이브러리 타입만 사용해 모의 열기와 연결 확인으로 동일한 생명 주기를 보여 줍니다.
package main
import (
"errors"
"fmt"
)
type DB struct{ dsn string }
func Open(driver, dsn string) (*DB, error) {
if dsn == "" {
return nil, errors.New("empty dsn")
}
return &DB{dsn: dsn}, nil
}
func (db *DB) Ping() error { return nil }
func (db *DB) Close() error { return nil }
func main() {
db, err := Open("postgres", "postgres://localhost/mydb")
if err != nil {
fmt.Println("open error:", err)
return
}
defer db.Close()
if err := db.Ping(); err != nil {
fmt.Println("ping error:", err)
return
}
fmt.Println("connected to", db.dsn)
}context를 인식하는 변형
호출이 기한과 취소를 준수하도록 PingContext, QueryContext, ExecContext를 우선 사용하십시오. context를 전달하면 멈춘 데이터베이스 호출이 차단할 수 있는 시간을 제한할 수 있습니다.
ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
defer cancel()
err := db.PingContext(ctx)DSN 형식
각 드라이버는 고유한 DSN 형식을 정의합니다. PostgreSQL은 URL을 허용하고, MySQL은 user:pass@tcp(host:3306)/dbname 형식을 사용합니다. 항상 드라이버 문서를 확인하고 자격 증명을 하드코딩하지 마십시오.
풀 하나를 오래 유지하기
흔히 하는 실수는 요청마다 sql.Open을 호출하는 것입니다. 그러면 풀링의 이점이 사라지고 연결이 고갈됩니다. 시작할 때 한 번 열고, *sql.DB를 저장한 뒤 모든 곳에서 재사용하십시오.
빠른 확인
연결에 대한 지식을 확인해 보십시오.
복습
연결 열기에 대해 배웠습니다:
- 드라이버를 빈 가져오기로 불러오고, 드라이버와 DSN을 사용해 sql.Open을 호출합니다
- *sql.DB는 한 번 열어 사용하는 동시성 안전 연결 풀입니다
- Ping은 실제 연결을 확인합니다
- 풀을 조정하고 context를 인식하는 메서드를 사용합니다
- 종료할 때 defer db.Close()를 호출합니다
자주 묻는 질문
“연결 열기” 강의는 무료인가요?
네 — “연결 열기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“연결 열기”에서 뭘 배우나요?
데이터베이스에 연결하기 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Go Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“연결 열기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.