Django ORM - Пример с одной таблицей

Перед чтением этой главы вам нужно прочитатьМодели DjangoВыполнить базовую настройку и понять решения распространённых проблем.

Далее мы создаём новый проект app01 (если он уже был создан ранее, пропустите следующие операции):

django-admin.py startproject app01

Tungaanut, settings.py-mi INSTALLED_APPS entry nani, maligassiuqtuq:

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'app01',               # 添加此项
)

Далее укажите Django использовать модуль pymysql для подключения к базе данных MySQL:

Пример

# Импортируйте модули и настройте в __init__.py в том же каталоге, что и settings.py
import pymysql
pymysql.install_as_MySQLdb()

Создание модели

Добавьте следующий класс в models.py проекта:

app01/models.py

class Book(models.Model):
    id = models.AutoField(primary_key=True) # id создаётся автоматически и может быть указан вручную
    title = models.CharField(max_length=32) # Название книги
    price = models.DecimalField(max_digits=5, decimal_places=2) # Цена книги
    publish = models.CharField(max_length=32) # Название издательства
    pub_date = models.DateField() # Дата публикации

Затем выполните следующую команду в командной строке:

$ python3 manage.py migrate   # 创建表结构

$ python3 manage.py makemigrations app01  # 让 Django 知道我们在我们的模型有一些变更
$ python3 manage.py migrate app01   # 创建表结构

Error message-ngit piujut

Malittumik error message takuguvit aulattijjut ingikkuq:

Причина в том, что MySQLclient в настоящее время поддерживает только Python до версии 3.4, поэтому, если вы используете более высокую версию Python, вам нужно изменить её следующим образом:

Используйте путь к файлу в сообщении об ошибке, чтобы найти файл base.py по пути ...site-packages\Django-2.0-py3.6.egg\django\db\backends\mysql, и закомментируйте эти две строки кода (код находится в начале файла):

if version < (1, 3, 13):
    raise ImproperlyConfigured('mysqlclient 1.3.13 or newer is required; you have %s.' % Database.__version__)

Обычно щёлкните по информации о пути к файлу в сообщении об ошибке, и она автоматически перейдёт к номеру строки в файле с ошибкой. На этом этапе мы закомментируем строку кода, в которой возникает ошибка.

В этот момент база данных example создаст таблицу с именем app01_book.

Далее мы добавим файлы views.py и models.py в проект app01. Структура каталогов проекта app01:

app01
|-- app01
|   |-- __init__.py
|   |-- __pycache__
|   |-- asgi.py
|   |-- migrations
|   |-- models.py
|   |-- settings.py
|   |-- urls.py
|   |-- views.py
|   `-- wsgi.py

Добавление в базу данных

Конфигурация правил:

app01/urls.py: код файла:

from django.contrib import admin from django.urls import path from . import views urlpatterns = [ path('add_book/', views.add_book), ]

Способ 1:Экземпляр класса модели

Необходимо импортировать файл models.py из каталога приложения:

from app 目录 import models

И после создания экземпляра объекта нужно выполнитьobject.save()Только тогда вы сможете успешно добавить данные в базу данных.

app01/views.py: Код файла:

from django.shortcuts import render,HttpResponse from app01 import models def add_book(request): book = models.Book(title="Example",price=300,publish="Rookie Press",pub_date="2008-8-8") book.save() return HttpResponse("<p>Данные успешно добавлены!</p>")

Способ 2:Используйте метод create, предоставляемый objects в ORM, чтобы добиться этого (рекомендуется)

app01/views.py: Код файла:

from django.shortcuts import render,HttpResponse from app01 import models def add_book(request): books = models.Book.objects.create(title="Ладонь Будды",price=200,publish="Кунг-фу Пресс",pub_date="2010-10-10") print(books, type(books)) # Объект Book (18) return HttpResponse("<p>Данные успешно добавлены!</p>")

Поиск

Использование методаall()для запроса всего содержимого.

Возвращаемые данные имеют тип QuerySet, подобный списку, и содержат объекты класса модели по одному. Для получения объектов класса модели можно использовать индексы.

app01/views.py: Код файла:

from django.shortcuts import render,HttpResponse from app01 import models def add_book(request): books = models.Book.objects.all() print(books,type(books)) # Тип QuerySet, похож на список. При обращении к URL данные отображаются в окне командной строки. return HttpResponse("<p>Поиск выполнен успешно!</p>")

filter()метод для запроса данных, удовлетворяющих условиям.

Возвращаемые данные имеют тип QuerySet, похожий на список, и содержат объекты классов моделей, удовлетворяющие условиям. Можно использовать индексы для получения объектов классов моделей.

pk=3 означает первичный ключ=3, что эквивалентно id=3.

Поскольку id имеет особое значение в PyCharm — это встроенная функция id(), которая просматривает адреса памяти, поэтому используйте pk.

app01/views.py: Код файла:

from django.shortcuts import render,HttpResponse from app01 import models def add_book(request): books = models.Book.objects.filter(pk=5) print(books) print("//////////////////////////////////////") books = models.Book.objects.filter(publish='Rookie Press', price=300) print(books, type(books)) # Тип QuerySet, похож на список. return HttpResponse("<p>Поиск выполнен успешно!</p>")

exclude() Метод используется для запроса данных, не удовлетворяющих условиям.

Возвращаемые данные имеют тип QuerySet, аналогичный списку, и содержат объекты класса модели, которые не соответствуют условиям. Для получения объектов класса модели можно использовать индексы.

app01/views.py: Код файла:

from django.shortcuts import render,HttpResponse from app01 import models def add_book(request): books = models.Book.objects.exclude(pk=5) print(books) print("//////////////////////////////////////") books = models.Book.objects.exclude(publish='Rookie Press', price=300) print(books, type(books)) # Тип QuerySet, похож на список. return HttpResponse("<p>Поиск выполнен успешно!</p>")

get()Метод используется для запроса объектов, соответствующих условиям, и возвращает объект класса модели. Условиям может соответствовать только один объект. Если фильтрующим условиям соответствует более одного объекта или ни одного, будет вызвана ошибка.

app01/views.py: Код файла:

from django.shortcuts import render,HttpResponse from app01 import models def add_book(request): books = models.Book.objects.get(pk=5) books = models.Book.objects.get(pk=18) # Ошибка, нет объекта, соответствующего условиям books = models.Book.objects.get(price=200) # Ошибка: найдено более одного соответствующего объекта. print(books, type(books)) # Объект класса модели return HttpResponse("<p>Поиск выполнен успешно!</p>")

order_by()Метод используется для сортировки результатов запроса.

Возвращаемые данные имеют тип QuerySet, подобный списку, содержащий отсортированные объекты классов моделей. Вы можете использовать индексы для получения объектов классов моделей.

Примечание:

  • a. Имена полей параметров должны быть заключены в кавычки.
  • b. Для сортировки по убыванию добавьте знак минус перед полем-。

app01/views.py: Код файла:

from django.shortcuts import render,HttpResponse from app01 import models def add_book(request): books = models.Book.objects.order_by("price") # Запрос всех, сортировка по цене по возрастанию books = models.Book.objects.order_by("-price") # Запрос всех, сортировка по цене по убыванию return HttpResponse("<p>Поиск выполнен успешно!</p>")

reverse()Метод используется для изменения порядка результатов запроса на обратный.

Возвращаемые данные имеют тип QuerySet, подобный списку, содержащий объекты классов моделей в обратном порядке. Вы можете использовать индексы для получения объектов классов моделей.

app01/views.py: Код файла:

from django.shortcuts import render,HttpResponse from app01 import models def add_book(request): # Сортировка по цене по возрастанию: сортировать по убыванию, затем reverse. books = models.Book.objects.order_by("-price").reverse() return HttpResponse("<p>Поиск выполнен успешно!</p>")

count() Метод используется для запроса количества записей данных; возвращаемые данные — целое число.

app01/views.py: Код файла:

from django.shortcuts import render,HttpResponse from app01 import models def add_book(request): books = models.Book.objects.count() # Запрос количества всех данных books = models.Book.objects.filter(price=200).count() # Запрос количества записей, удовлетворяющих условиям return HttpResponse("<p>Поиск выполнен успешно!</p>")

first()Метод возвращает первую запись. Возвращаемые данные — объект класса модели; также можно использовать индексный доступ.[0]。

app01/views.py: Код файла:

from django.shortcuts import render,HttpResponse from app01 import models def add_book(request): books = models.Book.objects.first() # Вернуть первую запись из всех данных return HttpResponse("<p>Поиск выполнен успешно!</p>")

Метод last() возвращает последнюю запись. Возвращаемые данные — объект класса модели, и нельзя использовать индексный доступ.[-1], в ORM нет обратного индекса.

app01/views.py: Код файла:

from django.shortcuts import render,HttpResponse from app01 import models def add_book(request): books = models.Book.objects.last() # Вернуть последнюю запись из всех данных return HttpResponse("<p>Поиск выполнен успешно!</p>")

exists()метод для определения наличия данных в списке результатов запроса QuerySet.

Возвращаемый тип данных — boolean. Если данные есть, возвращается true; если нет — false.

Примечание:Тип данных для проверки может быть только данными типа QuerySet, а не integer или объектами класса модели.

Пример

from django.shortcuts import render,HttpResponse
from app01 import models
def add_book(request):
    books = models.Book.objects.exists()
    # Ошибка: проверяемый тип данных может быть только данными типа QuerySet, а не целым числом.
    books = models.Book.objects.count().exists()
    # Ошибка: оцениваемый тип данных может быть только данными QuerySet, а не объектом класса модели
    books = models.Book.objects.first().exists()  
    return HttpResponse(<p>Поиск выполнен успешно!</p>)

values()метод для запроса данных по отдельным полям.

Возвращаемые данные имеют тип QuerySet, подобный списку, и содержат не объекты классов моделей, а итерируемую последовательность словарей. Ключи в словарях — это поля, а значения — данные.

Примечание:

  • Имена полей параметров должны быть заключены в кавычки
  • Если вы хотите, чтобы имена полей и данные использовалиvalues
  • Пример

    from django.shortcuts import render,HttpResponse
    from app01 import models
    def add_book(request):
        # Запрос данных для всех полей id и price
        books = models.Book.objects.values("pk","price")
        print(books[0]["price"],type(books)) # Получает данные поля price первой записи
        return HttpResponse(<p>Поиск выполнен успешно!</p>)

    values_list()метод для запроса данных по отдельным полям.

    Возвращаемые данные имеют тип QuerySet, похожий на список, и содержат не объекты классов моделей, а кортежи по одному. Каждый кортеж содержит данные, соответствующие полям запроса.

    Примечание:

    • Имена полей параметров должны быть заключены в кавычки
    • Если вам нужны только данные, используйте values_list.

    Пример


    from django.shortcuts import render,HttpResponse
    from app01 import models
    def add_book(request):
        # Запрос данных всех полей price и publish
        books = models.Book.objects.values_list("price","publish")
        print(books)
        print(books[0][0],type(books)) # Получает данные поля price первой записи
        return HttpResponse(<p>Поиск выполнен успешно!</p>)

    distinct() метод для удаления дубликатов данных.

    Возвращаемые данные имеют тип QuerySet.

    Примечание:

    • Дедупликация объектов класса модели бессмысленна, потому что каждый объект представляет собой уникальную сущность.
    • distinct() обычно используется вместе с values или values_list.

    Пример

    from django.shortcuts import render,HttpResponse
    from app01 import models
    def add_book(request):
        # Запрос общего количества издателей
        books = models.Book.objects.values_list("publish").distinct() # Дедупликация объектов класса модели бессмысленна, потому что каждый объект — отдельная сущность.
        books = models.Book.objects.distinct()
        return HttpResponse(<p>Поиск выполнен успешно!</p>)

    filter()Метод основан на нечётких запросах с двойным подчёркиванием (то же самое относится к exclude).

    Примечание:В filter можно использовать только знак равенства =; нельзя использовать знак больше >, знак меньше < или другие символы.

    __in используется для выборки диапазона; после знака = идёт список.

    Пример

    from django.shortcuts import render,HttpResponse
    from app01 import models
    def add_book(request):
        # Запрос данных с ценой 200 или 300
        books = models.Book.objects.filter(price__in=[200,300])
        return HttpResponse(<p>Поиск выполнен успешно!</p>)

    __gtбольше, значение после знака = — число.

    # 查询价格大于200的数据 
    books = models.Book.objects.filter(price__gt=200)

    __gteбольше или равно, значение после знака = — число.
    # 查询价格大于等于200的数据 
    books = models.Book.objects.filter(price__gte=200)

    __ltменьше, значение после знака = — число.

    # 查询价格小于300的数据 
    books=models.Book.objects.filter(price__lt=300)

    __lteменьше или равно, значение после знака = — число.

    # 查询价格小于等于300的数据 
    books=models.Book.objects.filter(price__lte=300)

    __rangeМежду ... , замкнутый слева и справа интервал; после знака = находится список из двух элементов.

    books=models.Book.objects.filter(price__range=[200,300])

    __containsсодержит, значение после знака = — строка.

    books=models.Book.objects.filter(title__contains="菜")

    __icontainsсодержит без учета регистра; после знака = — строка.

    books=models.Book.objects.filter(title__icontains="python") # 不区分大小写

    __startswithНачинается с указанного символа; после знака = — строка.

    books=models.Book.objects.filter(title__startswith="菜")

    __endswithЗаканчивается указанным символом; после знака = — строка.

    books=models.Book.objects.filter(title__endswith="教程")

    __yearЭто год типа данных DateField; после знака = — число.

    books=models.Book.objects.filter(pub_date__year=2008) 

    __monthЭто месяц типа данных DateField; после знака = — число.

    books=models.Book.objects.filter(pub_date__month=10) 

    __dayЭто день типа данных DateField; после знака = — число.

    books=models.Book.objects.filter(pub_date__day=01)

    Delete

    Способ 1:Использованиеobject.delete() класса модели。

    Возвращаемое значение:Кортеж; первый элемент — количество затронутых строк.

    books=models.Book.objects.filter(pk=8).first().delete()

    Способ 2: Использование QuerySettypeData.delete()(Рекомендуется)

    Возвращаемое значение:Кортеж; первый элемент — количество затронутых строк.

    books=models.Book.objects.filter(pk__in=[1,2]).delete()

    Примечание:

    • a. Когда Django удаляет данные, он имитирует поведение SQL-ограничения ON DELETE CASCADE, то есть при удалении объекта связанные с ним объекты внешнего ключа также удаляются.
    • Метод delete() является методом типа данных QuerySet, но он не применяется к самому Manager. То есть, если вы хотите удалить все данные, вы не можете опустить all.
    books=models.Book.objects.delete()  # 报错
    books=models.Book.objects.all().delete()   # 删除成功

    изменить

    Способ 1:

    模型类的对象.属性 = 更改的属性值
    模型类的对象.save()

    Возвращаемое значение:Объект класса модели, который редактируется.

    books = models.Book.objects.filter(pk=7).first() 
    books.price = 400 
    books.save()
    

    Способ 2:Данные типа QuerySet .update(имя поля = изменённые данные) (рекомендуется)

    Возвращаемое значение:Целое число, количество затронутых строк

    Пример

    from django.shortcuts import render,HttpResponse
    from app01 import models
    def add_book(request):
        books = models.Book.objects.filter(pk__in=[7,8]).update(price=888)
        return HttpResponse(books)

    Другие расширения