На этом шаге мы рассмотрим различные методы выполнения запросов.

    Чтобы выполнить запрос к базе, сначала следует создать экземпляр класса QSqlQuery. Для этого используется один из следующих форматов вызова его конструктора:

  QSqlQuery([<SQL-код>][, db=QSqlDatabase()]) 
  QSqlQuery(<QSqlDatabase>)
  QSqlQuery(<QSqlQuery>)

    Первый формат позволяет сразу задать SQL-код, который следует выполнить, и немедленно запустить его на исполнение. Необязательный параметр db задает соединение с базой данных, запрос к которой следует выполнить, - если он не указан, будет использоваться соединение по умолчанию.

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

    Для выполнения запросов применяются перечисленные далее методы класса QSqlQuery:

• ехес (<SQL-код>) - немедленно выполняет переданный в параметре SQL-код. Если последний был успешно выполнен, возвращает True и переводит запрос в активное состояние, в противном случае возвращает False. Пример:

  from PyQt5 import QtWidgets, QtSql
  import sys
  # Создаем объект приложения, иначе поддержка баз данных не будет работать
  арр = QtWidgets.QApplication(sys.argv)
  con = QtSql.QSqlDatabase.addDatabase('QSQLITE') 
  con.setDatabaseName('c:\\temp\\data.sqlite')
  if con.open():
      # Работаем с базой данных
       if 'good' not in con.tables():
           query = QtSql.QSqlQuery()
           query.exec("create table good (id integer primary key autoincrement, 
               goodname text, goodcount integer)")
  else:
      # Выводим текст описания ошибки
      print(con.lastError().text())
  

  Архив с файлом можно взять здесь.

      Здесь мы проверяем, есть ли в базе данных таблица good, и, если таковой нет, создаем ее SQL-командой CREATE TABLE.

  ---

     Замечание. Метод exec() следует использовать в тех случаях, если SQL-запрос не принимает параметров. В противном случае рекомендуется применять методы, рассмотренные далее.

  ---

• prepare (<SQL-код>) - подготавливает SQL-запрос к выполнению. Применяется, если SQL-запрос содержит параметры. Параметры в коде запроса могут быть заданы либо в стиле ODBC (вопросительными знаками), либо в стиле Oracle (символьными обозначениями, предваренными знаком двоеточия). Метод возвращает True, если SQL-запрос был успешно подготовлен, и False - в противном случае;

• addBindValue (<Значение параметра>[, paramType=In]) - задает значение очередного по счету параметра: так, первый вызов этого метода задает значение для первого параметра, второй вызов - для второго и т. д. Необязательный параметр paramType указывает тип параметра - здесь практически всегда используется атрибут In класса QSql, означающий, что этот параметр служит для занесения значения в базу. Пример:

    query.prepare("insert into good values(null, ?, ?)")
    query.addbindValue('Дискета')
    query.addbindValue(10)
    query.exec_()
  

      Здесь мы добавляем в только что созданную таблицу good запись, используя команду INSERT;

• bindValue (<Номер параметра>, <Значение параметра> [, paramType=In]) - задает значение для параметра с указанным порядковым номером:

    query.prepare("insert into good values(null, ?, ?)")
    query.bindValue(0, 'Дискета')
    query.bindValue(1, 10)
    query.exec_()
  

• bindValue (<Обозначение параметра>, <Значение параметра> [, paramType=In]) - задает значение для параметра с указанным символьным обозначением:

    query.prepare("insert into good values(null, :name, :count)")
    query.bindValue(':name', 'Дискета')
    query.bindValue(':count', 10)
    query.exec_()
  

• exec_() - выполняет подготовленный ранее запрос. Возвращает True, если запрос был успешно выполнен, и False - в противном случае;

• execBatch ([mode=ValuesAsRows]) - если в вызове метода addBindValue() или bindValue() в качестве значения параметра был указан список, выполнит подготовленный запрос. Необязательный параметр mode позволяет указать, как будут интерпретироваться отдельные элементы списка. На данный момент в качестве его значения поддерживается лишь атрибут ValuesAsRows класса QSqlQuery, говорящий, что подготовленный запрос должен быть выполнен столько раз, сколько элементов присутствует в списке, при этом на каждом выполнении запроса в его код подставляется очередной элемент списка.

      Метод возвращает True, если запрос был успешно выполнен, и False - в противном случае. Пример:

  .   .   .   .
  # Работаем с базой данных
       if 'good' not in con.tables():
           query = QtSql.QSqlQuery()
           query.exec("create table good (id integer primary key autoincrement, 
                goodname text, goodcount integer)")
       else:
           query = QtSql.QSqlQuery()
           query.prepare("insert into good values(null, :name, :count)")
           lst1 = ['Дискета', 'Бумага для принтера', 'Барабан для принтера']
           lst2 = [10, 3, 8]
           query.bindValue(':name', lst1)
           query.bindValue(':count', lst2)
           query.execBatch()
  .   .   .   .
  

  Архив с полным файлом можно взять здесь.

• setForwardOnly (<Флaг>) - если передано значение True, по результату запроса можно будет перемещаться только "вперед", т. е. от начала к концу. Такой режим выполнения запроса существенно сокращает потребление системных ресурсов. Этот метод должен быть вызван перед выполнением запроса, который возвращает результат. Пример:

    query.prepare("select * from good order by goodname") 
    query.setForwardOnly(True) 
    query.exec_()
  

    На следующем шаге мы рассмотрим обработку результатов выполнения запросов.

Предыдущий шаг Содержание Следующий шаг