행 쿼리하기
결과 집합 읽기
행 쿼리하기은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
결과 집합 조회
SELECT처럼 행을 반환하는 명령문에는 Query를 사용합니다. 반복해서 처리할 수 있는 *sql.Rows를 반환합니다. 단일 값에는 QueryRow가 더 간단합니다.
db.Query
Query는 SQL을 전송하고 행과 오류를 반환합니다. 행을 사용하기 전에 항상 오류를 확인하십시오.
rows, err := db.Query("SELECT id, name FROM users WHERE active = $1", true)
if err != nil {
log.Fatal(err)
}항상 rows.Close()를 defer로 호출하기
행은 닫힐 때까지 데이터베이스 연결을 점유합니다. defer rows.Close()는 연결을 풀로 돌려보냅니다. 이를 잊으면 부하가 걸릴 때 연결이 누수됩니다.
defer rows.Close()rows.Next로 반복하기
rows.Next()는 다음 행으로 이동하고, 끝에 도달하면 false를 반환합니다. 반복문 안에서는 Scan을 호출하여 열 값을 변수에 복사합니다.
for rows.Next() {
var id int
var name string
if err := rows.Scan(&id, &name); err != nil {
log.Fatal(err)
}
fmt.Println(id, name)
}Scan은 포인터를 받습니다
Scan은 전달한 변수에 값을 기록하므로 포인터를 전달해야 합니다(&id, &name). 포인터의 개수와 순서는 선택한 열과 일치해야 합니다.
rows.Err 확인하기
반복문은 데이터가 모두 소진되어 끝날 수도 있고, 반복 중 오류가 발생하여 끝날 수도 있습니다. 반복문이 끝난 후 rows.Err()를 호출하여 반복 중 발생한 오류를 확인하십시오.
if err := rows.Err(); err != nil {
log.Fatal(err)
}한 행에는 QueryRow 사용하기
정확히 한 행을 예상할 때는 QueryRow와 Scan을 함께 사용하는 편이 더 깔끔합니다. 일치하는 행이 없으면 Scan이 sql.ErrNoRows를 반환합니다.
var name string
err := db.QueryRow("SELECT name FROM users WHERE id = $1", 7).Scan(&name)
if err == sql.ErrNoRows {
fmt.Println("not found")
}실행 가능한 Scan 시뮬레이션
실제 조회에는 데이터베이스가 필요하므로, 이 실행 가능한 예제에서는 메모리 내 슬라이스를 대상으로 Query, Next, Scan 흐름을 모델링하여 반복 처리 방식을 보여 줍니다.
package main
import "fmt"
type Row struct {
ID int
Name string
}
func main() {
rows := []Row{{1, "Ada"}, {2, "Lin"}, {3, "Guido"}}
for i := 0; i < len(rows); i++ {
var id int
var name string
id = rows[i].ID
name = rows[i].Name
fmt.Printf("id=%d name=%s\n", id, name)
}
fmt.Println("scanned", len(rows), "rows")
}NULL 처리
NULL 열은 일반 문자열이나 정수로 스캔할 수 없습니다. sql.NullString, sql.NullInt64 또는 포인터 형식을 사용하여 코드가 NULL과 빈 값을 구분할 수 있게 하십시오.
var email sql.NullString
rows.Scan(&email)
if email.Valid {
fmt.Println(email.String)
}구조체로 스캔하기
표준 라이브러리는 전체 구조체가 아니라 개별 변수로 스캔합니다. &u.ID, &u.Name을 전달하여 열을 구조체 필드에 매핑합니다. sqlx와 같은 라이브러리는 이 작업을 자동화합니다.
SELECT * 피하기
Scan 순서가 안정적으로 유지되도록 열을 명시적으로 나열하십시오. SELECT *에 의존하면 열을 추가하는 스키마 변경이 위치 기반 Scan을 아무런 경고 없이 망가뜨릴 수 있습니다.
빠른 확인
조회에 대한 지식을 확인해 보십시오.
복습
행 조회에 대해 배웠습니다:
- Query는 *sql.Rows를 반환하며 rows.Close()는 defer로 호출합니다
- rows.Next로 반복하고, Scan을 통해 포인터에 값을 복사합니다
- 반복문 후에 rows.Err()를 확인합니다
- 단일 행에는 QueryRow를 사용하고, 조회되지 않으면 sql.ErrNoRows를 반환합니다
- NULL을 허용하는 열에는 Null 형식을 사용합니다
자주 묻는 질문
“행 쿼리하기” 강의는 무료인가요?
네 — “행 쿼리하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“행 쿼리하기”에서 뭘 배우나요?
결과 집합 읽기 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Go Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“행 쿼리하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.