Go言語のクエリ実行を完全解説！Query・QueryRowの基本と使い分けを初心者向けにやさしく理解

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言語でデータベース操作を行う上で欠かせない基本機能です。クエリ実行の考え方を理解すると、データベースとのやり取りが一気に身近になります。難しそうに見えても、実際は「聞く」「受け取る」というシンプルな流れです。

Go言語を基礎からスッキリ学びたい人や、文法だけでなく「実用的な使い方」まで押さえたい人には、定番の入門書がこちらです。

基礎からわかるGo言語をAmazonで見る

※ Amazon広告リンク

8. 初心者がつまずきやすいポイント

よくある失敗として、Queryを使ったあとにCloseを忘れてしまうことがあります。また、Scanの順番とSQLの列の順番が合っていないと、思わぬ値が入ってしまいます。これらは慣れるまで誰でも通る道なので、落ち着いて一つずつ確認することが大切です。基本を丁寧に積み重ねることで、安定したGo言語のデータベース処理が書けるようになります。