Go言語のクエリ実行を完全解説！Query・QueryRowの基本と使い分けを初心者向けにやさしく理解
生徒
「Go言語でデータベースからデータを取り出したいんですが、どうやって読むんですか？」
先生
「Go言語では、QueryやQueryRowという仕組みを使って、データベースに質問して結果を受け取ります。」
生徒
「2つもあると、どっちを使えばいいのか分からなくなりそうです……」
先生
「大丈夫です。役割はとてもシンプルなので、例えを使いながら順番に説明していきます。」
1. Go言語でのクエリ実行とは何か
Go言語でのクエリ実行とは、データベースに対して「この条件に合うデータをください」とお願いする操作のことです。
このお願いの文章がSQLと呼ばれる命令文で、データベースとの会話に使われます。
Go言語では、このSQLを使ってデータを読み取るために、QueryとQueryRowという2つの方法が用意されています。
プログラミング未経験の方は、クエリ実行を「引き出しの中から必要な書類を探して取り出す作業」だと考えると分かりやすいです。
2. QueryとQueryRowの違いをイメージで理解
QueryとQueryRowの違いは、取り出したいデータの量にあります。 Queryは「条件に合うものを全部ください」というお願いで、複数のデータをまとめて取得します。 一方、QueryRowは「この条件に合うものを1つだけください」というお願いです。 例えるなら、Queryは箱いっぱいのリンゴを受け取る方法で、QueryRowは1個だけリンゴを受け取る方法です。 この違いを理解するだけで、使い分けは一気に簡単になります。
3. Queryの基本的な使い方
Queryは、複数行のデータを取得したいときに使います。 例えば、ユーザー一覧や商品リストのように、何件あるか分からないデータを扱う場合です。 Queryを実行すると、結果がそのままでは使えない形で返ってくるため、1行ずつ順番に読み取る必要があります。 この読み取り作業は、ページをめくりながらノートを読むイメージに近いです。
rows, err := db.Query("SELECT id, name FROM users")
if err != nil {
// エラー処理
}
defer rows.Close()
for rows.Next() {
var id int
var name string
rows.Scan(&id, &name)
}
4. rows.NextとScanの意味
rows.Nextは、「次のデータがありますか？」と確認するための仕組みです。
データがある間はtrueになり、すべて読み終えるとfalseになります。
Scanは、取り出したデータをGo言語の変数に入れる作業です。
封筒に入った書類を取り出して、机の上に並べるようなイメージを持つと理解しやすくなります。
この2つはQueryを使うときに必ず登場する重要なポイントです。
5. QueryRowの基本的な使い方
QueryRowは、1行だけ結果を取得したいときに使います。 例えば、IDを指定してユーザー情報を1人分だけ取得するような場合です。 Queryと違い、ループ処理は不要で、そのままScanを呼び出せます。 必要な情報が1つだと分かっている場面では、QueryRowを使うとコードがとてもスッキリします。
var name string
err := db.QueryRow("SELECT name FROM users WHERE id = ?", 1).Scan(&name)
if err != nil {
// エラー処理
}
6. QueryRowでエラーが出る理由
QueryRowでは、結果が見つからなかった場合にエラーが返されます。 これは「条件に合うデータが存在しません」という合図です。 プログラムが壊れたわけではなく、データが無いことを正しく伝えてくれています。 初心者の方はエラーを見ると不安になりますが、これは正常な動作の一部なので安心してください。
7. QueryとQueryRowの使い分けまとめ
複数の行を扱うならQuery、1行だけならQueryRowというルールを覚えておくと迷いません。 どちらもGo言語でデータベース操作を行う上で欠かせない基本機能です。 クエリ実行の考え方を理解すると、データベースとのやり取りが一気に身近になります。 難しそうに見えても、実際は「聞く」「受け取る」というシンプルな流れです。
8. 初心者がつまずきやすいポイント
よくある失敗として、Queryを使ったあとにCloseを忘れてしまうことがあります。 また、Scanの順番とSQLの列の順番が合っていないと、思わぬ値が入ってしまいます。 これらは慣れるまで誰でも通る道なので、落ち着いて一つずつ確認することが大切です。 基本を丁寧に積み重ねることで、安定したGo言語のデータベース処理が書けるようになります。
