
【IT】Djangoから呼び出す前提で、GoのバックエンドAPIをPoC作成
皆さま
こんにちは
本日は、
GoのバックエンドAPIを学習したいと思います。
1.はじめに
Webアプリケーションを作っていると、
次のような不安を感じることはないでしょうか?
アプリ自体は複雑ではないのに、DBのレコードが増えてきたらレスポンスが遅くなりそう
そもそも、レコード件数が増えたときにこの構成で耐えられるのか
重いバックエンド処理は、アプリ本体から切り離したほうが制御(設計・運用)が楽なのではないか
私はDjangoを使ってWebアプリを作成する中で
こうしたことを考える機会がありました。
そこで今回は、
Djangoをメインに据えたまま、
重たい処理だけを別のAPIに切り出せないか
という検討の一環として、
GoでバックエンドAPIを作るPoC(検証環境)
を構築してみました。
本記事では、
Goとは何か
なぜGoを使うのか
実際にどのように環境を作ったのか
を、Goを知らない方にも分かるように、説明していきます。
2.Go(Golang)とは何か?
Go(ゴー)は、プログラミング言語の名前です。
正式には Golang(ゴーラング) と呼ばれることもあります。
2009年ごろ、Googleのエンジニアたちによって開発されました。
なぜGoは作られたのか
Goが作られた背景には、
サーバが巨大化していく
同時アクセスが増える
システムが複雑になり、人が把握しづらくなる
といった問題がありました。
そこでGoogleは、
速くて、軽くて、
人が安全に書けるサーバ向け言語
として、Goを設計しました。
Goは何が得意な言語なのか
Goは特に、次のような用途が得意です。
Web API サーバ
バックエンド処理
集計や検索などの重い処理
長時間動き続けるサービス
特徴としては、
処理が速い
メモリ消費が比較的少ない
同時処理が得意
何が起きているか分かりやすい
といった点があります。
Goは何でもできる言語ではない
一方で、Goは万能ではありません。
管理画面がたくさんある
認証やフォーム、画面遷移が多い
HTMLテンプレートを中心としたWebアプリ
こうしたものを Goだけで作る のは、あまり向いていないのでは思います。
Goは、
「便利な仕組みを大量に用意する言語」
ではなく、
「必要最低限を、分かりやすく提供する言語」
だからです。
何故、今回、Goを使うのか!
今回の前提は、次のような構成です。
メインのWebアプリ:Django
ユーザー管理・画面表示・業務ロジック:Djangoが担当
集計・検索・DB負荷の高い処理:別に切り出したい
つまり、Goは 主役ではありません。
Djangoを支える「裏方API」
として、Goがどれくらい現実的かを確認するのが目的です。
3.今回のPoCのゴール
今回のPoCでやることは、とてもシンプルです。
GoでAPIサーバを起動する
PostgreSQLに接続する
DBのデータをJSONで返す
これだけです。
Djangoとの連携は今回は行いません。
まずは Go側の感触を掴むこと を優先します。
4.PoC環境の作成
開発環境
macOS(ローカル)(今回は、OS 26.2)
Go
Gin(Go用のAPIフレームワーク)
PostgreSQL(Ver17)
Goが使えるか確認
まず、Goがインストールされているかを確認します。
go version
例
go version go1.25.5 darwin/arm64バージョンが表示されればOKです。
表示されない場合は、Homebrewでインストールします。
brew install goPoC用フォルダを作成
mkdir -p ~/dev/go-api-poc
cd ~/dev/go-api-pocこのフォルダが、今回のPoCの作業場所になります。
場所は適宜変更ください。
Goプロジェクトを初期化する
go mod init go-api-pocこれは、
「このフォルダを1つのGoプロジェクトとして扱います」
という宣言です。
Pythonでいう `pyproject.toml` を作るようなイメージです。
Gin(APIフレームワーク)を追加
go get github.com/gin-gonic/ginGinは、GoでAPIを書くときに便利な機能をまとめたライブラリです。
初期確認、先ずはAPIが起動するか確認
`main.go` を作成します。
package main
import (
"net/http"
"github.com/gin-gonic/gin"
)
func main() {
r := gin.Default()
r.GET("/health", func(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{"status": "ok"})
})
r.Run(":8081")
}起動します。
go run main.goブラウザで次にアクセスします。
http://localhost:8081/health`{"status":"ok"}` が返れば成功です。

PostgreSQLの準備
PostgreSQLに接続し、`rooms` テーブルを作成します。
CREATE TABLE rooms (
id SERIAL PRIMARY KEY,
name TEXT NOT NULL,
rent INTEGER NOT NULL,
is_soundproof BOOLEAN NOT NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);サンプルデータを入れます。
INSERT INTO rooms (name, rent, is_soundproof) VALUES
('グランドピアノOKワンルーム', 90000, TRUE),
('アップライトピアノ可・1LDK', 110000, TRUE),
('楽器相談可・2DK', 95000, FALSE);GoからPostgreSQLに接続
PostgreSQL用のドライバを追加します。
go get github.com/lib/pq接続情報は環境変数に設定します。
export REPORT_DB_DSN="postgres://ユーザー名@localhost:5432/DB名?sslmode=disable"DBの内容を返すAPIを作成
最終的な `main.go` は次のようになります。
package main
import (
"database/sql"
"net/http"
"os"
"strconv"
_ "github.com/lib/pq"
"github.com/gin-gonic/gin"
)
type Room struct {
ID int64 `json:"id"`
Name string `json:"name"`
Rent int `json:"rent"`
IsSoundproof bool `json:"is_soundproof"`
}
func main() {
dsn := os.Getenv("REPORT_DB_DSN")
if dsn == "" {
panic("REPORT_DB_DSN is not set")
}
db, err := sql.Open("postgres", dsn)
if err != nil {
panic(err)
}
defer db.Close()
// DB疎通チェック(起動時に落ちるようにしておくと分かりやすい)
if err := db.Ping(); err != nil {
panic(err)
}
r := gin.Default()
r.GET("/health", func(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{"status": "ok"})
})
// GET /rooms?limit=50
r.GET("/rooms", func(c *gin.Context) {
limit := 50
if s := c.Query("limit"); s != "" {
if v, err := strconv.Atoi(s); err == nil && v > 0 && v <= 200 {
limit = v
}
}
rows, err := db.Query(`
SELECT id, name, rent, is_soundproof
FROM rooms
ORDER BY id
LIMIT $1
`, limit)
if err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"error": "query failed"})
return
}
defer rows.Close()
rooms := make([]Room, 0, limit)
for rows.Next() {
var r Room
if err := rows.Scan(&r.ID, &r.Name, &r.Rent, &r.IsSoundproof); err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"error": "scan failed"})
return
}
rooms = append(rooms, r)
}
if err := rows.Err(); err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"error": "rows error"})
return
}
c.JSON(http.StatusOK, rooms)
})
// 8081で待ち受け
r.Run(":8081")
}
※ このAPIでは、
`GET /rooms`
PostgreSQLのデータを取得
JSONで返却
という処理を行っています。

5.実際にできたもの
GoでAPIサーバが起動する
PostgreSQLに接続できる
DBの内容をJSONで返せる
たったこれだけですが、
「GoはDjangoの裏側で、ちゃんと使えそうか?」
という疑問には、使えそうだの感触を得ることが出来ました。
6.Goは難しいのか?
今回のPoCを通して感じたのは、
Goは難しい言語ではないが、親切でもない
ということです。
ただし、
小さなAPI
責務がはっきりした処理
生SQL前提
という条件では、
Goは、とても素直な言語がと思いました。
7.おわりに
すべてを1つのアプリに任せる必要はありません。
主役はDjango
裏方としてGo
そうした役割分担を考える上で、
今回のPoCはとても良い確認作業になりました。
同じように、
Djangoを使っていて
処理の分離を考えている方
の参考になれば幸いです。
では
また