Указывает, было ли включено автоматическое сжатие при создании текущей базы данных (значение параметра autoCompact, указанное при вызове метода open() или openAsync(), с помощью которого была создана база данных). Если это свойство имеет значение true, неиспользуемое место автоматически удаляется из базы данных после каждой операции записи, тем самым уменьшая размер файла базы данных. Если это свойство имеет значение false, место, занимаемое данными до удаления, остается в базе данных и при необходимости используется повторно. Даже если свойство autoCompact имеет значение false, с помощью метода compact() можно выполнить принудительное восстановление неиспользуемого места.

Если свойство connected имеет значение false, это свойство имеет значение false.

См. также

Обеспечивает доступ к величине размера кэша данного подключения. Эта величина — максимальное количество дисковых страниц базы данных, которые могут одновременно находиться в памяти. Каждая страница использует около 1,5 КБ памяти (в зависимости от значения параметра pageSize, указанного при вызове метода open() или openAsync(), с помощью которого была создана база данных). Размер кэша по умолчанию равен 2000. Если в приложении выполняются операции UPDATE или DELETE, которые изменяют большое количество строк в базе данных, увеличив размер кэша, можно ускорить работу за счет повышенного потребления памяти.

См. также

Указывает, в каком виде имена столбцов представлены в результате выполнения инструкции SELECT.

Константы, определенные в классе SQLColumnNameStyle, представляют собой возможные значения данного свойства:

• SQLColumnNameStyle.LONG обозначает, что имена столбцов возвращаются в формате [table-name]_[column-name].
• SQLColumnNameStyle.SHORT обозначает, что имена столбцов имеют формат [column-name]. Если существует несколько столбцов с одинаковым именем, в результирующий объект будет добавлено только одно свойство с таким именем.
• SQLColumnNameStyle.DEFAULT является значением по умолчанию. Если используется это значение, то имена столбцов в результате форматируются в соответствии с количеством таблиц в инструкции SELECT, в которых есть столбцы с одинаковыми именами. Если в инструкции SELECT содержится только одна таблица, используется краткий формат имен [column-name]. Если в инструкции SELECT содержится несколько таблиц, соединенных вместе, всякий раз, когда из-за двух столбцов с одинаковым именем возникает конфликт имен, для них используется длинный формат имен [table-name]_[column-name].

См. также

Указывает, имеет ли экземпляр SQLConnection открытое подключение к файлу базы данных.

См. также

Указывает, используется ли это подключение транзакциями в данный момент.

См. также

Последний идентификатор строки, созданный инструкцией SQL INSERT. Уникальный идентификатор строки в таблице, используемый для поиска в базе данных. Это значение часто генерируется базой данных.

Значение равно нулю, если ни одна база данных не подключена или не выполнено ни одной инструкции INSERT.

Идентификатор строки для однократного выполнения инструкции SQL INSERT можно получить через свойство lastInsertRowID объекта SQLResult, возвращенного методом getResult() объекта SQLStatement (когда он вызывается после отправки объектом SQLStatement события result).

Дополнительные сведения о первичных ключах и генерируемых идентификаторах строк см. в разделах "CREATE TABLE" и "Выражения" приложения "Поддержка SQL в локальных базах данных".

См. также

Указывает размер страницы базы данных (в байтах), заданный при создании текущей базы данных (значение параметра pageSize, указанное при вызове метода open() или openAsync(), с помощью которого была создана база данных).

Если свойство connected имеет значение false, это значение данного свойства равно 0.

Размер страницы базы данных можно менять (с помощью методов open() или openAsync()), пока в базе данных не будет создана первая таблица.

См. также

Содержит общее число изменений данных, выполненных с момента открытия подключения к базе данных. Кроме отслеживания изменений, сделанных с помощью инструкций INSERT, DELETE и UPDATE, это значение включает изменения, вызванные триггерами.

При закрытии подключения к базе данных это значение сбрасывается в 0. Когда экземпляр SQLConnection не подключен к файлу базы данных, значение равно 0.

См. также

Создает экземпляр SQLConnection.

Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях. Регистрировать прослушиватели событий можно во всех узлах списка отображения для определенного типа события, фазы и приоритета.

После успешной регистрации прослушивателя событий нельзя изменить его приоритет путем дополнительных вызовов метода addEventListener(). Чтобы изменить приоритет прослушивателя, необходимо сначала вызвать метод removeListener(). Затем можно зарегистрировать прослушиватель еще раз с новым уровнем приоритета.

Следует учесть, что после регистрации прослушивателя последующие вызовы метода addEventListener() с другим значением свойства type или useCapture приводят к регистрации другого прослушивателя. Например, если сначала был зарегистрирован прослушиватель со свойством useCapture в значении true, он прослушивает события только в фазе захвата. Если вызвать метод addEventListener() еще раз с тем же объектом прослушивателя, но со свойством useCapture в значении false, то будет два прослушивателя: один — прослушивающий в фазе захвата, а другой — в фазах назначения и восходящей цепочки.

Нельзя зарегистрировать прослушиватель событий только для фазы цели или только для фазы пузырей. Эти фазы объединяются при регистрации, так как фаза пузырей применяется только к предкам целевого узла.

Если прослушиватель событий больше не нужен, его можно удалить, вызвав метод removeEventListener(); иначе могут возникнуть проблемы с памятью. Объекты с зарегистрированным прослушивателями событий не очищаются из памяти автоматически, так как сборщик мусора не удаляет объекты, на которые есть ссылки.

Копирование экземпляра EventDispatcher не приведет к копированию всех присоединенных к нему прослушивателей событий. (Если для вновь созданного узла требуется прослушиватель событий, его необходимо добавить после создания узла.) Однако если экземпляр EventDispatcher перемещается, все зарегистрированные для него прослушиватели событий перемещаются вместе с ним.

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

Если прослушиватель событий удаляется из узла в момент обработки события, он все равно запускается текущими действиями. После удаления прослушиватель событий больше не вызывается (если не будет снова зарегистрирован для дальнейшей обработки).

Параметры

Собирает статистику об индексах базы данных и сохраняет ее в базе данных. Статистика может использоваться оптимизатором запросов (той частью ядра СУБД, которая определяет самый эффективный способ выполнения каждой инструкции). Статистика помогает оптимизатору запросов лучшим образом выбрать один или несколько индексов при выполнении определенного запроса.

Если в базе данных определены индексы, но метод analyze() не вызван, среда выполнения все равно будет использовать их при выполнении инструкции. Но без дополнительных статистических данных, которые формируются с помощью метода analyze(), среда выполнения может выбрать не самый эффективный индекс для определенного запроса.

При изменении данных таблицы (в результате выполнения инструкций INSERT, UPDATE или DELETE) изменяются также и индексы, связанные с этой таблицей. Статистические данные, которые формируются с помощью метода analyze(), не обновляются автоматически. Следовательно, после большого числа изменений данных может быть полезным повторный вызов метода analyze(). Однако польза, полученная от вызова метода analyze(), зависит от нескольких факторов, включая число индексов в таблице, соотношение числа измененных строк и общего числа строк в таблице, степень изменения проиндексированных данных таблицы и того, насколько измененные данные отличаются от ранее измененных данных.

Параметр resourceName указывает, выполняется ли операция для индексов всех подключенных баз данных, определенной базы данных или определенной таблицы.

Каждый раз при вызове данного метода все ранее созданные статистические данные стираются и повторно создаются для базы данных или таблицы, указанной в параметре resourceName (или для всех таблиц всех подключенных баз данных, если параметр resourceName имеет значение null). Этот метод можно вызывать в любое время, пока открыто подключение базы данных. Операция analyze() и ее статистические данные не включаются в транзакцию. Несмотря на это, не рекомендуется вызывать метод analyze(), если в данный момент в базе данных открыта транзакция (свойство inTransaction имеет значение true). Это связано с тем, что при вызове метода analyze() не учитываются любые изменения данных, схем таблиц или индексов, которые были выполнены в транзакции, но еще не были зафиксированы, следовательно, на момент фиксации транзакции данные метода analyze() будут устаревшими.

Для удаления статистических данных, созданных с помощью метода analyze(), используется метод deanalyze().

Параметры

См. также

Добавляет новую базу данных в экземпляр SQLConnection, присваивая ей заданное имя. Подключение базы данных позволяет использовать ее в инструкциях SQL, выполняемых применительно к экземпляру SQLConnection.

Если база данных уже подключена с использованием заданного имени, вызов метода attach() приведет к отправке события error. Тем не менее, одну и ту же базу данных можно подключить несколько раз, используя уникальные имена. К одному экземпляру SQLConnection можно подключить не более 10 баз данных.

Любая инструкция SQL может быть выполнена применительно к базе данных, подключенной с помощью метода attach(). Этот метод вызывается для главной базы данных (базы данных, которая подключена с помощью метода open() или openAsync()). Инструкция SQL может обращаться к таблицам в любых базах данных, которые подключены к экземпляру SQLConnection, связанному с данной инструкцией. Также возможно обращение одной инструкции к таблицам из нескольких баз данных. Когда среда выполнения анализирует имена таблиц в инструкции, она осуществляет поиск по базам данных экземпляра SQLConnection в порядке их подключения, начиная с базы данных, которая была подключена с помощью метода open() или openAsync(). Чтобы в явном виде указать имя таблицы, в инструкции нужно использовать имя базы данных (как указано в передаваемом в метод attach() параметре name).

Для удаления базы данных, подключенной с помощью метода attach(), используется метод detach(). При закрытии экземпляра SQLConnection (с помощью метода close()) все подключенные базы данных отсоединяются.

Подключенная база данных использует тот же режим выполнения (синхронный или асинхронный), что и главная, в зависимости от метода, с помощью которого была подключена главная база данных open() или openAsync().

Параметры

См. также

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

По умолчанию каждая инструкция SQL выполняется в рамках своей транзакции, которая завершается после успешного выполнения или сбоя инструкции. При создании транзакции с помощью метода begin() создается новая ручная транзакция. После этого все инструкции SQL, выполненные применительно к экземпляру SQLConnection, находятся внутри транзакции, поэтому все действия и изменения, которые ими выполнены, можно зафиксировать (сделать постоянными) или откатить (отменить) не по одному, а только все одновременно.

Вложенные транзакции запрещены (вложенные вызовы метода begin() игнорируются). Для завершения транзакции используется метод commit() или rollback() в зависимости от того, что необходимо сделать с изменениями, сделанными инструкциями из транзакции: сделать их постоянными или отменить.

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

Параметры

См. также

Прерывает все инструкции SQL, выполняемые в текущий момент в базах данных, подключенных к данному экземпляру SQLConnection. Этот метод используется для завершения продолжительных или вышедших из-под контроля запросов.

Если в момент вызова метода cancel() выполняются инструкции, этот метод прерывает их выполнение и выполняет откат всех незавершенных обновлений или транзакций. Если в текущий момент нет выполняемых инструкций, этот метод выполняет откат открытой транзакции, в противном случае ничего не происходит.

Параметры

См. также

Закрывает текущее подключение базы данных. Также происходит отсоединение всех подключенных баз данных.

Если во время вызова метода close() есть открытая транзакция, она фиксируется. При очистке экземпляра SQLConnection среда выполнения автоматически вызывает метод close(), включая те случаи, когда приложение AIR закрыто, а экземпляр SQLConnection по-прежнему подключен к базе данных.

Параметры

Фиксирует существующую транзакцию, в результате чего все действия, выполненные ее инструкциями, применяются к базе данных окончательно.

Параметры

См. также

Освобождает все неиспользуемое место в базе данных. После удаления объекта (таблицы, индекса или триггера) из базы данных остается пустое место. Из-за этого файл базы данных становится больше, чем необходимо, но операции INSERT выполняются быстрее. Со временем из-за операций INSERT и DELETE структура файла базы данных становится фрагментированной, из-за чего замедляется доступ к содержимому базы данных. Данный метод сжимает файл базы данных, уничтожая пустые страницы и располагая данные таблиц без разрывов, а в противном случае — очищает структуру файла базы данных.

Операцию compact() нельзя выполнить применительно к файлу подключенной базы данных, а только к файлу главной (исходной) базы данных, который открыт с помощью экземпляра SQLConnection. Эта операция завершается сбоем, если есть активная транзакция, и не выполняет никаких действий применительно к базе данных, которая хранится в оперативной памяти.

Параметры

Удаляет все статистические данные, созданные методом analyze().

Так как статистика, создаваемая методом analyze(), занимает место в базе данных, с помощью вызова метода deanalyze() можно его освободить, например после удаления некоторых индексов или таблиц.

Данная операция не включена в активную транзакцию.

Параметры

См. также

Отсоединяет дополнительную базу данных, ранее подключенную к экземпляру SQLConnection с помощью метода attach(). Один и тот же файл базы данных может быть подключен несколько раз под разными именами, поэтому, если отсоединить одно подключение, остальные продолжат работать. Базу данных нельзя отсоединить, если в ней открыта транзакция (если свойство inTransaction имеет значение true).

Параметры

См. также

Обеспечивает доступ к результату вызова метода loadSchema(). Метод getSchemaResult() работает как очередь результатов с порядком доступа к элементам "первым поступил — первым обслужен" (FIFO, First In — First Out). Каждый раз после завершения вызова метода loadSchema() (каждый раз, когда в асинхронном режиме выполнения отправляется событие schema) в очередь добавляется новый объект SQLSchemaResult. Каждый раз при вызове метода getSchemaResult() возвращается и удаляется из очереди самый первый результат (тот, который был добавлен в очередь первым). Если в очереди не осталось объектов, метод getSchemaResult() возвращает null.

Если подключение базы данных закрыто, метод возвращает null.

См. также

Загружает сведения о схеме данных из присоединенной или любой подключенной базы данных. Схема данных отражает структуру таблиц, столбцов, индексов и триггеров базы данных.

Для обращения к загруженной схеме данных используется метод SQLConnection.getSchemaResult().

В асинхронном режиме выполнения событие schema отправляется в случае успешного завершения операции. В случае сбоя операции отправляется событие error.

Сочетание значений параметров type и name определяет тип данных схемы, создаваемой с помощью метода loadSchema(), а следовательно, и значения свойств создаваемого экземпляра SQLSchemaResult. В нижеприведенной таблице перечислены допустимые пары аргументов type и name и формируемые в результате данные схемы:

Если сочетание аргументов type и name не соответствует ни одному из перечисленных, в асинхронном режиме выполнения отправляется событие error, а в синхронном — генерируется исключение. Например, если аргумент type имеет значение SQLViewSchema, а аргумент name содержит имя таблицы (вместо имени представления), возникнет ошибка, указывающая на отсутствие в базе данных объекта указанного типа с заданным именем.

Параметры

См. также

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

Операции создания и открытия базы данных, а также все остальные операции, выполняемые с использованием данного экземпляра SQLConnection, выполняются синхронно при открытии базы данных с помощью этого метода. Это включает в себя выполнение инструкций и другие операции, выполняемые экземпляром SQLStatement, связанным с данным экземпляром SQLConnection. Для асинхронного выполнения операций вместо него подключение базы данных следует открывать с помощью метода openAsync().

Базе данных, присоединенной с помощью метода open(), автоматически назначается имя main, которое можно использовать для явного указания имен таблиц в инструкциях SQL в формате [database-name].[table-name].

Параметры

См. также

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

Операции создания и открытия базы данных, а также все остальные операции, выполняемые с использованием данного экземпляра SQLConnection, выполняются асинхронно при открытии базы данных с помощью этого метода. Это включает в себя выполнение инструкций и другие операции, выполняемые экземпляром SQLStatement, связанным с данным экземпляром SQLConnection. Для синхронного выполнения операций вместо него подключение базы данных следует открывать с помощью метода open().

Базе данных, присоединенной с помощью метода openAsync(), автоматически назначается имя main, которое можно использовать для явного указания имен таблиц в инструкциях SQL в формате [database-name].[table-name].

Параметры

См. также

Удаляет прослушиватель из объекта EventDispatcher. Если для объекта EventDispatcher нет зарегистрированного прослушивателя, то вызов этого метода игнорируется.

Параметры

Выполняет откат существующей транзакции, созданной с помощью метода begin(), то есть все изменения, внесенные любыми инструкциями SQL в рамках данной транзакции, отменяются.

Параметры

См. также

Отправляется при успешном завершении операции analyze().

См. также

Отправляется при успешном вызове метода attach().

См. также

Отправляется при успешном вызове метода begin().

См. также

Отправляется при успешном вызове метода cancel().

См. также

Отправляется при успешном вызове метода close().

См. также

Отправляется при успешном вызове метода commit().

См. также

Отправляется при успешном вызове метода compact().

См. также

Отправляется при успешном вызове метода deanalyze().

См. также

Отправляется при изменении данных в любой таблице любой подключенной базы данных в результате выполнения команды SQL DELETE. Данные могут измениться непосредственно в результате выполнения инструкции DELETE с помощью экземпляра SQLStatement или косвенно, в результате запуска триггера в ответ на выполнение инструкции.

См. также

Отправляется при успешном вызове метода detach().

См. также

Отправляется, если любая из асинхронных операций объекта SQLConnection вызывает ошибку. Экземпляр события SQLErrorEvent, которое отправляется в том случае, если свойство error объекта события содержит сведения об операции, при выполнении которой возникла ошибка.

Отправляется при изменении данных в любой таблице любой подключенной базы данных в результате выполнения команды SQL INSERT. Данные могут измениться непосредственно в результате выполнения инструкции INSERT с помощью экземпляра SQLStatement или косвенно, в результате запуска триггера в ответ на выполнение инструкции.

См. также

Отправляется при успешном вызове метода openAsync().

См. также

Отправляется при успешном вызове метода rollback().

См. также

Отправляется при успешном вызове метода loadSchema() и готовности результатов схемы.

См. также

Отправляется при изменении данных в любой таблице любой подключенной базы данных в результате выполнения команды SQL UPDATE. Данные могут измениться непосредственно в результате выполнения инструкции UPDATE с помощью экземпляра SQLStatement или косвенно, в результате запуска триггера в ответ на выполнение инструкции.

Объект события update имеет следующие свойства.

См. также