Поле DECIMAL

Поле DECIMAL в SQLAlchemy представляет собой числовой тип данных с фиксированной точкой. Он используется для хранения точных десятичных значений, например, денежных сумм. Первым параметром передается precision - общее количество цифр в числе, вторым параметром scale - количество цифр после запятой. Также можно указать asdecimal, который определяет, возвращать ли значения как Decimal или как float.

Синтаксис

DECIMAL(precision, scale, [asdecimal])

Пример

Давайте создадим модель с полем DECIMAL и посмотрим, как оно хранит точные значения:

from sqlalchemy import create_engine, DECIMAL
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, Session

class Base(DeclarativeBase):
	pass

class Article(Base):
	__tablename__ = 'articles'
	
	id: Mapped[int] = mapped_column(primary_key=True)
	title: Mapped[str]
	num: Mapped[float] = mapped_column(DECIMAL(10, 2))

engine = create_engine('sqlite:///:memory:')
Base.metadata.create_all(engine)

with Session(engine) as session:
	article = Article(title='article', num=1234.56)
	session.add(article)
	session.commit()
	
	res = session.query(Article).first()
	print(res.num)

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

1234.56

Пример

Давайте убедимся, что значение хранится без потери точности, сравнив его с обычным числом:

from decimal import Decimal
from sqlalchemy import create_engine, DECIMAL, select
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, Session

class Base(DeclarativeBase):
	pass

class Article(Base):
	__tablename__ = 'articles'
	
	id: Mapped[int] = mapped_column(primary_key=True)
	title: Mapped[str]
	num: Mapped[Decimal] = mapped_column(DECIMAL(10, 2))

engine = create_engine('sqlite:///:memory:')
Base.metadata.create_all(engine)

with Session(engine) as session:
	article = Article(title='article', num=Decimal('0.10'))
	session.add(article)
	session.commit()
	
	res = session.execute(select(Article.num)).scalar_one()
	print(res)
	print(res == Decimal('0.10'))

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

0.10
True

Пример

Давайте посмотрим, какой SQL-запрос создает SQLAlchemy для поля DECIMAL:

from sqlalchemy import create_engine, DECIMAL
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from sqlalchemy.schema import CreateTable

class Base(DeclarativeBase):
	pass

class Article(Base):
	__tablename__ = 'articles'
	
	id: Mapped[int] = mapped_column(primary_key=True)
	title: Mapped[str]
	num: Mapped[float] = mapped_column(DECIMAL(10, 2))

engine = create_engine('sqlite:///:memory:')
print(CreateTable(Article.__table__).compile(engine))

Итоговый SQL запрос:

CREATE TABLE articles (
	id INTEGER NOT NULL,
	title VARCHAR NOT NULL,
	num NUMERIC(10, 2) NOT NULL,
	PRIMARY KEY (id)
)

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

тип Numeric,
который является более общим числовым типом
тип Float,
который хранит числа с плавающей точкой
тип Integer,
который хранит целые числа
тип BigInteger,
который хранит большие целые числа