Метод startswith

Метод startswith класса ColumnElement создает условие SQL для проверки того, начинается ли строковое значение столбца с указанного префикса. Метод принимает одним параметром строку или выражение для сравнения. В сгенерированном SQL используется оператор LIKE с шаблоном, к которому справа добавляется знак процента.

Синтаксис

ColumnElement.startswith(other, [escape])

Пример

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

from sqlalchemy import select
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column

class Base(DeclarativeBase):
	pass

class Article(Base):
	__tablename__ = 'articles'
	
	id: Mapped[int] = mapped_column(primary_key=True)
	title: Mapped[str]

stmt = select(Article.title).where(Article.title.startswith('article'))
print(stmt)

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

"SELECT articles.title FROM articles WHERE (articles.title LIKE 'article' || '%')"

Пример

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

from sqlalchemy import create_engine, 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]

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

with Session(engine) as session:
	session.add_all([
		Article(title='article one'),
		Article(title='article two'),
		Article(title='sqlite notes'),
	])
	session.commit()
	
	stmt = select(Article.title).where(Article.title.startswith('article'))
	res = session.scalars(stmt).all()
	print(res)

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

['article one', 'article two']

Пример

Давайте выведем итоговый SQL-запрос для предыдущего примера:

from sqlalchemy import select
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column

class Base(DeclarativeBase):
	pass

class Article(Base):
	__tablename__ = 'articles'
	
	id: Mapped[int] = mapped_column(primary_key=True)
	title: Mapped[str]

stmt = select(Article.title).where(Article.title.startswith('article'))
print(stmt)

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

SELECT articles.title
FROM articles
WHERE (articles.title LIKE 'article' || '%')

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

класс ColumnElement,
который представляет элемент столбца
метод endswith,
который проверяет окончание строки
метод contains,
который проверяет вхождение подстроки
метод like,
который создает условие по шаблону