Главная » Инструкции » Простые SQL запросы - короткая справка и примеры. Команды SQL-запросов

Простые SQL запросы - короткая справка и примеры. Команды SQL-запросов

Adobe AIR включает компонент SQL Database Engine с поддержкой локальных баз данных SQL и многими стандартными возможностями SQL на основе системы баз данных с открытым кодом. Среда выполнения не определяет способ хранения данных баз данных и их расположение в файловой системе. Каждая база данных целиком хранится в одной файле. Разработчик может указать местоположение в файловой системе для хранения файла базы данных, и отдельное приложение AIR сможет получить доступ к одной или нескольким отдельным базам данных (т.е. отдельным файлам баз данных).

В данном документе описан синтаксис SQL и поддержка типов данных для локальных баз данных SQL Adobe AIR. Этот документ не претендует на роль исчерпывающего справочника по SQL. Наоборот, в нем приводятся конкретные сведения о диалекте SQL, поддерживаемом Adobe AIR. Среда выполнения поддерживает большую часть стандартного диалекта SQL-92. Поскольку существует большое число справочников, веб-узлов, книг и учебных материалов для изучения SQL, данный документ не следует рассматривать, как исчерпывающий справочник по SQL или учебник. Более того, этот документ посвящен, в частности, синтаксису SQL, поддерживаемому Apollo AIR, а также описывает различия между SQL-92 и поддерживаемым диалектом SQL.

Рассматриваются следующие темы:

Поддерживаемый синтаксис SQL

Этот раздел посвящен синтаксису SQL, поддерживаемому компонентом SQL Database Engine Adobe AIR. Приведенный список можно разделить на описания различных инструкций и типов предложений, выражений, встроенных функций и операторов. Рассматриваются следующие темы:

Общий синтаксис SQL

В дополнение к определенному синтаксису для различных инструкций и выражений применяются следующие общие правила синтаксиса SQL:

Инструкции обработки данных

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

SELECT

Инструкция SELECT служит для опроса базы данных. Результатом инструкции SELECT является ноль или несколько строк данных, где у каждой строки имеется фиксированное число столбцов. Число столбцов в результате определяется именем столбца result или списком выражений между SELECT и необязательным ключевым словом FROM .

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

По ключевому слову DISTINCT возвращается подмножество строк результатов с разными строками результатов. Значения NULL не рассматриваются как отличные друг от друга. По умолчанию возвращаются все строки результатов, если явным образом использовать ключевое слово ALL .

Запрос выполняется по одной или нескольким таблицам, указанным после ключевого слова FROM . Если несколько имен таблиц разделены запятыми, запрос использует перекрестное соединение различных таблиц. Синтаксис JOIN можно также использовать для указания способа соединения таблиц. Поддерживаемый тип внешнего соединения — LEFT OUTER JOIN . Выражение предложения ON в join-args должно приводить к логическому значению. Вложенный запрос в скобках можно использовать как таблицу в предложении FROM . Предложение FROM можно полностью опустить, в случае чего результатом будет отдельная строка значений списка выражений result .

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

Предложение GROUP BY приводит к объединению одной или нескольких строк результатов в одну строку результата. Предложение GROUP BY особенно полезно, если результат содержит статические функции. Выражения в предложении GROUP BY не должны быть выражениями из списка выражений SELECT .

Предложение HAVING похоже на WHERE тем, что оно ограничивает строки, возвращаемые инструкцией. При этом предложение HAVING применяется после выполнения любой группировки, заданной предложением GROUP BY . Следовательно, выражение HAVING может относиться к значениям со статическими функциями. Выражение предложения HAVING не обязательно должно присутствовать в списке SELECT . Как и выражение WHERE , выражение HAVING должно приводить к логическому значению.

Предложение ORDER BY вызывает сортировку выходных строк. Аргумент sort-expr-list в предложении ORDER BY представляет собой список выражений, используемых в качестве ключа для списка. Выражения не должны быть частью результата простой инструкции SELECT , но в составной инструкции SELECT (SELECT с использованием одного из операторов compound-op) каждое выражение сортировки должно в точности соответствовать одному из столбцов результатов. После каждого выражения сортировки можно использовать предложение sort-order (необязательно), состоящее из ключевого слова COLLATE и имени функции сортировки, используемое для упорядочивания текста, и/или ключевое слово ASC или DESC для указания порядка сортировки (по возрастанию или убыванию). Предложение sort-order можно опустить и использовать значение по умолчанию (упорядочивание по возрастанию). Определение предложения COLLATE и функций сортировки см. в разделе .

Предложение LIMIT устанавливает верхнюю границу числа строк, возвращаемых в результате. Отрицательное значение LIMIT указывает на отсутствие верхней границы. Необязательный оператор OFFSET после LIMIT указывает количество пропускаемых строк в начале результирующего набора. В составном запросе SELECT предложение LIMIT может только следовать за конечным оператором SELECT , и ограничение применяется к запросу целиком. Обратите внимание, что при использовании в предложении LIMIT ключевого слова OFFSET предельным значением является первое целое число, а смещением — второе целое число. Если вместо ключевого слова OFFSET использовать запятую, то смещением будет первое число, а предельным значением — второе число. Такое внешнее противоречие является намеренным: оно позволяет достичь максимальной совместимости с устаревшими системами баз данных SQL.

Составная инструкция SELECT формируется из одной или нескольких инструкций SELECT , соединенных одним из операторов UNION , UNION ALL , INTERSECT или EXCEPT . В составной инструкции SELECT все входящие в нее инструкции SELECT должны указывать то же число столбцов результатов. После конечной инструкции SELECT может быть только одно предложение ORDER BY (и перед отдельным предложением LIMIT , если оно указано). Операторы UNION и UNION ALL объединяют результаты предшествующих и последующих инструкции SELECT в одну таблицу. Отличие заключается в том, что в UNION различными являются все строки результатов, а в UNION ALL возможны повторения. Оператор INTERSECT принимает пересечение результатов предшествующих и последующих инструкций SELECT . EXCEPT принимает результат предшествующей инструкции SELECT после удаления результатов последующей инструкции SELECT . При соединении трех и более инструкций SELECT для образования составной инструкции, они группируются от первой до последней.

Определение разрешенных выражений см. в разделе

INSERT

Инструкция INSERT имеет две базовых формы и служит для заполнения таблиц данными.

Sql-statement::= INSERT INTO table-name [(column-list)] VALUES (value-list) | INSERT INTO table-name [(column-list)] select-statement REPLACE INTO table-name [(column-list)] VALUES (value-list) | REPLACE INTO table-name [(column-list)] select-statement

Первая форма (с ключевым словом VALUES) создает новую отдельную строку в существующей таблице. Если column-list не указан, то число значений должно соответствовать числу столбцов в таблице. Если column-list указан, то число значений должно соответствовать числу указанных столбцов. Столбцы таблицы, отсутствующие в списке столбцов, заполняются значением по умолчанию, определенным при создании таблицы, или значением NULL , если значение по умолчанию не определено.

Вторая форма INSERT берет свои данные из инструкции SELECT . Число столбцов в результате SELECT должно в точности соответствовать числу столбцов в таблице, если column-list не указан, или должно соответствовать числу столбцов, чьи имена указаны в column-list . Для каждой строки результата SELECT создается новая запись в таблице. Инструкция SELECT может быть простой или составной. Определение допустимых инструкций SELECT см. в разделе .

Две формы инструкции — REPLACE INTO — эквиваленты использованию стандартной инструкции INSERT с алгоритмом конфликтов REPLACE (т.е., форма INSERT OR REPLACE...).

UPDATE

Инструкция UPDATE служит для изменения значения столбцов в наборе строк в таблице.

Sql-statement::= UPDATE table-name SET assignment [, assignment]* conflict-algorithm::= ROLLBACK | ABORT | FAIL | IGNORE | REPLACE assignment::= column-name = expr

Каждое назначение в инструкции UPDATE указывает имя столбца слева от знака равенства (=) и произвольное выражение справа. В выражении можно использовать значения других столбцов. Перед любым назначением все выражения вычисляются. Определение разрешенных выражений см. в разделе

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

Необязательный conflict-algorithm позволяет указывать альтернативный алгоритм разрешения конфликтов ограничений во время этой команды. Определение и описание алгоритмов конфликтов см. в разделе .

DELETE

Команда удаления служит для удаления записей из таблицы.

Sql-statement::= DELETE FROM table-name

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

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

Инструкции определения данных

Инструкции определения данных служат для создания, изменения и удаления объектов баз данных, таких как таблицы, представления индексы и триггеры. Поддерживаются следующие инструкции определения данных:

CREATE TABLE

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

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

Ограничение столбца NOT NULL указывает, что в столбце не могут содержаться значения NULL .

Ограничение UNIQUE вызывает создание индекса для заданного столбца или столбцов. Этот индекс должен содержать уникальные ключи — две строки не могут содержать одинаковые значения или сочетания значений для заданного столбца или столбцов. Инструкция CREATE TABLE может иметь несколько ограничений UNIQUE , в том числе несколько столбцов с ограничением UNIQUE в определении столбца и/или несколько ограничений UNIQUE уровня таблицы.

Ограничение CHECK определяет вычисляемое выражение и должно быть истинным (true) для вставки или обновления данных строки. Выражение CHECK должно приводить к логическому значению.

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

Ограничение DEFAULT задает значение по умолчанию, используемое при выполнении INSERT . Значение может быть NULL , строковой константой или числом. Значение по умолчанию может также быть специальным независимым от регистра ключевым словом CURRENT_TIME , CURRENT_DATE или CURRENT_TIMESTAMP . Если значение равно NULL , является строковой константой или числом, оно буквально вставляется в столбец, если значение для столбца не задано инструкцией INSERT . Если используется значение CURRENT_TIME , CURRENT_DATE или CURRENT_TIMESTAMP , в столбец вставляется текущая дата и/или время в формате UTC. Для CURRENT_TIME задается формат HH:MM:SS . Для CURRENT_DATE форматом является YYYY-MM-DD . Формат для CURRENT_TIMESTAMP — YYYY-MM-DD HH:MM:SS .

Указание PRIMARY KEY обычно создает индекс UNIQUE для соответствующего столбца или столбцов. При этом если ограничение PRIMARY KEY действует для отдельного столбца с типом данных INTEGER , то столбец используется внутренне в качестве фактического первичного ключа для таблицы. Это означает, что в столбце могут содержаться только уникальные целочисленные значения. Если в таблице отсутствует столбец INTEGER PRIMARY KEY , ключ целых значений будет автоматически создан при вставке строки. Доступ к первичному ключу строки можно всегда получить при помощи одного из специальных имен ROWID , OID или _ROWID_ . Эти имена можно использовать независимо от того, явно объявленный INTEGER PRIMARY KEY это ключ или внутреннее созданное значение. Столбец INTEGER PRIMARY KEY может также включать ключевое слово AUTOINCREMENT . Когда используется ключевое слово AUTOINCREMENT , база данных автоматически создает и вставляет последовательно увеличивающийся ключ целых значений в столбец INTEGER PRIMARY KEY при выполнении инструкции INSERT .

В инструкции CREATE TABLE может быть только одно ограничение PRIMARY KEY . Оно может быть частью определения одного столбца или одного отдельного ограничения PRIMARY KEY уровня таблицы. Столбец первичного ключа неявно NOT NULL .

Необязательный conflict-clause после многих ограничений позволяет указывать альтернативный алгоритм разрешения конфликтов ограничений по умолчанию для такого ограничения. По умолчанию это ABORT . Для различных ограничений в одной и той же таблице возможны разные алгоритмы разрешения конфликтов по умолчанию. Если инструкция INSERT или UPDATE задает другой алгоритм разрешения конфликтов, то он используется вместо алгоритма, указанного в инструкции CREATE TABLE. Дополнительные сведения см. в разделе .

Дополнительные ограничения, такие как FOREIGN KEY, не приводят к ошибке, но среда выполнения пропускает их.

Если ключевое слово TEMP или TEMPORARY стоит между CREATE и TABLE , то создаваемая таблица будет видимой только в рамках одного и того же подключения к базе данных (экземпляр SQLConnection). При закрытии подключения она автоматически удаляется. Любые индексы, созданные во временной таблице, также являются временными. Временные таблицы и индексы хранятся в отдельном файле, отличным от основного файла базы данных.

Если указан необязательный префикс database-name , то таблица создается в именованной базе данных (базе данных, подключенной к экземпляру SQLConnection путем вызова метода attach() с заданным именем базы данных). Ошибочным будет указание префикса database-name и ключевого слова TEMP , если префикс database-name не является temp . Если имя базы данных не указано, а ключевое слово TEMP присутствует, то таблица создается в основной базе данных (базе данных, подключенной к экземпляру SQLConnection при помощи метода open() или openAsync()).

Не существует произвольных пределов на число столбцов или ограничений в таблице. Также отсутствует произвольный предел на объем данных в строке.

Форма CREATE TABLE AS определяет таблицу как результирующий набор запроса. Имена столбцов таблицы — это имена столбцов в результате.

Если присутствует необязательное предложение IF NOT EXISTS и другая таблица с тем же именем уже существует, то база данных пропускает команду CREATE TABLE .

Таблицу можно удалить при помощи инструкции DROP TABLE , а при помощи инструкции ALTER TABLE можно внести ограниченные изменения.

ALTER TABLE

Команда ALTER TABLE позволяет пользователю переименовать столбец или добавить новый столбец в существующую таблицу. Столбец невозможно удалить из таблицы.

Sql-statement::= ALTER TABLE table-name alteration alteration::= RENAME TO new-table-name alteration::= ADD column-def

Синтаксис RENAME TO используется для переименования таблицы, определенной table-name , в new-table-name . Эту команда нельзя использовать для переноса таблицы между присоединенными базами данных — она служит только для переименования таблицы в одной базе данных.

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

Синтаксис ADD используется для добавления нового столбца в существующую таблицу. Новый столбец всегда добавляется в конец списка существующих столбцов. Предложение column-def может принимать любые формы, допустимые в инструкции CREATE TABLE , со следующими ограничениями:

Столбец не может иметь ограничения PRIMARY KEY или UNIQUE .
Столбец не может иметь значения по умолчанию CURRENT_TIME , CURRENT_DATE или CURRENT_TIMESTAMP .
Если указано ограничение NOT NULL , столбец должен иметь значение по умолчанию, отличное от NULL .

Объем данных в таблице не влияет на время выполнения инструкции ALTER TABLE .

DROP TABLE

Инструкция DROP TABLE удаляет таблицу, добавленную с помощью инструкции CREATE TABLE . Таблица с указанным table-name — это удаленная таблица. Она полностью удаляется из базы данных и с диска. Восстановить таблицу невозможно. Все связанные с таблицей индексы также удаляются.

Sql-statement::= DROP TABLE table-name

По умолчанию инструкция DROP TABLE не уменьшает размер файла базы данных. Пустой пространство в базе данных сохраняется и используется в последующих операциях INSERT . Для удаления пустого пространства в базе данных служит метод SQLConnection.clean() . Если параметру autoClean присвоено значение true при первоначальном создании базы данных, пространство высвобождается автоматически.

Необязательное предложение IF EXISTS подавляет ошибку, которая обычно возникает, если таблица не существует.

CREATE INDEX

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

Sql-statement::= CREATE INDEX index-name ON table-name (column-name [, column-name]*) column-name::= name

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

Предложение COLLATE после каждого имени столбца определяет параметры сортировки, применяемые к текстовым значениям в этом столбце. Параметры сортировки по умолчанию — это параметры сортировки, определенные для такого столбца в инструкции CREATE TABLE . Если параметры сортировки не заданы, используются параметры сортировки BINARY . Определение предложения COLLATE и функций сортировки см. в разделе .

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

DROP INDEX

Инструкция удаления индекса позволяет удалить индекс, добавленный с помощью инструкции CREATE INDEX . Указанный индекс полностью удаляется из файла базы данных. Единственным способом восстановления индекса является повторный ввод команды CREATE INDEX .

Sql-statement::= DROP INDEX index-name

По умолчанию инструкция DROP INDEX не уменьшает размер файла базы данных. Пустой пространство в базе данных сохраняется и используется в последующих операциях INSERT . Для удаления пустого пространства в базе данных служит метод SQLConnection.clean() . Если параметру autoClean присвоено значение true при первоначальном создании базы данных, пространство высвобождается автоматически.

CREATE VIEW

Команда CREATE VIEW служит для назначения имени предопределенной инструкции SELECT . Затем это имя можно использовать в предложении FROM другой инструкции SELECT вместо имени таблицы. Представления, как правило, служат для упрощения запросов путем объединения сложного (или часто используемого) набора данных в структуру, которую можно использовать в других операциях.

Sql-statement::= CREATE VIEW view-name AS select-statement

Если ключевое слово TEMP или TEMPORARY стоит между CREATE и VIEW , то создаваемое представление будет видимым только экземпляру SQLConnection, который открыл базу данных, и будет удалено при закрытии базы данных.

Если указан , то представление создается в именованной базе данных (базе данных, подключенной к экземпляру SQLConnection при помощи метода attach() с указанным аргументом name). Ошибочным будет указание и ключевого слова TEMP , если не является temp . Если имя базы данных не указано, а ключевое слово TEMP присутствует, то представление создается в основной базе данных (базе данных, подключенной к экземпляру SQLConnection при помощи метода open() или openAsync()).

Представления доступны только для чтения. Инструкцию DELETE , INSERT или UPDATE нельзя использовать с представлением, если не определен, по меньшей мере, один триггер связанного типа (INSTEAD OF DELETE , INSTEAD OF INSERT , INSTEAD OF UPDATE). Дополнительные сведения о создании триггера для представления см. в разделе .

Для удаления представления из базы данных служит инструкция DROP VIEW .

DROP VIEW

Инструкция DROP VIEW удаляет представление, созданное с помощью инструкции CREATE VIEW .

Sql-statement::= DROP VIEW view-name

Указанный view-name является именем удаляемого представления. Представление удаляется из базы данных, но данные в базовых таблицах не изменяются.

CREATE TRIGGER

Инструкция создания триггера служит для добавления триггеров к схеме базы данных. Триггер — это операция базы данных (trigger-action), выполняемая автоматически при возникновении заданного события базы данных (database-event).

Sql-statement::= CREATE TRIGGER trigger-name database-event ON table-name trigger-action sql-statement::= CREATE TRIGGER trigger-name INSTEAD OF database-event ON view-name trigger-action database-event::= DELETE | INSERT | UPDATE | UPDATE OF column-list trigger-action::= BEGIN trigger-step ; [ trigger-step ; ]* END trigger-step::= update-statement | insert-statement | delete-statement | select-statement column-list::= column-name [, column-name]*

Триггер задается для запуска при возникновении события DELETE , INSERT или UPDATE определенной таблицы базы данных, или при обновлении одного или нескольких заданных столбцов таблицы при помощи инструкции UPDATE . Триггеры являются постоянными, если не используется ключевое слово TEMP или TEMPORARY . В таком случае триггер удаляется при закрытии подключения к основной базе данных экземпляра SQLConnection. Если время не указано (BEFORE или AFTER), триггер по умолчанию имеет значение BEFORE .

Поддерживаются только триггеры FOR EACH ROW , поэтому текст FOR EACH ROW является необязательным. С триггером FOR EACH ROW инструкции trigger-step выполняются для каждой вставляемой, обновляемой или удаляемой при помощи инструкции строки базы данных, вызывая запуск триггера, если выражение предложения WHEN получает значение true .

При указании предложения WHEN , инструкции SQL, указанные в качестве шагов триггера, выполняются только для строк, для которых предложение WHEN является истинным (true). Если предложение WHEN не указано, инструкции SQL выполняются для всех строк.

В теле триггера (предложение trigger-action) значения до изменения и после изменения затронутой таблицы доступны при помощи специальных имен таблиц OLD и NEW . Структура таблиц OLD и NEW соответствует структуре таблицы, для которой создается триггер. Таблица OLD содержит любые строки, измененные или удаленные инструкцией триггера, и их состояние до операций инструкции триггера. Таблица NEW содержит любые строки, измененные или созданные инструкцией триггера, и их состояние после операций инструкции триггера. Как предложение WHEN , так и инструкции trigger-step могут обращаться к значениям из вставляемых, удаляемых или обновляемых строк посредством ссылок вида NEW.column-name и OLD.column-name , где column-name — имя столбца из таблицы, с которой связан триггер. Доступность ссылок на таблицы OLD и NEW зависит от типа database-event , обрабатываемого триггером:

Указанное время (BEFORE , AFTER или INSTEAD OF) определяет время выполнения инструкций trigger-step относительно вставке, изменению или удалению связанной строки. Предложение ON CONFLICT может быть указано в составе инструкции UPDATE или INSERT в trigger-step . При этом если предложение ON CONFLICT указано в составе инструкции, вызывающей запуск триггера, то вместо этого используется политика разрешения конфликтов.

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

При создании триггера в таблице со столбцом INTEGER PRIMARY KEY важно помнить об одном. Если триггер BEFORE изменяет столбец INTEGER PRIMARY KEY строки, которая подлежит обновлению инструкцией, вызывающей запуск триггера, обновление не происходит. Выходом может быть создание таблицы со столбцом PRIMARY KEY вместо столбца INTEGER PRIMARY KEY .

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

Функция RAISE()

В инструкции trigger-step триггера можно использовать специальную функцию SQL RAISE() . Эта функция имеет следующий синтаксис:

Raise-function::= RAISE (ABORT, error-message) | RAISE (FAIL, error-message) | RAISE (ROLLBACK, error-message) | RAISE (IGNORE)

Одна из трех форм вызывается во время выполнения триггера, выполняется указанное действие обработки ON CONFLICT (ABORT , FAIL или ROLLBACK) и выполнение текущей инструкции прекращается. ROLLBACK считается ошибкой выполнения инструкции, поэтому экземпляр SQLStatement, чей метод execute() выполнялся, выдает событие error (SQLErrorEvent.ERROR). Объект SQLError в свойстве error выданного события объекта имеет свойство details со значением error-message , заданным в функции RAISE() .

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

DROP TRIGGER

Инструкция DROP TRIGGER удаляет триггер, созданный с помощью инструкции CREATE TRIGGER .

Sql-statement::= DROP TRIGGER trigger-name

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

Специальные инструкции и предложения

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

COLLATE

Предложение COLLATE используется в инструкциях SELECT , CREATE TABLE и CREATE INDEX для указания алгоритма сравнения, используемого при сравнении или сортировке значений.

Sql-statement::= COLLATE collation-name collation-name::= BINARY | NOCASE

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

Параметры сортировки NOCASE применяются только к значениями класса хранения TEXT . При использовании сортировка NOCASE выполняет независимое от регистра сравнение.

Параметры сортировки не используются для классов хранения типа NULL , BLOB , INTEGER или REAL .

Чтобы использовать тип сортировки, отличный от BINARY со столбцом, в составе определения столбца в инструкции CREATE TABLE необходимо указать предложение COLLATE . Каждый раз при сравнении двух значений TEXT , параметры сортировки используются для определения результатов сравнения по следующим правилам:

В случае с операторами двоичного сравнения (= , < , > , =) если один из операндов является столбцом, то тип сортировки столбца по умолчанию определяет параметры сортировки, используемые для сравнения. Если оба операнда являются столбцами, то тип сортировки для левого операнда определяет используемые параметры сортировки. Если ни один из операндов не является столбцом, то используют параметры сортировки BINARY .
Оператор BETWEEN...AND эквивалентен использованию двух выражений с операторами >= и = y AND x

Просмотров