[Python][Django]DB検索のあれこれをまとめ

from django.db import models
class BookManager(models.Manager):
    pass
class Book(models.Model):
    name = models.CharField(
        verbose_name=("名称"),
        max_length=255
    )
    class = models.IntegerField(
        verbose_name=('分類'),
        choices=(
            (1, '技術'),
            (2, '芸術'),
            (3, 'スポーツ')
            ....
        )
    )
    create_at = models.DateField(
        verbose_name=("作成日時")
    )
    objects = BookManager()

# 全レコードを取得したい場合
books = Book.objects.all()

# SQL だとこんな感じ
select * from books;

# 1 件だけ取得したい場合
book = Book.objects.get(pk=1)
# PK の名称を指定(ここでは id)しても同じ結果となる
# 基本的には上の pk= の方を使用するのがいいと思う
book = Book.objects.get(id=1)

# SQL だとこんな感じ
select * from books where id = 1;

# 存在しない条件
Book.objects.get(id=-1)  # DoesNotExist 例外が発生する
# 複数存在する条件
Book.objects.get(name='test')  # MultipleObjectsReturned 例外が発生する

# name が django ではない
books = Book.objects.exclude(name='django')

# SQL だとこんな感じ
select * from books where not (name = 'django')

# 完全一致
books = Book.objects.filter(name='django')

# SQL だとこんな感じ
select * from books where name = 'django'

# 完全一致(カンマ区切りで複数条件)
books = Book.objects.filter(id=1, name="django")

# SQL だとこんな感じ
select * from books where id = 1 and name = 'django'

# 完全一致
books = Book.objects.filter(id__exact=1)

# SQL だとこんな感じ
select * from books where id = 1

# 完全一致(Noneを指定)
books = Book.objects.filter(name__exact=None)

# SQL だとこんな感じ
select * from books where name is NULL

# Null であるか
books = Book.objects.filter(name__isnull=True)

# SQL だとこんな感じ
select * from books where name is NULL

# Null でないか
books = Book.objects.filter(name__isnull=False)

# SQL だとこんな感じ
select * from books where name is not NULL

# test を含むか(大文字小文字を区別する)
books = Book.objects.filter(name__contains='test')

# SQL だとこんな感じ
select * from books where name LIKE '%test%'

# test を含むか(大文字小文字を区別しない)
books = Book.objects.filter(name__icontains='test')

# SQL だとこんな感じ
select * from books where name ILIKE '%test%'

# test で始まるか(大文字小文字を区別する)
books = Book.objects.filter(name__startswith='test')

# SQL だとこんな感じ
select * from books where name ILIKE 'test%'

# test で始まるか(大文字小文字を区別する)
books = Book.objects.filter(name__endswith='test')

# SQL だとこんな感じ
select * from books where name ILIKE '%test'

# start で始まって、end で終わる文字列を検索
Book.objects.filter(name__regex=r'^start.*end$')

# PostgreSQL の場合
SELECT * FROM books WHERE name ~ '^word.*press$';

# MySql の場合
SELECT * FROM books WHERE name REGEXP '^word.*press$';

# id が 5 より大きい
books = Book.objects.filter(id__gt=5)

# SQL だとこんな感じ
select * from books where id > 5

# id が 5 未満
books = Book.objects.filter(id__lt=5)

# SQL だとこんな感じ
select * from books where id < 5

book = Book.objects.filter(id__in=[1, 3, 4])
book = Book.objects.filter(name__in="test")

SELECT * FROM books WHERE id IN (1, 3, 4);
SELECT * FROM books WHERE name IN ('t', 'e', 's', 't');

# id が 1 ~ 5
books = Book.objects.filter(id__range=(1, 5))

# SQL だとこんな感じ
select * from books where id between 1 and 5

Book.objects.filter(ceated_at__date=datetime.date(2005, 1, 1))

# 日付の"年"が完全一致
books = Book.objects.filter(create_at__year=2025)

# SQL だとこんな感じ
select * from books where create_at between '2025-01-01' and '2025-12-31'

# 日付の"年"が完全一致
books = Book.objects.filter(create_at__year__gte=2025)

# SQL だとこんな感じ
select * from books where create_at >= '2025-01-01'

# 日付の"月"が完全一致
books = Book.objects.filter(create_at__month =12)

# SQL だとこんな感じ
select * from books where EXTRACT('month' FROM create_at) = 12

book = Book.objects.filter(created_at__week_day=2)

# 第2四半期（4月1日から6月30日まで）を検索
book = Book.objects.filter(created_at__quarter=2)

# イテレートした時にクエリを実行する
for book in Book.objects.all():
    print(book.name)
# list を呼び出すことでクエリを実行する
book_list = list(Book.objects.all())

def search(self, search_conditions):
    # まずは全件取得
    books = Book.objects.filter()
    # 検索条件に name が含まれていれば条件を追加する
    if search_conditions.get('name'):
        books = books.filter(name=search_conditions.get('name'))
    return books