<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Django &#8211; CFXLOG</title>
	<atom:link href="https://cfxlog.com/category/python/django/feed/index.xml" rel="self" type="application/rss+xml" />
	<link>https://cfxlog.com/</link>
	<description></description>
	<lastBuildDate>Wed, 11 Nov 2026 22:25:26 +0000</lastBuildDate>
	<language>ja</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.1.4</generator>

<image>
	<url>https://cfxlog.com/wp-content/uploads/2026/07/cfxlog-favicon-150x150.png</url>
	<title>Django &#8211; CFXLOG</title>
	<link>https://cfxlog.com/</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>【Django REST framework】REST APIを開発する方法</title>
		<link>https://cfxlog.com/drf/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Fri, 07 Aug 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[API連携]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5226</guid>

					<description><![CDATA[このような疑問にお答えします。 Django では “Django REST framework”（以下、「DRF」とします） というフレームワークを使うことで、REST API を開発することができます。 最初に Dj [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Django を使って REST API を開発したい！</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような疑問にお答えします。</p>



<p class="wp-block-paragraph">Django では “Django REST framework”（以下、「DRF」とします） というフレームワークを使うことで、REST API を開発することができます。</p>



<p class="wp-block-paragraph">最初に Django をインストールした上で、さらに DRF をインストールする流れです。</p>



<p class="wp-block-paragraph">本記事では以下の内容をお伝えします。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>API 開発に DRF を採用するメリット</li>

<li>DRF を使った API 開発の流れ</li>

<li>DRF をさらに使いこなす実装例</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この記事さえご覧いただければ DRF の全体像を掴んでいただけるよう、内容を網羅して解説していきます。</p>



<p class="wp-block-paragraph">ただし分量が膨大になってしまう関係で、細かいトピックは別記事を用意しています。関連記事も併せてご覧いただくことで、より DRF を使いこなすことができるようになるはずです。</p>



<p class="is-style-icon_info wp-block-paragraph">ここでは「REST API がどのようなものか？」といったものは解説しません。</p>



<div id="rtoc-mokuji-wrapper" class="rtoc-mokuji-content frame2 preset5 animation-fade rtoc_open default" data-id="5226" data-theme="SWELL CHILD">
			<div id="rtoc-mokuji-title" class=" rtoc_left">
			<button class="rtoc_open_close rtoc_open"></button>
			<span>目次</span>
			</div><ol class="rtoc-mokuji mokuji_ol level-1"><li class="rtoc-item"><a href="#rtoc-1">DRFの主な機能</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-2">シリアライゼーション</a></li><li class="rtoc-item"><a href="#rtoc-3">ビューセットとルーター</a></li><li class="rtoc-item"><a href="#rtoc-4">認証と権限付与</a></li><li class="rtoc-item"><a href="#rtoc-5">ページネーションとフィルタリング</a></li><li class="rtoc-item"><a href="#rtoc-6">ブラウザブルAPI</a></li><li class="rtoc-item"><a href="#rtoc-7">バージョニング</a></li><li class="rtoc-item"><a href="#rtoc-8">セキュリティ</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-9">DRFを採用するメリット</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-10">Django と統合している</a></li><li class="rtoc-item"><a href="#rtoc-11">高度なシリアライゼーションが可能</a></li><li class="rtoc-item"><a href="#rtoc-12">細かく認証設定ができる</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-13">DRFを使ったAPI開発の流れ</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-14">① プロジェクトのセットアップ</a></li><li class="rtoc-item"><a href="#rtoc-15">② モデルの定義</a></li><li class="rtoc-item"><a href="#rtoc-16">③ シリアライザの作成</a></li><li class="rtoc-item"><a href="#rtoc-17">④ ビューの作成</a></li><li class="rtoc-item"><a href="#rtoc-18">⑤ ルーティングの設定</a></li><li class="rtoc-item"><a href="#rtoc-19">⑥ 認証と権限の設定</a></li><li class="rtoc-item"><a href="#rtoc-20">⑦ テスト</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-21">DRFをさらに使いこなす実装例</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-22">CORSヘッダーを付与する</a></li><li class="rtoc-item"><a href="#rtoc-23">API Key認証を追加する</a></li><li class="rtoc-item"><a href="#rtoc-24">画像アップロード機能を実装する</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-25">まとめ</a></li></ol></div><h2 id="rtoc-1"  class="wp-block-heading">DRFの主な機能</h2>



<p class="wp-block-paragraph">まずは DRF がどのようなフレームワークかを解説します。</p>



<p class="wp-block-paragraph">API 開発のためのフレームワークには Python でいえば Flask, FastAPI などが、他の言語であれば NestJS, Spring Boot, Ruby on Rails などがあります。</p>



<p class="wp-block-paragraph">その中でも DRF を利用するメリットなどを理解して、技術選定の一助としてみてください。</p>



<p class="wp-block-paragraph">ここでは簡単に DRF で実装できる機能と、簡単な説明をしていきます。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>シリアライゼーション</strong></li>

<li><strong>ビューセットとルーター</strong></li>

<li><strong>認証と権限付与</strong></li>

<li><strong>ページネーションとフィルタリング</strong></li>

<li><strong>ブラウザブルAPI</strong></li>

<li><strong>バージョニング</strong></li>

<li><strong>セキュリティ</strong></li>
</ul>
</div></div>



<p class="wp-block-paragraph">それぞれ、掘り下げて解説します。</p>



<h3 id="rtoc-2"  class="wp-block-heading">シリアライゼーション</h3>



<p class="wp-block-paragraph">Django 内部で処理された Python オブジェクトを、JSON や XML などのフロントエンドで解釈がしやすい形式に変換することができます。</p>



<p class="wp-block-paragraph">この変換機能を「シリアライズ」と呼び、これが DRF の代表的な機能の一つになります。</p>



<h3 id="rtoc-3"  class="wp-block-heading">ビューセットとルーター</h3>



<p class="wp-block-paragraph">API のアクセス先となるエンドポイントを決定することができます。</p>



<p class="wp-block-paragraph">大元のフレームワークは Django を利用しているので、ビューとルーターはそれぞれ “views.py” と “urls.py” で制御することになります。</p>



<h3 id="rtoc-4"  class="wp-block-heading">認証と権限付与</h3>



<p class="wp-block-paragraph">Basic 認証、セッション認証、トークン認証を標準でサポートしています。</p>



<p class="wp-block-paragraph">また、”REST framework api key” などのサードパーティライブラリを使うことで、API Key 認証機能なども実装することができます。</p>



<h3 id="rtoc-5"  class="wp-block-heading">ページネーションとフィルタリング</h3>



<p class="wp-block-paragraph">大量のデータを小分けできる「ページネーション」が実装できます。</p>



<p class="wp-block-paragraph">これにより、レスポンス速度が向上したり、ユーザーがデータを簡単に見つけやすくできます。</p>



<p class="wp-block-paragraph">DRF では以下のようなページネーション種類を提供しています。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>LimitOffsetPagination</li>

<li>PageNumberPagination</li>

<li>CursorPagination</li>
</ul>
</div></div>



<p class="wp-block-paragraph">settings.py に記述すれば全体にページネーションを反映させることができますし、ビューごとにページネーションを個別設定することも可能です。</p>



<p class="wp-block-paragraph">また、特定のキーワードで検索したりといった「フィルタリング」も簡単に実装できます。</p>



<p class="wp-block-paragraph">フィルタリングバックエンドとしては、以下のようなものがあります。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>DjangoFilterBackend</li>

<li>SearchFilter</li>

<li>OrderingFilter</li>
</ul>
</div></div>



<p class="wp-block-paragraph">これらの詳細は、別記事で解説する予定です。</p>



<h3 id="rtoc-6"  class="wp-block-heading">ブラウザブルAPI</h3>



<p class="wp-block-paragraph">ブラウザから直接 API を閲覧できる機能です。</p>



<p class="wp-block-paragraph">これにより API の挙動を簡単に確認できるので、フロントエンド開発者や API 利用者にとっても理解しやすくなります。</p>



<p class="is-style-icon_info wp-block-paragraph">ブラウザブルAPIはデフォルト機能ですが、うまく動作しない場合には settings.py の DEFAULT_RENDERER_CLASSES に BrowsableAPIRenderer あるか確認してください。</p>



<h3 id="rtoc-7"  class="wp-block-heading">バージョニング</h3>



<p class="wp-block-paragraph">urls.py でバージョンごとにエンドポイントを切り替えることで、バージョンごとの管理が簡単に行えます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.urls import path, include

urlpatterns = [
    path('api/v1/', include('app_v1.urls')),  # v1のAPI
    path('api/v2/', include('app_v2.urls')),  # v2のAPI
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> path, include</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">urlpatterns = [</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">'api/v1/'</span><span style="color:#D4D4D4">, include(</span><span style="color:#CE9178">'app_v1.urls'</span><span style="color:#D4D4D4">)),  </span><span style="color:#6A9955"># v1のAPI</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">'api/v2/'</span><span style="color:#D4D4D4">, include(</span><span style="color:#CE9178">'app_v2.urls'</span><span style="color:#D4D4D4">)),  </span><span style="color:#6A9955"># v2のAPI</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">バージョニング方法は、後日別記事で詳しく紹介する予定です。</p>



<h3 id="rtoc-8"  class="wp-block-heading">セキュリティ</h3>



<p class="wp-block-paragraph">CSRF 保護や CORS ヘッダーの管理など、セキュリティ対策が組み込まれています。</p>



<h2 id="rtoc-9"  class="wp-block-heading">DRFを採用するメリット</h2>



<p class="wp-block-paragraph">DRF を採用することで、以下のメリットが得られます。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Django と統合している</li>

<li>高度なシリアライゼーションが可能</li>

<li>細かく認証設定ができる</li>
</ul>
</div></div>



<h3 id="rtoc-10"  class="wp-block-heading">Django と統合している</h3>



<p class="wp-block-paragraph">すでに Python や Django を使い慣れている方には、学習コストを抑えて導入ができます。</p>



<p class="wp-block-paragraph">また、Djangoのモデル、ユーザー認証、管理画面などがそのまま使えることも大きなメリットの一つです。</p>



<h3 id="rtoc-11"  class="wp-block-heading">高度なシリアライゼーションが可能</h3>



<p class="wp-block-paragraph">Django モデルから API に簡単に変換できる仕組みが備わっています。</p>



<p class="wp-block-paragraph">他のフレームワークでは、モデルの変換・複雑なデータモデルのサポート・フィールドレベルのカスタマイズなどが煩雑になりがちですが、Django を使うことでシンプルに記述できるようになります。</p>



<h3 id="rtoc-12"  class="wp-block-heading">細かく認証設定ができる</h3>



<p class="wp-block-paragraph">DRF では標準で「基本認証」「トークン認証」「OAuth」などをサポートしています。</p>



<p class="wp-block-paragraph">さらに、Django 標準で搭載されている「セッション管理」「CSRF」などのセキュリティ機能とも連動。</p>



<p class="wp-block-paragraph">ビューごとに異なる認証方法を採用したり、ユーザーやグループごとに認証方式を変えることもでき、柔軟性の高さが魅力です。</p>



<h2 id="rtoc-13"  class="wp-block-heading">DRFを使ったAPI開発の流れ</h2>



<p class="wp-block-paragraph">ここからは実際に DRF を使った API 開発の流れをお伝えします。</p>



<p class="wp-block-paragraph">基本的な流れとして、以下の流れで説明します。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>プロジェクトのセットアップ</li>

<li>モデルの定義</li>

<li>シリアライザの作成</li>

<li>ビューの作成</li>

<li>ルーティングの設定</li>

<li>認証と権限の設定</li>

<li>テスト</li>
</ul>
</div></div>



<h3 id="rtoc-14"  class="wp-block-heading">① プロジェクトのセットアップ</h3>



<p class="wp-block-paragraph">Django を開発環境にインストールします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install django</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">pip</span><span style="color:#CE9178"> install</span><span style="color:#CE9178"> django</span></span></code></pre></div>



<p class="wp-block-paragraph">続いて Django のプロジェクトをセットアップを行いましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>django-admin startproject projectname</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">django-admin</span><span style="color:#CE9178"> startproject</span><span style="color:#CE9178"> projectname</span></span></code></pre></div>



<p class="wp-block-paragraph">アプリケーションの作成を行いましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>cd projectname
python manage.py startapp api</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">cd</span><span style="color:#CE9178"> projectname</span></span>
<span class="line"><span style="color:#DCDCAA">python</span><span style="color:#CE9178"> manage.py</span><span style="color:#CE9178"> startapp</span><span style="color:#CE9178"> api</span></span></code></pre></div>



<p class="wp-block-paragraph">さらに、DRF を使用するため以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install djangorestframework</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">pip</span><span style="color:#CE9178"> install</span><span style="color:#CE9178"> djangorestframework</span></span></code></pre></div>



<p class="wp-block-paragraph">settings.py に以下を追記して、DRF を使える状態にしましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>INSTALLED_APPS = [
    ...
    'rest_framework',
    'api',
    ...
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">INSTALLED_APPS = [</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#CE9178">    'rest_framework'</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    'api'</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">これでセットアップは完了です。</p>



<h3 id="rtoc-15"  class="wp-block-heading">② モデルの定義</h3>



<p class="wp-block-paragraph">一般的な Django プロジェクトと同様、models.py に以下のような形で記載します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.db import models

class Post(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)

    def __str__(self):
        return self.title</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.db </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> models</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> Post</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">models</span><span style="color:#D4D4D4">.</span><span style="color:#4EC9B0">Model</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    title = models.CharField(</span><span style="color:#9CDCFE">max_length</span><span style="color:#D4D4D4">=</span><span style="color:#B5CEA8">100</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">    content = models.TextField()</span></span>
<span class="line"><span style="color:#D4D4D4">    created_at = models.DateTimeField(</span><span style="color:#9CDCFE">auto_now_add</span><span style="color:#D4D4D4">=</span><span style="color:#569CD6">True</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">    updated_at = models.DateTimeField(</span><span style="color:#9CDCFE">auto_now</span><span style="color:#D4D4D4">=</span><span style="color:#569CD6">True</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> __str__</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#569CD6"> self</span><span style="color:#D4D4D4">.title</span></span></code></pre></div>



<p class="wp-block-paragraph">これをデータベースに適用するため、以下のコマンドを実行してマイグレーションを行いましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>python manage.py makemigrations
python manage.py migrate</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">python</span><span style="color:#CE9178"> manage.py</span><span style="color:#CE9178"> makemigrations</span></span>
<span class="line"><span style="color:#DCDCAA">python</span><span style="color:#CE9178"> manage.py</span><span style="color:#CE9178"> migrate</span></span></code></pre></div>



<h3 id="rtoc-16"  class="wp-block-heading">③ シリアライザの作成</h3>



<p class="wp-block-paragraph">続いてレスポンスとして JSON などを返せるよう、アプリディレクトリ内に serializers.py を作成して以下のように記述しましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from rest_framework import serializers
from .models import Post

class PostSerializer(serializers.ModelSerializer):
    class Meta:
        model = Post
        fields = ['id', 'title', 'content', 'created_at', 'updated_at']</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> serializers</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .models </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Post</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> PostSerializer</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">serializers</span><span style="color:#D4D4D4">.</span><span style="color:#4EC9B0">ModelSerializer</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#569CD6">    class</span><span style="color:#4EC9B0"> Meta</span><span style="color:#D4D4D4">:</span></span>
<span class="line"><span style="color:#D4D4D4">        model = Post</span></span>
<span class="line"><span style="color:#D4D4D4">        fields = [</span><span style="color:#CE9178">'id'</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">'title'</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">'content'</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">'created_at'</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">'updated_at'</span><span style="color:#D4D4D4">]</span></span></code></pre></div>



<h3 id="rtoc-17"  class="wp-block-heading">④ ビューの作成</h3>



<p class="wp-block-paragraph">先ほど作成したシリアライザを “views.py” 内で指定して、JSON 形式でレスポンスを行うように指定します。一覧表示用の<code>PostListView</code>と、詳細表示用の<code>PostDetailView</code>を両方作成します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from rest_framework.generics import ListAPIView, RetrieveAPIView
from .models import Post
from .serializers import PostSerializer

class PostListView(ListAPIView):
    queryset = Post.objects.all()
    serializer_class = PostSerializer

class PostDetailView(RetrieveAPIView):
    queryset = Post.objects.all()
    serializer_class = PostSerializer</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework.generics </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> ListAPIView, RetrieveAPIView</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .models </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Post</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .serializers </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> PostSerializer</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> PostListView</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">ListAPIView</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    queryset = Post.objects.all()</span></span>
<span class="line"><span style="color:#D4D4D4">    serializer_class = PostSerializer</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> PostDetailView</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">RetrieveAPIView</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    queryset = Post.objects.all()</span></span>
<span class="line"><span style="color:#D4D4D4">    serializer_class = PostSerializer</span></span></code></pre></div>



<h3 id="rtoc-18"  class="wp-block-heading">⑤ ルーティングの設定</h3>



<p class="wp-block-paragraph">さらに、エンドポイントの定義を行います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.urls import path
from .views import PostDetailView, PostListView

urlpatterns = [
    path('posts/', PostListView.as_view(), name='post-list'),
    path('posts/&lt;int:pk&gt;/', PostDetailView.as_view(), name='post-detail'),
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> path</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .views </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> PostDetailView, PostListView</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">urlpatterns = [</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">'posts/'</span><span style="color:#D4D4D4">, PostListView.as_view(), </span><span style="color:#9CDCFE">name</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'post-list'</span><span style="color:#D4D4D4">),</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">'posts/&lt;int:pk>/'</span><span style="color:#D4D4D4">, PostDetailView.as_view(), </span><span style="color:#9CDCFE">name</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'post-detail'</span><span style="color:#D4D4D4">),</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<h3 id="rtoc-19"  class="wp-block-heading">⑥ 認証と権限の設定</h3>



<p class="wp-block-paragraph">settings.py に以下のような追記を行います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>INSTALLED_APPS = [
    ...
    'rest_framework',
    'rest_framework.authtoken',
    ...
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">INSTALLED_APPS = [</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#CE9178">    'rest_framework'</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    'rest_framework.authtoken'</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">さらに、urls.py にトークン認証のエンドポイントを追加。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.urls import path
from rest_framework.authtoken.views import obtain_auth_token

urlpatterns = [
    ...
    path('api-token-auth/', obtain_auth_token, name='api_token_auth'),
    ...
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> path</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework.authtoken.views </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> obtain_auth_token</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">urlpatterns = [</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">'api-token-auth/'</span><span style="color:#D4D4D4">, obtain_auth_token, </span><span style="color:#9CDCFE">name</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'api_token_auth'</span><span style="color:#D4D4D4">),</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">そして認証の詳細を定義するため、以下のコードを追記します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from rest_framework.permissions import IsAuthenticated
from rest_framework.views import APIView
from rest_framework.response import Response

class ExampleView(APIView):
    permission_classes = [IsAuthenticated]

    def get(self, request, format=None):
        content = {
            'message': 'Hello, World!'
        }
        return Response(content)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework.permissions </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> IsAuthenticated</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework.views </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> APIView</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework.response </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Response</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> ExampleView</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">APIView</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    permission_classes = [IsAuthenticated]</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> get</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">request</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">format</span><span style="color:#D4D4D4">=</span><span style="color:#569CD6">None</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">        content = {</span></span>
<span class="line"><span style="color:#CE9178">            'message'</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">'Hello, World!'</span></span>
<span class="line"><span style="color:#D4D4D4">        }</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#D4D4D4"> Response(content)</span></span></code></pre></div>



<p class="wp-block-paragraph">IsAuthenticated を指定することで、トークン認証を有効化することができます。</p>



<h3 id="rtoc-20"  class="wp-block-heading">⑦ テスト</h3>



<p class="wp-block-paragraph">最後に test.py などに以下のようなテストコードを記載します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from rest_framework.test import APITestCase
from rest_framework import status
from django.urls import reverse
from .models import Post

class PostAPITest(APITestCase):
    def setUp(self):
        # テスト用のデータを準備
        Post.objects.create(title='Test Post 1', content='Test Content 1')
        Post.objects.create(title='Test Post 2', content='Test Content 2')

    def test_view_posts(self):
        url = reverse('post-list')
        response = self.client.get(url)
        self.assertEqual(response.status_code, status.HTTP_200_OK)
        self.assertEqual(len(response.data), 2)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework.test </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> APITestCase</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> rest_framework </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> status</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> reverse</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .models </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Post</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> PostAPITest</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">APITestCase</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> setUp</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#6A9955">        # テスト用のデータを準備</span></span>
<span class="line"><span style="color:#D4D4D4">        Post.objects.create(</span><span style="color:#9CDCFE">title</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'Test Post 1'</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">content</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'Test Content 1'</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">        Post.objects.create(</span><span style="color:#9CDCFE">title</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'Test Post 2'</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">content</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'Test Content 2'</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> test_view_posts</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">        url = reverse(</span><span style="color:#CE9178">'post-list'</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">        response = </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">.client.get(url)</span></span>
<span class="line"><span style="color:#569CD6">        self</span><span style="color:#D4D4D4">.assertEqual(response.status_code, status.HTTP_200_OK)</span></span>
<span class="line"><span style="color:#569CD6">        self</span><span style="color:#D4D4D4">.assertEqual(</span><span style="color:#DCDCAA">len</span><span style="color:#D4D4D4">(response.data), </span><span style="color:#B5CEA8">2</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">これで基本的な API 作成は完了です。</p>



<h2 id="rtoc-21"  class="wp-block-heading">DRFをさらに使いこなす実装例</h2>



<p class="wp-block-paragraph">次のような DRF の標準機能を拡張する方法をお伝えします。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>CORS ヘッダーを付与する</li>

<li>API Key 認証を追加する</li>

<li>画像アップロード機能を実装する</li>
</ul>
</div></div>



<h3 id="rtoc-22"  class="wp-block-heading">CORSヘッダーを付与する</h3>



<p class="wp-block-paragraph">フロントエンドとして React などの JavaScript フレームワークを使う場合には、 CORS 対策を行うことがあります。</p>



<p class="wp-block-paragraph">以下の記事では、”django-cors-headers” を利用した実装方法をご紹介しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-rest-cors-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-rest-cors/">Django REST framework で CORS 対策をする方法</a>
						<span class="p-blogCard__excerpt">Django REST framework で CORS エラーが出ている… このような場合の対策をお伝えします。 Django REST framework（以下「DRF」とします）では、外部ライブラリを使うこ&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 id="rtoc-23"  class="wp-block-heading">API Key認証を追加する</h3>



<p class="wp-block-paragraph">サードパーティライブラリ “restframework-api-key” を使えば、 API Key 認証機能を追加することができます。</p>



<p class="wp-block-paragraph">詳しい実装方法は、後日別記事で解説する予定です。</p>



<h3 id="rtoc-24"  class="wp-block-heading">画像アップロード機能を実装する</h3>



<p class="wp-block-paragraph">API に画像アップロード機能を実装するには、少し工夫が必要です。</p>



<p class="wp-block-paragraph">以下の記事で詳細を解説しましたので、ご覧ください。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-drf-upload-image/">【Django REST framework】画像ファイルアップロード機能の実装方法</a>
						<span class="p-blogCard__excerpt">Django REST framework で画像アップロード機能を実装したい！ Django REST framework（以下、「DRF」とします）で画像アップロード機能を実装するには、いくつかのステ&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 id="rtoc-25"  class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">Python で API 開発をする場合、真っ先に候補に上がるのが DRF になると思います。</p>



<p class="wp-block-paragraph">本記事では DRF の全体像をざっと見渡してきました。</p>



<p class="wp-block-paragraph">本ブログでは Python を中心としてプログラミングに関する情報を発信しています。</p>



<p class="wp-block-paragraph">ぜひ、他の記事にも目を通してみてください。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【Django】モデル・マイグレーション完全ガイド｜フィールド設計からリレーションまで徹底解説</title>
		<link>https://cfxlog.com/python-django-models-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Fri, 31 Jul 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5095</guid>

					<description><![CDATA[Djangoに触り始めた頃、モデルの前にまずデータベースそのものをよく知りませんでした。 モデルのクラス定義自体はPythonなので読めます。ただ、フィールドの引数に何を設定できるのか、それがDB側でどういう意味を持つの [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">Djangoに触り始めた頃、モデルの前にまずデータベースそのものをよく知りませんでした。</p>



<p class="wp-block-paragraph">モデルのクラス定義自体はPythonなので読めます。ただ、フィールドの引数に何を設定できるのか、それがDB側でどういう意味を持つのかがわからず、最初はそこでつまずきました。</p>



<p class="wp-block-paragraph">この記事では、<strong>モデルの基本的な書き方から、よく使うフィールドの種類、リレーション設計、マイグレーションの仕組み</strong>までを解説します。</p>



<p class="wp-block-paragraph">Djangoのプロジェクト構成がまだの方は、先にこちらを読んでおくとスムーズです。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-project-setup-300x157.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-project-setup/">【Django】プロジェクトとアプリの設定方法まとめ</a>
						<span class="p-blogCard__excerpt">Djangoの開発を始めるための準備が知りたい！ 普通にPythonでコーディングするのと違って、Djangoの開発では細々した準備が必要です。 内容をざっと列挙すると以下の通&#8230;</span>					</div>
				</div>
			</div>
		</div>


<div id="rtoc-mokuji-wrapper" class="rtoc-mokuji-content frame2 preset5 animation-fade rtoc_open default" data-id="5095" data-theme="SWELL CHILD">
			<div id="rtoc-mokuji-title" class=" rtoc_left">
			<button class="rtoc_open_close rtoc_open"></button>
			<span>目次</span>
			</div><ol class="rtoc-mokuji mokuji_ol level-1"><li class="rtoc-item"><a href="#rtoc-1">Djangoモデルとは何か</a></li><li class="rtoc-item"><a href="#rtoc-2">フィールドの引数、最初はここでつまずいた</a></li><li class="rtoc-item"><a href="#rtoc-3">よく使うフィールドタイプ</a></li><li class="rtoc-item"><a href="#rtoc-4">テーブル同士をつなぐ：リレーション設計</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-5">フィールド設計に固定ルールは持っていない</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-6">マイグレーションを実行する</a></li><li class="rtoc-item"><a href="#rtoc-7">まとめ</a></li></ol></div><h2 id="rtoc-1"  class="wp-block-heading">Djangoモデルとは何か</h2>



<p class="wp-block-paragraph">Djangoのモデルは、データベースのテーブルをPythonのクラスとして表現したものです。モデルクラス1つが、テーブル1つに対応します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.db import models

class Article(models.Model):
    title = models.CharField(max_length=100)
    body = models.TextField()
    published_at = models.DateTimeField(auto_now_add=True)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.db </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> models</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> Article</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">models</span><span style="color:#D4D4D4">.</span><span style="color:#4EC9B0">Model</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    title = models.CharField(</span><span style="color:#9CDCFE">max_length</span><span style="color:#D4D4D4">=</span><span style="color:#B5CEA8">100</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">    body = models.TextField()</span></span>
<span class="line"><span style="color:#D4D4D4">    published_at = models.DateTimeField(</span><span style="color:#9CDCFE">auto_now_add</span><span style="color:#D4D4D4">=</span><span style="color:#569CD6">True</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">クラス変数の1つ1つがテーブルのカラムになります。<code>CharField</code>や<code>TextField</code>といった型の指定が、SQLで言う<code>VARCHAR</code>や<code>TEXT</code>にあたります。SQLを自分で書く必要はありません。</p>



<h2 id="rtoc-2"  class="wp-block-heading">フィールドの引数、最初はここでつまずいた</h2>



<p class="wp-block-paragraph">フィールドにはそれぞれ引数があります。<code>CharField(max_length=100)</code>の<code>max_length</code>のような部分です。</p>



<p class="wp-block-paragraph">僕がつまずいたのはここでした。DBを触ったことがなかったので、「なぜ文字列に長さの上限を指定する必要があるのか」からしてピンときていませんでした。よく使う引数だけ、先に押さえておきます。</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>引数</th><th>意味</th></tr></thead><tbody><tr><td>max_length</td><td>文字列の最大長（CharFieldで必須）</td></tr><tr><td>null</td><td>DB側でNULLを許可するか</td></tr><tr><td>blank</td><td>フォーム入力で空欄を許可するか</td></tr><tr><td>default</td><td>デフォルト値</td></tr><tr><td>unique</td><td>値の重複を許可しないか</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">特に<code>null</code>と<code>blank</code>は名前が似ていて紛らわしいポイントです。<code>null</code>はDBの制約、<code>blank</code>はフォームバリデーションの話。役割が違うので、両方Trueにしたい場面以外は分けて考えるようにしています。</p>



<h2 id="rtoc-3"  class="wp-block-heading">よく使うフィールドタイプ</h2>



<p class="wp-block-paragraph">実務でよく使うフィールドはそれほど多くありません。まずはこのあたりを覚えておけば大抵の場面に対応できます。</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>フィールド</th><th>用途</th></tr></thead><tbody><tr><td>CharField</td><td>短い文字列（名前・タイトルなど）</td></tr><tr><td>TextField</td><td>長い文字列（本文など）</td></tr><tr><td>IntegerField</td><td>整数</td></tr><tr><td>BooleanField</td><td>True / False</td></tr><tr><td>DateTimeField</td><td>日時</td></tr><tr><td>ForeignKey</td><td>他のテーブルとの多対1のリレーション</td></tr></tbody></table></figure>



<h2 id="rtoc-4"  class="wp-block-heading">テーブル同士をつなぐ：リレーション設計</h2>



<p class="wp-block-paragraph">テーブル同士を関連づけるには<code>ForeignKey</code>を使います。「1人のユーザーが複数の記事を書く」というような、多対1の関係を表現できます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.conf import settings
from django.db import models

class Article(models.Model):
    title = models.CharField(max_length=100)
    author = models.ForeignKey(
        settings.AUTH_USER_MODEL,
        on_delete=models.CASCADE,
        related_name="articles",
    )</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.conf </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> settings</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.db </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> models</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> Article</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">models</span><span style="color:#D4D4D4">.</span><span style="color:#4EC9B0">Model</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    title = models.CharField(</span><span style="color:#9CDCFE">max_length</span><span style="color:#D4D4D4">=</span><span style="color:#B5CEA8">100</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">    author = models.ForeignKey(</span></span>
<span class="line"><span style="color:#D4D4D4">        settings.AUTH_USER_MODEL,</span></span>
<span class="line"><span style="color:#9CDCFE">        on_delete</span><span style="color:#D4D4D4">=models.CASCADE,</span></span>
<span class="line"><span style="color:#9CDCFE">        related_name</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"articles"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    )</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>on_delete</code>は、参照先（ここではユーザー）が削除されたときの挙動です。<code>CASCADE</code>を指定すると、ユーザーが削除された時に紐づく記事も一緒に削除されます。<code>related_name</code>を指定しておくと、ユーザー側から<code>user.articles.all()</code>のように逆方向にたどれるようになります。</p>



<h3 id="rtoc-5"  class="wp-block-heading">フィールド設計に固定ルールは持っていない</h3>



<p class="wp-block-paragraph">「このケースは必ずこう設計する」という固定のルールは、正直あまり持っていません。実際の運用を考えて、そのつど判断するようにしています。</p>



<p class="wp-block-paragraph">たとえば同じ「日付」でも、後から変更されうるデータなのか、記録として残すだけのデータなのかで、<code>null</code>を許可するかどうかの判断は変わります。設計を先に完璧に詰めるより、実際にどう使われるかをイメージしながら決めるほうが、結果的にうまくいく感覚があります。</p>



<h2 id="rtoc-6"  class="wp-block-heading">マイグレーションを実行する</h2>



<p class="wp-block-paragraph">モデルを書いただけでは、まだDBにテーブルは作られません。<strong>マイグレーション</strong>という仕組みを通して、モデルの定義をDBに反映します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># モデルの変更内容から、マイグレーションファイルを生成
python manage.py makemigrations

# 生成されたマイグレーションをDBに適用
python manage.py migrate</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># モデルの変更内容から、マイグレーションファイルを生成</span></span>
<span class="line"><span style="color:#DCDCAA">python</span><span style="color:#CE9178"> manage.py</span><span style="color:#CE9178"> makemigrations</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 生成されたマイグレーションをDBに適用</span></span>
<span class="line"><span style="color:#DCDCAA">python</span><span style="color:#CE9178"> manage.py</span><span style="color:#CE9178"> migrate</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>makemigrations</code>が「変更内容の差分」を記録したファイルを作り、<code>migrate</code>がそれを実際にDBへ適用する。この2段階に分かれているおかげで、適用前に差分の内容を確認できます。</p>



<h2 id="rtoc-7"  class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">Djangoのモデルは、SQLを直接書かなくてもDBを操作できる仕組みです。フィールドの型・引数・リレーションの基本を押さえれば、あとは実際の運用に合わせて設計を調整していけば十分です。</p>



<p class="wp-block-paragraph">DBを触ったことがない方にとっては、Djangoのモデルを通すことで、直感的にDBの考え方を学べるはずです。僕自身、DBの知識はDjangoのモデルを書きながら身についていきました。</p>



<p class="wp-block-paragraph">モデルが書けるようになったら、次はそのデータを画面に表示するビューとURLルーティングに進みましょう。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-views-guide/">【Django】ビュー・URLルーティング完全ガイド｜FBV・CBV・URLconfを徹底解説</a>
						<span class="p-blogCard__excerpt">Djangoのビューには、関数で書くFBV（Function Based View）と、クラスで書くCBV（Class Based View）の2種類があります。 最初にCBVを見たとき、正直よくわかりません&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">Django全体のロードマップに戻りたい方はこちらからどうぞ。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-guide/">Django完全入門ガイド｜MTVの基本から認証・API・デプロイまで全ステップ解説</a>
						<span class="p-blogCard__excerpt">Djangoって何から始めればいいの？ MTVの構造がよくわからない 認証やAPI連携、本番デプロイまで一通り学びたい このような疑問にお答えします。 Djangoは、Pythonで書&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【Django】ビュー・URLルーティング完全ガイド｜FBV・CBV・URLconfを徹底解説</title>
		<link>https://cfxlog.com/python-django-views-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Fri, 31 Jul 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5096</guid>

					<description><![CDATA[Djangoのビューには、関数で書くFBV（Function Based View）と、クラスで書くCBV（Class Based View）の2種類があります。 最初にCBVを見たとき、正直よくわかりませんでした。継承 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">Djangoのビューには、関数で書くFBV（Function Based View）と、クラスで書くCBV（Class Based View）の2種類があります。</p>



<p class="wp-block-paragraph">最初にCBVを見たとき、正直よくわかりませんでした。継承元のクラスが裏側で何をやっているのか見えず、「なぜこれで動くのか」がピンとこなかったからです。その点、FBVは処理がそのまま関数に書いてあるので直感的でした。</p>



<p class="wp-block-paragraph">この記事では、<strong>URLconfの基本、FBVとCBVそれぞれの書き方、実務での使い分け</strong>を解説します。</p>



<p class="wp-block-paragraph">モデルの基本がまだの方は、先にこちらを読んでおくとつながりがわかりやすいです。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-models-guide/">【Django】モデル・マイグレーション完全ガイド｜フィールド設計からリレーションまで徹底解説</a>
						<span class="p-blogCard__excerpt">Djangoに触り始めた頃、モデルの前にまずデータベースそのものをよく知りませんでした。 モデルのクラス定義自体はPythonなので読めます。ただ、フィールドの引数に何を&#8230;</span>					</div>
				</div>
			</div>
		</div>


<div id="rtoc-mokuji-wrapper" class="rtoc-mokuji-content frame2 preset5 animation-fade rtoc_open default" data-id="5096" data-theme="SWELL CHILD">
			<div id="rtoc-mokuji-title" class=" rtoc_left">
			<button class="rtoc_open_close rtoc_open"></button>
			<span>目次</span>
			</div><ol class="rtoc-mokuji mokuji_ol level-1"><li class="rtoc-item"><a href="#rtoc-1">URLconfの基本</a></li><li class="rtoc-item"><a href="#rtoc-2">FBV：関数でそのまま処理を書く</a></li><li class="rtoc-item"><a href="#rtoc-3">CBV：クラスの継承で処理をまとめる</a></li><li class="rtoc-item"><a href="#rtoc-4">実務ではCBVを基本にしている</a></li><li class="rtoc-item"><a href="#rtoc-5">まとめ</a></li></ol></div><h2 id="rtoc-1"  class="wp-block-heading">URLconfの基本</h2>



<p class="wp-block-paragraph">Djangoでは、URLとビューの対応を<code>urls.py</code>にまとめて書きます。この対応表のことをURLconfと呼びます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># urls.py
from django.urls import path
from . import views

urlpatterns = [
    path("articles/", views.article_list),
    path("articles/&lt;int:pk&gt;/", views.article_detail),
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># urls.py</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> path</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> . </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> views</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">urlpatterns = [</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"articles/"</span><span style="color:#D4D4D4">, views.article_list),</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"articles/&lt;int:pk>/"</span><span style="color:#D4D4D4">, views.article_detail),</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>&lt;int:pk&gt;</code>の部分はパスパラメータです。URLの一部を変数として受け取り、ビュー側の引数に渡してくれます。</p>



<h2 id="rtoc-2"  class="wp-block-heading">FBV：関数でそのまま処理を書く</h2>



<p class="wp-block-paragraph">FBVは、リクエストを受け取ってレスポンスを返すだけの、ただの関数です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># views.py
from django.shortcuts import render, get_object_or_404
from .models import Article

def article_list(request):
    articles = Article.objects.all()
    return render(request, "articles/list.html", {"articles": articles})

def article_detail(request, pk):
    article = get_object_or_404(Article, pk=pk)
    return render(request, "articles/detail.html", {"article": article})</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># views.py</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.shortcuts </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> render, get_object_or_404</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .models </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Article</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">def</span><span style="color:#DCDCAA"> article_list</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">request</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    articles = Article.objects.all()</span></span>
<span class="line"><span style="color:#C586C0">    return</span><span style="color:#D4D4D4"> render(request, </span><span style="color:#CE9178">"articles/list.html"</span><span style="color:#D4D4D4">, {</span><span style="color:#CE9178">"articles"</span><span style="color:#D4D4D4">: articles})</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">def</span><span style="color:#DCDCAA"> article_detail</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">request</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">pk</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    article = get_object_or_404(Article, </span><span style="color:#9CDCFE">pk</span><span style="color:#D4D4D4">=pk)</span></span>
<span class="line"><span style="color:#C586C0">    return</span><span style="color:#D4D4D4"> render(request, </span><span style="color:#CE9178">"articles/detail.html"</span><span style="color:#D4D4D4">, {</span><span style="color:#CE9178">"article"</span><span style="color:#D4D4D4">: article})</span></span></code></pre></div>



<p class="wp-block-paragraph">上から下に処理を読めば、何をやっているかがそのままわかります。これがFBVの一番の強みです。</p>



<h2 id="rtoc-3"  class="wp-block-heading">CBV：クラスの継承で処理をまとめる</h2>



<p class="wp-block-paragraph">CBVは、Django側が用意した汎用クラスを継承して書きます。同じ処理をFBVより少ないコードで書けます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># views.py
from django.views.generic import ListView, DetailView
from .models import Article

class ArticleListView(ListView):
    model = Article
    template_name = "articles/list.html"
    context_object_name = "articles"

class ArticleDetailView(DetailView):
    model = Article
    template_name = "articles/detail.html"
    context_object_name = "article"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># views.py</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.views.generic </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> ListView, DetailView</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> .models </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Article</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> ArticleListView</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">ListView</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    model = Article</span></span>
<span class="line"><span style="color:#D4D4D4">    template_name = </span><span style="color:#CE9178">"articles/list.html"</span></span>
<span class="line"><span style="color:#D4D4D4">    context_object_name = </span><span style="color:#CE9178">"articles"</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> ArticleDetailView</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">DetailView</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    model = Article</span></span>
<span class="line"><span style="color:#D4D4D4">    template_name = </span><span style="color:#CE9178">"articles/detail.html"</span></span>
<span class="line"><span style="color:#D4D4D4">    context_object_name = </span><span style="color:#CE9178">"article"</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>ListView</code>・<code>DetailView</code>は、それぞれ一覧表示・詳細表示によく使う処理をあらかじめ実装してくれています。urls.pyでは<code>.as_view()</code>を付けて登録します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># urls.py
from django.urls import path
from . import views

urlpatterns = [
    path("articles/", views.ArticleListView.as_view()),
    path("articles/&lt;int:pk&gt;/", views.ArticleDetailView.as_view()),
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># urls.py</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> path</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> . </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> views</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">urlpatterns = [</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"articles/"</span><span style="color:#D4D4D4">, views.ArticleListView.as_view()),</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"articles/&lt;int:pk>/"</span><span style="color:#D4D4D4">, views.ArticleDetailView.as_view()),</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<h2 id="rtoc-4"  class="wp-block-heading">実務ではCBVを基本にしている</h2>



<p class="wp-block-paragraph">使い分けとしては、基本的にCBVを使っています。FBVを使うのは、そのほうが実装として合理的で簡単に済む場合だけです。</p>



<p class="wp-block-paragraph">一覧・詳細・作成・更新・削除といった定型的な処理は、CBVに任せたほうがコード量が少なく済みます。逆に、複数のモデルにまたがる処理や、条件分岐が複雑な処理は、CBVの継承構造に無理やり当てはめるよりFBVで素直に書いたほうが読みやすいことが多いです。</p>



<p class="wp-block-paragraph">CBVの「裏側が見えにくい」という感覚は、正直今でも完全になくなったわけではありません。ただ、使いながら少しずつ「このクラスはこのメソッドをオーバーライドすれば挙動を変えられる」というパターンがわかってきて、慣れとともに理解できるようになっていきました。</p>



<h2 id="rtoc-5"  class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">URLconfでURLとビューを対応づけ、ビューではFBVかCBVで処理を書く。これがDjangoのリクエスト処理の基本形です。</p>



<p class="wp-block-paragraph">CBVは最初、裏側の動きが見えずに戸惑うかもしれません。それでも大丈夫です。使いながら少しずつ慣れていけば、自然と理解できるようになります。</p>



<p class="wp-block-paragraph">ビューが書けるようになったら、次は画面表示を担うテンプレートに進みましょう。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/08/python-django-templates-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-templates-guide/">【Django】テンプレート・静的ファイル完全ガイド｜継承・フィルタ・CSS/JS管理まで解説</a>
						<span class="p-blogCard__excerpt">Djangoのテンプレートを初めて触ったとき、普通のHTMLよりも少しオブジェクト指向的な考え方が必要で、理解するまで少し時間がかかりました。 変数を埋め込むだけならま&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">Django全体のロードマップに戻りたい方はこちらからどうぞ。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-guide/">Django完全入門ガイド｜MTVの基本から認証・API・デプロイまで全ステップ解説</a>
						<span class="p-blogCard__excerpt">Djangoって何から始めればいいの？ MTVの構造がよくわからない 認証やAPI連携、本番デプロイまで一通り学びたい このような疑問にお答えします。 Djangoは、Pythonで書&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Django完全入門ガイド｜MTVの基本から認証・API・デプロイまで全ステップ解説</title>
		<link>https://cfxlog.com/python-django-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Fri, 31 Jul 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<guid isPermaLink="false">https://cfxlog.com/python-django-guide/</guid>

					<description><![CDATA[このような疑問にお答えします。 Djangoは、Pythonで書けるWebフレームワークです。モデル・認証・管理画面といった、Webアプリに必要な機能が最初から揃っています。 このガイドでは、Djangoの基本的な考え方 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Djangoって何から始めればいいの？</li>

<li>MTVの構造がよくわからない</li>

<li>認証やAPI連携、本番デプロイまで一通り学びたい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような疑問にお答えします。</p>



<p class="wp-block-paragraph">Djangoは、Pythonで書けるWebフレームワークです。モデル・認証・管理画面といった、Webアプリに必要な機能が最初から揃っています。</p>



<p class="wp-block-paragraph">このガイドでは、<strong>Djangoの基本的な考え方から、実際に画面を表示するところまで</strong>をステップ順に解説します。<br>記事後半には、モデル・認証・API・デプロイなど、テーマ別の詳細ガイドへのロードマップも用意しました。「どこから学べばいいかわからない」という悩みは、これで解消できるはずです。</p>



<div id="rtoc-mokuji-wrapper" class="rtoc-mokuji-content frame2 preset5 animation-fade rtoc_open default" data-id="5401" data-theme="SWELL CHILD">
			<div id="rtoc-mokuji-title" class=" rtoc_left">
			<button class="rtoc_open_close rtoc_open"></button>
			<span>目次</span>
			</div><ol class="rtoc-mokuji mokuji_ol level-1"><li class="rtoc-item"><a href="#rtoc-1">Djangoとは何か</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-2">なぜDjangoを選ぶのか</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-3">Djangoを始める前の準備</a></li><li class="rtoc-item"><a href="#rtoc-4">Djangoの基本的な考え方</a></li><li class="rtoc-item"><a href="#rtoc-5">はじめての画面を表示してみよう</a></li><li class="rtoc-item"><a href="#rtoc-6">Django学習ロードマップ</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-7">Step 1：プロジェクトを立ち上げる</a></li><li class="rtoc-item"><a href="#rtoc-8">Step 2：モデル・データベースを扱う</a></li><li class="rtoc-item"><a href="#rtoc-9">Step 3：ビュー・URLルーティングを書く</a></li><li class="rtoc-item"><a href="#rtoc-10">Step 4：認証を実装する</a></li><li class="rtoc-item"><a href="#rtoc-11">Step 5：テンプレート・フロントと繋ぐ</a></li><li class="rtoc-item"><a href="#rtoc-12">Step 6：REST APIを公開する</a></li><li class="rtoc-item"><a href="#rtoc-13">Step 7：テストを書く</a></li><li class="rtoc-item"><a href="#rtoc-14">Step 8：運用を効率化する</a></li><li class="rtoc-item"><a href="#rtoc-15">Step 9：本番にデプロイする</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-16">こんなことをしたい → どの記事を読む？逆引きナビ</a></li><li class="rtoc-item"><a href="#rtoc-17">まとめ</a></li></ol></div><h2 id="rtoc-1"  class="wp-block-heading">Djangoとは何か</h2>



<p class="wp-block-paragraph">Djangoは、Pythonで書かれたWebフレームワークです。データベースとのやり取り、URL設計、管理画面、認証など、Webアプリでほぼ必ず必要になる機能が標準で用意されています。</p>



<p class="wp-block-paragraph">Djangoの設計は<strong>MTV（Model・Template・View）</strong>という3つの役割に分かれています。</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>要素</th><th>役割</th></tr></thead><tbody><tr><td>Model</td><td>データベースの構造・データのやり取り</td></tr><tr><td>Template</td><td>画面に表示するHTML</td></tr><tr><td>View</td><td>リクエストを受けてModelとTemplateをつなぐ処理</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">一般的なMVCと呼び方が違うだけで、考え方はほぼ同じです。「データ」「画面」「つなぐ処理」の3つに分かれている、とだけ覚えておけば十分です。</p>



<h3 id="rtoc-2"  class="wp-block-heading">なぜDjangoを選ぶのか</h3>



<p class="wp-block-paragraph">正直なところ、バックエンドの言語やフレームワークは、使い慣れたものを自由に選べばいいと思っています。他に慣れている言語があるなら、そちらで作っても何の問題もありません。</p>



<p class="wp-block-paragraph">僕がDjangoを選んでいるのは、単純にPythonに慣れているからです。認証・管理画面・ORMといった機能が最初から揃っているので、Pythonが書けるなら学習コストは低めです。</p>



<h2 id="rtoc-3"  class="wp-block-heading">Djangoを始める前の準備</h2>



<p class="wp-block-paragraph">環境構築の細かい手順は、後半のロードマップ内の記事にまとめています。ここでは全体の流れだけ押さえておきます。</p>



<p class="wp-block-paragraph">大まかな流れは、<strong>仮想環境の作成 → Djangoのインストール → プロジェクトの作成 → アプリの作成</strong>の4ステップです。プロジェクトが「サイト全体の入れ物」、アプリが「機能ごとの部品」という関係になっています。</p>



<h2 id="rtoc-4"  class="wp-block-heading">Djangoの基本的な考え方</h2>



<p class="wp-block-paragraph">僕自身、Djangoが最初に触ったWebフレームワークだったので、正直はじめは全部につまずきました。</p>



<p class="wp-block-paragraph">中でも馴染めなかったのが、<strong>フレームワーク特有の「お作法」を、途中の理屈を全部理解する前に「そういうものだ」と割り切って受け入れる</strong>ことでした。「なぜこのファイルにこう書くのか」を最初から全部理解しようとすると、手が止まってしまいます。</p>



<p class="wp-block-paragraph">Djangoには、settings.pyで設定を管理する、urls.pyでルーティングを書く、views.pyで処理を書く、といった「決まった置き場所」があります。まずはこの型をなぞって動かしてみて、理屈は後から追いつけばいいというくらいの気持ちで進めるのがおすすめです。</p>



<h2 id="rtoc-5"  class="wp-block-heading">はじめての画面を表示してみよう</h2>



<p class="wp-block-paragraph">理屈の説明が続いたので、実際に画面を表示するところまでやってみましょう。urls.pyとviews.pyだけで完結する、最小構成の例です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># views.py
from django.http import HttpResponse

def hello(request):
    return HttpResponse("Hello, Django!")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># views.py</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.http </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> HttpResponse</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">def</span><span style="color:#DCDCAA"> hello</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">request</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#C586C0">    return</span><span style="color:#D4D4D4"> HttpResponse(</span><span style="color:#CE9178">"Hello, Django!"</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># urls.py
from django.urls import path
from . import views

urlpatterns = [
    path("hello/", views.hello),
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># urls.py</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> path</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> . </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> views</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">urlpatterns = [</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"hello/"</span><span style="color:#D4D4D4">, views.hello),</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">「/hello/」にアクセスすると、views.pyのhello関数が呼ばれ、urls.pyがそのURLとの対応を管理する。これがDjangoのリクエスト処理の基本形です。実際のアプリではここにModelやTemplateが加わりますが、骨格はこの2ファイルの関係と変わりません。</p>



<h2 id="rtoc-6"  class="wp-block-heading">Django学習ロードマップ</h2>



<p class="wp-block-paragraph">基本が掴めたら、次のステップに進みましょう。以下はCFXLOGのDjango関連記事一覧です。テーマ別にまとめているので、気になるテーマから読み進めてください。</p>



<h3 id="rtoc-7"  class="wp-block-heading">Step 1：プロジェクトを立ち上げる</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-project-setup-300x157.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-project-setup/">【Django】プロジェクトとアプリの設定方法まとめ</a>
						<span class="p-blogCard__excerpt">Djangoの開発を始めるための準備が知りたい！ 普通にPythonでコーディングするのと違って、Djangoの開発では細々した準備が必要です。 内容をざっと列挙すると以下の通&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-settings-best-practices-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-settings-best-practices/">【Django】settings.pyの僕的ベストプラクティスをご紹介</a>
						<span class="p-blogCard__excerpt">settings.pyのベストプラクティスが知りたい！ 本記事では、僕が個人開発で使っているsettings.pyの内容を公開します。 ぜひ参考にしてみてください。 【Django】settin&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 id="rtoc-8"  class="wp-block-heading">Step 2：モデル・データベースを扱う</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-models-guide/">【Django】モデル・マイグレーション完全ガイド｜フィールド設計からリレーションまで徹底解説</a>
						<span class="p-blogCard__excerpt">Djangoに触り始めた頃、モデルの前にまずデータベースそのものをよく知りませんでした。 モデルのクラス定義自体はPythonなので読めます。ただ、フィールドの引数に何を&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/02/python-django-queryset-cheatsheet-300x157.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-queryset-cheatsheet/">【Django】QuerySetの使い方まとめ【ORM操作を一気に理解するチートシート】</a>
						<span class="p-blogCard__excerpt">Django の QuerySet 操作を逆引きで調べたい！ このような方に向けて、Django でよく使う操作を中心にまとめました。 各メソッドの説明はジャンルに分けてありますので&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-get-age-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-get-age/">【Django】最新の年齢を取得し続ける2つの方法</a>
						<span class="p-blogCard__excerpt">ユーザーの年齢は常に最新の値が欲しい！ このような方に向けて書きました。 本記事では最新の年齢を取得し続けるための方法を解説します。 年齢をデータベースで年齢を&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-docker-migrations-fix/">【Django × Docker】開発中のマイグレーション不整合問題はどう対処する？DBを消す場合・消さない場合の&#8230;</a>
						<span class="p-blogCard__excerpt">Django 開発でよく発生するのが、マイグレーションとデータベースの不整合。特に Docker でデプロイしながら開発していると、 ローカルでマイグレーションをやり直した &#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 id="rtoc-9"  class="wp-block-heading">Step 3：ビュー・URLルーティングを書く</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-views-guide/">【Django】ビュー・URLルーティング完全ガイド｜FBV・CBV・URLconfを徹底解説</a>
						<span class="p-blogCard__excerpt">Djangoのビューには、関数で書くFBV（Function Based View）と、クラスで書くCBV（Class Based View）の2種類があります。 最初にCBVを見たとき、正直よくわかりません&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 id="rtoc-10"  class="wp-block-heading">Step 4：認証を実装する</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-custom-user-model/">【Django】カスタムユーザーモデルの作り方【認証】</a>
						<span class="p-blogCard__excerpt">カスタムユーザーモデルの概念がどうしても理解できない 標準のUserモデルからカスタムユーザーモデルへの変更方法が知りたい Djangoには標準でログインなどの認証に使&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-allauth-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-allauth-guide/">django-allauthのデフォルト機能だけで高度な認証機能を実装する方法</a>
						<span class="p-blogCard__excerpt">django-allauthで認証を実装したい まずは基本の実装方法が知りたい Djangoはデフォルトでも認証機能を実装していますが、より高度な認証を行うにはdjango-allauthを使&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-allauth-admin-login-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-allauth-admin-login/">Google認証後に管理画面にログインできない【django-allauth】</a>
						<span class="p-blogCard__excerpt">Google認証で作ったユーザーで管理ページにログインしたい！ このような方に向けて書きました。 Google認証でユーザー作成すると、次の理由でDjangoの管理サイトにログ&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-login-logout-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-login-logout/">【Django】ログイン・ログアウト機能と表示するページの制御方法</a>
						<span class="p-blogCard__excerpt">Django に認証機能を実装したい 認証状況ごとに表示するページを変えたい Djangoでは標準でログイン・ログアウト関連のモジュールが実装されています。 そのため、簡単&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 id="rtoc-11"  class="wp-block-heading">Step 5：テンプレート・フロントと繋ぐ</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/08/python-django-templates-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-templates-guide/">【Django】テンプレート・静的ファイル完全ガイド｜継承・フィルタ・CSS/JS管理まで解説</a>
						<span class="p-blogCard__excerpt">Djangoのテンプレートを初めて触ったとき、普通のHTMLよりも少しオブジェクト指向的な考え方が必要で、理解するまで少し時間がかかりました。 変数を埋め込むだけならま&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-global-navigation-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-global-navigation/">【簡単】Djangoで基本のグローバルメニューを作る方法</a>
						<span class="p-blogCard__excerpt">Djangoでグローバルメニューを作りたい！ CSSファイルってどこに配置したら良いの？ このような疑問にお答えします。 テンプレートHTMLを作り込もうとした場合に、最初&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-tailwind-setup-300x171.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-tailwind-setup/">【TailwindCSS】 django-tailwind のセットアップ方法と使い方</a>
						<span class="p-blogCard__excerpt">Django で TailwindCSS を使いたい セットアップ手順は？ 簡単な使い方が知りたい 最近の求人を見渡していると、技術スタックで TailwindCSS を求められることが増えて&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/02/python-django-templates-ga4-setup-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-templates-ga4-setup/">DjangoテンプレートでGoogle Analytics（GA4）を実装する方法【本番のみ有効化】</a>
						<span class="p-blogCard__excerpt">GA4を環境変数でON/OFF制御したい 本番環境だけで計測したい メンテナンスコストを低く抑えたい このような方に向けて書きました。 Django プロジェクトに Google Analy&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/code-python-django-css-not-applied/">Django開発で「CSSが反映されない問題」を確実に解決する最小構成</a>
						<span class="p-blogCard__excerpt">スマホ実機・本番環境でもキャッシュを100%破壊する方法をご紹介します。 Django でスタイルを調整していると、CSS が反映されないことはよく遭遇します。 特にスマホ（&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 id="rtoc-12"  class="wp-block-heading">Step 6：REST APIを公開する</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-rest-cors-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-rest-cors/">Django REST framework で CORS 対策をする方法</a>
						<span class="p-blogCard__excerpt">Django REST framework で CORS エラーが出ている… このような場合の対策をお伝えします。 Django REST framework（以下「DRF」とします）では、外部ライブラリを使うこ&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-rest-framework-basic-auth-method/">【Basic, Token, Session】デフォルトで用意された3つの認証クラス入門【Django REST Framework】</a>
						<span class="p-blogCard__excerpt">Django REST Framework（DRF）には、デフォルトで3つの認証機能が搭載されています。 認証機能は認証クラス(authentication classes)で設定し、リクエストが誰からのも&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-rest-framework-version-management/">APIのバージョン管理（/api/v1/…）設計方法【Django REST framework】</a>
						<span class="p-blogCard__excerpt">既存クライアントに影響を与えずにAPIの仕様を変更したい 複数バージョンをどのように分けて設計・管理すればよいか分からない 将来的な拡張を見据えて、最初から正しい&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-drf-upload-image/">【Django REST framework】画像ファイルアップロード機能の実装方法</a>
						<span class="p-blogCard__excerpt">Django REST framework で画像アップロード機能を実装したい！ Django REST framework（以下、「DRF」とします）で画像アップロード機能を実装するには、いくつかのステ&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">投稿が見つかりません。</div>

<div class="swell-block-postLink">投稿が見つかりません。</div>


<h3 id="rtoc-13"  class="wp-block-heading">Step 7：テストを書く</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-unit-test-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-unit-test/">【Django】ユニットテストを書く方法【単体テスト】</a>
						<span class="p-blogCard__excerpt">Django のテストコードってどう書けばいい？？ このような疑問にお答えします。 ユニットテストは「単体テスト」とも呼ばれ、クラスや関数などの狭い範囲のプログラムが&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 id="rtoc-14"  class="wp-block-heading">Step 8：運用を効率化する</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-custom-command-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-custom-command/">【初心者でも簡単】Djangoカスタムコマンド入門</a>
						<span class="p-blogCard__excerpt">ルーティン作業を自動化したい カスタムコマンドを実装したい カスタムコマンドを使うと、あらかじめ書いたスクリプトを manage.py 経由で実行できます。 例えば、以下&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-djlint-setup-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-djlint-setup/">Django の djLint のセットアップ方法と使い方</a>
						<span class="p-blogCard__excerpt">Django のリンター djLint を使ってみたい 設定方法をサクッと知りたい djLint は Django でフォーマッター兼リンターとして使える便利なライブラリです。つまり Django&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 id="rtoc-15"  class="wp-block-heading">Step 9：本番にデプロイする</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-django-xserver-vps-deploy-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-django-xserver-vps-deploy/">【お試し】エックスサーバーVPSにDjangoプロジェクトをデプロイする方法</a>
						<span class="p-blogCard__excerpt">DjangoをVPSにデプロイする流れが知りたい！ このようなDjango学習中の方に向けて書きました。 どうせDjangoを勉強するなら、サーバーにデプロイしてみたいですよね。 &#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/gunicorn-django-basics/">GunicornでDjangoプロジェクトをデプロイする方法【Nginx使用】</a>
						<span class="p-blogCard__excerpt">Gunicornの設定が難しすぎる… 動かすコマンドは？ 実践的な設定方法を教えて！ このような方に向けて書きました。 中小規模のDjangoアプリのデプロイによく使われるアプ&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-certbot-https-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-certbot-https/">【Django + Let’s Encrypt】CerbotでHTTPS化するための手順</a>
						<span class="p-blogCard__excerpt">ブラウザで警告が表示されてる 暗号化されていないので不安 ユーザー管理しているのでちゃんとしておきたい サイトを公開後にまず取り組むべきは、HTTPS化です。 HTTPS&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-secret-key-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-secret-key/">【Django】SECRET_KEYを再生成する方法</a>
						<span class="p-blogCard__excerpt">まちがえてSECRET_KEYをGitHubにプッシュしてしまった！ Django標準の機能でSECRET_KEYを生成したい！ このような疑問にお答えします。 SECRET_KEYは、以下の条件を満た&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/02/python-django-sitemap-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-sitemap/">Djangoでサイトマップ（sitemap.xml）を実装する方法まとめ</a>
						<span class="p-blogCard__excerpt">検索エンジンに正しくクロールしてもらうために、Django が標準機能でサイトマップを生成する方法を整理します。 使うのはdjango.contrib.sitemaps です。 Django側の準&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/02/python-django-adstxt-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-adstxt/">【Django】Google AdSense の ads.txt をルートパスで配信する方法</a>
						<span class="p-blogCard__excerpt">Google AdSense を利用する時には、ads.txt をドメイン直下（/ads.txt）で公開する必要があります。 Django でサイトを構築していると、次のようなことで迷うことも多い&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 id="rtoc-16"  class="wp-block-heading">こんなことをしたい → どの記事を読む？逆引きナビ</h2>



<p class="wp-block-paragraph">「困りごとは決まっているけど、どこから読めばいいかわからない」という方向けに、トラブル対応系の記事をまとめました。</p>



<p class="wp-block-paragraph"><strong>開発サーバーが「ポートが使用中」と言われる</strong></p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/code-python-django-port-already-in-use/">【完全保存版】Djangoで「That port is already in use」エラーが出たときの対処法まとめ</a>
						<span class="p-blogCard__excerpt">Django 開発中に python manage.py runserver を実行したら、次のようなエラーに遭遇しましたか？ BashError: That port is already in use.Error: That port is alread&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph"><strong>リダイレクトの実装で迷っている</strong></p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/code-python-django-redirect/">【完全版】Djangoで使うリダイレクトの種類と判断基準・実装方法まとめ</a>
						<span class="p-blogCard__excerpt">URL 設計を途中で変更したい /old/ から /new/ に誘導したい pk URL を slug にリプレースしたい Webアプリを運用していると、こんな場面は必ず出てきます。 そのときに&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph"><strong>ローカル環境を外部に一時公開したい</strong></p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-ngrok/">【Django】ngrokを使ってローカル環境を外部公開する方法</a>
						<span class="p-blogCard__excerpt">ローカルの開発サーバーに外部からアクセスしたい Webhook のテストがしたい python manage.py runserver をすると開発用のローカルサーバーが立ち上がるのはご存知のと&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 id="rtoc-17"  class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">Djangoは、モデル・認証・管理画面といったWebアプリの土台がひと通り揃ったフレームワークです。このガイドで学んだことをまとめると、次のとおりです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>DjangoはModel・Template・Viewの3役割で構成される</li>

<li>言語・フレームワークは使い慣れたものを選べばよく、Djangoである必然性は特にない</li>

<li>フレームワーク特有の「お作法」は、理屈より先に一旦受け入れて動かしてみるのが近道</li>

<li>urls.pyとviews.pyの対応関係が、Djangoのリクエスト処理の骨格</li>

<li>各テーマの詳細は上のロードマップから学べる</li>
</ul>
</div></div>



<p class="wp-block-paragraph">実際に触ってみると、Djangoって意外と簡単だと感じてもらえるはずです。まずはプロジェクトを立ち上げるところから始めてみてください。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-project-setup-300x157.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-project-setup/">【Django】プロジェクトとアプリの設定方法まとめ</a>
						<span class="p-blogCard__excerpt">Djangoの開発を始めるための準備が知りたい！ 普通にPythonでコーディングするのと違って、Djangoの開発では細々した準備が必要です。 内容をざっと列挙すると以下の通&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【Django】テンプレート・静的ファイル完全ガイド｜継承・フィルタ・CSS/JS管理まで解説</title>
		<link>https://cfxlog.com/python-django-templates-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Fri, 31 Jul 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<guid isPermaLink="false">https://cfxlog.com/python-django-templates-guide/</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/08/python-django-templates-guide-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>Djangoのテンプレートを初めて触ったとき、普通のHTMLよりも少しオブジェクト指向的な考え方が必要で、理解するまで少し時間がかかりました。 変数を埋め込むだけならまだしも、テンプレート継承やタグ・フィルタといった仕組 [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/08/python-django-templates-guide-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>
<p class="wp-block-paragraph">Djangoのテンプレートを初めて触ったとき、普通のHTMLよりも少しオブジェクト指向的な考え方が必要で、理解するまで少し時間がかかりました。</p>



<p class="wp-block-paragraph">変数を埋め込むだけならまだしも、テンプレート継承やタグ・フィルタといった仕組みが加わると、「このHTMLはどこから来ているのか」を追うのに慣れが必要でした。</p>



<p class="wp-block-paragraph">この記事では、<strong>テンプレートの基本から、継承の仕組み、静的ファイルの管理方法</strong>までを解説します。</p>



<p class="wp-block-paragraph">ビューの基本がまだの方は、先にこちらを読んでおくとつながりがわかりやすいです。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-views-guide/">【Django】ビュー・URLルーティング完全ガイド｜FBV・CBV・URLconfを徹底解説</a>
						<span class="p-blogCard__excerpt">Djangoのビューには、関数で書くFBV（Function Based View）と、クラスで書くCBV（Class Based View）の2種類があります。 最初にCBVを見たとき、正直よくわかりません&#8230;</span>					</div>
				</div>
			</div>
		</div>


<div id="rtoc-mokuji-wrapper" class="rtoc-mokuji-content frame2 preset5 animation-fade rtoc_open default" data-id="5404" data-theme="SWELL CHILD">
			<div id="rtoc-mokuji-title" class=" rtoc_left">
			<button class="rtoc_open_close rtoc_open"></button>
			<span>目次</span>
			</div><ol class="rtoc-mokuji mokuji_ol level-1"><li class="rtoc-item"><a href="#rtoc-1">Djangoテンプレートの基本</a></li><li class="rtoc-item"><a href="#rtoc-2">テンプレート継承の仕組み</a></li><li class="rtoc-item"><a href="#rtoc-3">静的ファイル（CSS・JS・画像）を管理する</a></li><li class="rtoc-item"><a href="#rtoc-4">正直、最近はあまり出番がない</a></li><li class="rtoc-item"><a href="#rtoc-5">まとめ</a></li></ol></div><h2 id="rtoc-1"  class="wp-block-heading">Djangoテンプレートの基本</h2>



<p class="wp-block-paragraph">ビューから渡されたデータをHTMLに埋め込むには、<code>{{ }}</code>を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">HTML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>&lt;!-- articles/detail.html -->
&lt;h1>{{ article.title }}&lt;/h1>
&lt;p>{{ article.body }}&lt;/p></textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">&lt;!-- articles/detail.html --&gt;</span></span>
<span class="line"><span style="color: #808080">&lt;</span><span style="color: #569CD6">h1</span><span style="color: #808080">&gt;</span><span style="color: #D4D4D4">{{ article.title }}</span><span style="color: #808080">&lt;/</span><span style="color: #569CD6">h1</span><span style="color: #808080">&gt;</span></span>
<span class="line"><span style="color: #808080">&lt;</span><span style="color: #569CD6">p</span><span style="color: #808080">&gt;</span><span style="color: #D4D4D4">{{ article.body }}</span><span style="color: #808080">&lt;/</span><span style="color: #569CD6">p</span><span style="color: #808080">&gt;</span></span></code></pre></div>



<p class="wp-block-paragraph">条件分岐やループには<code>{% %}</code>タグを使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">HTML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>&lt;ul>
{% for article in articles %}
  &lt;li>{{ article.title }}&lt;/li>
{% empty %}
  &lt;li>記事がありません&lt;/li>
{% endfor %}
&lt;/ul></textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #808080">&lt;</span><span style="color: #569CD6">ul</span><span style="color: #808080">&gt;</span></span>
<span class="line"><span style="color: #D4D4D4">{% for article in articles %}</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #808080">&lt;</span><span style="color: #569CD6">li</span><span style="color: #808080">&gt;</span><span style="color: #D4D4D4">{{ article.title }}</span><span style="color: #808080">&lt;/</span><span style="color: #569CD6">li</span><span style="color: #808080">&gt;</span></span>
<span class="line"><span style="color: #D4D4D4">{% empty %}</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #808080">&lt;</span><span style="color: #569CD6">li</span><span style="color: #808080">&gt;</span><span style="color: #D4D4D4">記事がありません</span><span style="color: #808080">&lt;/</span><span style="color: #569CD6">li</span><span style="color: #808080">&gt;</span></span>
<span class="line"><span style="color: #D4D4D4">{% endfor %}</span></span>
<span class="line"><span style="color: #808080">&lt;/</span><span style="color: #569CD6">ul</span><span style="color: #808080">&gt;</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>{% empty %}</code>は、ループ対象が0件だったときに表示される特別な分岐です。件数チェックを別に書かなくていいので地味に便利です。</p>



<h2 id="rtoc-2"  class="wp-block-heading">テンプレート継承の仕組み</h2>



<p class="wp-block-paragraph">ヘッダーやフッターなど、全ページ共通の部分を毎回書くのは非効率です。Djangoでは<strong>テンプレート継承</strong>で、共通レイアウトを1つのファイルにまとめられます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">HTML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>&lt;!-- base.html -->
&lt;html>
&lt;body>
  &lt;header>共通ヘッダー&lt;/header>
  {% block content %}{% endblock %}
  &lt;footer>共通フッター&lt;/footer>
&lt;/body>
&lt;/html></textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">&lt;!-- base.html --&gt;</span></span>
<span class="line"><span style="color: #808080">&lt;</span><span style="color: #569CD6">html</span><span style="color: #808080">&gt;</span></span>
<span class="line"><span style="color: #808080">&lt;</span><span style="color: #569CD6">body</span><span style="color: #808080">&gt;</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #808080">&lt;</span><span style="color: #569CD6">header</span><span style="color: #808080">&gt;</span><span style="color: #D4D4D4">共通ヘッダー</span><span style="color: #808080">&lt;/</span><span style="color: #569CD6">header</span><span style="color: #808080">&gt;</span></span>
<span class="line"><span style="color: #D4D4D4">  {% block content %}{% endblock %}</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #808080">&lt;</span><span style="color: #569CD6">footer</span><span style="color: #808080">&gt;</span><span style="color: #D4D4D4">共通フッター</span><span style="color: #808080">&lt;/</span><span style="color: #569CD6">footer</span><span style="color: #808080">&gt;</span></span>
<span class="line"><span style="color: #808080">&lt;/</span><span style="color: #569CD6">body</span><span style="color: #808080">&gt;</span></span>
<span class="line"><span style="color: #808080">&lt;/</span><span style="color: #569CD6">html</span><span style="color: #808080">&gt;</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">HTML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>&lt;!-- articles/detail.html -->
{% extends "base.html" %}

{% block content %}
  &lt;h1>{{ article.title }}&lt;/h1>
  &lt;p>{{ article.body }}&lt;/p>
{% endblock %}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">&lt;!-- articles/detail.html --&gt;</span></span>
<span class="line"><span style="color: #D4D4D4">{% extends &quot;base.html&quot; %}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">{% block content %}</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #808080">&lt;</span><span style="color: #569CD6">h1</span><span style="color: #808080">&gt;</span><span style="color: #D4D4D4">{{ article.title }}</span><span style="color: #808080">&lt;/</span><span style="color: #569CD6">h1</span><span style="color: #808080">&gt;</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #808080">&lt;</span><span style="color: #569CD6">p</span><span style="color: #808080">&gt;</span><span style="color: #D4D4D4">{{ article.body }}</span><span style="color: #808080">&lt;/</span><span style="color: #569CD6">p</span><span style="color: #808080">&gt;</span></span>
<span class="line"><span style="color: #D4D4D4">{% endblock %}</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>{% extends %}</code>で親テンプレートを指定し、<code>{% block %}</code>で「ここを子テンプレートの内容に差し替える」という穴を開けておく。この2つがセットで、「共通部分は1箇所、ページ固有の部分だけ書く」という構造が成り立ちます。</p>



<h2 id="rtoc-3"  class="wp-block-heading">静的ファイル（CSS・JS・画像）を管理する</h2>



<p class="wp-block-paragraph">CSSやJavaScript、画像は<strong>静的ファイル（static files）</strong>として扱います。テンプレート内で参照するには、まず先頭で<code>{% load static %}</code>を読み込みます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">HTML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>{% load static %}
&lt;link rel="stylesheet" href="{% static 'css/style.css' %}">
&lt;img src="{% static 'images/logo.png' %}" alt="logo"></textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">{% load static %}</span></span>
<span class="line"><span style="color: #808080">&lt;</span><span style="color: #569CD6">link</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">rel</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;stylesheet&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">href</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;{% static &apos;css/style.css&apos; %}&quot;</span><span style="color: #808080">&gt;</span></span>
<span class="line"><span style="color: #808080">&lt;</span><span style="color: #569CD6">img</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">src</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;{% static &apos;images/logo.png&apos; %}&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">alt</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;logo&quot;</span><span style="color: #808080">&gt;</span></span></code></pre></div>



<p class="wp-block-paragraph">パスを直接書かずに<code>{% static %}</code>タグを通す理由は、本番環境でファイルの配信元が変わっても（CDNに置くなど）、テンプレート側を書き換えずに済むからです。</p>



<h2 id="rtoc-4"  class="wp-block-heading">正直、最近はあまり出番がない</h2>



<p class="wp-block-paragraph">ここまで基本を解説しましたが、正直に言うと、最近はNext.jsなどでフロントエンドを組むことが多く、Djangoのテンプレート機能に触れる機会自体が減っています。</p>



<p class="wp-block-paragraph">管理画面や社内ツールのような、凝ったフロントが不要な場面ではまだ十分現役です。ただ、フロントを別で作る構成が前提なら、無理に今すぐ深く学ばなくても、必要になったタイミングで後回しにして問題ないと思います。</p>



<h2 id="rtoc-5"  class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">Djangoのテンプレートは、変数埋め込み・タグ・継承の3つを押さえれば基本形は書けるようになります。静的ファイルは<code>{% static %}</code>タグを通すのが基本です。</p>



<p class="wp-block-paragraph">フロントをNext.js等で別に組む場合は優先度を下げても構いません。管理画面や社内ツールを素早く作りたいときに知っておくと役立ちます。</p>



<p class="wp-block-paragraph">Django全体のロードマップに戻りたい方はこちらからどうぞ。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-guide/">Django完全入門ガイド｜MTVの基本から認証・API・デプロイまで全ステップ解説</a>
						<span class="p-blogCard__excerpt">Djangoって何から始めればいいの？ MTVの構造がよくわからない 認証やAPI連携、本番デプロイまで一通り学びたい このような疑問にお答えします。 Djangoは、Pythonで書&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Django JWT認証の実装｜SimpleJWT + Djoser設定とRedisレートリミット</title>
		<link>https://cfxlog.com/django-simplejwt-djoser-setup/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Thu, 14 May 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[認証]]></category>
		<guid isPermaLink="false">https://cfxlog.com/django-simplejwt-djoser-setup/</guid>

					<description><![CDATA[この記事は、Next.js + Django JWT認証シリーズのバックエンド実装編です。設計の考え方は下記の記事で解説しています。 この記事では、djangorestframework-simplejwt と djos [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>DjangoでJWT認証を実装したい</li>

<li>SimpleJWTとDjoserをどう組み合わせるか知りたい</li>

<li>不要なエンドポイントを封鎖してセキュリティを高めたい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この記事は、Next.js + Django JWT認証シリーズのバックエンド実装編です。設計の考え方は下記の記事で解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/nextjs-django-jwt-auth-design/">Next.js + Django JWT認証の設計｜アクセストークンはメモリ、リフレッシュはHttpOnly Cookieに分ける理由</a>
						<span class="p-blogCard__excerpt">JWTをlocalStorageに保存していいのか不安 アクセストークンとリフレッシュトークンをどこに保存すべきか知りたい XSSとCSRFを両方対策した設計の考え方を理解したい JW&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">この記事では、<code>djangorestframework-simplejwt</code> と <code>djoser</code> の設定、Redisを使ったレートリミットミドルウェアの実装を解説します。</p>



<div id="rtoc-mokuji-wrapper" class="rtoc-mokuji-content frame2 preset5 animation-fade rtoc_open default" data-id="5419" data-theme="SWELL CHILD">
			<div id="rtoc-mokuji-title" class=" rtoc_left">
			<button class="rtoc_open_close rtoc_open"></button>
			<span>目次</span>
			</div><ol class="rtoc-mokuji mokuji_ol level-1"><li class="rtoc-item"><a href="#rtoc-1">必要なパッケージ</a></li><li class="rtoc-item"><a href="#rtoc-2">INSTALLED_APPS と MIDDLEWARE の設定</a></li><li class="rtoc-item"><a href="#rtoc-3">REST_FRAMEWORK の設定</a></li><li class="rtoc-item"><a href="#rtoc-4">SimpleJWT の設定</a></li><li class="rtoc-item"><a href="#rtoc-5">Djoser の設定 &#8211; 不要なエンドポイントを封鎖する</a></li><li class="rtoc-item"><a href="#rtoc-6">Redis キャッシュの設定</a></li><li class="rtoc-item"><a href="#rtoc-7">RateLimitMiddleware の実装</a></li><li class="rtoc-item"><a href="#rtoc-8">URL の設定</a></li></ol></div><h2 id="rtoc-1"  class="wp-block-heading">必要なパッケージ</h2>



<p class="wp-block-paragraph">JWT認証に必要なパッケージを追加します。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>djangorestframework-simplejwt</strong><br>JWTの発行・検証・リフレッシュ・ブラックリスト管理を担う。</li>

<li><strong>djoser</strong><br>ユーザー登録・ログイン・パスワードリセットなどの認証エンドポイントを提供するライブラリ。SimpleJWTと組み合わせて使う。</li>

<li><strong>django-redis</strong><br>RedisをDjangoのキャッシュバックエンドとして使うためのパッケージ。レートリミットのカウンターをマルチワーカー間で共有できる。</li>

<li><strong>django-environ</strong><br>環境変数を <code>.env</code> ファイルから読み込むユーティリティ。</li>
</ul>
</div></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># uv を使う場合
uv add djangorestframework djangorestframework-simplejwt djoser django-redis django-environ

# pip を使う場合
pip install djangorestframework djangorestframework-simplejwt djoser django-redis django-environ</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># uv を使う場合</span></span>
<span class="line"><span style="color:#DCDCAA">uv</span><span style="color:#CE9178"> add</span><span style="color:#CE9178"> djangorestframework</span><span style="color:#CE9178"> djangorestframework-simplejwt</span><span style="color:#CE9178"> djoser</span><span style="color:#CE9178"> django-redis</span><span style="color:#CE9178"> django-environ</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># pip を使う場合</span></span>
<span class="line"><span style="color:#DCDCAA">pip</span><span style="color:#CE9178"> install</span><span style="color:#CE9178"> djangorestframework</span><span style="color:#CE9178"> djangorestframework-simplejwt</span><span style="color:#CE9178"> djoser</span><span style="color:#CE9178"> django-redis</span><span style="color:#CE9178"> django-environ</span></span></code></pre></div>



<h2 id="rtoc-2"  class="wp-block-heading">INSTALLED_APPS と MIDDLEWARE の設定</h2>



<p class="wp-block-paragraph">インストールしたパッケージを <code>INSTALLED_APPS</code> に追加します。<code>rest_framework_simplejwt.token_blacklist</code> はリフレッシュトークンのローテーション時に古いトークンを無効化するために必要です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    # サードパーティ
    "corsheaders",
    "rest_framework",
    "rest_framework_simplejwt",
    "rest_framework_simplejwt.token_blacklist",
    "djoser",
    # ローカルアプリ
    "apps.users",
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">INSTALLED_APPS = [</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.admin"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.auth"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.contenttypes"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.sessions"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.messages"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.staticfiles"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#6A9955">    # サードパーティ</span></span>
<span class="line"><span style="color:#CE9178">    "corsheaders"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "rest_framework"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "rest_framework_simplejwt"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "rest_framework_simplejwt.token_blacklist"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "djoser"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#6A9955">    # ローカルアプリ</span></span>
<span class="line"><span style="color:#CE9178">    "apps.users"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>MIDDLEWARE</code> には <code>CorsMiddleware</code> を最上位に、カスタムミドルウェアを末尾に追加します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>MIDDLEWARE = [
    "corsheaders.middleware.CorsMiddleware",  # 最上位に置く
    "django.middleware.security.SecurityMiddleware",
    "whitenoise.middleware.WhiteNoiseMiddleware",
    "django.contrib.sessions.middleware.SessionMiddleware",
    "django.middleware.common.CommonMiddleware",
    "django.middleware.csrf.CsrfViewMiddleware",
    "django.contrib.auth.middleware.AuthenticationMiddleware",
    "django.contrib.messages.middleware.MessageMiddleware",
    "django.middleware.clickjacking.XFrameOptionsMiddleware",
    # カスタム
    "apps.users.middleware.RateLimitMiddleware",
    "apps.users.middleware.SecurityHeadersMiddleware",
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">MIDDLEWARE = [</span></span>
<span class="line"><span style="color:#CE9178">    "corsheaders.middleware.CorsMiddleware"</span><span style="color:#D4D4D4">,  </span><span style="color:#6A9955"># 最上位に置く</span></span>
<span class="line"><span style="color:#CE9178">    "django.middleware.security.SecurityMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "whitenoise.middleware.WhiteNoiseMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.sessions.middleware.SessionMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.middleware.common.CommonMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.middleware.csrf.CsrfViewMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.auth.middleware.AuthenticationMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.messages.middleware.MessageMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.middleware.clickjacking.XFrameOptionsMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#6A9955">    # カスタム</span></span>
<span class="line"><span style="color:#CE9178">    "apps.users.middleware.RateLimitMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "apps.users.middleware.SecurityHeadersMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<h2 id="rtoc-3"  class="wp-block-heading">REST_FRAMEWORK の設定</h2>



<p class="wp-block-paragraph">デフォルトの認証クラスを <code>JWTAuthentication</code> のみにします。Sessionなど不要な認証方式を残すとセキュリティ上のリスクになるため削除します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>REST_FRAMEWORK = {
    "DEFAULT_AUTHENTICATION_CLASSES": [
        "rest_framework_simplejwt.authentication.JWTAuthentication",
    ],
    "DEFAULT_PERMISSION_CLASSES": [
        "rest_framework.permissions.IsAuthenticated",
    ],
    "DEFAULT_PAGINATION_CLASS": "rest_framework.pagination.PageNumberPagination",
    "PAGE_SIZE": 20,
    "DEFAULT_RENDERER_CLASSES": [
        "rest_framework.renderers.JSONRenderer",
    ],
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">REST_FRAMEWORK = {</span></span>
<span class="line"><span style="color:#CE9178">    "DEFAULT_AUTHENTICATION_CLASSES"</span><span style="color:#D4D4D4">: [</span></span>
<span class="line"><span style="color:#CE9178">        "rest_framework_simplejwt.authentication.JWTAuthentication"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    ],</span></span>
<span class="line"><span style="color:#CE9178">    "DEFAULT_PERMISSION_CLASSES"</span><span style="color:#D4D4D4">: [</span></span>
<span class="line"><span style="color:#CE9178">        "rest_framework.permissions.IsAuthenticated"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    ],</span></span>
<span class="line"><span style="color:#CE9178">    "DEFAULT_PAGINATION_CLASS"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"rest_framework.pagination.PageNumberPagination"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "PAGE_SIZE"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">20</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "DEFAULT_RENDERER_CLASSES"</span><span style="color:#D4D4D4">: [</span></span>
<span class="line"><span style="color:#CE9178">        "rest_framework.renderers.JSONRenderer"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    ],</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre></div>



<h2 id="rtoc-4"  class="wp-block-heading">SimpleJWT の設定</h2>



<p class="wp-block-paragraph">トークンの有効期限とローテーション設定が中心です。各パラメータの意味を確認しておきます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from datetime import timedelta

SIMPLE_JWT = {
    # アクセストークン: 15分（短命にしてリスクを限定）
    "ACCESS_TOKEN_LIFETIME": timedelta(minutes=15),
    # リフレッシュトークン: 14日
    "REFRESH_TOKEN_LIFETIME": timedelta(days=14),
    # リフレッシュのたびに新しいリフレッシュトークンを発行
    "ROTATE_REFRESH_TOKENS": True,
    # 使用済みリフレッシュトークンをブラックリストに登録
    "BLACKLIST_AFTER_ROTATION": True,
    "AUTH_HEADER_TYPES": ("Bearer",),
    "TOKEN_TYPE_CLAIM": "token_type",
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> datetime </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> timedelta</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">SIMPLE_JWT = {</span></span>
<span class="line"><span style="color:#6A9955">    # アクセストークン: 15分（短命にしてリスクを限定）</span></span>
<span class="line"><span style="color:#CE9178">    "ACCESS_TOKEN_LIFETIME"</span><span style="color:#D4D4D4">: timedelta(</span><span style="color:#9CDCFE">minutes</span><span style="color:#D4D4D4">=</span><span style="color:#B5CEA8">15</span><span style="color:#D4D4D4">),</span></span>
<span class="line"><span style="color:#6A9955">    # リフレッシュトークン: 14日</span></span>
<span class="line"><span style="color:#CE9178">    "REFRESH_TOKEN_LIFETIME"</span><span style="color:#D4D4D4">: timedelta(</span><span style="color:#9CDCFE">days</span><span style="color:#D4D4D4">=</span><span style="color:#B5CEA8">14</span><span style="color:#D4D4D4">),</span></span>
<span class="line"><span style="color:#6A9955">    # リフレッシュのたびに新しいリフレッシュトークンを発行</span></span>
<span class="line"><span style="color:#CE9178">    "ROTATE_REFRESH_TOKENS"</span><span style="color:#D4D4D4">: </span><span style="color:#569CD6">True</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#6A9955">    # 使用済みリフレッシュトークンをブラックリストに登録</span></span>
<span class="line"><span style="color:#CE9178">    "BLACKLIST_AFTER_ROTATION"</span><span style="color:#D4D4D4">: </span><span style="color:#569CD6">True</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "AUTH_HEADER_TYPES"</span><span style="color:#D4D4D4">: (</span><span style="color:#CE9178">"Bearer"</span><span style="color:#D4D4D4">,),</span></span>
<span class="line"><span style="color:#CE9178">    "TOKEN_TYPE_CLAIM"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"token_type"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>ROTATE_REFRESH_TOKENS = True</code> を設定すると、リフレッシュのたびに新しいリフレッシュトークンが発行されます。古いトークンがブラックリストに入るため、トークン漏洩時の被害を限定できます。</p>



<p class="wp-block-paragraph">ただし、フロントエンドで複数のAPIリクエストが並走してリフレッシュを呼び出すと競合が起きます。この問題の対策はフロントエンド実装の記事で解説します。</p>



<h2 id="rtoc-5"  class="wp-block-heading">Djoser の設定 &#8211; 不要なエンドポイントを封鎖する</h2>



<p class="wp-block-paragraph">Djoserはデフォルトでユーザー登録・削除・メール変更など多くのエンドポイントを公開します。使わないエンドポイントを <code>IsAdminUser</code> で封鎖することが重要です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>DJOSER = {
    "SERIALIZERS": {
        "current_user": "apps.users.serializers.UserProfileSerializer",
    },
    "PERMISSIONS": {
        "current_user": ["rest_framework.permissions.IsAuthenticated"],
        # /auth/users/ への直接登録を禁止（独自の承認フローを使うため）
        "user_create": ["rest_framework.permissions.IsAdminUser"],
        # メールアドレス変更を禁止（乗っ取り時に元オーナーが復旧できなくなるため）
        "set_username": ["rest_framework.permissions.IsAdminUser"],
        # 自己削除を禁止（関連データが失われるため）
        "user_delete": ["rest_framework.permissions.IsAdminUser"],
        # djoser標準のパスワードリセットを封鎖（独自実装を使うため）
        "password_reset": ["rest_framework.permissions.IsAdminUser"],
        "password_reset_confirm": ["rest_framework.permissions.IsAdminUser"],
    },
    # ユーザー列挙攻撃を防ぐ（未登録メールでも同じレスポンスを返す）
    "PASSWORD_RESET_SHOW_EMAIL_NOT_FOUND": False,
    "USERNAME_RESET_SHOW_EMAIL_NOT_FOUND": False,
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">DJOSER = {</span></span>
<span class="line"><span style="color:#CE9178">    "SERIALIZERS"</span><span style="color:#D4D4D4">: {</span></span>
<span class="line"><span style="color:#CE9178">        "current_user"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"apps.users.serializers.UserProfileSerializer"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    },</span></span>
<span class="line"><span style="color:#CE9178">    "PERMISSIONS"</span><span style="color:#D4D4D4">: {</span></span>
<span class="line"><span style="color:#CE9178">        "current_user"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAuthenticated"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#6A9955">        # /auth/users/ への直接登録を禁止（独自の承認フローを使うため）</span></span>
<span class="line"><span style="color:#CE9178">        "user_create"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#6A9955">        # メールアドレス変更を禁止（乗っ取り時に元オーナーが復旧できなくなるため）</span></span>
<span class="line"><span style="color:#CE9178">        "set_username"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#6A9955">        # 自己削除を禁止（関連データが失われるため）</span></span>
<span class="line"><span style="color:#CE9178">        "user_delete"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#6A9955">        # djoser標準のパスワードリセットを封鎖（独自実装を使うため）</span></span>
<span class="line"><span style="color:#CE9178">        "password_reset"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#CE9178">        "password_reset_confirm"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#D4D4D4">    },</span></span>
<span class="line"><span style="color:#6A9955">    # ユーザー列挙攻撃を防ぐ（未登録メールでも同じレスポンスを返す）</span></span>
<span class="line"><span style="color:#CE9178">    "PASSWORD_RESET_SHOW_EMAIL_NOT_FOUND"</span><span style="color:#D4D4D4">: </span><span style="color:#569CD6">False</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "USERNAME_RESET_SHOW_EMAIL_NOT_FOUND"</span><span style="color:#D4D4D4">: </span><span style="color:#569CD6">False</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">特に <code>PASSWORD_RESET_SHOW_EMAIL_NOT_FOUND = False</code> は重要です。これを有効にしないと、未登録のメールアドレスを送信したときに「そのメールは登録されていません」というレスポンスが返り、攻撃者にユーザー一覧を推測させてしまいます。</p>



<h2 id="rtoc-6"  class="wp-block-heading">Redis キャッシュの設定</h2>



<p class="wp-block-paragraph">レートリミットのカウンターをマルチワーカー間で共有するために、Redisをキャッシュバックエンドとして使います。Gunicornなど複数ワーカーを立てる場合に必要な設定です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import environ
env = environ.Env()

REDIS_URL = env("REDIS_URL", default="redis://localhost:6379/1")
CACHES = {
    "default": {
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": REDIS_URL,
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
        },
    }
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> environ</span></span>
<span class="line"><span style="color:#D4D4D4">env = environ.Env()</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">REDIS_URL = env(</span><span style="color:#CE9178">"REDIS_URL"</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">default</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"redis://localhost:6379/1"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">CACHES = {</span></span>
<span class="line"><span style="color:#CE9178">    "default"</span><span style="color:#D4D4D4">: {</span></span>
<span class="line"><span style="color:#CE9178">        "BACKEND"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"django_redis.cache.RedisCache"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">        "LOCATION"</span><span style="color:#D4D4D4">: REDIS_URL,</span></span>
<span class="line"><span style="color:#CE9178">        "OPTIONS"</span><span style="color:#D4D4D4">: {</span></span>
<span class="line"><span style="color:#CE9178">            "CLIENT_CLASS"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"django_redis.client.DefaultClient"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">        },</span></span>
<span class="line"><span style="color:#D4D4D4">    }</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre></div>



<h2 id="rtoc-7"  class="wp-block-heading">RateLimitMiddleware の実装</h2>



<p class="wp-block-paragraph">Redisキャッシュを使ってIPアドレスごとにリクエスト数を制限するカスタムミドルウェアを実装します。<code>cache.add()</code> と <code>cache.incr()</code> を組み合わせることで、レースコンディションが起きないアトミックな実装になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import json
from django.conf import settings
from django.core.cache import cache
from django.http import HttpResponse
from django.utils.deprecation import MiddlewareMixin


class RateLimitMiddleware(MiddlewareMixin):
    def __init__(self, get_response):
        super().__init__(get_response)
        auth_req = 120 if settings.DEBUG else 30
        self.rate_limits = {
            "default":  {"requests": 100, "window": 60},
            "auth":     {"requests": auth_req, "window": 60},
            "register": {"requests": 5,   "window": 3600},
            "contact":  {"requests": 5,   "window": 3600},
        }

    def process_request(self, request):
        exempt = ["/static/", "/media/", "/favicon.ico", "/admin/"]
        if any(request.path.startswith(p) for p in exempt):
            return None
        ip = self._get_client_ip(request)
        endpoint = self._get_endpoint_type(request.path)
        if not self._check_rate_limit(ip, endpoint):
            return HttpResponse(
                json.dumps({"detail": "Rate limit exceeded."}),
                content_type="application/json",
                status=429,
            )
        return None

    def _get_client_ip(self, request):
        """リバースプロキシ経由の実クライアントIPを取得する"""
        remote_addr = request.META.get("REMOTE_ADDR", "")
        trusted = getattr(settings, "TRUSTED_PROXIES", [])
        if remote_addr in trusted:
            xff = request.META.get("HTTP_X_FORWARDED_FOR", "")
            if xff:
                # nginx は実クライアントIPを末尾に追記する
                return xff.split(",")[-1].strip()
        return remote_addr

    def _get_endpoint_type(self, path):
        if "/api/auth/register/" in path:
            return "register"
        if "/auth/" in path or "/login" in path:
            return "auth"
        if "/api/contact/" in path:
            return "contact"
        return "default"

    def _check_rate_limit(self, ip, endpoint):
        """アトミックなカウントアップで競合を防ぐ"""
        config = self.rate_limits.get(endpoint, self.rate_limits["default"])
        key = f"rate_limit:{endpoint}:{ip}"
        # キーが存在しない場合のみ0で初期化（TTL付き）
        cache.add(key, 0, config["window"])
        # アトミックにインクリメント
        count = cache.incr(key)
        return count &lt;= config["requests"]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> json</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.conf </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> settings</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.core.cache </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> cache</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.http </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> HttpResponse</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.utils.deprecation </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> MiddlewareMixin</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> RateLimitMiddleware</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">MiddlewareMixin</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> __init__</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">get_response</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#4EC9B0">        super</span><span style="color:#D4D4D4">().</span><span style="color:#DCDCAA">__init__</span><span style="color:#D4D4D4">(get_response)</span></span>
<span class="line"><span style="color:#D4D4D4">        auth_req = </span><span style="color:#B5CEA8">120</span><span style="color:#C586C0"> if</span><span style="color:#D4D4D4"> settings.DEBUG </span><span style="color:#C586C0">else</span><span style="color:#B5CEA8"> 30</span></span>
<span class="line"><span style="color:#569CD6">        self</span><span style="color:#D4D4D4">.rate_limits = {</span></span>
<span class="line"><span style="color:#CE9178">            "default"</span><span style="color:#D4D4D4">:  {</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">100</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">60</span><span style="color:#D4D4D4">},</span></span>
<span class="line"><span style="color:#CE9178">            "auth"</span><span style="color:#D4D4D4">:     {</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">: auth_req, </span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">60</span><span style="color:#D4D4D4">},</span></span>
<span class="line"><span style="color:#CE9178">            "register"</span><span style="color:#D4D4D4">: {</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">5</span><span style="color:#D4D4D4">,   </span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">3600</span><span style="color:#D4D4D4">},</span></span>
<span class="line"><span style="color:#CE9178">            "contact"</span><span style="color:#D4D4D4">:  {</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">5</span><span style="color:#D4D4D4">,   </span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">3600</span><span style="color:#D4D4D4">},</span></span>
<span class="line"><span style="color:#D4D4D4">        }</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> process_request</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">request</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">        exempt = [</span><span style="color:#CE9178">"/static/"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"/media/"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"/favicon.ico"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"/admin/"</span><span style="color:#D4D4D4">]</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#DCDCAA"> any</span><span style="color:#D4D4D4">(request.path.startswith(p) </span><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> p </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> exempt):</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#569CD6"> None</span></span>
<span class="line"><span style="color:#D4D4D4">        ip = </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">._get_client_ip(request)</span></span>
<span class="line"><span style="color:#D4D4D4">        endpoint = </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">._get_endpoint_type(request.path)</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#569CD6"> not</span><span style="color:#569CD6"> self</span><span style="color:#D4D4D4">._check_rate_limit(ip, endpoint):</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#D4D4D4"> HttpResponse(</span></span>
<span class="line"><span style="color:#D4D4D4">                json.dumps({</span><span style="color:#CE9178">"detail"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"Rate limit exceeded."</span><span style="color:#D4D4D4">}),</span></span>
<span class="line"><span style="color:#9CDCFE">                content_type</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"application/json"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#9CDCFE">                status</span><span style="color:#D4D4D4">=</span><span style="color:#B5CEA8">429</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">            )</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#569CD6"> None</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> _get_client_ip</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">request</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#CE9178">        """リバースプロキシ経由の実クライアントIPを取得する"""</span></span>
<span class="line"><span style="color:#D4D4D4">        remote_addr = request.META.get(</span><span style="color:#CE9178">"REMOTE_ADDR"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">""</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">        trusted = </span><span style="color:#DCDCAA">getattr</span><span style="color:#D4D4D4">(settings, </span><span style="color:#CE9178">"TRUSTED_PROXIES"</span><span style="color:#D4D4D4">, [])</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#D4D4D4"> remote_addr </span><span style="color:#569CD6">in</span><span style="color:#D4D4D4"> trusted:</span></span>
<span class="line"><span style="color:#D4D4D4">            xff = request.META.get(</span><span style="color:#CE9178">"HTTP_X_FORWARDED_FOR"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">""</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#C586C0">            if</span><span style="color:#D4D4D4"> xff:</span></span>
<span class="line"><span style="color:#6A9955">                # nginx は実クライアントIPを末尾に追記する</span></span>
<span class="line"><span style="color:#C586C0">                return</span><span style="color:#D4D4D4"> xff.split(</span><span style="color:#CE9178">","</span><span style="color:#D4D4D4">)[-</span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">].strip()</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#D4D4D4"> remote_addr</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> _get_endpoint_type</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">path</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#CE9178"> "/api/auth/register/"</span><span style="color:#569CD6"> in</span><span style="color:#D4D4D4"> path:</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#CE9178"> "register"</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#CE9178"> "/auth/"</span><span style="color:#569CD6"> in</span><span style="color:#D4D4D4"> path </span><span style="color:#569CD6">or</span><span style="color:#CE9178"> "/login"</span><span style="color:#569CD6"> in</span><span style="color:#D4D4D4"> path:</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#CE9178"> "auth"</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#CE9178"> "/api/contact/"</span><span style="color:#569CD6"> in</span><span style="color:#D4D4D4"> path:</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#CE9178"> "contact"</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#CE9178"> "default"</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> _check_rate_limit</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">ip</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">endpoint</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#CE9178">        """アトミックなカウントアップで競合を防ぐ"""</span></span>
<span class="line"><span style="color:#D4D4D4">        config = </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">.rate_limits.get(endpoint, </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">.rate_limits[</span><span style="color:#CE9178">"default"</span><span style="color:#D4D4D4">])</span></span>
<span class="line"><span style="color:#D4D4D4">        key = </span><span style="color:#569CD6">f</span><span style="color:#CE9178">"rate_limit:</span><span style="color:#569CD6">{</span><span style="color:#D4D4D4">endpoint</span><span style="color:#569CD6">}</span><span style="color:#CE9178">:</span><span style="color:#569CD6">{</span><span style="color:#D4D4D4">ip</span><span style="color:#569CD6">}</span><span style="color:#CE9178">"</span></span>
<span class="line"><span style="color:#6A9955">        # キーが存在しない場合のみ0で初期化（TTL付き）</span></span>
<span class="line"><span style="color:#D4D4D4">        cache.add(key, </span><span style="color:#B5CEA8">0</span><span style="color:#D4D4D4">, config[</span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">])</span></span>
<span class="line"><span style="color:#6A9955">        # アトミックにインクリメント</span></span>
<span class="line"><span style="color:#D4D4D4">        count = cache.incr(key)</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#D4D4D4"> count &lt;= config[</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">ポイントは <code>cache.add()</code> と <code>cache.incr()</code> の組み合わせです。<code>cache.add()</code> はキーが存在しない場合のみ値をセットし、TTLも同時に設定します。その後 <code>cache.incr()</code> でアトミックにカウントを増やします。</p>



<p class="wp-block-paragraph">もし <code>cache.get()</code> → <code>cache.set()</code> のパターンで書いてしまうと、並走リクエストが同時に「0件」を読んでそれぞれがカウントをリセットするレースコンディションが起きます。</p>



<h2 id="rtoc-8"  class="wp-block-heading">URL の設定</h2>



<p class="wp-block-paragraph">DjoserのURLを2行追加します。<code>djoser.urls</code> がユーザー管理系エンドポイント、<code>djoser.urls.jwt</code> がJWT発行・リフレッシュ・ログアウトのエンドポイントを提供します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.urls import path, include

urlpatterns = [
    path("auth/", include("djoser.urls")),
    path("auth/", include("djoser.urls.jwt")),
    path("api/", include("apps.main.urls")),
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> path, include</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">urlpatterns = [</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"auth/"</span><span style="color:#D4D4D4">, include(</span><span style="color:#CE9178">"djoser.urls"</span><span style="color:#D4D4D4">)),</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"auth/"</span><span style="color:#D4D4D4">, include(</span><span style="color:#CE9178">"djoser.urls.jwt"</span><span style="color:#D4D4D4">)),</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"api/"</span><span style="color:#D4D4D4">, include(</span><span style="color:#CE9178">"apps.main.urls"</span><span style="color:#D4D4D4">)),</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">この設定で有効になる主なエンドポイントです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>POST /auth/jwt/create/</strong><br>ログイン。アクセストークンとリフレッシュトークンを返す。</li>

<li><strong>POST /auth/jwt/refresh/</strong><br>リフレッシュ。HttpOnly CookieのリフレッシュトークンをもとにアクセストークンをJSON で返す。</li>

<li><strong>POST /auth/logout/</strong><br>ログアウト。リフレッシュトークンをブラックリストに登録する。</li>

<li><strong>GET /auth/users/me/</strong><br>ログイン中のユーザー情報を返す。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">バックエンドの設定はこれで完成です。フロントエンド側でこれらのエンドポイントをどう呼び出すかは、次の記事で解説します。</p>


<div class="swell-block-postLink"></div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Next.js + Django JWT認証の設計｜アクセストークンはメモリ、リフレッシュはHttpOnly Cookieに分ける理由</title>
		<link>https://cfxlog.com/nextjs-django-jwt-auth-design/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Wed, 13 May 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[Next.js]]></category>
		<category><![CDATA[認証]]></category>
		<guid isPermaLink="false">https://cfxlog.com/nextjs-django-jwt-auth-design/</guid>

					<description><![CDATA[JWTの保存場所は「localStorageかCookieか」と語られがちですが、アクセストークンとリフレッシュトークンで保存先を分けるのがより安全な設計です。 この記事では、なぜその設計になるのかを理由から解説します。 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>JWTをlocalStorageに保存していいのか不安</li>

<li>アクセストークンとリフレッシュトークンをどこに保存すべきか知りたい</li>

<li>XSSとCSRFを両方対策した設計の考え方を理解したい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">JWTの保存場所は「localStorageかCookieか」と語られがちですが、アクセストークンとリフレッシュトークンで保存先を分けるのがより安全な設計です。</p>



<p class="wp-block-paragraph">この記事では、なぜその設計になるのかを理由から解説します。実装コードはバックエンド・フロントエンドで別記事に分けてあるので、この記事では「設計の考え方」に絞ります。</p>



<div id="rtoc-mokuji-wrapper" class="rtoc-mokuji-content frame2 preset5 animation-fade rtoc_open default" data-id="5418" data-theme="SWELL CHILD">
			<div id="rtoc-mokuji-title" class=" rtoc_left">
			<button class="rtoc_open_close rtoc_open"></button>
			<span>目次</span>
			</div><ol class="rtoc-mokuji mokuji_ol level-1"><li class="rtoc-item"><a href="#rtoc-1">JWTの保存場所は3種類ある</a></li><li class="rtoc-item"><a href="#rtoc-2">アクセストークンとリフレッシュトークンを分ける理由</a></li><li class="rtoc-item"><a href="#rtoc-3">認証フローの全体像</a></li><li class="rtoc-item"><a href="#rtoc-4">ROTATE_REFRESH_TOKENSが引き起こす並走リフレッシュ問題</a></li><li class="rtoc-item"><a href="#rtoc-5">バックエンド（Django）の実装</a></li><li class="rtoc-item"><a href="#rtoc-6">フロントエンド（Next.js）の実装</a></li></ol></div><h2 id="rtoc-1"  class="wp-block-heading">JWTの保存場所は3種類ある</h2>



<p class="wp-block-paragraph">JWTを保存できる場所は主に3つあり、それぞれセキュリティ特性が異なります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>localStorage</strong><br>JavaScriptから自由に読み書きできる。XSSが成立すると <code>localStorage.getItem()</code> 一行でトークンが盗まれる。</li>

<li><strong>HttpOnly Cookie</strong><br>JavaScriptから読み書きできない。ただしブラウザが同一オリジンへのリクエストに自動付与するため、CSRF攻撃の対象になりやすい。</li>

<li><strong>メモリ（JS変数）</strong><br>ページをまたいで持続しない。同じタブ内のJavaScriptからは参照できるが、localStorageのように永続化されないため露出範囲が限られる。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">「HttpOnly Cookieが最も安全だから、全部そこに入れればいい」と思いたくなります。しかし、アクセストークンとリフレッシュトークンでは性質が大きく違うため、同じ保存先にまとめるのは最適解ではありません。</p>



<h2 id="rtoc-2"  class="wp-block-heading">アクセストークンとリフレッシュトークンを分ける理由</h2>



<p class="wp-block-paragraph">2種類のトークンには、用途と有効期限に大きな差があります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>アクセストークン（有効期限: 15分）</strong><br>APIリクエストのたびに <code>Authorization: Bearer</code> ヘッダーに付けて送る。短命なので仮に流出しても被害期間が限定される。</li>

<li><strong>リフレッシュトークン（有効期限: 14日）</strong><br>アクセストークンが切れたときだけ使う。長命なので慎重に管理する必要がある。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この性質の差から、次の方針が導き出されます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>アクセストークン → メモリ（JS変数）</strong><br>短命なのでリロードで消えても問題ない。Authorizationヘッダーで送るため、Cookieのような自動付与によるCSRFリスクがない。</li>

<li><strong>リフレッシュトークン → HttpOnly Cookie（パス: /auth/ に限定）</strong><br>JavaScriptから読めないのでXSSで盗まれない。パスを <code>/auth/</code> に絞ることで <code>/api/</code> へのリクエストにはCookieが付かず、CSRF攻撃の対象面を最小化できる。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">両方をHttpOnly Cookieに入れた場合と比べて、アクセストークンがヘッダー送信のみになるため、CSRFトークンによる保護が不要なリクエストの範囲が広がります。</p>



<h2 id="rtoc-3"  class="wp-block-heading">認証フローの全体像</h2>



<p class="wp-block-paragraph">設計を決めたら、次はフローを整理します。ログインからAPIアクセス、トークン更新、ログアウトまでの流れです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list">
<li><strong>ページ初期化</strong><br>CSRF Cookieを取得 → <code>/auth/jwt/refresh/</code> にリクエスト → ブラウザがHttpOnly Cookieを自動送信 → サーバーがアクセストークンを返す → メモリに保存する</li>

<li><strong>APIリクエスト</strong><br>メモリ上のアクセストークンを <code>Authorization: Bearer {token}</code> ヘッダーに付けて送信する</li>

<li><strong>401レスポンス時</strong><br>アクセストークンの有効期限切れ → <code>refreshToken()</code> でトークン更新 → 新しいアクセストークンをメモリに保存 → 元のリクエストを自動リトライする</li>

<li><strong>ログアウト</strong><br>サーバー側でリフレッシュトークンをブラックリスト登録 → メモリ上のアクセストークンをクリアする</li>
</ol>
</div></div>



<p class="wp-block-paragraph">「メモリ保存だとページリロードでトークンが消えるのでは？」という疑問は正しくて、リロード後はステップ1の初期化フローが走ります。有効なリフレッシュCookieがあれば自動でアクセストークンが復元されます。</p>



<h2 id="rtoc-4"  class="wp-block-heading">ROTATE_REFRESH_TOKENSが引き起こす並走リフレッシュ問題</h2>



<p class="wp-block-paragraph">Djangoの <code>djangorestframework-simplejwt</code> では <code>ROTATE_REFRESH_TOKENS = True</code> を設定すると、リフレッシュのたびに新しいリフレッシュトークンが発行され、古いトークンがブラックリストに登録されます。セキュリティ上望ましい設定ですが、フロントエンドで問題が起きることがあります。</p>



<p class="wp-block-paragraph">ページ読み込み直後など、複数のAPIリクエストが同時に走るタイミングで、それぞれが並走して <code>refreshToken()</code> を呼び出すケースです。1本目のリフレッシュが成功すると古いリフレッシュトークンがブラックリストに入り、2本目以降は同じトークンで呼び出しているためエラーになります。</p>



<p class="wp-block-paragraph">対策は、進行中のリフレッシュリクエストがあれば新たに呼び出さず、同じPromiseを使い回す「mutex」パターンです。シンプルな実装で解決できます。詳しくはフロントエンド実装の記事で解説します。</p>



<h2 id="rtoc-5"  class="wp-block-heading">バックエンド（Django）の実装</h2>



<p class="wp-block-paragraph">SimpleJWT・Djoserの設定と、RedisキャッシュによるレートリミットミドルウェアをDjangoで実装する方法を解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-simplejwt-djoser-setup/">Django JWT認証の実装｜SimpleJWT + Djoser設定とRedisレートリミット</a>
						<span class="p-blogCard__excerpt">DjangoでJWT認証を実装したい SimpleJWTとDjoserをどう組み合わせるか知りたい 不要なエンドポイントを封鎖してセキュリティを高めたい この記事は、Next.js + Django J&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 id="rtoc-6"  class="wp-block-heading">フロントエンド（Next.js）の実装</h2>



<p class="wp-block-paragraph">アクセストークンのメモリ管理・セッションフラグ・refreshToken()のmutex・apiFetch()の自動リトライをTypeScriptで実装する方法を解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/nextjs-jwt-memory-token-auth/">Next.js JWT認証の実装｜アクセストークンをメモリ管理・リフレッシュ並走バグを防ぐmutexパターン</a>
						<span class="p-blogCard__excerpt">Next.jsでJWTトークンをどこに保存すればいいか知りたい 複数リクエストが同時にリフレッシュを呼んでエラーになる問題を解決したい 401レスポンスを受け取ったときに自&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【Django】SECRET_KEYを再生成する方法</title>
		<link>https://cfxlog.com/python-django-secret-key/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 01 Mar 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[デプロイ]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=111</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-secret-key.jpg" class="webfeedsFeaturedVisual" /></p>このような疑問にお答えします。 SECRET_KEYは、以下の条件を満たす必要があります。 これを自力で考えるのはとても大変なので、Django組み込みの関数を使って生成する方法をお伝えします。 目次 DjangoのSE [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-secret-key.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>まちがえて<code>SECRET_KEY</code>をGitHubにプッシュしてしまった！</li>



<li>Django標準の機能で<code>SECRET_KEY</code>を生成したい！</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような疑問にお答えします。</p>



<p class="wp-block-paragraph"><code>SECRET_KEY</code>は、以下の条件を満たす必要があります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>5種類以上の文字を使用</li>



<li>50文字以上の長さ</li>
</ul>
</div></div>



<p class="wp-block-paragraph">これを自力で考えるのはとても大変なので、Django組み込みの関数を使って生成する方法をお伝えします。</p>



<div id="rtoc-mokuji-wrapper" class="rtoc-mokuji-content frame2 preset5 animation-fade rtoc_open default" data-id="111" data-theme="SWELL CHILD">
			<div id="rtoc-mokuji-title" class=" rtoc_left">
			<button class="rtoc_open_close rtoc_open"></button>
			<span>目次</span>
			</div><ol class="rtoc-mokuji mokuji_ol level-1"><li class="rtoc-item"><a href="#rtoc-1">DjangoのSECRET_KEYを再生成する方法</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-2">Django 組み込みの関数でキーを発行</a></li><li class="rtoc-item"><a href="#rtoc-3">環境変数で管理することでセキュリティ向上を目指す</a></li></ul></li></ol></div><h2 id="rtoc-1"  class="wp-block-heading">DjangoのSECRET_KEYを再生成する方法</h2>



<h3 id="rtoc-2"  class="wp-block-heading">Django 組み込みの関数でキーを発行</h3>



<p class="wp-block-paragraph">Djangoで<code>SECRET_KEY</code>を再生成するには、以下の関数を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.core.management.utils import get_random_secret_key

# SECRET_KEYを生成する
new_secret_key = get_random_secret_key()
print(new_secret_key)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> django.core.management.utils </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> get_random_secret_key</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># SECRET_KEYを生成する</span></span>
<span class="line"><span style="color: #D4D4D4">new_secret_key = get_random_secret_key()</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(new_secret_key)</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>get_random_secret_key()</code>関数は、Djangoが<code>settings.py</code>の<code>SECRET_KEY</code>を生成しているものなので安心して使えます。</p>



<h3 id="rtoc-3"  class="wp-block-heading">環境変数で管理することでセキュリティ向上を目指す</h3>



<p class="wp-block-paragraph"><code>SECRET_KEY</code>はハードコーディングせずに、環境変数として管理することが推奨されます。</p>



<p class="wp-block-paragraph">もちろん<code>get_random_secret_key()</code>を使ってから<code>.env</code>に文字列を貼り付けても良いですが、ちょっと面倒なのでシェルスクリプトを作ってコマンド一つで実装できるようにしましょう。</p>



<p class="wp-block-paragraph">スクリプトは以下になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>#!/bin/bash

# OSの種類を判定
if [&#91; "$OSTYPE" == "darwin"* &#93;]; then
    # MacOS
    OS_TYPE="MacOS"
else
    # その他のUNIX系OS（主にLinux）
    OS_TYPE="Other"
fi

# DjangoでSECRET_KEYを生成
SECRET_KEY=$(python3 -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())")

# .envファイルのパスを指定
ENV_FILE=".env"

# .envファイルの存在確認
if &#91; -f "$ENV_FILE" &#93;; then
    echo ".envファイルが見つかりました。SECRET_KEYを更新します。"
    
    # OSに応じてsedコマンドを実行
    if &#91; "$OS_TYPE" == "MacOS" &#93;; then
        sed -i '' '/^SECRET_KEY=/d' "$ENV_FILE"
    else
        sed -i '/^SECRET_KEY=/d' "$ENV_FILE"
    fi
    
    echo "SECRET_KEY=$SECRET_KEY" >> "$ENV_FILE"
    echo "SECRET_KEYを更新しました。"
else
    echo ".envファイルが見つかりません。新しく作成します。"
    echo "SECRET_KEY=$SECRET_KEY" > "$ENV_FILE"
    echo ".envファイルを作成し、SECRET_KEYを設定しました。"
fi

# 変更の確認
echo "更新後の.envファイルの内容:"
cat "$ENV_FILE"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">#!/bin/bash</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># OSの種類を判定</span></span>
<span class="line"><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> [&#91; </span><span style="color: #CE9178">&quot;$OSTYPE&quot;</span><span style="color: #D4D4D4"> == </span><span style="color: #CE9178">&quot;darwin&quot;</span><span style="color: #D4D4D4">* &#93;]; then</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># MacOS</span></span>
<span class="line"><span style="color: #D4D4D4">    OS_TYPE=</span><span style="color: #CE9178">&quot;MacOS&quot;</span></span>
<span class="line"><span style="color: #C586C0">else</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># その他のUNIX系OS（主にLinux）</span></span>
<span class="line"><span style="color: #D4D4D4">    OS_TYPE=</span><span style="color: #CE9178">&quot;Other&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">fi</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># DjangoでSECRET_KEYを生成</span></span>
<span class="line"><span style="color: #D4D4D4">SECRET_KEY=</span><span style="color: #F44747">$</span><span style="color: #D4D4D4">(python3 -c </span><span style="color: #CE9178">&quot;from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># .envファイルのパスを指定</span></span>
<span class="line"><span style="color: #D4D4D4">ENV_FILE=</span><span style="color: #CE9178">&quot;.env&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># .envファイルの存在確認</span></span>
<span class="line"><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> &#91; -f </span><span style="color: #CE9178">&quot;$ENV_FILE&quot;</span><span style="color: #D4D4D4"> &#93;; then</span></span>
<span class="line"><span style="color: #D4D4D4">    echo </span><span style="color: #CE9178">&quot;.envファイルが見つかりました。SECRET_KEYを更新します。&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># OSに応じてsedコマンドを実行</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> &#91; </span><span style="color: #CE9178">&quot;$OS_TYPE&quot;</span><span style="color: #D4D4D4"> == </span><span style="color: #CE9178">&quot;MacOS&quot;</span><span style="color: #D4D4D4"> &#93;; then</span></span>
<span class="line"><span style="color: #D4D4D4">        sed -i </span><span style="color: #CE9178">&apos;&apos;</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;/^SECRET_KEY=/d&apos;</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;$ENV_FILE&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">else</span></span>
<span class="line"><span style="color: #D4D4D4">        sed -i </span><span style="color: #CE9178">&apos;/^SECRET_KEY=/d&apos;</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;$ENV_FILE&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    fi</span></span>
<span class="line"><span style="color: #D4D4D4">    </span></span>
<span class="line"><span style="color: #D4D4D4">    echo </span><span style="color: #CE9178">&quot;SECRET_KEY=$SECRET_KEY&quot;</span><span style="color: #D4D4D4"> &gt;&gt; </span><span style="color: #CE9178">&quot;$ENV_FILE&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    echo </span><span style="color: #CE9178">&quot;SECRET_KEYを更新しました。&quot;</span></span>
<span class="line"><span style="color: #C586C0">else</span></span>
<span class="line"><span style="color: #D4D4D4">    echo </span><span style="color: #CE9178">&quot;.envファイルが見つかりません。新しく作成します。&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    echo </span><span style="color: #CE9178">&quot;SECRET_KEY=$SECRET_KEY&quot;</span><span style="color: #D4D4D4"> &gt; </span><span style="color: #CE9178">&quot;$ENV_FILE&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    echo </span><span style="color: #CE9178">&quot;.envファイルを作成し、SECRET_KEYを設定しました。&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">fi</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 変更の確認</span></span>
<span class="line"><span style="color: #D4D4D4">echo </span><span style="color: #CE9178">&quot;更新後の.envファイルの内容:&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">cat </span><span style="color: #CE9178">&quot;$ENV_FILE&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">これをプロジェクトのルートディレクトリに配置して、以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>bash ./update_env_secret_key.sh</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">bash ./update_env_secret_key.sh</span></span></code></pre></div>



<p class="wp-block-paragraph">環境変数の<code>SECRET_KEY</code>をsettings.pyで読み込むために、以下のように書き換えます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import environ

# .envファイルのパスを指定
env = environ.Env()
environ.Env.read_env(".env")

SECRET_KEY = env("SECRET_KEY")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> environ</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># .envファイルのパスを指定</span></span>
<span class="line"><span style="color: #D4D4D4">env = environ.Env()</span></span>
<span class="line"><span style="color: #D4D4D4">environ.Env.read_env(</span><span style="color: #CE9178">&quot;.env&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">SECRET_KEY = env(</span><span style="color: #CE9178">&quot;SECRET_KEY&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>.gitignore</code>ファイルで<code>.env</code>を Git 管理対象外にしておくことで、間違ってキーを公開してしまうことを防げます。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Djangoでサイトマップ（sitemap.xml）を実装する方法まとめ</title>
		<link>https://cfxlog.com/python-django-sitemap/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Tue, 24 Feb 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[デプロイ]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=58</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/02/python-django-sitemap-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>検索エンジンに正しくクロールしてもらうために、Django が標準機能でサイトマップを生成する方法を整理します。 使うのはdjango.contrib.sitemaps です。 Django側の準備から、サイトマップクラ [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/02/python-django-sitemap-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>
<p class="wp-block-paragraph">検索エンジンに正しくクロールしてもらうために、Django が標準機能でサイトマップを生成する方法を整理します。</p>



<p class="wp-block-paragraph">使うのは<code>django.contrib.sitemaps</code> です。</p>



<p class="wp-block-paragraph">Django側の準備から、サイトマップクラスの作成、URL ルーティングまでの流れをまとめました。</p>



<div id="rtoc-mokuji-wrapper" class="rtoc-mokuji-content frame2 preset5 animation-fade rtoc_open default" data-id="58" data-theme="SWELL CHILD">
			<div id="rtoc-mokuji-title" class=" rtoc_left">
			<button class="rtoc_open_close rtoc_open"></button>
			<span>目次</span>
			</div><ol class="rtoc-mokuji mokuji_ol level-1"><li class="rtoc-item"><a href="#rtoc-1">Djangoでサイトマップ（sitemap.xml）を実装する方法まとめ</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-2">1. django.contrib.sitemaps を有効化する</a></li><li class="rtoc-item"><a href="#rtoc-3">2. サイトマップクラスを作成する</a></li><li class="rtoc-item"><a href="#rtoc-4">3. URL に sitemap.xml を登録する</a></li><li class="rtoc-item"><a href="#rtoc-5">4. 動作確認</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-6">サイトマップを分割したい場合</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-7">サイトマップを分割する必要があるケース</a></li><li class="rtoc-item"><a href="#rtoc-8">Djangoでサイトマップを分割する実装方法</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-9">まとめ</a></li></ol></div><h2 id="rtoc-1"  class="wp-block-heading">Djangoでサイトマップ（sitemap.xml）を実装する方法まとめ</h2>



<h3 id="rtoc-2"  class="wp-block-heading">1. django.contrib.sitemaps を有効化する</h3>



<p class="wp-block-paragraph">まずは Django の設定。</p>



<div class="wp-block-kevinbatdorf-code-block-pro" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#2e3440"><span style="background:#c8d0e0;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#2e3440">Python</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>INSTALLED_APPS = &#91;
    # 既存アプリ
    "django.contrib.sitemaps",
&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">INSTALLED_APPS </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&#91;</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #616E88"># 既存アプリ</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">django.contrib.sitemaps</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #ECEFF4">&#93;</span></span></code></pre></div>



<p class="wp-block-paragraph">これでサイトマップ機能が利用可能になります。</p>



<h3 id="rtoc-3"  class="wp-block-heading">2. サイトマップクラスを作成する</h3>



<p class="wp-block-paragraph">サイトマップに含めたい URL を定義するためのクラスを作ります。</p>



<p class="wp-block-paragraph"><code>app_name/sitemaps.py</code> のように専用ファイルを切っておくと管理しやすいです。</p>



<h4 class="wp-block-heading">2-1. モデルベースのサイトマップ</h4>



<p class="wp-block-paragraph">更新頻度や優先度は適宜調整します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#2e3440"><span style="background:#c8d0e0;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#2e3440">Python</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.contrib.sitemaps import Sitemap
from .models import Article  # 任意のモデル

class ArticleSitemap(Sitemap):
    changefreq = "weekly"
    priority = 0.8

    def items(self):
        # 公開済みデータを対象にする
        return Article.objects.filter(is_published=True).order_by("-updated_at")

    def location(self, obj):
        return obj.get_absolute_url()

    def lastmod(self, obj):
        return obj.updated_at</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #81A1C1">from</span><span style="color: #D8DEE9FF"> django</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">contrib</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">sitemaps </span><span style="color: #81A1C1">import</span><span style="color: #D8DEE9FF"> Sitemap</span></span>
<span class="line"><span style="color: #81A1C1">from</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">models </span><span style="color: #81A1C1">import</span><span style="color: #D8DEE9FF"> Article  </span><span style="color: #616E88"># 任意のモデル</span></span>
<span class="line"></span>
<span class="line"><span style="color: #81A1C1">class</span><span style="color: #D8DEE9FF"> </span><span style="color: #8FBCBB">ArticleSitemap</span><span style="color: #ECEFF4">(</span><span style="color: #8FBCBB; font-weight: bold">Sitemap</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">    changefreq </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">weekly</span><span style="color: #ECEFF4">&quot;</span></span>
<span class="line"><span style="color: #D8DEE9FF">    priority </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #B48EAD">0.8</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #81A1C1">def</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">items</span><span style="color: #ECEFF4">(</span><span style="color: #81A1C1">self</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #616E88"># 公開済みデータを対象にする</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #81A1C1">return</span><span style="color: #D8DEE9FF"> Article</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">objects</span><span style="color: #ECEFF4">.</span><span style="color: #88C0D0">filter</span><span style="color: #ECEFF4">(</span><span style="color: #D8DEE9">is_published</span><span style="color: #81A1C1">=True</span><span style="color: #ECEFF4">).</span><span style="color: #88C0D0">order_by</span><span style="color: #ECEFF4">(</span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">-updated_at</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #81A1C1">def</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">location</span><span style="color: #ECEFF4">(</span><span style="color: #81A1C1">self</span><span style="color: #ECEFF4">,</span><span style="color: #D8DEE9FF"> </span><span style="color: #D8DEE9">obj</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #81A1C1">return</span><span style="color: #D8DEE9FF"> obj</span><span style="color: #ECEFF4">.</span><span style="color: #88C0D0">get_absolute_url</span><span style="color: #ECEFF4">()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #81A1C1">def</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">lastmod</span><span style="color: #ECEFF4">(</span><span style="color: #81A1C1">self</span><span style="color: #ECEFF4">,</span><span style="color: #D8DEE9FF"> </span><span style="color: #D8DEE9">obj</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #81A1C1">return</span><span style="color: #D8DEE9FF"> obj</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">updated_at</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>items()</code> で返したオブジェクトが、サイトマップに展開されます。</p>



<h4 class="wp-block-heading">2-2. 静的ページ用サイトマップ</h4>



<p class="wp-block-paragraph">トップページやプライバシーポリシーなど、モデルを持たない URL をまとめたいときに使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#2e3440"><span style="background:#c8d0e0;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#2e3440">Python</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.contrib.sitemaps import Sitemap
from django.urls import reverse

class StaticViewSitemap(Sitemap):
    changefreq = "monthly"
    priority = 0.5

    def items(self):
        return &#91;"index", "search", "privacy_policy"&#93;  # URL 名

    def location(self, item):
        return reverse(item)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #81A1C1">from</span><span style="color: #D8DEE9FF"> django</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">contrib</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">sitemaps </span><span style="color: #81A1C1">import</span><span style="color: #D8DEE9FF"> Sitemap</span></span>
<span class="line"><span style="color: #81A1C1">from</span><span style="color: #D8DEE9FF"> django</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">urls </span><span style="color: #81A1C1">import</span><span style="color: #D8DEE9FF"> reverse</span></span>
<span class="line"></span>
<span class="line"><span style="color: #81A1C1">class</span><span style="color: #D8DEE9FF"> </span><span style="color: #8FBCBB">StaticViewSitemap</span><span style="color: #ECEFF4">(</span><span style="color: #8FBCBB; font-weight: bold">Sitemap</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">    changefreq </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">monthly</span><span style="color: #ECEFF4">&quot;</span></span>
<span class="line"><span style="color: #D8DEE9FF">    priority </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #B48EAD">0.5</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #81A1C1">def</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">items</span><span style="color: #ECEFF4">(</span><span style="color: #81A1C1">self</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #81A1C1">return</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&#91;</span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">index</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">,</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">search</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">,</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">privacy_policy</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">&#93;</span><span style="color: #D8DEE9FF">  </span><span style="color: #616E88"># URL 名</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #81A1C1">def</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">location</span><span style="color: #ECEFF4">(</span><span style="color: #81A1C1">self</span><span style="color: #ECEFF4">,</span><span style="color: #D8DEE9FF"> </span><span style="color: #D8DEE9">item</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #81A1C1">return</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">reverse</span><span style="color: #ECEFF4">(</span><span style="color: #D8DEE9FF">item</span><span style="color: #ECEFF4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">URL 名（<code>name="..."</code>）を返すと、自動で実 URL に変換されます。</p>



<h3 id="rtoc-4"  class="wp-block-heading">3. URL に sitemap.xml を登録する</h3>



<p class="wp-block-paragraph"><code>core/urls.py</code> にサイトマップを紐づけます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#2e3440"><span style="background:#c8d0e0;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#2e3440">Python</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.contrib.sitemaps.views import sitemap
from app_name.sitemaps import ArticleSitemap, StaticViewSitemap

sitemaps = {
    "articles": ArticleSitemap,
    "static": StaticViewSitemap,
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #81A1C1">from</span><span style="color: #D8DEE9FF"> django</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">contrib</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">sitemaps</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">views </span><span style="color: #81A1C1">import</span><span style="color: #D8DEE9FF"> sitemap</span></span>
<span class="line"><span style="color: #81A1C1">from</span><span style="color: #D8DEE9FF"> app_name</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">sitemaps </span><span style="color: #81A1C1">import</span><span style="color: #D8DEE9FF"> ArticleSitemap</span><span style="color: #ECEFF4">,</span><span style="color: #D8DEE9FF"> StaticViewSitemap</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">sitemaps </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">{</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">articles</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> ArticleSitemap</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">static</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> StaticViewSitemap</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #ECEFF4">}</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#2e3440"><span style="background:#c8d0e0;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#2e3440">Python</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>urlpatterns = &#91;
    # 既存のURLパターン…
    path(
        "sitemap.xml",
        sitemap,
        {"sitemaps": sitemaps},
        name="sitemap",
    ),
&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">urlpatterns </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&#91;</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #616E88"># 既存のURLパターン…</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #88C0D0">path</span><span style="color: #ECEFF4">(</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">sitemap.xml</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">        sitemap</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #ECEFF4">{</span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">sitemaps</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> sitemaps</span><span style="color: #ECEFF4">},</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #D8DEE9">name</span><span style="color: #81A1C1">=</span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">sitemap</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #ECEFF4">),</span></span>
<span class="line"><span style="color: #ECEFF4">&#93;</span></span></code></pre></div>



<p class="wp-block-paragraph">これで <code>/sitemap.xml</code> にアクセスすると、XML形式で URL 一覧が出力されます。</p>



<h3 id="rtoc-5"  class="wp-block-heading">4. 動作確認</h3>



<p class="wp-block-paragraph">実装後に確認した内容は次の通り。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>リンターエラーがないか</li>



<li><code>/sitemap.xml</code> に意図したURLが含まれているか</li>



<li>非公開データが混ざっていないか</li>



<li><code>lastmod</code> が正しい値になっているか</li>
</ul>
</div></div>



<p class="wp-block-paragraph">特にモデルベースのサイトマップは、対象条件の絞り込み漏れに注意します。</p>



<h2 id="rtoc-6"  class="wp-block-heading">サイトマップを分割したい場合</h2>



<p class="wp-block-paragraph">Django では、サイトマップを複数ファイルに分割して「サイトマップインデックス」として管理できます。</p>



<p class="wp-block-paragraph">URL 数が増えてきたり、用途別に整理したくなった場合に便利な仕組みです。</p>



<h3 id="rtoc-7"  class="wp-block-heading">サイトマップを分割する必要があるケース</h3>



<p class="wp-block-paragraph">サイトマップ分割の必要性は、次のいずれかを満たすときに検討します。</p>



<h4 class="wp-block-heading"><strong>1. URL が 50,000 件を超える場合</strong></h4>



<p class="wp-block-paragraph">Google の仕様上、1つの sitemap.xml は <strong>最大 50,000 URL</strong>。<br>これを超える規模のコンテンツを扱う場合は、物理的に分割が必須。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>大規模ブログ</li>



<li>ECサイトの商品ページ</li>



<li>動的に生成される大量のページを持つサイトなどで発生しやすいケース。</li>
</ul>
</div></div>



<h4 class="wp-block-heading"><strong>2. XML のサイズが 50MB を超える場合</strong></h4>



<p class="wp-block-paragraph">サイトマップは「圧縮後で 50MB 以下」という制限があります。<br>画像タグ（<code>&lt;image:image&gt;</code>）を大量に含む場合など、サイズ制限で分割が必要になるケース。</p>



<h4 class="wp-block-heading"><strong>3. コンテンツの用途が明確に分かれている場合</strong></h4>



<p class="wp-block-paragraph">URL 上限以下でも、構造上の整理目的で分割する例も多いです。</p>



<p class="wp-block-paragraph">例：</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>ブログ記事 sitemap</li>



<li>商品ページ sitemap</li>



<li>静的ページ sitemap</li>
</ul>
</div></div>



<p class="wp-block-paragraph">管理しやすく、Search Console 上でカバレッジの把握もしやすくなります。</p>



<h4 class="wp-block-heading"><strong>4. Search Console で用途別にクロール状態を可視化したい場合</strong></h4>



<p class="wp-block-paragraph">「ブログだけエラーが出てる」など、問題を切り分けたいときに便利です。</p>



<p class="wp-block-paragraph">サイトマップを分けることで原因の特定が容易になります。</p>



<h3 id="rtoc-8"  class="wp-block-heading">Djangoでサイトマップを分割する実装方法</h3>



<p class="wp-block-paragraph">Django は <code>sitemap</code> ビューに複数の Sitemap クラスを渡すだけで、自動的に <strong>サイトマップインデックス</strong> として扱ってくれます。</p>



<p class="wp-block-paragraph">下記のように、用途別に Sitemap クラスを増やして分割します。</p>



<h4 class="wp-block-heading">ステップ1：用途別の Sitemap クラスを作る</h4>



<p class="wp-block-paragraph">例として、ブログ・商品・静的ページの3種類を用意します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#2e3440"><span style="background:#c8d0e0;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#2e3440">Python</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># app/sitemaps.py
from django.contrib.sitemaps import Sitemap
from django.urls import reverse
from .models import BlogPost, Product

class BlogSitemap(Sitemap):
    changefreq = "weekly"
    priority = 0.8

    def items(self):
        return BlogPost.objects.filter(published=True)

    def lastmod(self, obj):
        return obj.updated_at


class ProductSitemap(Sitemap):
    changefreq = "daily"
    priority = 0.9

    def items(self):
        return Product.objects.filter(is_active=True)

    def lastmod(self, obj):
        return obj.updated_at


class StaticViewSitemap(Sitemap):
    changefreq = "monthly"
    priority = 0.5

    def items(self):
        return &#91;"index", "privacy_policy"&#93;

    def location(self, item):
        return reverse(item)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #616E88"># app/sitemaps.py</span></span>
<span class="line"><span style="color: #81A1C1">from</span><span style="color: #D8DEE9FF"> django</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">contrib</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">sitemaps </span><span style="color: #81A1C1">import</span><span style="color: #D8DEE9FF"> Sitemap</span></span>
<span class="line"><span style="color: #81A1C1">from</span><span style="color: #D8DEE9FF"> django</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">urls </span><span style="color: #81A1C1">import</span><span style="color: #D8DEE9FF"> reverse</span></span>
<span class="line"><span style="color: #81A1C1">from</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">models </span><span style="color: #81A1C1">import</span><span style="color: #D8DEE9FF"> BlogPost</span><span style="color: #ECEFF4">,</span><span style="color: #D8DEE9FF"> Product</span></span>
<span class="line"></span>
<span class="line"><span style="color: #81A1C1">class</span><span style="color: #D8DEE9FF"> </span><span style="color: #8FBCBB">BlogSitemap</span><span style="color: #ECEFF4">(</span><span style="color: #8FBCBB; font-weight: bold">Sitemap</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">    changefreq </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">weekly</span><span style="color: #ECEFF4">&quot;</span></span>
<span class="line"><span style="color: #D8DEE9FF">    priority </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #B48EAD">0.8</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #81A1C1">def</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">items</span><span style="color: #ECEFF4">(</span><span style="color: #81A1C1">self</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #81A1C1">return</span><span style="color: #D8DEE9FF"> BlogPost</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">objects</span><span style="color: #ECEFF4">.</span><span style="color: #88C0D0">filter</span><span style="color: #ECEFF4">(</span><span style="color: #D8DEE9">published</span><span style="color: #81A1C1">=True</span><span style="color: #ECEFF4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #81A1C1">def</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">lastmod</span><span style="color: #ECEFF4">(</span><span style="color: #81A1C1">self</span><span style="color: #ECEFF4">,</span><span style="color: #D8DEE9FF"> </span><span style="color: #D8DEE9">obj</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #81A1C1">return</span><span style="color: #D8DEE9FF"> obj</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">updated_at</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #81A1C1">class</span><span style="color: #D8DEE9FF"> </span><span style="color: #8FBCBB">ProductSitemap</span><span style="color: #ECEFF4">(</span><span style="color: #8FBCBB; font-weight: bold">Sitemap</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">    changefreq </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">daily</span><span style="color: #ECEFF4">&quot;</span></span>
<span class="line"><span style="color: #D8DEE9FF">    priority </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #B48EAD">0.9</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #81A1C1">def</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">items</span><span style="color: #ECEFF4">(</span><span style="color: #81A1C1">self</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #81A1C1">return</span><span style="color: #D8DEE9FF"> Product</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">objects</span><span style="color: #ECEFF4">.</span><span style="color: #88C0D0">filter</span><span style="color: #ECEFF4">(</span><span style="color: #D8DEE9">is_active</span><span style="color: #81A1C1">=True</span><span style="color: #ECEFF4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #81A1C1">def</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">lastmod</span><span style="color: #ECEFF4">(</span><span style="color: #81A1C1">self</span><span style="color: #ECEFF4">,</span><span style="color: #D8DEE9FF"> </span><span style="color: #D8DEE9">obj</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #81A1C1">return</span><span style="color: #D8DEE9FF"> obj</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">updated_at</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #81A1C1">class</span><span style="color: #D8DEE9FF"> </span><span style="color: #8FBCBB">StaticViewSitemap</span><span style="color: #ECEFF4">(</span><span style="color: #8FBCBB; font-weight: bold">Sitemap</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">    changefreq </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">monthly</span><span style="color: #ECEFF4">&quot;</span></span>
<span class="line"><span style="color: #D8DEE9FF">    priority </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #B48EAD">0.5</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #81A1C1">def</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">items</span><span style="color: #ECEFF4">(</span><span style="color: #81A1C1">self</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #81A1C1">return</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&#91;</span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">index</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">,</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">privacy_policy</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">&#93;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #81A1C1">def</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">location</span><span style="color: #ECEFF4">(</span><span style="color: #81A1C1">self</span><span style="color: #ECEFF4">,</span><span style="color: #D8DEE9FF"> </span><span style="color: #D8DEE9">item</span><span style="color: #ECEFF4">):</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #81A1C1">return</span><span style="color: #D8DEE9FF"> </span><span style="color: #88C0D0">reverse</span><span style="color: #ECEFF4">(</span><span style="color: #D8DEE9FF">item</span><span style="color: #ECEFF4">)</span></span></code></pre></div>



<h4 class="wp-block-heading">ステップ2：<code>sitemaps</code> 辞書でまとめる</h4>



<div class="wp-block-kevinbatdorf-code-block-pro" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#2e3440"><span style="background:#c8d0e0;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#2e3440">Python</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># core/urls.py
from django.contrib.sitemaps.views import sitemap
from app.sitemaps import BlogSitemap, ProductSitemap, StaticViewSitemap

sitemaps = {
    "blog": BlogSitemap,
    "products": ProductSitemap,
    "static": StaticViewSitemap,
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #616E88"># core/urls.py</span></span>
<span class="line"><span style="color: #81A1C1">from</span><span style="color: #D8DEE9FF"> django</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">contrib</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">sitemaps</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">views </span><span style="color: #81A1C1">import</span><span style="color: #D8DEE9FF"> sitemap</span></span>
<span class="line"><span style="color: #81A1C1">from</span><span style="color: #D8DEE9FF"> app</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">sitemaps </span><span style="color: #81A1C1">import</span><span style="color: #D8DEE9FF"> BlogSitemap</span><span style="color: #ECEFF4">,</span><span style="color: #D8DEE9FF"> ProductSitemap</span><span style="color: #ECEFF4">,</span><span style="color: #D8DEE9FF"> StaticViewSitemap</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D8DEE9FF">sitemaps </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">{</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">blog</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> BlogSitemap</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">products</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> ProductSitemap</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">static</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> StaticViewSitemap</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #ECEFF4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">ここでキー名がそのまま以下のようなサブサイトマップの名前になります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>/sitemap-blog.xml</code></li>



<li><code>/sitemap-products.xml</code></li>



<li><code>/sitemap-static.xml</code></li>
</ul>
</div></div>



<h4 class="wp-block-heading">ステップ3：URL に sitemap.xml（インデックス）を登録する</h4>



<div class="wp-block-kevinbatdorf-code-block-pro" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#2e3440"><span style="background:#c8d0e0;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#2e3440">Python</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>urlpatterns = &#91;
    path(
        "sitemap.xml",
        sitemap,
        {"sitemaps": sitemaps},
        name="sitemap"
    ),
&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">urlpatterns </span><span style="color: #81A1C1">=</span><span style="color: #D8DEE9FF"> </span><span style="color: #ECEFF4">&#91;</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #88C0D0">path</span><span style="color: #ECEFF4">(</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">sitemap.xml</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">        sitemap</span><span style="color: #ECEFF4">,</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #ECEFF4">{</span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">sitemaps</span><span style="color: #ECEFF4">&quot;</span><span style="color: #ECEFF4">:</span><span style="color: #D8DEE9FF"> sitemaps</span><span style="color: #ECEFF4">},</span></span>
<span class="line"><span style="color: #D8DEE9FF">        </span><span style="color: #D8DEE9">name</span><span style="color: #81A1C1">=</span><span style="color: #ECEFF4">&quot;</span><span style="color: #A3BE8C">sitemap</span><span style="color: #ECEFF4">&quot;</span></span>
<span class="line"><span style="color: #D8DEE9FF">    </span><span style="color: #ECEFF4">),</span></span>
<span class="line"><span style="color: #ECEFF4">&#93;</span></span></code></pre></div>



<p class="wp-block-paragraph">これだけで Django が自動的に以下を生成します。</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>URL</th><th>役割</th></tr></thead><tbody><tr><td><code>/sitemap.xml</code></td><td>サイトマップのインデックス（sitemap-index.xml 相当）</td></tr><tr><td><code>/sitemap-blog.xml</code></td><td>ブログ記事専用のサイトマップ</td></tr><tr><td><code>/sitemap-products.xml</code></td><td>商品ページ専用のサイトマップ</td></tr><tr><td><code>/sitemap-static.xml</code></td><td>静的ページ専用のサイトマップ</td></tr></tbody></table></figure>



<h4 class="wp-block-heading">ステップ4：Search Console にインデックスのみ登録する</h4>



<p class="wp-block-paragraph">Google Search Console で登録するのは <strong><code>/sitemap.xml</code>（インデックス）だけでOK</strong>。</p>



<p class="wp-block-paragraph">Google が各サブサイトマップを自動で取得してくれます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#2e3440"><span style="background:#c8d0e0;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#2e3440">Python</span></span><span role="button" tabindex="0" style="color:#d8dee9ff;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>https://example.com/sitemap.xml</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki nord" style="background-color: #2e3440ff" tabindex="0"><code><span class="line"><span style="color: #D8DEE9FF">https</span><span style="color: #ECEFF4">:</span><span style="color: #81A1C1">//</span><span style="color: #D8DEE9FF">example</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">com</span><span style="color: #81A1C1">/</span><span style="color: #D8DEE9FF">sitemap</span><span style="color: #ECEFF4">.</span><span style="color: #D8DEE9FF">xml</span></span></code></pre></div>



<h2 id="rtoc-9"  class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">Django のサイトマップ機能は、最小限のコードで <code>sitemap.xml</code> を自動生成できるのが便利です。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>モデルごとに Sitemap クラスを定義</li>



<li>静的ページは URL 名をまとめて Sitemap 化</li>



<li><code>sitemap.xml</code> にまとめて登録</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この3つを押さえておけば、複数ページを持つサイトでも簡単にサイトマップを運用できます。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【Django】QuerySetの使い方まとめ【ORM操作を一気に理解するチートシート】</title>
		<link>https://cfxlog.com/python-django-queryset-cheatsheet/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Mon, 23 Feb 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[データベース]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=65</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/02/python-django-queryset-cheatsheet.jpg" class="webfeedsFeaturedVisual" /></p>このような方に向けて、Django でよく使う操作を中心にまとめました。 各メソッドの説明はジャンルに分けてありますので、以下の目次からお目当てのコンテンツにジャンプしてご利用ください！ 目次 基本の取得方法 全レコード [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/02/python-django-queryset-cheatsheet.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Django の QuerySet 操作を逆引きで調べたい！</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような方に向けて、Django でよく使う操作を中心にまとめました。</p>



<p class="wp-block-paragraph">各メソッドの説明はジャンルに分けてありますので、<strong>以下の目次からお目当てのコンテンツにジャンプ</strong>してご利用ください！</p>



<div id="rtoc-mokuji-wrapper" class="rtoc-mokuji-content frame2 preset5 animation-fade rtoc_open default" data-id="65" data-theme="SWELL CHILD">
			<div id="rtoc-mokuji-title" class=" rtoc_left">
			<button class="rtoc_open_close rtoc_open"></button>
			<span>目次</span>
			</div><ol class="rtoc-mokuji mokuji_ol level-1"><li class="rtoc-item"><a href="#rtoc-1">基本の取得方法</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-2">全レコードを取得する</a></li><li class="rtoc-item"><a href="#rtoc-3">プライマリーキーを指定して取得</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-4">レコードを「文字列」で絞り込んで取得</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-5">完全一致で絞り込む</a></li><li class="rtoc-item"><a href="#rtoc-6">AND 条件で絞り込んで取得</a></li><li class="rtoc-item"><a href="#rtoc-7">OR 条件で絞り込んで取得</a></li><li class="rtoc-item"><a href="#rtoc-8">複数のフィールドにまたがって OR 条件で絞り込んで取得</a></li><li class="rtoc-item"><a href="#rtoc-9">前方一致で絞り込む</a></li><li class="rtoc-item"><a href="#rtoc-10">後方一致で絞り込む</a></li><li class="rtoc-item"><a href="#rtoc-11">中間一致で絞り込む</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-12">レコードを「数字」で絞り込んで取得</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-13">より大きい</a></li><li class="rtoc-item"><a href="#rtoc-14">より小さい</a></li><li class="rtoc-item"><a href="#rtoc-15">以上</a></li><li class="rtoc-item"><a href="#rtoc-16">以下</a></li><li class="rtoc-item"><a href="#rtoc-17">範囲</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-18">その他の絞り込み</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-19">最新・最古のレコードを取得する</a></li><li class="rtoc-item"><a href="#rtoc-20">最初・最後のレコードを取得する</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-21">並び替え</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-22">昇順でソート</a></li><li class="rtoc-item"><a href="#rtoc-23">降順でソート</a></li><li class="rtoc-item"><a href="#rtoc-24">複数フィールドを基準にソートする</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-25">取得形式を指定する</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-26">辞書形式で取得する</a></li><li class="rtoc-item"><a href="#rtoc-27">特定カラムをリストで取得する</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-28">クエリセットを使って計算する</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-29">合計値を求める</a></li><li class="rtoc-item"><a href="#rtoc-30">平均値を求める</a></li><li class="rtoc-item"><a href="#rtoc-31">最大値を求める</a></li><li class="rtoc-item"><a href="#rtoc-32">最小値</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-33">SQL クエリ発行回数の節約</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-34">ForeignKey のクエリ発行回数を減らす</a></li><li class="rtoc-item"><a href="#rtoc-35">ManyToMany のクエリ発行回数を減らす</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-36">レコードの更新（追加・削除）</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-37">レコードを追加する</a></li><li class="rtoc-item"><a href="#rtoc-38">レコードがあれば取得して、なければ追加する</a></li><li class="rtoc-item"><a href="#rtoc-39">特定レコードの値を書き換える</a></li><li class="rtoc-item"><a href="#rtoc-40">特定のレコードの値を削除する</a></li><li class="rtoc-item"><a href="#rtoc-41"> 複数のレコードを一度に削除する</a></li><li class="rtoc-item"><a href="#rtoc-42">レコードを更新する</a></li><li class="rtoc-item"><a href="#rtoc-43">複数レコードを更新する</a></li><li class="rtoc-item"><a href="#rtoc-44">選択された行を他のデータベーストランザクションから一時的にロックする</a></li></ul></li><li class="rtoc-item"><a href="#rtoc-45">レコードの存在確認</a><ul class="rtoc-mokuji mokuji_none level-2"><li class="rtoc-item"><a href="#rtoc-46">特定のレコードが存在するかを確認する</a></li></ul></li></ol></div><h2 id="rtoc-1"  class="wp-block-heading">基本の取得方法</h2>



<p class="wp-block-paragraph">まずは超基本的なクエリセットの取得方法を解説します。</p>



<p class="wp-block-paragraph">Django 公式チュートリアルにも頻出なので説明不要かもしれませんが、基本なので念のためです。</p>



<h3 id="rtoc-2"  class="wp-block-heading">全レコードを取得する</h3>



<p class="wp-block-paragraph">全レコードを取得するには、all() メソッドを使います。</p>



<p class="wp-block-paragraph">余談ですが、objects はマネージャーオブジェクトと呼ばれていて Django コードを解釈して SQL を発行してくれるという役割があります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>queryset = Model.objects.all()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">queryset = Model.objects.all()</span></span></code></pre></div>



<p class="wp-block-paragraph">例えば Model テーブルに 10 個のレコードがあれば、10 個分すべての QuerySet オブジェクトが返ってきます。</p>



<p class="is-style-icon_info wp-block-paragraph">Django では遅延評価がされるので、上記コードが実行されたタイミングでは SQL クエリは発行されません。</p>



<h3 id="rtoc-3"  class="wp-block-heading">プライマリーキーを指定して取得</h3>



<p class="wp-block-paragraph">プライマリキーを指定して、特定のレコードを取得することもできます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>model_instance = Model.objects.get(pk=1)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">model_instance = Model.objects.get(</span><span style="color: #9CDCFE">pk</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">ここでいう get() は Python の辞書に対して使うメソッドとは違って、Django の objects マネージャを通して使われるものであることに注意です。<span class="swl-fz u-fz-xs">（つまり、第二引数にデフォルト値を取ることはできない）</span></p>



<p class="wp-block-paragraph">また、get() でプライマリキーを指定する場合には、クエリセットではなく単一のモデルインスタンスが返ります。</p>



<p class="wp-block-paragraph">そのため、ループできない<span class="swl-fz u-fz-xs">（イテラブルではない）</span>ことにも注意が必要です。</p>



<p class="is-style-icon_announce wp-block-paragraph">該当する pk が存在しない場合には DoesNotExist エラーが、複数のレコードが存在する場合には MultipleObjectsReturned エラーが発生します。</p>



<h2 id="rtoc-4"  class="wp-block-heading">レコードを「文字列」で絞り込んで取得</h2>



<p class="wp-block-paragraph">続いて、「文字列」を基準に絞り込んでレコードを取得する方法をご紹介します。</p>



<h3 id="rtoc-5"  class="wp-block-heading">完全一致で絞り込む</h3>



<p class="wp-block-paragraph">filter() メソッドの引数に、「フィールド名 = 絞り込みたい文字列」を渡しましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>queryset = Model.objects.filter(name="john")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">queryset = Model.objects.filter(</span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;john&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">上記を実行すると、name が John のレコードだけが取得されます。</p>



<h3 id="rtoc-6"  class="wp-block-heading">AND 条件で絞り込んで取得</h3>



<p class="wp-block-paragraph">「 A かつ B 」のような AND 条件で絞り込みたい場合には、フィールドと条件をカンマ区切りで列挙します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>queryset = Model.objects.filter(name="john", band="beatles")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">queryset = Model.objects.filter(</span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;john&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">band</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;beatles&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="is-style-icon_pen wp-block-paragraph">例では name が &#8220;John&#8221; で、かつ band が &#8220;beatles&#8221; のオブジェクトを取得します。</p>



<h3 id="rtoc-7"  class="wp-block-heading">OR 条件で絞り込んで取得</h3>



<p class="wp-block-paragraph">「A または B」のような OR 条件で絞りたい場合には、フィールド名の後に &#8220;__in&#8221; をつけます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>queryset = Model.objects.filter(name__in=&#91;"john","george"&#93;)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">queryset = Model.objects.filter(</span><span style="color: #9CDCFE">name__in</span><span style="color: #D4D4D4">=&#91;</span><span style="color: #CE9178">&quot;john&quot;</span><span style="color: #D4D4D4">,</span><span style="color: #CE9178">&quot;george&quot;</span><span style="color: #D4D4D4">&#93;)</span></span></code></pre></div>



<p class="is-style-icon_announce wp-block-paragraph">この、アンダースコア２つの後に挙動を指示する部分は「フィールドルックアップ」と呼ばれます。</p>



<h3 id="rtoc-8"  class="wp-block-heading">複数のフィールドにまたがって OR 条件で絞り込んで取得</h3>



<p class="wp-block-paragraph">複数フィールドにまたがって OR 条件を指定するには、Qオブジェクトと | （パイプ）を組み合わせて表現します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.db.models import Q
queryset = Model.objects.filter(Q(name="john") | Q(age=30))</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> django.db.models </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Q</span></span>
<span class="line"><span style="color: #D4D4D4">queryset = Model.objects.filter(Q(</span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;john&quot;</span><span style="color: #D4D4D4">) | Q(</span><span style="color: #9CDCFE">age</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">30</span><span style="color: #D4D4D4">))</span></span></code></pre></div>



<p class="wp-block-paragraph">ちなみに OR 以外を表現する方法についても触れておきます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>AND
<ul class="wp-block-list">
<li>Qオブジェクト同士をカンマで区切る</li>



<li>objects = Model.objects.filter(Q(name=&#8221;john&#8221;), Q(age=30))</li>
</ul>
</li>



<li>NOT
<ul class="wp-block-list">
<li>Qオブジェクトの先頭に &#8211; （ハイフン）をつける</li>



<li>objects = Model.objects.filter(~Q(name=&#8221;john&#8221;))</li>
</ul>
</li>
</ul>
</div></div>



<p class="wp-block-paragraph">パイプやハイフンを使うところは、やや Pandas に近いかもしれません。</p>



<p class="is-style-icon_book wp-block-paragraph">なお、__in では単一のフィールド内でしか「または」条件が指定できませんでした。</p>



<h3 id="rtoc-9"  class="wp-block-heading">前方一致で絞り込む</h3>



<p class="wp-block-paragraph">ある文字列から始まるレコードを取得するには、&#8221;startswith&#8221; を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># name が "jo" で始まるレコードを取得
queryset = Model.objects.filter(name__startswith="jo")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># name が &quot;jo&quot; で始まるレコードを取得</span></span>
<span class="line"><span style="color: #D4D4D4">queryset = Model.objects.filter(</span><span style="color: #9CDCFE">name__startswith</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;jo&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="is-style-icon_announce wp-block-paragraph">正規表現でいうところの<code>^</code>と考えるとわかりやすいです。</p>



<h3 id="rtoc-10"  class="wp-block-heading">後方一致で絞り込む</h3>



<p class="wp-block-paragraph">ある文字列で終わるレコードを取得するには、&#8221;endswith&#8221; を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># name が "non" で終わるレコードを取得
queryset = Model.objects.filter(name__endswith="non")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># name が &quot;non&quot; で終わるレコードを取得</span></span>
<span class="line"><span style="color: #D4D4D4">queryset = Model.objects.filter(</span><span style="color: #9CDCFE">name__endswith</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;non&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="is-style-icon_announce wp-block-paragraph">正規表現でいうところの<code>$</code>と考えるとわかりやすいです。</p>



<h3 id="rtoc-11"  class="wp-block-heading">中間一致で絞り込む</h3>



<p class="wp-block-paragraph">指定した文字列を含むかどうかを判定するのが contains です。</p>



<p class="wp-block-paragraph">そのため、中間一致というよりは、文字列の存在をチェックするといった方がわかりやすいかもしれません。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># name に "hn" を含むレコードを取得
queryset = Model.objects.filter(name__contains="hn")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># name に &quot;hn&quot; を含むレコードを取得</span></span>
<span class="line"><span style="color: #D4D4D4">queryset = Model.objects.filter(</span><span style="color: #9CDCFE">name__contains</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;hn&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">もし、大文字・小文字を無視したい場合には icontains を使うことで実現できます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 大文字・小文字を無視する
queryset = Model.objects.filter(name__icontains="hn")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 大文字・小文字を無視する</span></span>
<span class="line"><span style="color: #D4D4D4">queryset = Model.objects.filter(</span><span style="color: #9CDCFE">name__icontains</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;hn&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h2 id="rtoc-12"  class="wp-block-heading">レコードを「数字」で絞り込んで取得</h2>



<p class="wp-block-paragraph">数値型フィールドを使って、数字の大小関係で絞り込む方法です。</p>



<h3 id="rtoc-13"  class="wp-block-heading">より大きい</h3>



<p class="wp-block-paragraph"><code>__gt</code> は &#8220;greater than&#8221; の略で、「より大きい」という意味になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 30 より大きい
queryset = Model.objects.filter(age__gt=30)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 30 より大きい</span></span>
<span class="line"><span style="color: #D4D4D4">queryset = Model.objects.filter(</span><span style="color: #9CDCFE">age__gt</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">30</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="is-style-icon_book wp-block-paragraph">上記の例では &#8220;30&#8221; は含まず、30より大きい数値を持つレコードに絞り込まれます。</p>



<h3 id="rtoc-14"  class="wp-block-heading">より小さい</h3>



<p class="wp-block-paragraph"><code>__lt</code> は &#8220;less than&#8221; の略で、「より小さい」という意味になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 30 より小さい
queryset = Model.objects.filter(age__lt=30)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 30 より小さい</span></span>
<span class="line"><span style="color: #D4D4D4">queryset = Model.objects.filter(</span><span style="color: #9CDCFE">age__lt</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">30</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="is-style-icon_book wp-block-paragraph">上記の例では &#8220;30&#8221; は含まず、30より小さい数値を持つレコードに絞り込まれます。</p>



<h3 id="rtoc-15"  class="wp-block-heading">以上</h3>



<p class="wp-block-paragraph"><code>__gte</code> は &#8220;greater than equal&#8221; の略で、「以上」という意味になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 30 以上
queryset = Model.objects.filter(age__gte=30)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 30 以上</span></span>
<span class="line"><span style="color: #D4D4D4">queryset = Model.objects.filter(</span><span style="color: #9CDCFE">age__gte</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">30</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="is-style-icon_book wp-block-paragraph">上記の例では &#8220;30&#8221; を含む、30以上の数値を持つレコードに絞り込まれます。</p>



<h3 id="rtoc-16"  class="wp-block-heading">以下</h3>



<p class="wp-block-paragraph"><code>__lte</code> は &#8220;less than equal&#8221; の略で、「以下」という意味になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 30 以下
queryset = Model.objects.filter(age__lte=30)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 30 以下</span></span>
<span class="line"><span style="color: #D4D4D4">queryset = Model.objects.filter(</span><span style="color: #9CDCFE">age__lte</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">30</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="is-style-icon_book wp-block-paragraph">上記の例では &#8220;30&#8221; を含む、30以下の数値を持つレコードに絞り込まれます。</p>



<h3 id="rtoc-17"  class="wp-block-heading">範囲</h3>



<p class="wp-block-paragraph">範囲を指定する場合は range を用います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 30 から 50
queryset = Model.objects.filter(age__range=(30, 50))</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 30 から 50</span></span>
<span class="line"><span style="color: #D4D4D4">queryset = Model.objects.filter(</span><span style="color: #9CDCFE">age__range</span><span style="color: #D4D4D4">=(</span><span style="color: #B5CEA8">30</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">50</span><span style="color: #D4D4D4">))</span></span></code></pre></div>



<p class="is-style-icon_book wp-block-paragraph">上記の例では &#8220;30&#8221; と &#8220;50&#8221; を含む、30から50の間を数値として持つレコードに絞り込まれます。</p>



<h2 id="rtoc-18"  class="wp-block-heading">その他の絞り込み</h2>



<p class="wp-block-paragraph">これまでご紹介してきた以外の絞り込み方法をご紹介します。</p>



<h3 id="rtoc-19"  class="wp-block-heading">最新・最古のレコードを取得する</h3>



<p class="wp-block-paragraph">&#8220;created_at&#8221; という DateField がある場合には、次のように日時が最も早い・遅いという基準でレコードを取得できます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 最新のレコードを取得する
latest_instance = Model.objects.latest("created_at")

# 最古のレコードを取得する
oldest_instance = Model.objects.earliest("created_at")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 最新のレコードを取得する</span></span>
<span class="line"><span style="color: #D4D4D4">latest_instance = Model.objects.latest(</span><span style="color: #CE9178">&quot;created_at&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 最古のレコードを取得する</span></span>
<span class="line"><span style="color: #D4D4D4">oldest_instance = Model.objects.earliest(</span><span style="color: #CE9178">&quot;created_at&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 id="rtoc-20"  class="wp-block-heading">最初・最後のレコードを取得する</h3>



<p class="wp-block-paragraph">クエリセットオブジェクトの先頭にあるもの、または最後にあるものを取得する場合です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 最初のレコードを取得する
first_instance = Model.objects.all().first()

# 最後のレコードを取得する
last_instance = Model.objects.all().last()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 最初のレコードを取得する</span></span>
<span class="line"><span style="color: #D4D4D4">first_instance = Model.objects.all().first()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 最後のレコードを取得する</span></span>
<span class="line"><span style="color: #D4D4D4">last_instance = Model.objects.all().last()</span></span></code></pre></div>



<p class="is-style-icon_book wp-block-paragraph">実務的には first() を使うことが多いイメージです。<br>この後に if 文で null チェックを行うという流れが多いと思います。</p>



<h2 id="rtoc-21"  class="wp-block-heading">並び替え</h2>



<p class="wp-block-paragraph">並び替えの方法を解説します。</p>



<h3 id="rtoc-22"  class="wp-block-heading">昇順でソート</h3>



<p class="wp-block-paragraph">昇順の場合には order_by() メソッドの引数にフィールド名を指定します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># name を昇順でソート
queryset = Model.objects.all().order_by("name")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># name を昇順でソート</span></span>
<span class="line"><span style="color: #D4D4D4">queryset = Model.objects.all().order_by(</span><span style="color: #CE9178">&quot;name&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 id="rtoc-23"  class="wp-block-heading">降順でソート</h3>



<p class="wp-block-paragraph">降順の場合には、フィールド名の前に &#8211; （ハイフン）をつけてください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># name を降順でソート
queryset = Model.objects.all().order_by("-name")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># name を降順でソート</span></span>
<span class="line"><span style="color: #D4D4D4">queryset = Model.objects.all().order_by(</span><span style="color: #CE9178">&quot;-name&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 id="rtoc-24"  class="wp-block-heading">複数フィールドを基準にソートする</h3>



<p class="wp-block-paragraph">優先順位に従ってフィールド名をカンマ区切りで書いていきます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>queryset = Model.objects.all().order_by("name", "age")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">queryset = Model.objects.all().order_by(</span><span style="color: #CE9178">&quot;name&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;age&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="is-style-icon_book wp-block-paragraph">上記の例ではまず &#8220;name&#8221; で並び替えをしてから &#8220;age&#8221; で並び替えを行います。</p>



<h2 id="rtoc-25"  class="wp-block-heading">取得形式を指定する</h2>



<p class="wp-block-paragraph">クエリセット以外の形式で取得する方法をご紹介します。</p>



<h3 id="rtoc-26"  class="wp-block-heading">辞書形式で取得する</h3>



<p class="wp-block-paragraph">values() とすることで、辞書形式で取得ができます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 辞書で取得
model_dict = Model.objects.values()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 辞書で取得</span></span>
<span class="line"><span style="color: #D4D4D4">model_dict = Model.objects.values()</span></span></code></pre></div>



<p class="is-style-icon_pen wp-block-paragraph">values() メソッドはデフォルトでクエリセットの全レコードを取得するので、all() メソッドは不要です。</p>



<h3 id="rtoc-27"  class="wp-block-heading">特定カラムをリストで取得する</h3>



<p class="wp-block-paragraph">あるカラムのデータをリストで取得したい場合には、values_list() メソッドを使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># age 列をリスト型で取得する
age_list = Model.objects.values_list("age", flat=True)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># age 列をリスト型で取得する</span></span>
<span class="line"><span style="color: #D4D4D4">age_list = Model.objects.values_list(</span><span style="color: #CE9178">&quot;age&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">flat</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="is-style-icon_pen wp-block-paragraph">flat=True を外すと、リスト型ではなくタプルとして返ります。</p>



<h2 id="rtoc-28"  class="wp-block-heading">クエリセットを使って計算する</h2>



<p class="wp-block-paragraph">計算をすることもできます。</p>



<h3 id="rtoc-29"  class="wp-block-heading">合計値を求める</h3>



<p class="wp-block-paragraph">特定フィールドで合計値を計算する場合、aggregate() メソッドを使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.db.models import Sum

total_price = Product.objects.aggregate(Sum("price"))
print(total_price)
# 実行結果
# {"price__sum": 合計値}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> django.db.models </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Sum</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">total_price = Product.objects.aggregate(Sum(</span><span style="color: #CE9178">&quot;price&quot;</span><span style="color: #D4D4D4">))</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(total_price)</span></span>
<span class="line"><span style="color: #6A9955"># 実行結果</span></span>
<span class="line"><span style="color: #6A9955"># {&quot;price__sum&quot;: 合計値}</span></span></code></pre></div>



<p class="wp-block-paragraph">以下のようにすると、戻り値の辞書のキーを変えることもできます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.db.models import Sum

total_price = Product.objects.aggregate(total_price=Sum("price"))
print(total_price)
# 実行結果
# {"tota_price": 合計値}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> django.db.models </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Sum</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">total_price = Product.objects.aggregate(</span><span style="color: #9CDCFE">total_price</span><span style="color: #D4D4D4">=Sum(</span><span style="color: #CE9178">&quot;price&quot;</span><span style="color: #D4D4D4">))</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(total_price)</span></span>
<span class="line"><span style="color: #6A9955"># 実行結果</span></span>
<span class="line"><span style="color: #6A9955"># {&quot;tota_price&quot;: 合計値}</span></span></code></pre></div>



<h3 id="rtoc-30"  class="wp-block-heading">平均値を求める</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.db.models import Avg
average = Product.objects.aggregate(Avg("price"))</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> django.db.models </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Avg</span></span>
<span class="line"><span style="color: #D4D4D4">average = Product.objects.aggregate(Avg(</span><span style="color: #CE9178">&quot;price&quot;</span><span style="color: #D4D4D4">))</span></span></code></pre></div>



<h3 id="rtoc-31"  class="wp-block-heading">最大値を求める</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.db.models import Max
max = Product.objects.aggregate(Max("price"))</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> django.db.models </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Max</span></span>
<span class="line"><span style="color: #DCDCAA">max</span><span style="color: #D4D4D4"> = Product.objects.aggregate(Max(</span><span style="color: #CE9178">&quot;price&quot;</span><span style="color: #D4D4D4">))</span></span></code></pre></div>



<h3 id="rtoc-32"  class="wp-block-heading">最小値</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.db.models import Min
result = Product.objects.aggregate(Min("price"))</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> django.db.models </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Min</span></span>
<span class="line"><span style="color: #D4D4D4">result = Product.objects.aggregate(Min(</span><span style="color: #CE9178">&quot;price&quot;</span><span style="color: #D4D4D4">))</span></span></code></pre></div>



<h2 id="rtoc-33"  class="wp-block-heading">SQL クエリ発行回数の節約</h2>



<p class="wp-block-paragraph">Django では SQL クエリを然るべきタイミングで実行する「遅延評価」という方式を採用しています。</p>



<p class="wp-block-paragraph">そのため、ForeignKey や ManyToMany フィールドで定義したデータを呼び出す際にはここで紹介するメソッドを利用してデータベースからデータを効率的に取得するのがおすすめです。</p>



<h3 id="rtoc-34"  class="wp-block-heading">ForeignKey のクエリ発行回数を減らす</h3>



<p class="wp-block-paragraph">ForeignKey で定義したフィールドの呼び出しには、select_related() を用います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>queryset = Model.objects.select_related("band").all()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">queryset = Model.objects.select_related(</span><span style="color: #CE9178">&quot;band&quot;</span><span style="color: #D4D4D4">).all()</span></span></code></pre></div>



<h3 id="rtoc-35"  class="wp-block-heading">ManyToMany のクエリ発行回数を減らす</h3>



<p class="wp-block-paragraph">ManyToMany で定義したフィールドの呼び出しには、prefetch_related() を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>queryset = Model.objects.prefetch_related("band").all()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">queryset = Model.objects.prefetch_related(</span><span style="color: #CE9178">&quot;band&quot;</span><span style="color: #D4D4D4">).all()</span></span></code></pre></div>



<h2 id="rtoc-36"  class="wp-block-heading">レコードの更新（追加・削除）</h2>



<h3 id="rtoc-37"  class="wp-block-heading">レコードを追加する</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># レコードを追加 その1
Model.objects.create(name="John Lennon", age=30, part="guitar")

# レコードを追加 その2
model_instance = Model(name="John Lennon", age=30, part="guitar")
model_instance.save()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># レコードを追加 その1</span></span>
<span class="line"><span style="color: #D4D4D4">Model.objects.create(</span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;John Lennon&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">age</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">30</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">part</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;guitar&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># レコードを追加 その2</span></span>
<span class="line"><span style="color: #D4D4D4">model_instance = Model(</span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;John Lennon&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">age</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">30</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">part</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;guitar&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">model_instance.save()</span></span></code></pre></div>



<h3 id="rtoc-38"  class="wp-block-heading">レコードがあれば取得して、なければ追加する</h3>



<p class="wp-block-paragraph">該当のレコードがある場合にはモデルインスタンスと、False を返します。</p>



<p class="wp-block-paragraph">一方で、該当のレコードがない場合には作成の上モデルインスタンスを返し、is_created としてTrue を返す事になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># レコードに存在しなければ作成
model_instance, is_created = Model.objects.get_or_create(name="John Lennon", age=30, part="guitar")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># レコードに存在しなければ作成</span></span>
<span class="line"><span style="color: #D4D4D4">model_instance, is_created = Model.objects.get_or_create(</span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;John Lennon&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">age</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">30</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">part</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;guitar&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 id="rtoc-39"  class="wp-block-heading">特定レコードの値を書き換える</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 変更したいレコードを取得する
model_instance = Model.objects.get(pk=1)
# 内容を変更する
model_instance.name = "Ringo Star"
# 変更を反映する
model_instance.save()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 変更したいレコードを取得する</span></span>
<span class="line"><span style="color: #D4D4D4">model_instance = Model.objects.get(</span><span style="color: #9CDCFE">pk</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #6A9955"># 内容を変更する</span></span>
<span class="line"><span style="color: #D4D4D4">model_instance.name = </span><span style="color: #CE9178">&quot;Ringo Star&quot;</span></span>
<span class="line"><span style="color: #6A9955"># 変更を反映する</span></span>
<span class="line"><span style="color: #D4D4D4">model_instance.save()</span></span></code></pre></div>



<h3 id="rtoc-40"  class="wp-block-heading">特定のレコードの値を削除する</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 変更したいレコードを取得する
model_instance = Model.objects.get(pk=1)
# 削除する
model_instance.delete()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 変更したいレコードを取得する</span></span>
<span class="line"><span style="color: #D4D4D4">model_instance = Model.objects.get(</span><span style="color: #9CDCFE">pk</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #6A9955"># 削除する</span></span>
<span class="line"><span style="color: #D4D4D4">model_instance.delete()</span></span></code></pre></div>



<h3 id="rtoc-41"  class="wp-block-heading"> 複数のレコードを一度に削除する</h3>



<p class="wp-block-paragraph">複数レコードを一度に削除する場合も delete() メソッドで行います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 変更したいレコードを取得する
queryset = Model.objects.filter(band="beatles")
# 削除する
queryset.delete()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 変更したいレコードを取得する</span></span>
<span class="line"><span style="color: #D4D4D4">queryset = Model.objects.filter(</span><span style="color: #9CDCFE">band</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;beatles&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #6A9955"># 削除する</span></span>
<span class="line"><span style="color: #D4D4D4">queryset.delete()</span></span></code></pre></div>



<h3 id="rtoc-42"  class="wp-block-heading">レコードを更新する</h3>



<p class="wp-block-paragraph">レコードを更新するには update メソッドを使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 最初のオブジェクトを取得
model_instance = Model.objects.all().first()
# band フィールドを Beatles に更新
model_instance.update(band="Beatles")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 最初のオブジェクトを取得</span></span>
<span class="line"><span style="color: #D4D4D4">model_instance = Model.objects.all().first()</span></span>
<span class="line"><span style="color: #6A9955"># band フィールドを Beatles に更新</span></span>
<span class="line"><span style="color: #D4D4D4">model_instance.update(</span><span style="color: #9CDCFE">band</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;Beatles&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 id="rtoc-43"  class="wp-block-heading">複数レコードを更新する</h3>



<p class="wp-block-paragraph">複数レコードを一括で変更することもできます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 最初のオブジェクトを取得
queryset = Model.objects.all()
# 全レコードの band フィールドを Beatles に更新
queryset.update(band="Beatles")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 最初のオブジェクトを取得</span></span>
<span class="line"><span style="color: #D4D4D4">queryset = Model.objects.all()</span></span>
<span class="line"><span style="color: #6A9955"># 全レコードの band フィールドを Beatles に更新</span></span>
<span class="line"><span style="color: #D4D4D4">queryset.update(</span><span style="color: #9CDCFE">band</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;Beatles&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 id="rtoc-44"  class="wp-block-heading">選択された行を他のデータベーストランザクションから一時的にロックする</h3>



<p class="wp-block-paragraph"><code>select_for_update()</code> メソッドを用います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>@transaction.atomic
def my_function():
    # データベース操作
    instance = Model.objects.select_for_update().get(pk=1)
    # ここから先、instance に対する操作が制限される
    instance.field += 1
    instalnce.save()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">@transaction.atomic</span></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">my_function</span><span style="color: #D4D4D4">():</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># データベース操作</span></span>
<span class="line"><span style="color: #D4D4D4">    instance = Model.objects.select_for_update().get(</span><span style="color: #9CDCFE">pk</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># ここから先、instance に対する操作が制限される</span></span>
<span class="line"><span style="color: #D4D4D4">    instance.field += </span><span style="color: #B5CEA8">1</span></span>
<span class="line"><span style="color: #D4D4D4">    instalnce.save()</span></span></code></pre></div>



<p class="wp-block-paragraph">上記の通りで、select_for_update() が実行された段階でそのインスタンスへのアクセスが制限されるので、他のトランザクションがこのインスタンスに操作を加えようとすると待機状態になります。</p>



<p class="wp-block-paragraph">なお、待機ではなく即座いにエラーを返したい場合には以下のように nowait=True とします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>@transaction.atomic
def my_function():
    # データベース操作
    instance = Model.objects.select_for_update(nowait=True).get(pk=1)
    # ここから先、instance に対する操作が制限される
    instance.field += 1
    instalnce.save()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">@transaction.atomic</span></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">my_function</span><span style="color: #D4D4D4">():</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># データベース操作</span></span>
<span class="line"><span style="color: #D4D4D4">    instance = Model.objects.select_for_update(</span><span style="color: #9CDCFE">nowait</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">).get(</span><span style="color: #9CDCFE">pk</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># ここから先、instance に対する操作が制限される</span></span>
<span class="line"><span style="color: #D4D4D4">    instance.field += </span><span style="color: #B5CEA8">1</span></span>
<span class="line"><span style="color: #D4D4D4">    instalnce.save()</span></span></code></pre></div>



<p class="is-style-icon_announce wp-block-paragraph">@transaction.atomic を使っているので、関数内で何がしかの問題があればロールバックされます。</p>



<h2 id="rtoc-45"  class="wp-block-heading">レコードの存在確認</h2>



<h3 id="rtoc-46"  class="wp-block-heading">特定のレコードが存在するかを確認する</h3>



<p class="wp-block-paragraph">is_exists には True または False のBool 値が入ります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 存在を確認する
is_exists = Model.objects.filter(name="John").exists()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 存在を確認する</span></span>
<span class="line"><span style="color: #D4D4D4">is_exists = Model.objects.filter(</span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;John&quot;</span><span style="color: #D4D4D4">).exists()</span></span></code></pre></div>
]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
