メインコンテンツへスキップ
見出し画像

【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 go

    PoC用フォルダを作成

    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/gin

    Ginは、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を使っていて

    • 処理の分離を考えている方

    の参考になれば幸いです。


    では
    また


    過去の記事



     
     
    インフラエンジニアとして実務メモを、 写真作家として写真物語を、 童話作家として物語を書いています。 写真作品は、ポートフォリオサイトとしてまとめていく予定です。

    あなたへのおすすめ