<?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>データベース操作 &#8211; CFXLOG</title>
	<atom:link href="https://cfxlog.com/tag/database-operations/feed/index.xml" rel="self" type="application/rss+xml" />
	<link>https://cfxlog.com/</link>
	<description></description>
	<lastBuildDate>Wed, 18 Nov 2026 21:49:38 +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>データベース操作 &#8211; CFXLOG</title>
	<link>https://cfxlog.com/</link>
	<width>32</width>
	<height>32</height>
</image> 
	<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>
		<category><![CDATA[データベース操作]]></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>


<h2 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 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 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 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 class="wp-block-heading">フィールド設計に固定ルールは持っていない</h3>



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



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



<h2 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 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>【Python】業務系アプリケーションでよく使うPandas操作の基本</title>
		<link>https://cfxlog.com/python-pandas-basics/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sat, 07 Mar 2026 11:13:18 +0000</pubDate>
				<category><![CDATA[Python]]></category>
		<category><![CDATA[データベース操作]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4951</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-pandas-basics.jpg" class="webfeedsFeaturedVisual" /></p>Pandas は内部的に C 言語で最適化されているので、Python の CSV モジュールなどと比べても超高速に動作します。 また、Pandas で使われる DataFrame には痒いところに手が届くようなメソッド [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-pandas-basics.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>Pandas を使ってみたい！</li>



<li>DataFrame の取り扱い方に自信がない…</li>
</ul>
</div></div>



<p class="wp-block-paragraph">Pandas は内部的に C 言語で最適化されているので、Python の CSV モジュールなどと比べても超高速に動作します。</p>



<p class="wp-block-paragraph">また、Pandas で使われる DataFrame には痒いところに手が届くようなメソッドが多数実装されているので、少ないコード量でデータ分析ができる超便利なライブラリです。</p>



<p class="wp-block-paragraph">とはいえ DataFrame はコードの書き方にやや癖があるので、苦手意識やとっつきにくさを感じている方も多いと思います。</p>



<p class="wp-block-paragraph">本記事ではPandasの基本操作をシンプルにご紹介していきます。</p>



<h2 class="wp-block-heading">DataFrame として読み込む</h2>



<p class="wp-block-paragraph">すでにあるデータから DataFrame として読み込む方法から紹介します。</p>



<p class="wp-block-paragraph">ここで取得した DataFrame オブジェクトに対して加工・集計を行なっていくことになるのでファーストステップですね。</p>



<p class="wp-block-paragraph">引数にパラメーターを与えることで色々できますので、基本の使い方 =&gt; 応用的な使い方までご紹介します。</p>



<h3 class="wp-block-heading">Excel ブック</h3>



<p class="wp-block-paragraph">ただ単に Excel ブックを読み込みたい場合は以下のコードです。</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>excel_path = 'new_book.xlsx'
sheet_name = 'Sheet1'

# Excel => DataFrame
df = pd.read_excel(excel_path, sheet_name=sheet_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: #D4D4D4">excel_path = </span><span style="color: #CE9178">&apos;new_book.xlsx&apos;</span></span>
<span class="line"><span style="color: #D4D4D4">sheet_name = </span><span style="color: #CE9178">&apos;Sheet1&apos;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># Excel =&gt; DataFrame</span></span>
<span class="line"><span style="color: #D4D4D4">df = pd.read_excel(excel_path, </span><span style="color: #9CDCFE">sheet_name</span><span style="color: #D4D4D4">=sheet_name)</span></span></code></pre></div>



<p class="wp-block-paragraph">DataFrame として読み込む場合にはシートを指定することに注意してください。<span class="swl-fz u-fz-xs">（CSVはシートという概念がないので<code>sheet_name</code>がない）</span></p>



<p class="wp-block-paragraph">エンコードの関係で文字化けする場合には、<code>encoding</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>excel_path = 'new_book.xlsx'
sheet_name = 'Sheet1'

# Excel => DataFrame
df = pd.read_excel(excel_path, sheet_name=sheet_name, encoding='utf-8_sig')</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">excel_path = </span><span style="color: #CE9178">&apos;new_book.xlsx&apos;</span></span>
<span class="line"><span style="color: #D4D4D4">sheet_name = </span><span style="color: #CE9178">&apos;Sheet1&apos;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># Excel =&gt; DataFrame</span></span>
<span class="line"><span style="color: #D4D4D4">df = pd.read_excel(excel_path, </span><span style="color: #9CDCFE">sheet_name</span><span style="color: #D4D4D4">=sheet_name, </span><span style="color: #9CDCFE">encoding</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&apos;utf-8_sig&apos;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">基本的には<code>utf-8_sig</code>でいけますが、それでもダメな場合は<code>ANSI</code>や<code>cp932</code>を使ってみましょう。色々試してみてください。</p>



<h3 class="wp-block-heading">CSV ファイル</h3>



<p class="wp-block-paragraph">CSVファイルを読み込む方法です。</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>csv_path = 'somefile.csv'

# CSV => DataFrame
df = pd.read_CSV(csv_path, encoding="utf-8_sig")</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">csv_path = </span><span style="color: #CE9178">&apos;somefile.csv&apos;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># CSV =&gt; DataFrame</span></span>
<span class="line"><span style="color: #D4D4D4">df = pd.read_CSV(csv_path, </span><span style="color: #9CDCFE">encoding</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;utf-8_sig&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">CSVファイルは文字化けの問題が多いので、基本的には<code>encoding</code>で指定します。</p>



<h2 class="wp-block-heading">データ整形</h2>



<h3 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># 青森県を取得
df&#91;"都道府県"&#93; = df[df&#91;"都道府県"&#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: #6A9955"># 青森県を取得</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;都道府県&quot;</span><span style="color: #D4D4D4">&#93; = df[df&#91;</span><span style="color: #CE9178">&quot;都道府県&quot;</span><span style="color: #D4D4D4">&#93; == </span><span style="color: #CE9178">&quot;青森県&quot;</span><span style="color: #D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>df["都道府県"] == "青森県"</code>の部分では<code>True</code>か<code>False</code>のブール値が得られますので、これを外から<code>df</code>で囲むと<code>True</code>のものだけが抽出できるというわけです。</p>



<p class="wp-block-paragraph">逆に<code>False</code>のものだけで抽出したい場合には、以下のように<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">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># 青森県以外を取得
df&#91;"都道府県"&#93; = df[~df&#91;"都道府県"&#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: #6A9955"># 青森県以外を取得</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;都道府県&quot;</span><span style="color: #D4D4D4">&#93; = df[~df&#91;</span><span style="color: #CE9178">&quot;都道府県&quot;</span><span style="color: #D4D4D4">&#93; == </span><span style="color: #CE9178">&quot;青森県&quot;</span><span style="color: #D4D4D4">]</span></span></code></pre></div>



<h3 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># 得点が80点以上のレコードを取得
df&#91;"得点"&#93; = df[df&#91;"得点"&#93; &lt;= 80]</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"># 得点が80点以上のレコードを取得</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;得点&quot;</span><span style="color: #D4D4D4">&#93; = df[df&#91;</span><span style="color: #CE9178">&quot;得点&quot;</span><span style="color: #D4D4D4">&#93; &lt;= </span><span style="color: #B5CEA8">80</span><span style="color: #D4D4D4">]</span></span></code></pre></div>



<h3 class="wp-block-heading">あるキーワードを含むレコードで絞り込む</h3>



<p class="wp-block-paragraph"><code>isin</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># 「県」を含むレコードを取得
df&#91;"都道府県"&#93; = df[df&#91;"都道府県"&#93;.isin(&#91;"県"&#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: #6A9955"># 「県」を含むレコードを取得</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;都道府県&quot;</span><span style="color: #D4D4D4">&#93; = df[df&#91;</span><span style="color: #CE9178">&quot;都道府県&quot;</span><span style="color: #D4D4D4">&#93;.isin(&#91;</span><span style="color: #CE9178">&quot;県&quot;</span><span style="color: #D4D4D4">&#93;)]</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">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># 「県」を含むレコードを取得
df&#91;"都道府県"&#93; = df[~df&#91;"都道府県"&#93;.isin(&#91;"県"&#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: #6A9955"># 「県」を含むレコードを取得</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;都道府県&quot;</span><span style="color: #D4D4D4">&#93; = df[~df&#91;</span><span style="color: #CE9178">&quot;都道府県&quot;</span><span style="color: #D4D4D4">&#93;.isin(&#91;</span><span style="color: #CE9178">&quot;県&quot;</span><span style="color: #D4D4D4">&#93;)]</span></span></code></pre></div>



<h2 class="wp-block-heading">日時の操作</h2>



<h3 class="wp-block-heading">datetime型に変換する</h3>



<p class="wp-block-paragraph">日時に関するデータを読み込んだはずが文字列型で読み込まれていることがあります。</p>



<p class="wp-block-paragraph">そんな時は、<code>to_datetime</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>df&#91;"日時"&#93; = pd.to_datetime(df&#91;"日時"&#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">df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93; = pd.to_datetime(df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93;)</span></span></code></pre></div>



<h3 class="wp-block-heading">timedelta型に変換する</h3>



<p class="wp-block-paragraph">時間計算などする場合には<code>timedelta</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>df&#91;"時間"&#93; = pd.to_timedelta(df&#91;"時間"&#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">df&#91;</span><span style="color: #CE9178">&quot;時間&quot;</span><span style="color: #D4D4D4">&#93; = pd.to_timedelta(df&#91;</span><span style="color: #CE9178">&quot;時間&quot;</span><span style="color: #D4D4D4">&#93;)</span></span></code></pre></div>



<h3 class="wp-block-heading">年 / 月 / 日だけを抽出する</h3>



<p class="wp-block-paragraph">年・月・日など単体で要素を取り出したい場合、dtアクセサを使うとうまく抽出できます。</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># 年だけ抽出
df&#91;"年"&#93; = df&#91;"日時"&#93;.dt.year
# 月だけ抽出
df&#91;"月"&#93; = df&#91;"日時"&#93;.dt.month
# 日だけ抽出
df&#91;"日"&#93; = df&#91;"日時"&#93;.dt.day</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">df&#91;</span><span style="color: #CE9178">&quot;年&quot;</span><span style="color: #D4D4D4">&#93; = df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93;.dt.year</span></span>
<span class="line"><span style="color: #6A9955"># 月だけ抽出</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;月&quot;</span><span style="color: #D4D4D4">&#93; = df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93;.dt.month</span></span>
<span class="line"><span style="color: #6A9955"># 日だけ抽出</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;日&quot;</span><span style="color: #D4D4D4">&#93; = df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93;.dt.day</span></span></code></pre></div>



<h3 class="wp-block-heading">日時で丸め / 切り捨て / 切り上げ</h3>



<p class="wp-block-paragraph"><code>datetime</code>型はミリ秒単位で情報があるとかえって扱いが煩雑になってしまうことがあるので、必要な範囲でデータを削ぎ落としておくと扱いがラクになります。</p>



<p class="wp-block-paragraph"><code>dt</code>アクセサを使って<code>datetime</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># 日時の丸め
df&#91;"日時"&#93; = df&#91;"日時"&#93;.dt.round(freq="D")  # 日
df&#91;"日時"&#93; = df&#91;"日時"&#93;.dt.round(freq="H")  # 時間
df&#91;"日時"&#93; = df&#91;"日時"&#93;.dt.round(freq="15T")  # 15分

# 日時の切り捨て
df&#91;"日時"&#93; = df&#91;"日時"&#93;.dt.floor(freq="D")  # 日
df&#91;"日時"&#93; = df&#91;"日時"&#93;.dt.floor(freq="H")  # 時間
df&#91;"日時"&#93; = df&#91;"日時"&#93;.dt.floor(freq="15T")  # 15分

# 日時の切り捨て
df&#91;"日時"&#93; = df&#91;"日時"&#93;.dt.ceil(freq="D")  # 日
df&#91;"日時"&#93; = df&#91;"日時"&#93;.dt.ceil(freq="H")  # 時間
df&#91;"日時"&#93; = df&#91;"日時"&#93;.dt.ceil(freq="15T")  # 15分</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">df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93; = df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93;.dt.round(</span><span style="color: #9CDCFE">freq</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;D&quot;</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 日</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93; = df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93;.dt.round(</span><span style="color: #9CDCFE">freq</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;H&quot;</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 時間</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93; = df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93;.dt.round(</span><span style="color: #9CDCFE">freq</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;15T&quot;</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 15分</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 日時の切り捨て</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93; = df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93;.dt.floor(</span><span style="color: #9CDCFE">freq</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;D&quot;</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 日</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93; = df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93;.dt.floor(</span><span style="color: #9CDCFE">freq</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;H&quot;</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 時間</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93; = df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93;.dt.floor(</span><span style="color: #9CDCFE">freq</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;15T&quot;</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 15分</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 日時の切り捨て</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93; = df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93;.dt.ceil(</span><span style="color: #9CDCFE">freq</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;D&quot;</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 日</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93; = df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93;.dt.ceil(</span><span style="color: #9CDCFE">freq</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;H&quot;</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 時間</span></span>
<span class="line"><span style="color: #D4D4D4">df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93; = df&#91;</span><span style="color: #CE9178">&quot;日時&quot;</span><span style="color: #D4D4D4">&#93;.dt.ceil(</span><span style="color: #9CDCFE">freq</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;15T&quot;</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 15分</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>round</code>に渡す引数<code>freq</code>はかなりの数が用意されているので、目的に合わせて公式ドキュメントを参照してみましょう。</p>



<p class="wp-block-paragraph"><a href="https://pandas.pydata.org/pandas-docs/stable/user_guide/timeseries.html#offset-aliases">» 参考：pandas Offset aliases</a></p>



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



<p class="wp-block-paragraph">Python でデータを扱う場合に比べてややクセはありますが、Pandas なら高速に少ないコード量でやりたいことが実現できます。</p>



<p class="wp-block-paragraph">習得までには少し時間がかかるかもしれませんが、データを扱う場合に大きな力になってくれるライブラリです。</p>



<p class="wp-block-paragraph">ぜひ、スラスラと書けるようになるまで使い込んでみてください。</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>



<h2 class="wp-block-heading">基本の取得方法</h2>



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



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



<h3 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 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 class="wp-block-heading">レコードを「文字列」で絞り込んで取得</h2>



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



<h3 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 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 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 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 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 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 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 class="wp-block-heading">レコードを「数字」で絞り込んで取得</h2>



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



<h3 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 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 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 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 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 class="wp-block-heading">その他の絞り込み</h2>



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



<h3 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 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 class="wp-block-heading">並び替え</h2>



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



<h3 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 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 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 class="wp-block-heading">取得形式を指定する</h2>



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



<h3 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 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 class="wp-block-heading">クエリセットを使って計算する</h2>



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



<h3 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 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 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 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 class="wp-block-heading">SQL クエリ発行回数の節約</h2>



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



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



<h3 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 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 class="wp-block-heading">レコードの更新（追加・削除）</h2>



<h3 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 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 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 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 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 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 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 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 class="wp-block-heading">レコードの存在確認</h2>



<h3 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>
		<item>
		<title>【SQL】SELECT でデータ取得するための基礎講座</title>
		<link>https://cfxlog.com/sql-select-basics/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sat, 10 Jan 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[SQL]]></category>
		<category><![CDATA[データベース操作]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4925</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/sql-select-basics.jpg" class="webfeedsFeaturedVisual" /></p>このような方に向けて書きました。 SQL 操作の中でも「基本」かつ「最重要」なのが今回ご紹介するSELECT文です。 データベースからデータを取得してくるクエリで、単にデータを取得してくるほか条件や並び替え、集計などを行 [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/sql-select-basics.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>SQL でデータを取得したい！</li>



<li>できればちょっと複雑な条件で取得したい。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような方に向けて書きました。</p>



<p class="wp-block-paragraph">SQL 操作の中でも「基本」かつ「最重要」なのが今回ご紹介する<code>SELECT</code>文です。</p>



<p class="wp-block-paragraph">データベースからデータを取得してくるクエリで、単にデータを取得してくるほか条件や並び替え、集計などを行うことができます。</p>



<p class="wp-block-paragraph">必ずマスターすべきクエリの一つなので、一つずつ丁寧に確認していきましょう！</p>



<h2 class="wp-block-heading">SELECT 文の基本</h2>



<p class="wp-block-paragraph">データベースからデータを取得する時に使うのが<code>SELECT</code>文です。</p>



<h3 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">SQL</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>SELECT 列1, 列2, ...
FROM テーブル名
WHERE 条件
GROUP BY 列1
HAVING 集計条件
ORDER BY 列1
LIMIT 件数 OFFSET オフセット;</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: #569CD6">SELECT</span><span style="color: #D4D4D4"> 列1, 列2, ...</span></span>
<span class="line"><span style="color: #569CD6">FROM</span><span style="color: #D4D4D4"> テーブル名</span></span>
<span class="line"><span style="color: #569CD6">WHERE</span><span style="color: #D4D4D4"> 条件</span></span>
<span class="line"><span style="color: #569CD6">GROUP BY</span><span style="color: #D4D4D4"> 列1</span></span>
<span class="line"><span style="color: #569CD6">HAVING</span><span style="color: #D4D4D4"> 集計条件</span></span>
<span class="line"><span style="color: #569CD6">ORDER BY</span><span style="color: #D4D4D4"> 列1</span></span>
<span class="line"><span style="color: #569CD6">LIMIT</span><span style="color: #D4D4D4"> 件数 OFFSET オフセット;</span></span></code></pre></div>



<p class="wp-block-paragraph">それぞれの句を詳しく説明すると、以下の通りです。</p>



<figure class="wp-block-table"><table><thead><tr><th>句</th><th>効果</th></tr></thead><tbody><tr><td>SELECT</td><td>取得する列を指定<br>全列取得には<code>*</code>を使用</td></tr><tr><td>FROM</td><td>取得するテーブルを指定</td></tr><tr><td>WHERE</td><td>取得条件を指定</td></tr><tr><td>GROUP BY</td><td>特定の列でグループ化</td></tr><tr><td>HAVING</td><td>GROUP BYのデータに条件指定</td></tr><tr><td>ORDER BY</td><td>特定の列で並び替える</td></tr><tr><td>LIMIT</td><td>取得する行数を制限</td></tr></tbody></table><figcaption class="wp-element-caption">句の説明</figcaption></figure>



<h3 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">SQL</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>SELECT *
FROM employees;</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: #569CD6">SELECT</span><span style="color: #D4D4D4"> *</span></span>
<span class="line"><span style="color: #569CD6">FROM</span><span style="color: #D4D4D4"> employees;</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>employees</code>テーブルからすべての列のデータを取得します。</p>



<p class="wp-block-paragraph"><code>SELECT</code>はデータベースからデータを選択するために使います。</p>



<p class="wp-block-paragraph">さらにすべての列を表す<code>*</code>（アスタリスク）を使うことで、<code>SELECT</code>の対象がすべての行になります。</p>



<h3 class="wp-block-heading">特定の列を取得</h3>



<p class="wp-block-paragraph">特定の列だけを抽出する場合、<code>SELECT</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">SQL</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>SELECT name, age
FROM employees;</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: #569CD6">SELECT</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">name</span><span style="color: #D4D4D4">, age</span></span>
<span class="line"><span style="color: #569CD6">FROM</span><span style="color: #D4D4D4"> employees;</span></span></code></pre></div>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>クエリ実行例</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">元々、<code>employees</code>テーブルが次のようなものだったとします。</p>



<figure class="wp-block-table"><table><thead><tr><th>id</th><th>name</th><th>age</th><th>position</th><th>salary</th></tr></thead><tbody><tr><td>1</td><td>Alice</td><td>30</td><td>Manager</td><td>70000</td></tr><tr><td>2</td><td>Bob</td><td>25</td><td>Developer</td><td>60000</td></tr><tr><td>3</td><td>Carol</td><td>28</td><td>Designer</td><td>55000</td></tr></tbody></table><figcaption class="wp-element-caption">クエリ実行前</figcaption></figure>



<p class="wp-block-paragraph">クエリの実行結果は以下になります。</p>



<figure class="wp-block-table"><table><thead><tr><th>name</th><th>age</th></tr></thead><tbody><tr><td>Alice</td><td>30</td></tr><tr><td>Bob</td><td>25</td></tr><tr><td>Carol</td><td>28</td></tr></tbody></table><figcaption class="wp-element-caption">クエリ実行結果</figcaption></figure>
</div></div>



<h3 class="wp-block-heading">条件に一致する行を取得</h3>



<p class="wp-block-paragraph">条件の指定は<code>WHERE</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">SQL</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>SELECT name, age
FROM employees
WHERE 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: #569CD6">SELECT</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">name</span><span style="color: #D4D4D4">, age</span></span>
<span class="line"><span style="color: #569CD6">FROM</span><span style="color: #D4D4D4"> employees</span></span>
<span class="line"><span style="color: #569CD6">WHERE</span><span style="color: #D4D4D4"> age &gt; </span><span style="color: #B5CEA8">30</span><span style="color: #D4D4D4">;</span></span></code></pre></div>



<p class="wp-block-paragraph">上記では、<code>employees</code>テーブルから<code>age</code>列の値が<code>30</code>より大きい異形の<code>name</code>と<code>age</code>列のデータだけを取得します。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>クエリ実行例</span></div><div class="cap_box_content">
<p class="wp-block-paragraph"><code>employees</code>テーブルが次のようだったとします。</p>



<figure class="wp-block-table"><table><thead><tr><th>id</th><th>name</th><th>age</th><th>position</th><th>salary</th></tr></thead><tbody><tr><td>1</td><td>Alice</td><td>35</td><td>Manager</td><td>70000</td></tr><tr><td>2</td><td>Bob</td><td>25</td><td>Developer</td><td>60000</td></tr><tr><td>3</td><td>Carol</td><td>40</td><td>Designer</td><td>55000</td></tr><tr><td>4</td><td>Dave</td><td>30</td><td>Tester</td><td>50000</td></tr></tbody></table><figcaption class="wp-element-caption">元々のテーブル</figcaption></figure>



<p class="wp-block-paragraph">クエリの実行結果は以下です。</p>



<figure class="wp-block-table"><table><thead><tr><th>name</th><th>age</th></tr></thead><tbody><tr><td>Alice</td><td>35</td></tr><tr><td>Carol</td><td>40</td></tr></tbody></table><figcaption class="wp-element-caption">クエリ実行結果</figcaption></figure>
</div></div>



<h3 class="wp-block-heading">データをグループ化して集計</h3>



<p class="wp-block-paragraph"><code>GROUP BY</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">SQL</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>SELECT department, COUNT(*)
FROM employees
GROUP BY department;</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: #569CD6">SELECT</span><span style="color: #D4D4D4"> department, </span><span style="color: #DCDCAA">COUNT</span><span style="color: #D4D4D4">(*)</span></span>
<span class="line"><span style="color: #569CD6">FROM</span><span style="color: #D4D4D4"> employees</span></span>
<span class="line"><span style="color: #569CD6">GROUP BY</span><span style="color: #D4D4D4"> department;</span></span></code></pre></div>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>クエリ実行例</span></div><div class="cap_box_content">
<p class="wp-block-paragraph"><code>employees</code>テーブルが以下だったとします。</p>



<figure class="wp-block-table"><table><thead><tr><th>id</th><th>name</th><th>age</th><th>department</th><th>position</th><th>salary</th></tr></thead><tbody><tr><td>1</td><td>Alice</td><td>35</td><td>HR</td><td>Manager</td><td>70000</td></tr><tr><td>2</td><td>Bob</td><td>25</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>3</td><td>Carol</td><td>40</td><td>IT</td><td>Designer</td><td>55000</td></tr><tr><td>4</td><td>Dave</td><td>30</td><td>HR</td><td>Tester</td><td>50000</td></tr><tr><td>5</td><td>Eve</td><td>28</td><td>Sales</td><td>Sales Rep</td><td>45000</td></tr></tbody></table><figcaption class="wp-element-caption">元々のテーブル</figcaption></figure>



<p class="wp-block-paragraph">クエリの実行結果は以下の通りです。</p>



<figure class="wp-block-table"><table><thead><tr><th>department</th><th>COUNT(*)</th></tr></thead><tbody><tr><td>HR</td><td>2</td></tr><tr><td>IT</td><td>2</td></tr><tr><td>Sales</td><td>1</td></tr></tbody></table><figcaption class="wp-element-caption">クエリ実行結果</figcaption></figure>



<p class="wp-block-paragraph">つまり<code>employees</code>テーブルから各部門ごとに従業員の数をカウントし、各部門名と従業員数を取得します。</p>
</div></div>



<h3 class="wp-block-heading">集計データに条件をつける場合</h3>



<p class="wp-block-paragraph"><code>GROUP BY</code>の条件指定には<code>HAVING</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">SQL</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>SELECT department, COUNT(*)
FROM employees
GROUP BY department
HAVING COUNT(*) > 5;</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: #569CD6">SELECT</span><span style="color: #D4D4D4"> department, </span><span style="color: #DCDCAA">COUNT</span><span style="color: #D4D4D4">(*)</span></span>
<span class="line"><span style="color: #569CD6">FROM</span><span style="color: #D4D4D4"> employees</span></span>
<span class="line"><span style="color: #569CD6">GROUP BY</span><span style="color: #D4D4D4"> department</span></span>
<span class="line"><span style="color: #569CD6">HAVING</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">COUNT</span><span style="color: #D4D4D4">(*) &gt; </span><span style="color: #B5CEA8">5</span><span style="color: #D4D4D4">;</span></span></code></pre></div>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>クエリ実行例</span></div><div class="cap_box_content">
<p class="wp-block-paragraph"><code>employees</code>テーブルが以下だったとします。</p>



<figure class="wp-block-table"><table><thead><tr><th>id</th><th>name</th><th>age</th><th>department</th><th>position</th><th>salary</th></tr></thead><tbody><tr><td>1</td><td>Alice</td><td>35</td><td>HR</td><td>Manager</td><td>70000</td></tr><tr><td>2</td><td>Bob</td><td>25</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>3</td><td>Carol</td><td>40</td><td>IT</td><td>Designer</td><td>55000</td></tr><tr><td>4</td><td>Dave</td><td>30</td><td>HR</td><td>Tester</td><td>50000</td></tr><tr><td>5</td><td>Eve</td><td>28</td><td>Sales</td><td>Sales Rep</td><td>45000</td></tr><tr><td>6</td><td>Frank</td><td>32</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>7</td><td>Grace</td><td>29</td><td>IT</td><td>Designer</td><td>55000</td></tr><tr><td>8</td><td>Heidi</td><td>27</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>9</td><td>Ivan</td><td>26</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>10</td><td>Judy</td><td>31</td><td>Sales</td><td>Sales Rep</td><td>45000</td></tr></tbody></table><figcaption class="wp-element-caption">元々のテーブル</figcaption></figure>



<p class="wp-block-paragraph">以下がクエリの実行結果です。</p>



<figure class="wp-block-table"><table><thead><tr><th>department</th><th>COUNT(*)</th></tr></thead><tbody><tr><td>IT</td><td>6</td></tr></tbody></table><figcaption class="wp-element-caption">クエリ実行結果</figcaption></figure>



<p class="wp-block-paragraph">このように、<code>employees</code>テーブルから各部門ごとに従業員の数をカウントし、その結果が<code>5</code>より多い部門だけが取得されます。</p>



<p class="wp-block-paragraph">今回は5より大きいのは<code>IT</code>のみなので、このような結果になりました。</p>
</div></div>



<h3 class="wp-block-heading">データを並び替える</h3>



<p class="wp-block-paragraph">データの並び替えには<code>ORDER BY</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">SQL</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>SELECT name, age
FROM employees
ORDER BY age DESC;</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: #569CD6">SELECT</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">name</span><span style="color: #D4D4D4">, age</span></span>
<span class="line"><span style="color: #569CD6">FROM</span><span style="color: #D4D4D4"> employees</span></span>
<span class="line"><span style="color: #569CD6">ORDER BY</span><span style="color: #D4D4D4"> age </span><span style="color: #569CD6">DESC</span><span style="color: #D4D4D4">;</span></span></code></pre></div>



<p class="wp-block-paragraph">高い順（降順）に並び替える場合には<code>DESC</code>を、低い順（昇順）に並び替える場合には<code>ASC</code>を使います。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>クエリ実行例</span></div><div class="cap_box_content">
<p class="wp-block-paragraph"><code>employees</code>テーブルが以下だったとします。</p>



<figure class="wp-block-table"><table><thead><tr><th>id</th><th>name</th><th>age</th><th>department</th><th>position</th><th>salary</th></tr></thead><tbody><tr><td>1</td><td>Alice</td><td>35</td><td>HR</td><td>Manager</td><td>70000</td></tr><tr><td>2</td><td>Bob</td><td>25</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>3</td><td>Carol</td><td>40</td><td>IT</td><td>Designer</td><td>55000</td></tr><tr><td>4</td><td>Dave</td><td>30</td><td>HR</td><td>Tester</td><td>50000</td></tr><tr><td>5</td><td>Eve</td><td>28</td><td>Sales</td><td>Sales Rep</td><td>45000</td></tr></tbody></table><figcaption class="wp-element-caption">元々のテーブル</figcaption></figure>



<p class="wp-block-paragraph">以下がクエリの実行結果です。</p>



<figure class="wp-block-table"><table><thead><tr><th>name</th><th>age</th></tr></thead><tbody><tr><td>Carol</td><td>40</td></tr><tr><td>Alice</td><td>35</td></tr><tr><td>Dave</td><td>30</td></tr><tr><td>Eve</td><td>28</td></tr><tr><td>Bob</td><td>25</td></tr></tbody></table><figcaption class="wp-element-caption">クエリ実行結果</figcaption></figure>



<p class="wp-block-paragraph"><code>employees</code>テーブルから<code>name</code>と<code>age</code>列のデータを取得し、<code>age</code>列の値が高い順に並べ替えた結果が出力されます。</p>
</div></div>



<h3 class="wp-block-heading">取得する行数を制限</h3>



<p class="wp-block-paragraph">ページネーションをする場合やデータの一部だけ取得してパフォーマンスを上げたい場合などに便利なのが<code>LIMIT</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">SQL</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>SELECT name, age
FROM employees
LIMIT 10;</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: #569CD6">SELECT</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">name</span><span style="color: #D4D4D4">, age</span></span>
<span class="line"><span style="color: #569CD6">FROM</span><span style="color: #D4D4D4"> employees</span></span>
<span class="line"><span style="color: #569CD6">LIMIT</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">10</span><span style="color: #D4D4D4">;</span></span></code></pre></div>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>クエリ実行例</span></div><div class="cap_box_content">
<p class="wp-block-paragraph"><code>employees</code>テーブルが以下だったとします。</p>



<figure class="wp-block-table"><table><thead><tr><th>id</th><th>name</th><th>age</th><th>department</th><th>position</th><th>salary</th></tr></thead><tbody><tr><td>1</td><td>Alice</td><td>35</td><td>HR</td><td>Manager</td><td>70000</td></tr><tr><td>2</td><td>Bob</td><td>25</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>3</td><td>Carol</td><td>40</td><td>IT</td><td>Designer</td><td>55000</td></tr><tr><td>4</td><td>Dave</td><td>30</td><td>HR</td><td>Tester</td><td>50000</td></tr><tr><td>5</td><td>Eve</td><td>28</td><td>Sales</td><td>Sales Rep</td><td>45000</td></tr><tr><td>6</td><td>Frank</td><td>32</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>7</td><td>Grace</td><td>29</td><td>IT</td><td>Designer</td><td>55000</td></tr><tr><td>8</td><td>Heidi</td><td>27</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>9</td><td>Ivan</td><td>26</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>10</td><td>Judy</td><td>31</td><td>Sales</td><td>Sales Rep</td><td>45000</td></tr><tr><td>11</td><td>Kevin</td><td>33</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>12</td><td>Laura</td><td>24</td><td>HR</td><td>Assistant</td><td>40000</td></tr></tbody></table><figcaption class="wp-element-caption">元々のテーブル</figcaption></figure>



<p class="wp-block-paragraph">以下がクエリの実行結果です。</p>



<figure class="wp-block-table"><table><thead><tr><th>name</th><th>age</th></tr></thead><tbody><tr><td>Alice</td><td>35</td></tr><tr><td>Bob</td><td>25</td></tr><tr><td>Carol</td><td>40</td></tr><tr><td>Dave</td><td>30</td></tr><tr><td>Eve</td><td>28</td></tr><tr><td>Frank</td><td>32</td></tr><tr><td>Grace</td><td>29</td></tr><tr><td>Heidi</td><td>27</td></tr><tr><td>Ivan</td><td>26</td></tr><tr><td>Judy</td><td>31</td></tr></tbody></table><figcaption class="wp-element-caption">クエリ実行結果</figcaption></figure>



<p class="wp-block-paragraph"><code>employees</code>テーブルから<code>name</code>と<code>age</code>列のデータを取得し、その中から最初の10行までのデータが返されます。</p>
</div></div>



<h3 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">SQL</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>SELECT department, AVG(salary)
FROM employees
WHERE age > 30
GROUP BY department
HAVING AVG(salary) > 50000
ORDER BY AVG(salary) DESC
LIMIT 5 OFFSET 10;</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: #569CD6">SELECT</span><span style="color: #D4D4D4"> department, </span><span style="color: #DCDCAA">AVG</span><span style="color: #D4D4D4">(salary)</span></span>
<span class="line"><span style="color: #569CD6">FROM</span><span style="color: #D4D4D4"> employees</span></span>
<span class="line"><span style="color: #569CD6">WHERE</span><span style="color: #D4D4D4"> age &gt; </span><span style="color: #B5CEA8">30</span></span>
<span class="line"><span style="color: #569CD6">GROUP BY</span><span style="color: #D4D4D4"> department</span></span>
<span class="line"><span style="color: #569CD6">HAVING</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">AVG</span><span style="color: #D4D4D4">(salary) &gt; </span><span style="color: #B5CEA8">50000</span></span>
<span class="line"><span style="color: #569CD6">ORDER BY</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">AVG</span><span style="color: #D4D4D4">(salary) </span><span style="color: #569CD6">DESC</span></span>
<span class="line"><span style="color: #569CD6">LIMIT</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">5</span><span style="color: #D4D4D4"> OFFSET </span><span style="color: #B5CEA8">10</span><span style="color: #D4D4D4">;</span></span></code></pre></div>



<p class="wp-block-paragraph">このクエリは、30歳以上の従業員のデータから、部門ごとの平均給与を計算し、平均給与が50,000を超える部門を取得し、給与の高い順に並べ替え、11番目から15番目までの部門を取得します。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>クエリ実行例</span></div><div class="cap_box_content">
<p class="wp-block-paragraph"><code>employees</code>テーブルが以下だったとします。</p>



<figure class="wp-block-table"><table><thead><tr><th>id</th><th>name</th><th>age</th><th>department</th><th>position</th><th>salary</th></tr></thead><tbody><tr><td>1</td><td>Alice</td><td>35</td><td>HR</td><td>Manager</td><td>70000</td></tr><tr><td>2</td><td>Bob</td><td>45</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>3</td><td>Carol</td><td>40</td><td>IT</td><td>Designer</td><td>55000</td></tr><tr><td>4</td><td>Dave</td><td>32</td><td>HR</td><td>Tester</td><td>50000</td></tr><tr><td>5</td><td>Eve</td><td>38</td><td>Sales</td><td>Sales Rep</td><td>45000</td></tr><tr><td>6</td><td>Frank</td><td>42</td><td>IT</td><td>Developer</td><td>65000</td></tr><tr><td>7</td><td>Grace</td><td>29</td><td>IT</td><td>Designer</td><td>55000</td></tr><tr><td>8</td><td>Heidi</td><td>27</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>9</td><td>Ivan</td><td>26</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>10</td><td>Judy</td><td>31</td><td>Sales</td><td>Sales Rep</td><td>47000</td></tr><tr><td>11</td><td>Kevin</td><td>33</td><td>IT</td><td>Developer</td><td>60000</td></tr><tr><td>12</td><td>Laura</td><td>24</td><td>HR</td><td>Assistant</td><td>40000</td></tr><tr><td>13</td><td>Mike</td><td>55</td><td>HR</td><td>Consultant</td><td>80000</td></tr><tr><td>14</td><td>Nina</td><td>36</td><td>Sales</td><td>Sales Rep</td><td>48000</td></tr></tbody></table><figcaption class="wp-element-caption">元々のテーブル</figcaption></figure>



<p class="wp-block-paragraph">以下がクエリの実行結果です。</p>



<figure class="wp-block-table"><table><thead><tr><th>department</th><th>AVG(salary)</th></tr></thead><tbody><tr><td>IT</td><td>62500</td></tr><tr><td>HR</td><td>60000</td></tr></tbody></table><figcaption class="wp-element-caption">クエリ実行結果</figcaption></figure>



<p class="wp-block-paragraph">ただし、<code>LIMIT 5 OFFSET 10</code>によって適用されるデータが上記の例に適用される場合は、スキップされたり表示されたりするデータ量に応じて部分的な結果のみが表示される可能性があります。</p>
</div></div>



<h2 class="wp-block-heading">まとめ：SELECT 文を理解してSQLの超基本をマスターしよう！</h2>



<p class="wp-block-paragraph">SQL の基本かつ超重要な<code>SELECT</code>文をご紹介しました。</p>



<p class="wp-block-paragraph">ちょっと複雑なクエリもありましたが、一つ一つ丁寧に追っていけば必ず理解できるはずです。</p>



<p class="wp-block-paragraph">ぜひ、マスターまでクエリを書きつつ粘り強く挑戦してみてください。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>SQLAlchemyの使い方｜2.0の書き方とCRUD・エラー対処</title>
		<link>https://cfxlog.com/python-sqlalchemy-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Mon, 08 Dec 2025 15:00:00 +0000</pubDate>
				<category><![CDATA[Python]]></category>
		<category><![CDATA[データベース操作]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4781</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-sqlalchemy-guide.jpg" class="webfeedsFeaturedVisual" /></p>SQLをほぼ触ったことがなかった僕が、SQLAlchemyを使ったらPythonコードだけでデータベース操作できるようになりました。 SQLAlchemyは本当に使いやすくて、「これまでにCSVやExcelファイル（.x [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-sqlalchemy-guide.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>Pythonでデータベースを使いたい！</li>

<li>でもSQLクエリを覚えるのは面倒…</li>

<li>SQLAlchemyのコードの意味を理解したい</li>

<li>SQLAlchemy 2.0 の新しい書き方を知りたい</li>

<li>OperationalError や IntegrityError が出て困っている</li>
</ul>
</div></div>



<p class="wp-block-paragraph">SQLをほぼ触ったことがなかった僕が、SQLAlchemyを使ったら<strong>Pythonコードだけでデータベース操作できるようになりました</strong>。</p>



<p class="wp-block-paragraph">SQLAlchemyは本当に使いやすくて、「これまでにCSVやExcelファイル（.xlsx）などでデータ操作をしていたけれど、データベースにデータを蓄えてみたい」という方にはうってつけのライブラリだと思います。</p>



<p class="wp-block-paragraph">とはいえ、Python初心者目線ではSQLAlchemyのコードはやや分かりづらいのも事実。<br>そこで本記事では僕が最初にSQLAlchemy使ってみたときに感じた疑問にも答える形でお伝えさせていただきます。</p>



<p class="wp-block-paragraph">本記事を参考にしていただければ、コードの意味を理解しつつSQLAlchemyを使ったデータベース操作がスラスラとできるようになっているはずです。</p>



<h2 class="wp-block-heading">SQLAlchemyについて簡単に解説</h2>



<p class="wp-block-paragraph">SQLAlchemyでSQLを操作するためには、データベースに繋ぐ部分などで準備のためのコードが数行必要です。</p>



<p class="wp-block-paragraph">決まり文句的に書いてしまっても良いのですが、意味がわからず使うのも気持ち悪いと思うので<span class="swl-fz u-fz-xs">（僕は結構気になるタイプ）</span>ここで概略を説明します。</p>



<p class="is-style-icon_announce wp-block-paragraph">説明よりコードの書き方を！という方は飛ばしてくださいね。</p>



<h3 class="wp-block-heading">SQLAlchemyでデータベース操作するまでの流れ</h3>



<p class="wp-block-paragraph">SQLAlchemyを使ってデータベースを操作するためには、次のような手順が必要になってきます。</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 is-style-index">
<li><strong>データベースの準備</strong>
<ul class="wp-block-list">
<li>各列に何を格納するかを決定</li>



<li>データベースに接続</li>



<li>定義したテーブルを作成</li>
</ul>
</li>



<li><strong>データベースにアクセスする窓口を起動</strong>
<ul class="wp-block-list">
<li>sessionが開始される</li>
</ul>
</li>



<li><strong>データベースを操作</strong>
<ul class="wp-block-list">
<li>トランザクションの開始・終了</li>
</ul>
</li>
</ul>
</div></div>



<p class="wp-block-paragraph">最終的には「<strong>データベースを操作</strong>」をしたいのですが、そのための準備としてこのような手順が必要になってくるというわけですね。</p>



<p class="wp-block-paragraph">データベースを扱うためには、まず<strong>データを格納する列の構造</strong>を決めなければいけませんし、<strong>データベースの種類</strong>（sqliteやMySQLなど）を決めたり、<strong>データベースに接続</strong>する必要もあります。</p>



<p class="wp-block-paragraph">ちょっと手順が多く思えるかもしれませんが、事前準備としてこれらが必要になることを知っておきましょう。</p>



<p class="is-style-icon_pen wp-block-paragraph">&#8220;セッション&#8221;を立ち上げるとデータベースへの窓口が開かれます。<br>セッションの中に&#8221;トランザクション&#8221;という概念が内包されているイメージです。</p>



<h3 class="wp-block-heading">SQLAlchemyにはORMとCoreの二つの概念がある</h3>



<p class="wp-block-paragraph">最初はあまり気にしなくても良いのですが、SQLAlchemyの中にはORMとCoreの二つの概念があります。主な違いは次のとおり。</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>ORM: 
<ul class="wp-block-list">
<li>直感的に操作できる</li>



<li>リレーションなどは自動的に管理される</li>



<li>複雑なSQLクエリは苦手</li>
</ul>
</li>



<li>Core
<ul class="wp-block-list">
<li>SQLの概念をより直接的に扱える</li>



<li>ORMに比べてより細かいコントロールが可能</li>
</ul>
</li>
</ul>
</div></div>



<p class="wp-block-paragraph">最初のうちは分かりやすいORMの方を使えばOKだと思いますが、ORMで限界を感じた時には「<strong>Coreならできるかも！</strong>」と思い出していただければいいと思います。</p>



<p class="is-style-icon_announce wp-block-paragraph">後ほどORMとCoreの両方のサンプルコードを示します！</p>



<h2 class="wp-block-heading">SQLAlchemyの使い方</h2>



<p class="wp-block-paragraph">さて、ここから本題の具体的な使い方の説明に入っていきます。</p>



<p class="is-style-icon_info wp-block-paragraph">Pythonの環境設定は終わっていることを前提としています</p>



<h3 class="wp-block-heading">インストール</h3>



<p class="wp-block-paragraph">まずはお使いのパッケージ管理ツールの方法にしたがって、SQLAlchemyのインストールしてください。</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の場合
pip install sqlalchemy

# poetryの場合
poetry add sqlalchemy</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"># pipの場合</span></span>
<span class="line"><span style="color:#DCDCAA">pip</span><span style="color:#CE9178"> install</span><span style="color:#CE9178"> sqlalchemy</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># poetryの場合</span></span>
<span class="line"><span style="color:#DCDCAA">poetry</span><span style="color:#CE9178"> add</span><span style="color:#CE9178"> sqlalchemy</span></span></code></pre></div>



<p class="wp-block-paragraph">uv を使っている場合は <code>uv add sqlalchemy</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">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 -c "import sqlalchemy; print(sqlalchemy.__version__)"</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:#D4D4D4"> </span><span style="color:#569CD6">-c</span><span style="color:#D4D4D4"> </span><span style="color:#CE9178">&quot;import sqlalchemy; print(sqlalchemy.__version__)&quot;</span></span></code></pre></div>



<p class="is-style-icon_info wp-block-paragraph">本記事の前半は SQLAlchemy 1.x の頃から使われている書き方（<code>session.query()</code>）で説明し、後半の「<a href="#sqlalchemy-2-style">SQLAlchemy 2.0 スタイルの書き方</a>」で新しい書き方との対応を紹介します。2.0 でも前半の書き方は動きますが、公式ドキュメントは 2.0 スタイルを基本にしています。</p>



<h3 class="wp-block-heading">簡単なデータベースを作成して保存する流れ</h3>



<p class="wp-block-paragraph">まずはsqliteを使って簡単なデータをカレントディレクトリの<code>example.db</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 sqlalchemy import Column, Integer, String, create_engine
from sqlalchemy.orm import declarative_base, sessionmaker

# ベースクラスを定義
Base = declarative_base()


# テーブルの定義
class User(Base):
    __tablename__ = "users"

    id = Column(Integer, primary_key=True)
    name = Column(String)
    email = Column(String)


# DBエンジンを作成し、DBに接続
engine = create_engine("sqlite:///example.db")

# 実際にテーブルを作成
Base.metadata.create_all(engine)

# セッションを作成
Session = sessionmaker(bind=engine)
session = Session()

# 新しいレコードを定義
new_user = User(name="xxx", email="xxx@example.com")

# ユーザーをデータベースに追加（実際にはまだ追加されない）
session.add(new_user)

# データベースに永続的に保存される
session.commit()</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"> sqlalchemy </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Column, Integer, String, create_engine</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> sqlalchemy.orm </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> declarative_base, sessionmaker</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># ベースクラスを定義</span></span>
<span class="line"><span style="color:#D4D4D4">Base = declarative_base()</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># テーブルの定義</span></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#D4D4D4"> </span><span style="color:#4EC9B0">User</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">Base</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    __tablename__ = </span><span style="color:#CE9178">&quot;users&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#DCDCAA">id</span><span style="color:#D4D4D4"> = Column(Integer, </span><span style="color:#9CDCFE">primary_key</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">    name = Column(String)</span></span>
<span class="line"><span style="color:#D4D4D4">    email = Column(String)</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># DBエンジンを作成し、DBに接続</span></span>
<span class="line"><span style="color:#D4D4D4">engine = create_engine(</span><span style="color:#CE9178">&quot;sqlite:///example.db&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">Base.metadata.create_all(engine)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># セッションを作成</span></span>
<span class="line"><span style="color:#D4D4D4">Session = sessionmaker(</span><span style="color:#9CDCFE">bind</span><span style="color:#D4D4D4">=engine)</span></span>
<span class="line"><span style="color:#D4D4D4">session = Session()</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 新しいレコードを定義</span></span>
<span class="line"><span style="color:#D4D4D4">new_user = User(</span><span style="color:#9CDCFE">name</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;xxx&quot;</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">email</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;xxx@example.com&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">session.add(new_user)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># データベースに永続的に保存される</span></span>
<span class="line"><span style="color:#D4D4D4">session.commit()</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>example.db</code>は<code>Base.metadata.create_all(engine)</code>を実行するタイミングで作成されますので、ご自身で何か作成する必要はありません。</p>



<p class="is-style-icon_info wp-block-paragraph">古い記事では <code>from sqlalchemy.ext.declarative import declarative_base</code> と書かれていることがありますが、この場所からのインポートは非推奨です。<code>sqlalchemy.orm</code> から読み込みましょう。</p>



<h3 class="wp-block-heading">データの挿入（Insert）</h3>



<p class="wp-block-paragraph">次は<strong>ORMでデータの挿入を行うコード</strong>です。</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># ORMにより実行
new_user = User(name="xxx", email="xxx@example.com")
session.add(new_user)
session.commit()</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"># ORMにより実行</span></span>
<span class="line"><span style="color:#D4D4D4">new_user = User(</span><span style="color:#9CDCFE">name</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"xxx"</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">email</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"xxx@example.com"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">session.add(new_user)</span></span>
<span class="line"><span style="color:#D4D4D4">session.commit()</span></span></code></pre></div>



<p class="wp-block-paragraph">こちらは先ほどサンプルコードで示したものと同じですね。</p>



<p class="wp-block-paragraph">普段からPythonを書き慣れている方からすると、かなり直感的で読みやすいのではないでしょうか？<code>User</code>はモデルを定義したクラス名を指定します。</p>



<p class="wp-block-paragraph">続いては、<strong>Coreでデータ挿入を行うコード</strong>です。</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 sqlalchemy import insert
from sqlalchemy import create_engine, Table, MetaData
from sqlalchemy.orm import sessionmaker

# Coreでは必要
metadata = MetaData()
users = Table("users", metadata, autoload_with=engine)

statement = insert(users).values(name="xxx", email="xxx@example.com")
session.execute(statement)
session.commit()</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"> sqlalchemy </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> insert</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> sqlalchemy </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> create_engine, Table, MetaData</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> sqlalchemy.orm </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> sessionmaker</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># Coreでは必要</span></span>
<span class="line"><span style="color:#D4D4D4">metadata = MetaData()</span></span>
<span class="line"><span style="color:#D4D4D4">users = Table(</span><span style="color:#CE9178">"users"</span><span style="color:#D4D4D4">, metadata, </span><span style="color:#9CDCFE">autoload_with</span><span style="color:#D4D4D4">=engine)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">statement = insert(users).values(</span><span style="color:#9CDCFE">name</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"xxx"</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">email</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"xxx@example.com"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">session.execute(statement)</span></span>
<span class="line"><span style="color:#D4D4D4">session.commit()</span></span></code></pre></div>



<p class="wp-block-paragraph">InsertというSQLステートメントを<code>statement</code>変数に格納して、それを実行・コミットすることでデータベースに反映されます。</p>



<p class="is-style-icon_info wp-block-paragraph">ORMとは異なり、Coreではデータベースのクラス名をそのまま指定できません。Metadataなどを用いてテーブル構造を取得します。</p>



<h3 class="wp-block-heading">データの選択（Select）</h3>



<p class="wp-block-paragraph">ORMを使ってデータの選択をするコードは次のとおりです。</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>users = session.query(User).filter(User.name == "xxx").all()
for user in users:
    print(user.email)</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">users = session.query(User).filter(User.name == </span><span style="color:#CE9178">"xxx"</span><span style="color:#D4D4D4">).all()</span></span>
<span class="line"><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> user </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> users:</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(user.email)</span></span></code></pre></div>



<p class="wp-block-paragraph">少しDjangoのクエリセットを扱う場合に似ている気がします…該当のuserが取得できたら、ループで取り出していく形ですね。</p>



<p class="wp-block-paragraph">続いてはCoreを使ったコード例です。</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 sqlalchemy import select
from sqlalchemy import create_engine, Table, MetaData
from sqlalchemy.orm import sessionmaker

# Coreでは必要
metadata = MetaData()
users = Table("users", metadata, autoload_with=engine)

statement = select(users).where(users.c.name == 'xxx')
results = session.execute(statement).fetchall()
for result in results:
    print(result)</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"> sqlalchemy </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> select</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> sqlalchemy </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> create_engine, Table, MetaData</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> sqlalchemy.orm </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> sessionmaker</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># Coreでは必要</span></span>
<span class="line"><span style="color:#D4D4D4">metadata = MetaData()</span></span>
<span class="line"><span style="color:#D4D4D4">users = Table(</span><span style="color:#CE9178">"users"</span><span style="color:#D4D4D4">, metadata, </span><span style="color:#9CDCFE">autoload_with</span><span style="color:#D4D4D4">=engine)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">statement = select(users).where(users.c.name == </span><span style="color:#CE9178">'xxx'</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">results = session.execute(statement).fetchall()</span></span>
<span class="line"><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> result </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> results:</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(result)</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>where</code>メソッドを使っているあたりが間接的にでもSQLを扱っていると実感。</p>



<h3 class="wp-block-heading">データの更新（Update）</h3>



<p class="wp-block-paragraph">まずはORMの場合です。</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>session.query(User).filter(User.name == 'xxx').update({User.email: 'xxx2@example.com'})
session.commit()</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">session.query(User).filter(User.name == </span><span style="color:#CE9178">'xxx'</span><span style="color:#D4D4D4">).update({User.email: </span><span style="color:#CE9178">'xxx2@example.com'</span><span style="color:#D4D4D4">})</span></span>
<span class="line"><span style="color:#D4D4D4">session.commit()</span></span></code></pre></div>



<p class="wp-block-paragraph">まずはfilterメソッドでレコードを取得した上で、該当の列を更新していきます。<br>データ更新は<code>update</code>メソッドを使い、更新後の値は辞書で渡しましょう。</p>



<p class="wp-block-paragraph">続いてはCoreを使った場合です。</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 sqlalchemy import update
from sqlalchemy import create_engine, Table, MetaData
from sqlalchemy.orm import sessionmaker

# Coreでは必要
metadata = MetaData()
users = Table("users", metadata, autoload_with=engine)

statement = update(users).where(users.c.name == 'xxx').values(email='xxx2@example.com')
session.execute(statement)
session.commit()</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"> sqlalchemy </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> update</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> sqlalchemy </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> create_engine, Table, MetaData</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> sqlalchemy.orm </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> sessionmaker</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># Coreでは必要</span></span>
<span class="line"><span style="color:#D4D4D4">metadata = MetaData()</span></span>
<span class="line"><span style="color:#D4D4D4">users = Table(</span><span style="color:#CE9178">"users"</span><span style="color:#D4D4D4">, metadata, </span><span style="color:#9CDCFE">autoload_with</span><span style="color:#D4D4D4">=engine)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">statement = update(users).where(users.c.name == </span><span style="color:#CE9178">'xxx'</span><span style="color:#D4D4D4">).values(</span><span style="color:#9CDCFE">email</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">'xxx2@example.com'</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">session.execute(statement)</span></span>
<span class="line"><span style="color:#D4D4D4">session.commit()</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>user.c.name</code>の<code>c</code>はSQLAlchemyでColumnにアクセスするときに使われる書き方です。SQLではこのような表現がないので、あくまでSQLAlchemyだけに使う表現だということをご理解ください。</p>



<h3 class="wp-block-heading">データの削除（Delete）</h3>



<p class="wp-block-paragraph">ORMを使った方法からご紹介します。書き方はかなり簡潔です。</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>session.query(User).filter(User.name == 'xxx').delete()
session.commit()</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">session.query(User).filter(User.name == </span><span style="color:#CE9178">'xxx'</span><span style="color:#D4D4D4">).delete()</span></span>
<span class="line"><span style="color:#D4D4D4">session.commit()</span></span></code></pre></div>



<p class="wp-block-paragraph">続いてCoreを使った方法です。</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 sqlalchemy import delete
from sqlalchemy import create_engine, Table, MetaData
from sqlalchemy.orm import sessionmaker

# Coreでは必要
metadata = MetaData()
users = Table("users", metadata, autoload_with=engine)

statement = delete(users).where(users.c.name == 'xxx')
session.execute(statement)
session.commit()</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"> sqlalchemy </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> delete</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> sqlalchemy </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> create_engine, Table, MetaData</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> sqlalchemy.orm </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> sessionmaker</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># Coreでは必要</span></span>
<span class="line"><span style="color:#D4D4D4">metadata = MetaData()</span></span>
<span class="line"><span style="color:#D4D4D4">users = Table(</span><span style="color:#CE9178">"users"</span><span style="color:#D4D4D4">, metadata, </span><span style="color:#9CDCFE">autoload_with</span><span style="color:#D4D4D4">=engine)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">statement = delete(users).where(users.c.name == </span><span style="color:#CE9178">'xxx'</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">session.execute(statement)</span></span>
<span class="line"><span style="color:#D4D4D4">session.commit()</span></span></code></pre></div>



<p class="wp-block-paragraph">こちらもややコードが長くなるものの、簡潔に表現できます。</p>



<h3 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># 全取得
users = session.query(User).all()
for user in users:
    print(user.name, user.email)</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:#D4D4D4">users = session.query(User).all()</span></span>
<span class="line"><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> user </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> users:</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(user.name, user.email)</span></span></code></pre></div>



<p class="wp-block-paragraph">特定のユーザーを主キーで取得する方法。以下の場合は<code>id=1</code>のユーザーを取得します（見つからなければ <code>None</code> が返ります）。以前は <code>session.query(User).get(1)</code> と書いていましたが、2.0 では <code>session.get()</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>user = session.get(User, 1)
print(user.name, user.email)</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">user = session.get(User, </span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#DCDCAA">print</span><span style="color:#D4D4D4">(user.name, user.email)</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>users = session.query(User).filter(User.name.like("%xxx%")).all()
for user in users:
    print(user.name, user.email)</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">users = session.query(User).filter(User.name.like(</span><span style="color:#CE9178">"</span><span style="color:#569CD6">%x</span><span style="color:#CE9178">xx%"</span><span style="color:#D4D4D4">)).all()</span></span>
<span class="line"><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> user </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> users:</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(user.name, user.email)</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>%</code>は0個以上の任意の文字列を表すワイルドカードです。Excelでいうところの<code>*</code>ですね。</p>



<p class="wp-block-paragraph">任意の一文字を表したい場合には<code>_</code>を使います。</p>



<p class="is-style-icon_info wp-block-paragraph">なお、正規表現の使い方はデータベースエンジンの種類ごとに異なります。</p>



<h3 class="wp-block-heading">ソート</h3>



<p class="wp-block-paragraph">名前でソートしてすべてのユーザーを取得するには<code>order_by()</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>users = session.query(User).order_by(User.name).all()
for user in users:
    print(user.name, user.email)</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">users = session.query(User).order_by(User.name).all()</span></span>
<span class="line"><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> user </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> users:</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(user.name, user.email)</span></span></code></pre></div>



<p class="wp-block-paragraph">Pandasを使い慣れた方なら馴染みやすいかもしれません。</p>



<h3 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>count = session.query(User).count()
print(count)</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">count = session.query(User).count()</span></span>
<span class="line"><span style="color:#DCDCAA">print</span><span style="color:#D4D4D4">(count)</span></span></code></pre></div>



<h3 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(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 sqlalchemy.exc import SQLAlchemyError

try:
    new_user = User(name="xxx", email="xxx@example.com")
    session.add(new_user)
    session.commit()
except SQLAlchemyError:
    # エラーが発生したら最初の状態に戻す
    session.rollback()
    raise  # 握りつぶさず、呼び出し元にエラーを伝える</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"> sqlalchemy.exc </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> SQLAlchemyError</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">try</span><span style="color:#D4D4D4">:</span></span>
<span class="line"><span style="color:#D4D4D4">    new_user = User(</span><span style="color:#9CDCFE">name</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;xxx&quot;</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">email</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;xxx@example.com&quot;</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">    session.add(new_user)</span></span>
<span class="line"><span style="color:#D4D4D4">    session.commit()</span></span>
<span class="line"><span style="color:#C586C0">except</span><span style="color:#D4D4D4"> SQLAlchemyError:</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#6A9955"># エラーが発生したら最初の状態に戻す</span></span>
<span class="line"><span style="color:#D4D4D4">    session.rollback()</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#C586C0">raise</span><span style="color:#D4D4D4">  </span><span style="color:#6A9955"># 握りつぶさず、呼び出し元にエラーを伝える</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>except:</code> だけにするとプログラムの停止（Ctrl+C）まで捕まえてしまうので、<code>SQLAlchemyError</code> のように対象を絞り、ロールバックした後は <code>raise</code> でエラーを呼び出し元に伝えるのが安全です。</p>



<h2 class="wp-block-heading">SQLAlchemyの最適化</h2>



<p class="wp-block-paragraph">これまでご紹介した方法でもSQLAlchemyを使うことはできますが、ここからは「さらにSQLAlchemyのベストプラクティスを追い求めたい」場合に参考にしていただけそうな知識をまとめます。</p>



<h3 class="wp-block-heading">事前ロードにより高速化できる場合がある</h3>



<p class="wp-block-paragraph">SQLAlchemy ORMは遅延ロードがデフォルトです。<br>遅延ロードとは<strong>データが必要になるまでロードを先送りにする</strong>ことで、通常はこれによりパフォーマンスUPが期待できます。</p>



<p class="wp-block-paragraph">ところが必要な情報がたくさんあり、SQLに対する命令が小出しに行われる場合には非効率です。俗に&#8221;<strong>N+1問題</strong>&#8220;と呼ばれるものです。</p>



<p class="wp-block-paragraph">このような場合には一度のデータベースへのリクエストで必要なデータを事前に用意しておいた方がパフォーマンスが良くなる場合があります。</p>



<p class="wp-block-paragraph">SQLAlchemyでは<code>joinedload</code>や<code>subqueryload</code>といったものを用いて事前ロードの実装ができます。</p>



<p class="wp-block-paragraph"><code>joinedload</code>は<code>LEFT OUTER JOIN</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 sqlalchemy.orm import joinedload

# Userクラスのaddressesを一気にロード
query = session.query(User).options(joinedload(User.addresses))

for user in query:
    print(user.name, user.addresses)</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"> sqlalchemy.orm </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> joinedload</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># Userクラスのaddressesを一気にロード</span></span>
<span class="line"><span style="color:#D4D4D4">query = session.query(User).options(joinedload(User.addresses))</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> user </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> query:</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(user.name, user.addresses)</span></span></code></pre></div>



<p class="wp-block-paragraph">関連する要素を一度に取得するので、要素の配置状態によってはデータ量が大きくなる場合があります。（1つの親エンティティに対して多数の子エンティティがある場合など）</p>



<p class="wp-block-paragraph">一方で<code>subqueryload</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 sqlalchemy.orm import subqueryload

# Userクラスのaddressesを一気にロード
query = session.query(User).options(subqueryload(User.addresses))

for user in query:
    print(user.name, user.addresses)</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"> sqlalchemy.orm </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> subqueryload</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># Userクラスのaddressesを一気にロード</span></span>
<span class="line"><span style="color:#D4D4D4">query = session.query(User).options(subqueryload(User.addresses))</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> user </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> query:</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(user.name, user.addresses)</span></span></code></pre></div>



<p class="wp-block-paragraph">こちらは<code>joinedload</code>と違い、親を取得するSQLとは別に、関連テーブルを取得するSQLを追加で1回発行します。JOIN で行が増えないので、1つの親エンティティに対して多数の子エンティティが存在する場合にはパフォーマンスのアップが期待できます。</p>



<p class="wp-block-paragraph">SQLAlchemy 2.0 の公式ドキュメントでは、一対多のコレクションを事前ロードする方法として <code>selectinload</code> が勧められています。親の主キーを <code>IN</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 sqlalchemy.orm import selectinload

# Userクラスのaddressesを一気にロード
query = session.query(User).options(selectinload(User.addresses))

for user in query:
    print(user.name, user.addresses)</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"> sqlalchemy.orm </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> selectinload</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># Userクラスのaddressesを一気にロード</span></span>
<span class="line"><span style="color:#D4D4D4">query = session.query(User).options(selectinload(User.addresses))</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> user </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> query:</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#DCDCAA">print</span><span style="color:#D4D4D4">(user.name, user.addresses)</span></span></code></pre></div>



<p class="is-style-icon_info wp-block-paragraph">ここでの <code>User.addresses</code> は、<code>User</code> に <code>relationship()</code> で住所テーブルとの関連を定義している前提のコードです。</p>



<h3 class="wp-block-heading">デバッグのヒント</h3>



<p class="wp-block-paragraph"><code>create_engine</code>メソッドの引数として<code>echo=True</code>を指定することで、すべての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>from sqlalchemy import create_engine

engine = create_engine("sqlite:///example.db", echo=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"> sqlalchemy </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> create_engine</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">engine = create_engine(</span><span style="color:#CE9178">"sqlite:///example.db"</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">echo</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">便利なログ出力機能ですが、本番環境ではFalseにしておきましょう。<br>すべてのクエリを出力することでアプリケーションのパフォーマンスが落ちたり、機密情報がログに含まれてしまうことがあるためです。</p>



<p class="is-style-icon_info wp-block-paragraph">あくまで開発環境のみでTrueにしておくものという理解が正解だと思います。</p>



<h3 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(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 sqlalchemy.exc import (
    DataError,
    IntegrityError,
    InvalidRequestError,
    MultipleResultsFound,
    NoResultFound,
    OperationalError,
    SQLAlchemyError,
    StatementError,
)

try:
    # SQLAlchemyの操作を実行するコード
    ...
except NoResultFound:
    # レコードが見つからなかった場合の処理
    ...
except MultipleResultsFound:
    # 複数のレコードが見つかった場合の処理
    ...
except InvalidRequestError:
    # 無効な要求が行われた場合の処理
    ...
except OperationalError:
    # データベース接続などの操作エラーが発生した場合の処理
    ...
except IntegrityError:
    # データベースの整合性制約に違反した場合の処理
    ...
except DataError:
    # データベースに関連するデータエラーが発生した場合の処理
    ...
except StatementError:
    # SQLステートメントの実行中にエラーが発生した場合の処理
    ...
except SQLAlchemyError:
    # SQLAlchemyの他のエラーをキャッチするための一般的な例外処理
    ...
except Exception:
    # その他の一般的な例外をキャッチするためのブロック
    ...
finally:
    # 必要に応じてクリーンアップ処理を実行するブロック
    ...</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"> sqlalchemy.exc </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> (</span></span>
<span class="line"><span style="color:#D4D4D4">    DataError,</span></span>
<span class="line"><span style="color:#D4D4D4">    IntegrityError,</span></span>
<span class="line"><span style="color:#D4D4D4">    InvalidRequestError,</span></span>
<span class="line"><span style="color:#D4D4D4">    MultipleResultsFound,</span></span>
<span class="line"><span style="color:#D4D4D4">    NoResultFound,</span></span>
<span class="line"><span style="color:#D4D4D4">    OperationalError,</span></span>
<span class="line"><span style="color:#D4D4D4">    SQLAlchemyError,</span></span>
<span class="line"><span style="color:#D4D4D4">    StatementError,</span></span>
<span class="line"><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">try</span><span style="color:#D4D4D4">:</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#6A9955"># SQLAlchemyの操作を実行するコード</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#C586C0">except</span><span style="color:#D4D4D4"> NoResultFound:</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#6A9955"># レコードが見つからなかった場合の処理</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#C586C0">except</span><span style="color:#D4D4D4"> MultipleResultsFound:</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#6A9955"># 複数のレコードが見つかった場合の処理</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#C586C0">except</span><span style="color:#D4D4D4"> InvalidRequestError:</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#6A9955"># 無効な要求が行われた場合の処理</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#C586C0">except</span><span style="color:#D4D4D4"> OperationalError:</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#6A9955"># データベース接続などの操作エラーが発生した場合の処理</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#C586C0">except</span><span style="color:#D4D4D4"> IntegrityError:</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#6A9955"># データベースの整合性制約に違反した場合の処理</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#C586C0">except</span><span style="color:#D4D4D4"> DataError:</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#6A9955"># データベースに関連するデータエラーが発生した場合の処理</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#C586C0">except</span><span style="color:#D4D4D4"> StatementError:</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#6A9955"># SQLステートメントの実行中にエラーが発生した場合の処理</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#C586C0">except</span><span style="color:#D4D4D4"> SQLAlchemyError:</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#6A9955"># SQLAlchemyの他のエラーをキャッチするための一般的な例外処理</span></span>
<span class="line"><span style="color:#D4D4D4">    ...</span></span>
<span class="line"><span style="color:#C586C0">except</span><span style="color:#D4D4D4"> </span><span style="color:#4EC9B0">Exception</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">    ...</span></span>
<span class="line"><span style="color:#C586C0">finally</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">    ...</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>except</code> は上から順に判定されるので、<code>NoResultFound</code> のような個別の例外を先に、<code>SQLAlchemyError</code> や <code>Exception</code> のような広い例外を後に書きます。</p>



<p class="wp-block-paragraph">詳しくは<a href="https://docs.sqlalchemy.org/en/20/core/exceptions.html">公式ドキュメント</a><span data-icon="PhArrowSquareOut" data-id="12" style="--the-icon-svg: url(data:image/svg+xml;base64,PHN2ZyBoZWlnaHQ9IjFlbSIgd2lkdGg9IjFlbSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiBhcmlhLWhpZGRlbj0idHJ1ZSIgdmlld0JveD0iMCAwIDI1NiAyNTYiPjxyZWN0IHdpZHRoPSIyNTYiIGhlaWdodD0iMjU2IiBmaWxsPSJub25lIj48L3JlY3Q+PHBvbHlsaW5lIHBvaW50cz0iMjE2IDEwMCAyMTYgNDAgMTU2IDQwIiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIiBzdHJva2Utd2lkdGg9IjE2Ij48L3BvbHlsaW5lPjxsaW5lIHgxPSIxNDQiIHkxPSIxMTIiIHgyPSIyMTYiIHkyPSI0MCIgZmlsbD0ibm9uZSIgc3Ryb2tlPSJjdXJyZW50Q29sb3IiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIgc3Ryb2tlLXdpZHRoPSIxNiI+PC9saW5lPjxwYXRoIGQ9Ik0xODQsMTQ0djY0YTgsOCwwLDAsMS04LDhINDhhOCw4LDAsMCwxLTgtOFY4MGE4LDgsMCwwLDEsOC04aDY0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIiBzdHJva2Utd2lkdGg9IjE2Ij48L3BhdGg+PC9zdmc+)" aria-hidden="true" class="swl-inline-icon"> </span>を参照してください。</p>



<h2 class="wp-block-heading" id="sqlalchemy-2-style">SQLAlchemy 2.0 スタイルの書き方</h2>



<p class="wp-block-paragraph">SQLAlchemy 2.0 からは、モデルの定義と SELECT の書き方が新しくなりました。前半のサンプルを、公式ドキュメントの記法に沿って 2.0 スタイルで書き直すと次のようになります。</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 sqlalchemy import String, create_engine, select
from sqlalchemy.orm import DeclarativeBase, Mapped, Session, mapped_column


# ベースクラスを定義（2.0 では DeclarativeBase を継承する）
class Base(DeclarativeBase):
    pass


# テーブルの定義（型ヒントで列の型を表す）
class User(Base):
    __tablename__ = "users"

    id: Mapped&#91;int&#93; = mapped_column(primary_key=True)
    name: Mapped&#91;str&#93; = mapped_column(String(50))
    email: Mapped&#91;str&#93; = mapped_column(String(100))


engine = create_engine("sqlite:///example.db")
Base.metadata.create_all(engine)

# with を抜けるとセッションが自動で閉じられる
with Session(engine) as session:
    session.add(User(name="xxx", email="xxx@example.com"))
    session.commit()

    # SELECT は select() で組み立てて、scalars() で ORM オブジェクトとして受け取る
    stmt = select(User).where(User.name == "xxx")
    for user in session.scalars(stmt):
        print(user.email)</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"> sqlalchemy </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> String, create_engine, select</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> sqlalchemy.orm </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> DeclarativeBase, Mapped, Session, mapped_column</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># ベースクラスを定義（2.0 では DeclarativeBase を継承する）</span></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#D4D4D4"> </span><span style="color:#4EC9B0">Base</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">DeclarativeBase</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#C586C0">pass</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># テーブルの定義（型ヒントで列の型を表す）</span></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#D4D4D4"> </span><span style="color:#4EC9B0">User</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">Base</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">    __tablename__ = </span><span style="color:#CE9178">&quot;users&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#DCDCAA">id</span><span style="color:#D4D4D4">: Mapped[</span><span style="color:#4EC9B0">int</span><span style="color:#D4D4D4">] = mapped_column(</span><span style="color:#9CDCFE">primary_key</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">    name: Mapped[</span><span style="color:#4EC9B0">str</span><span style="color:#D4D4D4">] = mapped_column(String(</span><span style="color:#B5CEA8">50</span><span style="color:#D4D4D4">))</span></span>
<span class="line"><span style="color:#D4D4D4">    email: Mapped[</span><span style="color:#4EC9B0">str</span><span style="color:#D4D4D4">] = mapped_column(String(</span><span style="color:#B5CEA8">100</span><span style="color:#D4D4D4">))</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">engine = create_engine(</span><span style="color:#CE9178">&quot;sqlite:///example.db&quot;</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">Base.metadata.create_all(engine)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># with を抜けるとセッションが自動で閉じられる</span></span>
<span class="line"><span style="color:#C586C0">with</span><span style="color:#D4D4D4"> Session(engine) </span><span style="color:#C586C0">as</span><span style="color:#D4D4D4"> session:</span></span>
<span class="line"><span style="color:#D4D4D4">    session.add(User(</span><span style="color:#9CDCFE">name</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;xxx&quot;</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">email</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;xxx@example.com&quot;</span><span style="color:#D4D4D4">))</span></span>
<span class="line"><span style="color:#D4D4D4">    session.commit()</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#6A9955"># SELECT は select() で組み立てて、scalars() で ORM オブジェクトとして受け取る</span></span>
<span class="line"><span style="color:#D4D4D4">    stmt = select(User).where(User.name == </span><span style="color:#CE9178">&quot;xxx&quot;</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> user </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> session.scalars(stmt):</span></span>
<span class="line"><span style="color:#D4D4D4">        </span><span style="color:#DCDCAA">print</span><span style="color:#D4D4D4">(user.email)</span></span></code></pre></div>



<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>DeclarativeBase</code> を継承したクラスをベースにし、列は <code>Mapped[型]</code> と <code>mapped_column()</code> で定義する</li>

<li>セッションは <code>with Session(engine) as session:</code> で開き、ブロックを抜けると閉じられる</li>

<li>SELECT は <code>select()</code> で組み立てて <code>session.scalars()</code> や <code>session.execute()</code> で実行する</li>
</ul>
</div></div>



<h3 class="wp-block-heading">1.x スタイルとの対応表</h3>



<p class="wp-block-paragraph">前半で紹介した書き方が、2.0 スタイルではどうなるかの対応です。</p>



<figure class="wp-block-table"><table><thead><tr><th>やりたいこと</th><th>1.x スタイル（前半の書き方）</th><th>2.0 スタイル</th></tr></thead><tbody><tr><td>ベースクラス</td><td><code>Base = declarative_base()</code></td><td><code>class Base(DeclarativeBase): pass</code></td></tr><tr><td>列の定義</td><td><code>name = Column(String)</code></td><td><code>name: Mapped[str] = mapped_column(String(50))</code></td></tr><tr><td>全件取得</td><td><code>session.query(User).all()</code></td><td><code>session.scalars(select(User)).all()</code></td></tr><tr><td>条件で絞り込み</td><td><code>session.query(User).filter(User.name == "xxx")</code></td><td><code>session.scalars(select(User).where(User.name == "xxx"))</code></td></tr><tr><td>主キーで1件取得</td><td><code>session.query(User).get(1)</code></td><td><code>session.get(User, 1)</code></td></tr><tr><td>件数</td><td><code>session.query(User).count()</code></td><td><code>session.scalar(select(func.count()).select_from(User))</code></td></tr></tbody></table><figcaption class="wp-element-caption">SQLAlchemy 1.x と 2.0 の書き方の違い</figcaption></figure>



<p class="wp-block-paragraph"><code>func</code> は <code>from sqlalchemy import func</code> で読み込みます。前半で紹介した Core の <code>insert()</code>・<code>update()</code>・<code>delete()</code> は、2.0 でも同じように <code>session.execute()</code> で実行できます。</p>



<h2 class="wp-block-heading">よくあるエラーと対処法</h2>



<p class="wp-block-paragraph">SQLAlchemy のエラーは、データベース側のエラーを包んだ形で表示されます。SQLite を使っている場合によく見かける2つを取り上げます。</p>



<h3 class="wp-block-heading">OperationalError: no such table</h3>



<p class="wp-block-paragraph">SQLite 側のメッセージが <code>no such table: users</code> となっている場合は、接続したデータベースにテーブルがありません。主な原因は次の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><code>Base.metadata.create_all(engine)</code> を実行する前に、データを読み書きしている</li>

<li><code>sqlite:///example.db</code> のような相対パスが、<strong>実行したときのカレントディレクトリ</strong>を基準に解釈され、別の場所に空のデータベースができている</li>
</ul>
</div></div>



<p class="wp-block-paragraph">2つ目は、実行する場所を変えたときに起きやすい原因です。スクリプトの場所を基準に絶対パスを組み立てておくと、どこから実行しても同じファイルを使えます。</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 pathlib import Path

from sqlalchemy import create_engine

# このファイルと同じフォルダの example.db を、どこから実行しても使う
db_path = Path(__file__).resolve().parent / "example.db"
engine = create_engine(f"sqlite:///{db_path}")</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"> pathlib </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Path</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> sqlalchemy </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> create_engine</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># このファイルと同じフォルダの example.db を、どこから実行しても使う</span></span>
<span class="line"><span style="color:#D4D4D4">db_path = Path(</span><span style="color:#9CDCFE">__file__</span><span style="color:#D4D4D4">).resolve().parent / </span><span style="color:#CE9178">&quot;example.db&quot;</span></span>
<span class="line"><span style="color:#D4D4D4">engine = create_engine(</span><span style="color:#569CD6">f</span><span style="color:#CE9178">&quot;sqlite:///</span><span style="color:#569CD6">{</span><span style="color:#D4D4D4">db_path</span><span style="color:#569CD6">}</span><span style="color:#CE9178">&quot;</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>Path(__file__)</code> を使ったパスの組み立ては、こちらの記事で解説しています。</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-pathlib-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-pathlib-guide/">Python pathlibの使い方｜パス操作・読み書き・glob</a>
						<span class="p-blogCard__excerpt">pathlib の基本的な使い方を知りたい！ os.path の書き方を pathlib に置き換えたい！ ファイルの読み書き・コピー・検索を pathlib で書きたい！ このような方に向けて&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">IntegrityError（UNIQUE・NOT NULL 制約違反）</h3>



<p class="wp-block-paragraph"><code>unique=True</code> の列に同じ値を入れたり、<code>nullable=False</code> の列を空にしたりすると <code>IntegrityError</code> になります。SQLite 側のメッセージは <code>UNIQUE constraint failed: users.email</code> や <code>NOT NULL constraint failed: users.name</code> のように、違反した列名を含みます。</p>



<p class="wp-block-paragraph">次の例は、<code>User</code> モデルの <code>email</code> 列を <code>email: Mapped[str] = mapped_column(String(100), unique=True)</code> のように <code>unique=True</code> で定義し、<code>xxx@example.com</code> のユーザーがすでに登録されている前提のコードです。本記事のサンプルは <code>email</code> に <code>unique</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 sqlalchemy.exc import IntegrityError

try:
    session.add(User(name="yyy", email="xxx@example.com"))  # email が重複している
    session.commit()
except IntegrityError:
    session.rollback()  # ロールバックしないと、このセッションは次の操作ができない
    print("同じメールアドレスのユーザーがすでに登録されています")</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"> sqlalchemy.exc </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> IntegrityError</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">try</span><span style="color:#D4D4D4">:</span></span>
<span class="line"><span style="color:#D4D4D4">    session.add(User(</span><span style="color:#9CDCFE">name</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;yyy&quot;</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">email</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;xxx@example.com&quot;</span><span style="color:#D4D4D4">))  </span><span style="color:#6A9955"># email が重複している</span></span>
<span class="line"><span style="color:#D4D4D4">    session.commit()</span></span>
<span class="line"><span style="color:#C586C0">except</span><span style="color:#D4D4D4"> IntegrityError:</span></span>
<span class="line"><span style="color:#D4D4D4">    session.rollback()  </span><span style="color:#6A9955"># ロールバックしないと、このセッションは次の操作ができない</span></span>
<span class="line"><span style="color:#D4D4D4">    </span><span style="color:#DCDCAA">print</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&quot;同じメールアドレスのユーザーがすでに登録されています&quot;</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>commit()</code> で失敗したセッションは、<code>rollback()</code> するまで次の操作を受け付けません。エラーを捕まえたら、まずロールバックしてから処理を続けます。</p>



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



<p class="wp-block-paragraph">ざっくりではありますが、SQLAlchemyの概略から基本的な使い方まで横断的にお伝えしてきました。</p>



<p class="wp-block-paragraph">少しずつでもコードを書いていくことでデータベースを触る感覚が掴めてくると思います。</p>



<p class="wp-block-paragraph">ぜひサンプルコードなども参考にしつつ、開発中のアプリケーションに導入してみてください！</p>



<p class="wp-block-paragraph">SQLAlchemy の裏側で実行されている SQL の <code>INSERT</code>・<code>DELETE</code> については、こちらの記事で解説しています。</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/sql-insert-records-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/sql-insert-records/">SQLのINSERT文の使い方｜INSERT INTOと複数行挿入</a>
						<span class="p-blogCard__excerpt">SQL の INSERT 文の基本を理解したい！ 複数行の挿入や、別テーブルからのコピーをしたい！ 型・NULL・重複でつまずかないための注意点を知りたい！ Python から INSERT&#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/sql-delete-records-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/sql-delete-records/">SQLのDELETE文の使い方｜複数行・複数条件の削除と安全な手順</a>
						<span class="p-blogCard__excerpt">DELETE 文の基本の書き方を知りたい！ 複数の行・複数の条件でまとめて削除したい！ DELETE・TRUNCATE・DROP の違いが分からない！ 間違えて消さないための安全な手順を&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【Django × Docker】開発中のマイグレーション不整合問題はどう対処する？DBを消す場合・消さない場合の整理</title>
		<link>https://cfxlog.com/django-docker-migrations-fix/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Mon, 01 Dec 2025 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[Docker]]></category>
		<category><![CDATA[データベース操作]]></category>
		<category><![CDATA[トラブルシューティング]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5236</guid>

					<description><![CDATA[Django 開発でよく発生するのが、マイグレーションとデータベースの不整合。特に Docker でデプロイしながら開発していると、 といった状況になりがちです。 結論として、判断基準の目安を示します。 判断基準 おすす [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">Django 開発でよく発生するのが、<strong>マイグレーションとデータベースの不整合</strong>。<br/>特に Docker でデプロイしながら開発していると、</p>



<div class="wp-block-group has-border -border04"><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><code>InconsistentMigrationHistory</code> などのエラーが出る</li>
</ul>
</div></div>



<p class="wp-block-paragraph">といった状況になりがちです。</p>



<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>まだ開発フェーズ／テストデータのみ</td><td><strong>DBを削除</strong></td></tr><tr><td>データに価値がある（本番やステージング）</td><td><strong>履歴を調整して整合性を取る</strong></td></tr><tr><td>マイグレーションを大幅に作り直した</td><td>開発段階なら「消す」、本番寄りなら「調整」</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">この記事では <strong>「DBを消すべきケース」と「消さずに直すケース」</strong> を整理し、<strong>それぞれの手順を端的にまとめます。</strong></p>



<p class="wp-block-paragraph">「まだ開発中」「テストデータしか入っていない」なら、<strong>マイグレーションを直すより DB を作り直したほうが早くて安全</strong> です。</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"></div></div>



<p class="wp-block-paragraph">本番寄りの環境では、<strong>DB を消すと消えて困るデータがある場合が多い</strong>です。</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"></div></div>



<p class="wp-block-paragraph">開発中とはいえ、<code>docker volume rm</code> は <strong>データベースを完全消去する破壊的操作</strong> です。</p>



<p class="wp-block-paragraph">以下の点を押さえておくと、安全に作業できます。</p>



<p class="wp-block-paragraph"><code>docker volume rm xxx_db-data</code> は <strong>元に戻せません</strong>。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>チーム開発なら、他メンバーが使っている DB を消さないよう注意</li>

<li>本番やステージングの volume 名と似ていると事故の元</li>

<li>削除前に必ず volume 一覧で <strong>対象の volume 名を再確認</strong></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>docker volume ls</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">docker</span><span style="color:#CE9178"> volume</span><span style="color:#CE9178"> ls</span></span></code></pre></div>



<p class="wp-block-paragraph">意図しない volume を消すミスが最も多いため、慎重に確認してください。</p>



<p class="wp-block-paragraph">万が一間違ってDBを消しても復元できるよう、削除前にバックアップを取るのが理想です。</p>



<h4 class="wp-block-heading">PostgreSQL の例</h4>



<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>pg_dump -h localhost -U postgres -d mydb &gt; backup.sql</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">pg_dump</span><span style="color:#569CD6"> -h</span><span style="color:#CE9178"> localhost</span><span style="color:#569CD6"> -U</span><span style="color:#CE9178"> postgres</span><span style="color:#569CD6"> -d</span><span style="color:#CE9178"> mydb</span><span style="color:#D4D4D4"> > </span><span style="color:#CE9178">backup.sql</span></span></code></pre></div>



<h4 class="wp-block-heading">SQLite の例</h4>



<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>cp db.sqlite3 db-backup.sqlite3</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">cp</span><span style="color:#CE9178"> db.sqlite3</span><span style="color:#CE9178"> db-backup.sqlite3</span></span></code></pre></div>



<h4 class="wp-block-heading">再現性のために「初期化スクリプト」を準備するのも有効</h4>



<p class="wp-block-paragraph">開発では 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>#!/usr/bin/env bash
set -e

docker compose down
docker volume rm project_db-data
docker compose up -d

docker compose exec app python manage.py migrate
docker compose exec app python manage.py loaddata initial_data.json</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">#!/usr/bin/env bash</span></span>
<span class="line"><span style="color:#DCDCAA">set</span><span style="color:#569CD6"> -e</span></span>
<span class="line"></span>
<span class="line"><span style="color:#DCDCAA">docker</span><span style="color:#CE9178"> compose</span><span style="color:#CE9178"> down</span></span>
<span class="line"><span style="color:#DCDCAA">docker</span><span style="color:#CE9178"> volume</span><span style="color:#CE9178"> rm</span><span style="color:#CE9178"> project_db-data</span></span>
<span class="line"><span style="color:#DCDCAA">docker</span><span style="color:#CE9178"> compose</span><span style="color:#CE9178"> up</span><span style="color:#569CD6"> -d</span></span>
<span class="line"></span>
<span class="line"><span style="color:#DCDCAA">docker</span><span style="color:#CE9178"> compose</span><span style="color:#CE9178"> exec</span><span style="color:#CE9178"> app</span><span style="color:#CE9178"> python</span><span style="color:#CE9178"> manage.py</span><span style="color:#CE9178"> migrate</span></span>
<span class="line"><span style="color:#DCDCAA">docker</span><span style="color:#CE9178"> compose</span><span style="color:#CE9178"> exec</span><span style="color:#CE9178"> app</span><span style="color:#CE9178"> python</span><span style="color:#CE9178"> manage.py</span><span style="color:#CE9178"> loaddata</span><span style="color:#CE9178"> initial_data.json</span></span></code></pre></div>



<p class="wp-block-paragraph">環境構築が一瞬で終わります。</p>



<p class="wp-block-paragraph">DB の volume を削除すると同時に、<code>migrations/</code> ディレクトリを整理したいケースもあります。</p>



<p class="wp-block-paragraph">その際の注意事項は次の通りです。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>migrations/__init__.py</code> <strong>だけは必ず残す</strong>（これがないとアプリが migration パッケージとして認識されない）</li>

<li>チーム開発では、勝手に migration を消すと履歴が他メンバーとズレる</li>

<li>Git で migration を削除する際は、<strong>全員で一斉に migration をリセットするタイミングを揃える</strong></li>
</ul>
</div></div>



<h4 class="wp-block-heading">不要なマイグレーションの削除例</h4>



<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>rm app_name/migrations/000*.py
touch app_name/migrations/__init__.py</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">rm</span><span style="color:#CE9178"> app_name/migrations/000</span><span style="color:#569CD6">*</span><span style="color:#CE9178">.py</span></span>
<span class="line"><span style="color:#DCDCAA">touch</span><span style="color:#CE9178"> app_name/migrations/__init__.py</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>



<p class="wp-block-paragraph">これらの補足を押さえておくと、開発フェーズでも安全にマイグレーションの再構築が行えます。</p>



<p class="wp-block-paragraph">Django × Docker の開発では、マイグレーション不整合はほぼ必ず起きます。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>消してよいDBか？ 残すべきDBか？</strong></li>

<li><strong>「速く直す」か「丁寧に直す」か？</strong></li>
</ul>
</div></div>



<p class="wp-block-paragraph">大事なのは、上記を状況で切り分けることが必要です。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【SQL】UPDATE で既存のレコードを更新しよう！</title>
		<link>https://cfxlog.com/sql-update-records/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Mon, 17 Nov 2025 15:00:00 +0000</pubDate>
				<category><![CDATA[SQL]]></category>
		<category><![CDATA[データベース操作]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4938</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/sql-update-records.jpg" class="webfeedsFeaturedVisual" /></p>このような方に向けて書きました。 すでにあるテーブルのレコードを書き換えるクエリがUPDATEです。 分量としてはあまり多くないので、ざっと全体像を俯瞰してマスターしていきましょう。 UPDATE 文の基本 既存のレコー [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/sql-update-records.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>SQL で既存のレコードを更新したい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような方に向けて書きました。</p>



<p class="wp-block-paragraph">すでにあるテーブルのレコードを書き換えるクエリが<code>UPDATE</code>です。</p>



<p class="wp-block-paragraph">分量としてはあまり多くないので、ざっと全体像を俯瞰してマスターしていきましょう。</p>



<h2 class="wp-block-heading">UPDATE 文の基本</h2>



<p class="wp-block-paragraph">既存のレコードの値を変更するために使われるのが<code>UPDATE</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(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">SQL</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>UPDATE table_name
SET column1 = value1, column2 = value2, ...
WHERE condition;</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: #569CD6">UPDATE</span><span style="color: #D4D4D4"> table_name</span></span>
<span class="line"><span style="color: #569CD6">SET</span><span style="color: #D4D4D4"> column1 = value1, column2 = value2, ...</span></span>
<span class="line"><span style="color: #569CD6">WHERE</span><span style="color: #D4D4D4"> condition;</span></span></code></pre></div>



<p class="wp-block-paragraph">各要素の意味をまとめると以下の通りです。</p>



<figure class="wp-block-table"><table><thead><tr><th>句</th><th>効果</th></tr></thead><tbody><tr><td><code>table_name</code></td><td>更新対象のテーブル名</td></tr><tr><td><code>SET column1 = value1</code></td><td>更新する列と新しい値を指定</td></tr><tr><td><code>WHERE condition</code></td><td>更新する行の条件</td></tr></tbody></table><figcaption class="wp-element-caption">句と効果</figcaption></figure>



<p class="wp-block-paragraph">最後の<code>WHERE</code>句を指定しないと、テーブル内の全行が更新されるので注意してください。</p>



<p class="wp-block-paragraph">また、一度<code>UPDATE</code>すると元に戻せないので、更新前にバックアップをとりましょう。</p>



<h2 class="wp-block-heading">UPDATE の具体例</h2>



<p class="wp-block-paragraph">ここからは実際のクエリ例を示しながら、<code>UPDATE</code>の挙動を確認していきましょう。</p>



<h3 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">SQL</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>UPDATE employees
SET salary = 50000
WHERE employee_id = 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: #569CD6">UPDATE</span><span style="color: #D4D4D4"> employees</span></span>
<span class="line"><span style="color: #569CD6">SET</span><span style="color: #D4D4D4"> salary = </span><span style="color: #B5CEA8">50000</span></span>
<span class="line"><span style="color: #569CD6">WHERE</span><span style="color: #D4D4D4"> employee_id = </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">;</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>employees</code>テーブルの<code>employee_id=1</code>のフィールドを取得して、<code>salary</code>列の値を<code>50000</code>に変更します。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>クエリ実行例</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">元々、<code>employees</code>テーブルが次のようなものだったとします。</p>



<figure class="wp-block-table"><table><thead><tr><th>employee_id</th><th>name</th><th>position</th><th>salary</th></tr></thead><tbody><tr><td>1</td><td>John Smith</td><td>Manager</td><td>45000</td></tr><tr><td>2</td><td>Jane Doe</td><td>Developer</td><td>55000</td></tr><tr><td>3</td><td>Alice Jones</td><td>Designer</td><td>48000</td></tr><tr><td>4</td><td>Bob Brown</td><td>Tester</td><td>42000</td></tr></tbody></table><figcaption class="wp-element-caption">クエリ実行前</figcaption></figure>



<p class="wp-block-paragraph">クエリの実行結果は以下になります。</p>



<figure class="wp-block-table"><table><thead><tr><th>employee_id</th><th>name</th><th>position</th><th>salary</th></tr></thead><tbody><tr><td>1</td><td>John Smith</td><td>Manager</td><td>50000</td></tr><tr><td>2</td><td>Jane Doe</td><td>Developer</td><td>55000</td></tr><tr><td>3</td><td>Alice Jones</td><td>Designer</td><td>48000</td></tr><tr><td>4</td><td>Bob Brown</td><td>Tester</td><td>42000</td></tr></tbody></table><figcaption class="wp-element-caption">クエリ実行後</figcaption></figure>
</div></div>



<h3 class="wp-block-heading">複数の列を更新する場合</h3>



<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">SQL</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>UPDATE employees
SET salary = 50000, job_title = 'Senior Developer'
WHERE employee_id = 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: #569CD6">UPDATE</span><span style="color: #D4D4D4"> employees</span></span>
<span class="line"><span style="color: #569CD6">SET</span><span style="color: #D4D4D4"> salary = </span><span style="color: #B5CEA8">50000</span><span style="color: #D4D4D4">, job_title = </span><span style="color: #CE9178">&apos;Senior Developer&apos;</span></span>
<span class="line"><span style="color: #569CD6">WHERE</span><span style="color: #D4D4D4"> employee_id = </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">;</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>employees</code>テーブルの<code>employee_id=1</code>のフィールドを取得して、<code>salary</code>列と<code>job_title</code>の値を書き換えます。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>クエリ実行例</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">クエリ実行前の<code>employees</code>テーブルが以下だったとします。</p>



<figure class="wp-block-table"><table><thead><tr><th>employee_id</th><th>name</th><th>position</th><th>salary</th></tr></thead><tbody><tr><td>1</td><td>John Smith</td><td>Manager</td><td>45000</td></tr><tr><td>2</td><td>Jane Doe</td><td>Developer</td><td>55000</td></tr><tr><td>3</td><td>Alice Jones</td><td>Designer</td><td>48000</td></tr><tr><td>4</td><td>Bob Brown</td><td>Tester</td><td>42000</td></tr></tbody></table><figcaption class="wp-element-caption">クエリ実行前</figcaption></figure>



<p class="wp-block-paragraph">クエリの実行結果は以下になります。</p>



<figure class="wp-block-table"><table><thead><tr><th>employee_id</th><th>name</th><th>position</th><th>salary</th></tr></thead><tbody><tr><td>1</td><td>John Smith</td><td>Manager</td><td>50000</td></tr><tr><td>2</td><td>Jane Doe</td><td>Developer</td><td>55000</td></tr><tr><td>3</td><td>Alice Jones</td><td>Designer</td><td>48000</td></tr><tr><td>4</td><td>Bob Brown</td><td>Tester</td><td>42000</td></tr></tbody></table><figcaption class="wp-element-caption">クエリ実行後</figcaption></figure>
</div></div>



<h3 class="wp-block-heading">全行を更新する場合</h3>



<p class="wp-block-paragraph">全行を更新するには、<code>WHERE</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">SQL</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>UPDATE employees
SET salary = salary * 1.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: #569CD6">UPDATE</span><span style="color: #D4D4D4"> employees</span></span>
<span class="line"><span style="color: #569CD6">SET</span><span style="color: #D4D4D4"> salary = salary * </span><span style="color: #B5CEA8">1</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">上記の例では、<code>salary</code>カラムの全行を<code>10%</code>分増やします。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>クエリ実行例</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">クエリ実行前の<code>employees</code>テーブルが以下だったとします。</p>



<figure class="wp-block-table"><table><thead><tr><th>employee_id</th><th>name</th><th>position</th><th>salary</th></tr></thead><tbody><tr><td>1</td><td>John Smith</td><td>Manager</td><td>45000</td></tr><tr><td>2</td><td>Jane Doe</td><td>Developer</td><td>55000</td></tr><tr><td>3</td><td>Alice Jones</td><td>Designer</td><td>48000</td></tr><tr><td>4</td><td>Bob Brown</td><td>Tester</td><td>42000</td></tr></tbody></table><figcaption class="wp-element-caption">クエリ実行前</figcaption></figure>



<p class="wp-block-paragraph">クエリの実行結果は以下になります。</p>



<figure class="wp-block-table"><table><thead><tr><th>employee_id</th><th>name</th><th>position</th><th>salary</th></tr></thead><tbody><tr><td>1</td><td>John Smith</td><td>Manager</td><td>49500</td></tr><tr><td>2</td><td>Jane Doe</td><td>Developer</td><td>60500</td></tr><tr><td>3</td><td>Alice Jones</td><td>Designer</td><td>52800</td></tr><tr><td>4</td><td>Bob Brown</td><td>Tester</td><td>46200</td></tr></tbody></table><figcaption class="wp-element-caption">クエリ実行後</figcaption></figure>
</div></div>
]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
