Метод set класса URL

Метод set класса URL устанавливает значения компонентов URL подключения к базе данных. Первым параметром передаётся словарь с новыми значениями компонентов. Метод возвращает новый объект URL, при этом исходный объект остаётся неизменным.

В словаре можно указать такие компоненты, как drivername, username, password, host, port, database и query.

Синтаксис

url.set(**kwargs)

Пример

Давайте создадим объект URL и установим имя базы данных с помощью метода set:

from sqlalchemy import URL

url = URL.create('sqlite')
res = url.set(database=':memory:')

print(res)

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

"sqlite:///:memory:"

Пример

Давайте установим сразу несколько компонентов URL подключения:

from sqlalchemy import URL

url = URL.create('sqlite')
res = url.set(
	drivername='postgresql',
	username='user',
	password='secret',
	host='localhost',
	port=5432,
	database='articles'
)

print(res)

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

"postgresql://user:secret@localhost:5432/articles"

Пример

Давайте передадим движку подключения URL, изменённый методом set:

from sqlalchemy import URL, create_engine, text

url = URL.create('sqlite')
url = url.set(database=':memory:')

engine = create_engine(url)
with engine.connect() as conn:
	res = conn.execute(text('SELECT 1'))
	print(res.scalar())

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

1

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

класс URL,
который представляет URL подключения
метод create,
который создает объект URL
метод update_query_dict,
который обновляет параметры строки запроса
метод render_as_string,
который возвращает URL в виде строки