NotSupportedError

Исключение NotSupportedError наследуется от DatabaseError и возникает в Django при выполнении операций, которые не поддерживаются используемой базой данных или её драйвером. Это может происходить при использовании специфических функций, которые доступны не во всех СУБД, например, полнотекстовый поиск, оконные функции или определённые типы полей. Также это исключение может быть вызвано при попытке выполнить транзакционные операции, не поддерживаемые движком базы данных.

Синтаксис

from django.db import transaction
from django.db.utils import NotSupportedError

try:
	# Код, который может вызвать ошибку
	pass
except NotSupportedError as e:
	# Обработка ошибки
	print(f"Operation not supported: {e}")

Исключение можно импортировать из модуля django.db.utils.

Пример

Рассмотрим ситуацию, когда используется база данных SQLite, которая не поддерживает полнотекстовый поиск по умолчанию:

from django.db import models
from django.db.utils import NotSupportedError

class Article(models.Model):
	title = models.CharField(max_length=200)
	content = models.TextField()

# Попытка выполнить полнотекстовый поиск в SQLite без расширения
try:
	res = Article.objects.filter(content__search="python")
	print(list(res))
except NotSupportedError as e:
	print(f"Error: {e}")

Результат выполнения кода:

"Error: Full-text search is not supported by this database backend"

В данном примере возникает ошибка, так как SQLite требует специального расширения для полнотекстового поиска, которое по умолчанию не подключено.

Пример

Попытка использования оконных функций в базе данных, которая их не поддерживает:

from django.db.models import Window, F, Sum
from django.db.utils import NotSupportedError

class Sale(models.Model):
	product = models.CharField(max_length=100)
	amount = models.IntegerField()
	date = models.DateTimeField()

# Попытка использования оконной функции в неподдерживаемой БД
try:
	res = Sale.objects.annotate(
		running_total=Window(
			expression=Sum('amount'),
			order_by=F('date').asc()
		)
	)
	print(list(res))
except NotSupportedError as e:
	print(f"Error: {e}")

Результат выполнения кода:

"Error: Window functions are not supported by this database backend"

Оконные функции поддерживаются не всеми базами данных, и попытка их использования в неподдерживаемой СУБД вызовет данное исключение.

Пример

Попытка выполнения транзакции с использованием функции commit_on_success в неподдерживаемом контексте:

from django.db import transaction
from django.db.utils import NotSupportedError

@transaction.commit_on_success
def update_data():
	# Код обновления данных
	pass

try:
	update_data()
except NotSupportedError as e:
	print(f"Error: {e}")

Результат выполнения кода:

"Error: Savepoints are not supported by this database backend"

В некоторых базах данных могут отсутствовать механизмы сохранения точек, что приводит к возникновению данного исключения.

Смотрите также

исключение OperationalError,
которое возникает при ошибках, связанных с подключением к базе данных
исключение IntegrityError,
которое возникает при нарушении целостности данных
исключение ProgrammingError,
которое возникает при ошибках в SQL-запросах
исключение DataError,
которое возникает при проблемах с обработкой данных