10.5. Модуль db

Модуль cerebro.db предоставляет доступ к удаленной базе данных для выполнения SQL-запросов.

Классы

• Db

class cerebro.db.Db(db_timeout=5, db_reconn_count=3)

Класс доступа к удаленной базе данных Cerebro.

Методы

• execute()
• is_connected()
• url()

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

Доступ к данным осуществляется с помощью хранимых процедур на стороне базы данных. Подробнее о процедурах смотрите раздел Программный интефейс к базе данных memoria на языке SQL.

db = cerebro.db.Db()
res = db.execute('select "listProjects_01"(%s,%s)', false, true) # выполняем запрос на список проектов
print('Список проектов', res) # печатаем результат

execute(query, *parameters)

Параметры:

• query (string) – строка SQL-запроса.
• parameters – параметры запроса.

Результат:

результат запроса.

Тип результата:

list(tuple,)

Выполняет запрос и возвращает результат в виде списка кортежей.

Аргументы запроса задаются в формате %s.

db = cerebro.db.Db()
projects = db.execute('select "listProjects_01"(%s,%s)', false, true) # выполняем запрос на список проектов
print('Список проектов', projects) # печатаем результат 

db = cerebro.db.Db()
# выполняем запрос на установку прогресса задачи в 50%
projects = db.execute('select "taskSetProgress_a"(%s,%s)', {task_id,}, 50)                      

is_connected()

Результат:True, если соединение c базой данных установлено. Тип результата:bool

url()

Результат:строковый локатор удаленной базы данных. Тип результата:string