Главная
Безопасность компьютера
Примеры SQL-запросов в MariaDB (MySQL). Простые SQL запросы - короткая справка и примеры

Примеры SQL-запросов в MariaDB (MySQL). Простые SQL запросы - короткая справка и примеры

29.07.2019

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

Все эти функции возвращают единственное значение. При этом функции COUNT, MIN и MAX применимы к любым типам данных, в то время как SUM и AVG используются только для числовых полей. Разница между функцией COUNT(*) и COUNT(<имя поля>) состоит в том, что вторая при подсчете не учитывает NULL-значения.

Пример. Найти минимальную и максимальную цену на персональные компьютеры:

Пример. Найти имеющееся в наличии количество компьютеров, выпущенных производителем А:

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

Пример. Найти количество имеющихся различных моделей, выпускаемых производителем А. Запрос похож на предыдущий, в котором требовалось определить общее число моделей, выпускаемых производителем А. Здесь же требуется найти число различных моделей в таблице PC (т.е. имеющихся в продаже).

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

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

Предложение GROUP BY

Предложение GROUP BY используется для определения групп выходных строк, к которым могут применяться агрегатные функции (COUNT, MIN, MAX, AVG и SUM) . Если это предложение отсутствует, и используются агрегатные функции, то все столбцы с именами, упомянутыми в SELECT , должны быть включены в агрегатные функции , и эти функции будут применяться ко всему набору строк, которые удовлетворяют предикату запроса. В противном случае все столбцы списка SELECT, не вошедшие в агрегатные функции, должны быть указаны в предложении GROUP BY . В результате чего все выходные строки запроса разбиваются на группы, характеризуемые одинаковыми комбинациями значений в этих столбцах. После этого к каждой группе будут применены агрегатные функции. Следует иметь в виду, что для GROUP BY все значения NULL трактуются как равные, т.е. при группировке по полю, содержащему NULL-значения, все такие строки попадут в одну группу.
Если при наличии предложения GROUP BY , в предложении SELECT отсутствуют агрегатные функции , то запрос просто вернет по одной строке из каждой группы. Эту возможность, наряду с ключевым словом DISTINCT, можно использовать для исключения дубликатов строк в результирующем наборе.
Рассмотрим простой пример:

SELECT model, COUNT(model) AS Qty_model, AVG(price) AS Avg_price
FROM PC
GROUP BY model;

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

model	Qty_model	Avg_price
1121	3	850.0
1232	4	425.0
1233	3	843.33333333333337
1260	1	350.0

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

Существует несколько определенных правил выполнения агрегатных функций :

Если в результате выполнения запроса не получено ни одной строки (или не одной строки для данной группы), то исходные данные для вычисления любой из агрегатных функций отсутствуют. В этом случае результатом выполнения функций COUNT будет нуль, а результатом всех других функций - NULL.
Аргумент агрегатной функции не может сам содержать агрегатные функции (функция от функции). Т.е. в одном запросе нельзя, скажем, получить максимум средних значений.
Результат выполнения функции COUNT есть целое число (INTEGER). Другие агрегатные функции наследуют типы данных обрабатываемых значений.
Если при выполнении функции SUM был получен результат, превышающий максимальное значение используемого типа данных, возникает ошибка .

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

Предложение HAVING

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

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

Именно поэтому мы подготовили краткий экскурс по основам SQL. Начнем же!

1. Создание таблицы

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

Создадим простую таблицу по имени month . Она состоит из 3 колонок:

id – Номер месяца в календарном году (целое число).
name – Название месяца (строка, максимум 10 символов).
days – Количество дней в этом месяце (целое число).

Вот как будет выглядеть соответствующий SQL запрос:

CREATE TABLE months (id int, name varchar(10), days int);

Также при создании таблиц целесообразно добавить первичный ключ для одной из колонок. Это позволит держать записи уникальными и ускорит запросы на выборку. Пусть в нашем случае уникальным будет название месяца (столбец name )

CREATE TABLE months (id int, name varchar(10), days int, PRIMARY KEY (name));

Дата и время

Тип данных	Описание
DATE	Значения даты
DATETIME	Значения даты и времени с точностью до минты
TIME	Значения времени

2. Вставка строк

Теперь давайте заполнять нашу таблицу months полезной информацией. Добавление записей в таблицу производится через инструкцию INSERT . Есть два способа записи этой инструкции.

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

Этот способ записи прост, но небезопасен, поскольку нет гарантии, что по мере расширения проекта и редактировании таблицы, столбцы будут располагаться в том же порядке, что и ранее. Безопасный (и в тоже время более громоздкий) способ записи инструкции INSERT требует указания как значений, так и порядка следования столбцов:

Здесь первое значение в списке VALUES соответствует первому указанному имени столбца и т.д.

3. Извлечение данных из таблиц

Инструкция SELECT - наш лучший друг, когда мы хотим получить данные из базы данных. Она используется очень часто, так что отнеситесь к этому разделу очень внимательно.

Самый простое использование инструкции SELECT - запрос, который возвращает все столбцы и строки из таблицы (например, таблицы по имени characters ):

SELECT * FROM "characters"

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

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

SELECT id, name FROM month

Кроме того, во многих случаях мы хотим, чтобы полученные результаты были отсортированы в определенном порядке. В SQL мы делаем это с помощью ORDER BY . Он может принимать опциональный модификатор – ASC (по-умолчанию) сортирующий по возрастанию или DESC , сортирующий по убыванию:

SELECT id, name FROM month ORDER BY name DESC

При использовании ORDER BY убедитесь, что оно будет последним в инструкции SELECT . В противном случае будет выдано сообщение об ошибке.

4. Фильтрация данных

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

В этом запросе мы выбираем только те месяцы из таблицы month , в которых больше 30 дней с помощью оператора больше (>).

SELECT id, name FROM month WHERE days > 30

5. Расширенная фильтрация данных. Операторы AND и OR

Ранее мы использовали фильтрацию данных с использованием одного критерия. Для более сложной фильтрации данных можно использовать операторы AND и OR и операторов сравнения (=,<,>,<=,>=,<>).

Здесь мы имеем таблицу, содержащую четыре самых продаваемых альбомов всех времен. Давайте выберем те из них, которые классифицируются как рок и у которых менее 50 миллионов проданных копий. Это можно легко сделать путем размещения оператора AND между этими двумя условиями.

SELECT * FROM albums WHERE genre = "рок" AND sales_in_millions <= 50 ORDER BY released

6. In/Between/Like

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

IN – служит для указания диапазона условий, любое из которых может быть выполнено
BETWEEN – проверяет, находится ли значение в указанном диапазоне
LIKE – ищет по определенным паттернам

Например, если мы хотим выбрать альбомы с поп и соул музыкой, мы можем использовать IN("value1","value2") .

SELECT * FROM albums WHERE genre IN ("pop","soul");

Если мы хотим получить все альбомы, изданные между 1975 и 1985годами, мы должны записать:

SELECT * FROM albums WHERE released BETWEEN 1975 AND 1985;

7. Функции

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

COUNT() – возвращает количество строк
SUM() – возвращает общую сумму числового столбца
AVG() – возвращает среднее значение из множества значений
MIN() / MAX() – получает минимальное / максимальное значение из столбца

Чтобы получить самый последний год в нашей таблице мы должны записать такой SQL запрос:

SELECT MAX(released) FROM albums;

8. Подзапросы

В предыдущем пункте мы научились делать простые расчеты с данными. Если мы хотим использовать результат от этих расчетов, нам не обойтись без вложенных запросов. Допустим, мы хотим вывести artist , album и release year для старейшего альбома в таблице.

Мы знаем, как получить эти конкретные столбцы:

SELECT artist, album, released FROM albums;

Мы также знаем, как получить самый ранний год:

SELECT MIN(released) FROM album;

Все, что нужно сейчас, - это объединить два запроса с помощью WHERE:

SELECT artist,album,released FROM albums WHERE released = (SELECT MIN(released) FROM albums);

9. Объединение таблиц

В более сложных базах данных существует несколько таблиц, связанных друг с другом. Например, ниже представлены две таблицы о видеоиграх (video_games ) и разработчиков видеоигр (game_developers ).

В таблице video_games есть колонка разработчик (developer_id ), но в ней содержится целое число, а не имя разработчика. Это число представляет собой идентификатор (id ) соответствующего разработчика из таблицы разработчиков игр (game_developers ), связывая логически два списка, что позволяет нам использовать информацию, хранящуюся в них обоих одновременно.

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

SELECT video_games.name, video_games.genre, game_developers.name, game_developers.country FROM video_games INNER JOIN game_developers ON video_games.developer_id = game_developers.id;

Это самый простой и наиболее распространенный тип JOIN . Есть несколько других вариантов, но они применимы к менее частым случаям.

10. Алиасы

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

Мы также можем сократить запрос задав псевдонимы имен таблиц: video_games назовем games , game_developers - devs :

SELECT games.name, games.genre, devs.name AS developer, devs.country FROM video_games AS games INNER JOIN game_developers AS devs ON games.developer_id = devs.id;

11. Обновление данных

Часто мы должны изменить данные в некоторых строках. В SQL это делается с помощью инструкции UPDATE . Инструкция UPDATE состоит из:

Таблицы, в которой находится значение для замены;
Имен столбцов и их новых значений;
Выбранные с помощью WHERE строки, которые мы хотим обновить. Если этого не сделать, то изменятся все строки в таблице.

Ниже приведена таблица tv_series с сериалами с их рейтингом. Однако, в таблицу закралась маленькая ошибка: хотя сериал Игра престолов и описывается как комедия, он на самом деле ей не является. Давайте исправим это!

Данные таблицы tv_series UPDATE tv_series SET genre = "драма" WHERE id = 2;

12. Удаление данных

Удаление строки таблицы с помощью SQL - это очень простой процесс. Все, что вам нужно, - это выбрать таблицу и строку, которую нужно удалить. Давайте удалим из предыдущего примера последнюю строку в таблице tv_series . Делается это с помощью инструкции >DELETE

DELETE FROM tv_series WHERE id = 4

Будьте осторожными при написании инструкции DELETE и убедитесь, что условие WHERE присутствует, иначе все строки таблицы будут удалены!

13. Удаление таблицы

Если мы хотим, чтобы удалить все строки, но оставить саму таблицу, то воспользуйтесь командой TRUNCATE:

TRUNCATE TABLE table_name;

В случае, когда мы на самом деле хотим, чтобы удалить и данные, и саму таблицу, то нам пригодится команда DROP:

DROP TABLE table_name;

Будьте очень осторожны с этими командами. Их нельзя отменить!/p>

На этом мы завершаем наш учебник по 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 эквивалентен использованию двух выражений с операторами >= и <= . Например, выражение x BETWEEN y AND z эквивалентно x >= y AND x <= z . Таким образом, оператор BETWEEN...AND следует описанному правилу для определения параметров сортировки.
Оператор IN по своему поведению напоминает оператор = для целей определения используемых параметров сортировки. Например, параметры сортировки, используемые для выражения x IN (y, z) , представляют тип сортировки по умолчанию для x , если x является столбцом. В противном случае, применяется сортировка BINARY .
Предложению ORDER BY , являющемуся частью инструкции SELECT , можно явно присвоить параметры сортировки, используемые для операции сортировки. В этом случае всегда используются явные параметры сортировки. И наоборот, если выражение, отсортированное предложением ORDER BY , является столбцом, то тип сортировки по умолчанию для столбца используется для определения порядка сортировки. Если выражение не является столбцом, то используют параметры сортировки BINARY .

EXPLAIN

Модификатор команды EXPLAIN является нестандартным расширением SQL.

Sql-statement::= EXPLAIN sql-statement

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

ON CONFLICT (алгоритмы конфликтов)

Предложение ON CONFLICT не является отдельной командой SQL. Это нестандартное предложение, которое может использоваться во многих других командах SQL.

Conflict-clause::= ON CONFLICT conflict-algorithm conflict-clause::= OR conflict-algorithm conflict-algorithm::= ROLLBACK | ABORT | FAIL | IGNORE | REPLACE

Первая форма предложения ON CONFLICT с ключевым словом ON CONFLICT используется в инструкции CREATE TABLE . Для инструкции INSERT или UPDATE используется вторая форма, где ON CONFLICT заменяется OR для придания более естественного вида синтаксису. Например, вместо INSERT ON CONFLICT IGNORE используется инструкция INSERT OR IGNORE . Несмотря на разные ключевые слова, значение предложения не меняется в обеих формах.

Предложение ON CONFLICT задает алгоритм, используемый для разрешения конфликтов ограничений. Существует пять алгоритмов: ROLLBACK , ABORT , FAIL , IGNORE и REPLACE . Алгоритм по умолчанию — ABORT . Далее приводится описание пяти алгоритмов конфликтов:

ROLLBACK . При возникновении нарушения ограничения незамедлительно происходит ROLLBACK , что завершает текущую транзакцию. Выполнение команды прекращается и экземпляр SQLStatement выдает событие error . Если активной транзакции нет (кроме подразумеваемой транзакции, создаваемой для каждой команды), то этот алгоритм работает так же, как ABORT .
ABORT . При возникновении нарушения ограничения, команда аннулирует все предыдущие изменения, которые могли быть внесены, а экземпляр SQLStatement выдает событие error . ROLLBACK не выполняется, поэтому изменения, внесенные предыдущими командами в транзакции, сохраняются. ABORT — это поведение по умолчанию.
FAIL . При возникновении нарушения ограничения выполнение команды прекращается и SQLStatement выдает событие error . При этом любые изменения в базе данных, внесенные инструкцией до возникновения нарушения ограничения, сохраняются и не аннулируются. Например, если инструкция UPDATE сталкивается с нарушением ограничения на 100-ой строке, которую она пытается обновить, то сохраняются только первые 99 строк и изменения 100-ой строки и последующих строк не происходят.
IGNORE . При возникновении нарушения ограничения строка с нарушением ограничения не вставляется или не изменяется. Несмотря на пропуск этой строки, команда продолжает выполняться в обычном режиме. Другие строки до и после строки с нарушением ограничения вставляются и обновляются далее как обычно. Ошибка не возвращается.
REPLACE . При возникновении нарушения ограничения UNIQUE , ранее существующие строки, вызывающие нарушение ограничения, удаляются перед вставкой или обновлением текущей строки. Следовательно, вставки или обновление происходит всегда, и команда продолжает выполняться в обычном режиме. Ошибка не возвращается. При возникновении нарушения ограничения NOT NULL значение NULL заменяется значением по умолчанию для этого столбца. Если столбец не имеет значения по умолчанию, используется алгоритм ABORT . Если возникает нарушение ограничения CHECK , используется алгоритм IGNORE . Когда строки удаляются этой стратегией разрешения конфликтов для удовлетворения ограничения, удаление триггеров в этих строках не вызывается.

Алгоритм, заданный в предложении OR инструкции INSERT или UPDATE , переопределяет любой алгоритм, указанный в инструкции CREATE TABLE . Если в инструкции CREATE TABLE или выполняющей инструкции INSERT или UPDATE алгоритм не указан, используется алгоритм ABORT .

REINDEX

Команда REINDEX служит для удаления и повторного создания одного или нескольких индексов. Эта команда полезна, когда определение параметров сортировки было изменено.

Sql-statement::= REINDEX collation-name sql-statement::= REINDEX (table-name | index-name)

В первой форме все индексы в подключенных базах данных, использующих именованные параметры сортировки, создаются повторно. Во второй форме при указании table-name происходит повторное построение всех индексов, связанных с таблицей. Если указан index-name , то удаляется, а затем повторно создается только заданный индекс.

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

Comment::= single-line-comment | block-comment single-line-comment::= -- single-line block-comment::= /* multiple-lines or block [*/]

Однострочный комментарий помечается двумя дефисами. Однострочный комментарий может простираться только до конца текущей строки.

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

Выражения

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

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

В некоторых ситуациях (в предложении WHERE, предложении HAVING, выражении ON в предложении JOIN и выражении CHECK) выражение должно приводить к логическому значению. Этому условию удовлетворяют следующие типы выражений:

Значения литерала

Числовые значения литерала записываются в виде целого числа или числа с плавающей запятой. Поддерживается экспоненциальное представление. Символ. (точка) всегда используется в качестве десятичной точки.

Строковый литерал обозначается заключением строки в одинарные кавычки " . Чтобы включить одинарные кавычки в строку, добавьте две одинарные кавычки в строку, например: "" .

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

Литерал BLOB представляет собой строковый литерал с шестнадцатиричными данными и символом x или X в начале, например: X"53514697465" .

Значением литерала может также быть маркер NULL .

Имя столбца

Именем столбца может быть любое имя, определенное в инструкции CREATE TABLE , или один из следующих специальных идентификаторов: ROWID , OID или _ROWID_ . Все эти специальные идентификаторы описывают уникальный произвольный ключ целых значений ("ключ строки"), связанный с каждой строкой каждой таблицы. Специальные идентификаторы относятся к ключу строки, только если инструкция CREATE TABLE не определяет существующий столбец с тем же именем. Ключи строк действуют так же как столбцы только для чтения. Ключ строки можно использовать там, где можно использовать обычный столбец, однако значение ключа строки нельзя изменять в инструкции UPDATE или INSERT . Инструкция SELECT * FROM table не содержит ключ строки в своем результирующем наборе.

Инструкция SELECT

Инструкция SELECT может присутствовать в выражении в качестве правого операнда оператора IN , скалярного количества (отдельное значение результата) или операнда оператора EXISTS . При использовании в качестве скалярного количества или операнда оператора IN , в результате SELECT может быть только один столбец. Допускается составная инструкция SELECT (соединенная ключевыми словами UNION или EXCEPT). С оператором EXISTS столбцы в результирующем наборе SELECT пропускаются, и выражение возвращает TRUE , если существует одна или несколько строк, и FALSE , если результирующий набор пуст. Если никакие условия в выражении SELECT не ссылаются на значение в содержащем запросе, выражение вычисляется один раз перед любой другой обработкой и результат используется повторно по мере необходимости. Если в выражении SELECT не содержатся переменные из внешнего запроса, известном как связанный вложенный запрос, SELECT вычисляется повторно каждый раз, когда требуется.

Если SELECT является правым операндом оператора IN , оператор IN возвращает TRUE , если результат левого операнда равен любому из значений в результирующем наборе инструкции SELECT . Оператору IN может предшествовать ключевое слово NOT для изменения значения теста.

Если SELECT содержится внутри выражения и не является правым операндом оператора IN , первая строка результата SELECT становится значением, используемым в выражении. Если SELECT выдает более одной строки результатов, все строки после первой пропускаются. Если SELECT не выдает строк, значением SELECT будет NULL .

Выражение CAST

Дополнительные элементы выражений

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

Встроенные функции

Встроенные функции подразделяются на три основные категории:

Помимо этих функций существует специальная функция RAISE() , которая используется для предоставления уведомления об ошибке в выполнении триггера. Эту функцию можно использовать только внутри тела инструкции CREATE TRIGGER . Сведения о функции RAISE() см. в разделе .

Как и все ключевые слова в SQL, имена функций не зависят от регистра.

Статические функции

Статические функции выполняют операции со значениями из нескольких строк. Эти функции в основном используются в инструкциях SELECT вместе с предложением GROUP BY .

AVG(X)	Возвращает среднее значение всех не NULL X в группе. Строковые и BLOB-значения, не похожие на числа, рассматриваются как 0. Результатом AVG() всегда является значение с плавающей запятой, даже если все входные значения — целые числа.
	Первая форма возвращает число раз, которое X не является NULL в группе. Вторая форма (с аргументом *) возвращает общее число строк в группе.
MAX(X)	Возвращает максимальное значение всех значений в группе. Для определения максимального значения используется обычный порядок сортировки.
MIN(X)	Возвращает минимальное не NULL значение всех значений в группе. Для определения минимального значения используется обычный порядок сортировки. Если все значения в группе равны NULL , возвращается NULL .
	Возвращает сумму чисел всех не NULL значений в группе. Если все значения равны NULL , то SUM() возвращает NULL , а TOTAL() возвращает 0.0 . Результатом TOTAL() всегда является значение с плавающей запятой. Результатом SUM() является целочисленное значение, если все не NULL входные значения являются целыми числами. Если какое-либо входное значение для SUM() не является целым числом и не NULL , SUM() возвращает значение с плавающей запятой. Это значение может быть приблизительным числом верной суммы.

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

Скалярные функции

Скалярные функции выполняют операции со значениями по одной строке за раз. Ниже приводится список этих функций:

ABS(X)	Возвращает абсолютное значение аргумента X .
COALESCE(X, Y, ...)	Возвращает копию первого не NULL аргумента. Если все аргументы равны NULL , возвращается NULL . Требуется, по меньшей мере, два аргумента.
GLOB(X, Y)	Эта функция служит для реализации синтаксиса X GLOB Y .
IFNULL(X, Y)	Возвращает копию первого не NULL аргумента. Если оба аргумента равны NULL , возвращается NULL . Эта функция действует так же, как COALESCE() .
HEX(X)	Аргумент рассматривается как значение типа хранения BLOB. Результатом является шестнадцатиричное отображение содержимого этого значения.
LAST_INSERT_ROWID()	Возвращает идентификатор (созданный первичный ключ) последней строки, вставленной в базу данных через текущий экземпляр SQLConnection. Это значение совпадает со значением, которое возвращает свойство SQLConnection.lastInsertRowID .
LENGTH(X)	Возвращает длину строки X в символах.
LIKE(X, Y [, Z])	Эта функция служит для реализации синтаксиса SQL X LIKE Y . Если присутствует необязательное предложение ESCAPE , функция вызывается с тремя аргументами. В противном случае она вызывается только с двумя аргументами.
LOWER(X)	Возвращает копию строки X с преобразованием всех символов в строчные.
	Возвращает строку с удаленными пробелами слева от X . Если указан аргумент Y , функция удаляет любые символы в Y слева от X .
MAX(X, Y, ...)	Возвращает аргумент с максимальным значением. Аргументы могут представлять строки, добавленные к числам. Максимальное значение определяется заданным порядком сортировки. Следует отметить, что функция MAX() является простой, когда имеет 2 или более аргументов, но с одним аргументом является статической функцией.
MIN(X, Y, ...)	Возвращает аргумент с минимальным значением. Аргументы могут представлять строки, добавленные к числам. Минимальное значение определяется заданным порядком сортировки. Следует отметить, что функция MIN() является простой, когда имеет 2 или более аргументов, но с одним аргументом является статической функцией.
NULLIF(X, Y)	Возвращает первый аргумент, если аргументы отличаются; в противном случае возвращает NULL .
QUOTE(X)	Эта подпрограмма возвращает строку, которая представляет значение своего аргумента, подходящее для вставки в другую инструкцию SQL. Строки заключаются в одинарные кавычки с escape-символами во внутренних кавычках в зависимости от необходимости. Классы хранения BLOB кодируются в шестнадцатиричные литералы. Эту функция полезна при написании триггеров для реализации функций отмены или повтора действий.
RANDOM(*)	Возвращает псевдослучайное целое число из интервала -9223372036854775808 — 9223372036854775807. Это случайное значение не является стойким к шифрованию.
RANDOMBLOB(N)	Возвращает N -байтов объекта BLOB с псевдослучайными байтами. N должно быть положительным целым числом. Это случайное значение не является стойким к шифрованию. Если значение N является отрицательным, возвращается один байт.
	Округляет число X до Y знаков справа от десятичной точки. Если аргумент Y опущен, используется 0.
	Возвращает строку с удаленными пробелами слева от X . Если указан аргумент Y , функция удаляет любые символы в Y справа от X .
SUBSTR(X, Y, Z)	Возвращает подстроку входящей строки X , начинающейся с Y символа длиной Z символов. Крайний левый символ X представляет положение индекса 1. Если Y является отрицательным, первый символ подстроки находится путем подсчета справа, а не слева.
	Возвращает строку с удаленными пробелами слева и справа от X . Если указан аргумент Y , функция удаляет любые символы в Y слева и справа от X .
TYPEOF(X)	Возвращает тип выражения X . Возможные возвращаемые значения: "null", "integer", "real", "text" и "blob". Дополнительные сведения о типах данных см. в разделе .
UPPER(X)	Возвращает копию входящей строки X с преобразованием всех символов в прописные.
ZEROBLOB(N)	Возвращает BLOB с N байтами 0x00.

Функции форматирования даты и времени

Функции форматирования даты и времени представляют собой группу скалярных функций, используемых для создания форматированных данных даты и времени. Следует отметить, что эти функции работают со строковыми и числовыми значениями и возвращают их. Эти функции не предназначены для использования с типом данных DATE. Если их использовать с данными в столбце, объявленный тип данных которого — DATE, их поведение будет не таким, как требуется.

DATE(T, ...)	Функция DATE() возвращает строку, содержащую дату в следующем формате: ГГГГ-ММ-ДД. Первый параметр (T) задает строку времени формата, расположенного в разделе . После строки времени можно указать любое число модификаторов. Модификаторы расположены в разделе .
TIME(T, ...)	Функция TIME() возвращает строку, содержащую время в формате ЧЧ:ММ:СС. Первый параметр (T) задает строку времени формата, расположенного в разделе . После строки времени можно указать любое число модификаторов. Модификаторы расположены в разделе .
DATETIME(T, ...)	Функция DATETIME() возвращает строку, содержащую дату и время в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС. Первый параметр (T) задает строку времени формата, расположенного в разделе . После строки времени можно указать любое число модификаторов. Модификаторы расположены в разделе .
JULIANDAY(T, ...)	Функция JULIANDAY() возвращает число, обозначающее количество дней с полудня по Гринвичу 24 ноября 4714 до нашей эры и заданную дату. Первый параметр (T) задает строку времени формата, расположенного в разделе . После строки времени можно указать любое число модификаторов. Модификаторы расположены в разделе .
STRFTIME(F, T, ...)	Подпрограмма STRFTIME() возвращает дату по заданной строке формата в качестве первого аргумента F . Строка формата поддерживает следующие подстановочные знаки: Второй параметр (T) задает строку времени формата, расположенного в разделе . После строки времени можно указать любое число модификаторов. Модификаторы расположены в разделе .

Форматы времени

Формат строки времени может быть любым из следующих:

ГГГГ-ММ-ДД	2007-06-15
ГГГГ-ММ-ДД ЧЧ:ММ	2007-06-15 07:30
ГГГГ-ММ-ДД ЧЧ:ММ:СС	2007-06-15 07:30:59
ГГГГ-ММ-ДД ЧЧ:ММ:СС,ССС	2007-06-15 07:30:59.152
ГГГГ-ММ-ДДTЧЧ:ММ	2007-06-15T07:30
ГГГГ-ММ-ДДTЧЧ:ММ:СС	2007-06-15T07:30:59
ГГГГ-ММ-ДДTЧЧ:ММ:СС,ССС	2007-06-15T07:30:59.152
ЧЧ:ММ	07:30 (дата: 2000-01-01)
ЧЧ:ММ:СС	07:30:59 (дата: 2000-01-01)
ЧЧ:ММ:СС,ССС	07:30:59:152 (дата: 2000-01-01)
now	Текущая дата и время в формате UTC.
ДДДД.ДДДД	День по юлианскому календарю в виде числа с плавающей запятой

Символ T в этих форматах представляет буквенный символ "T", разделяющий дату и время. Форматы, включающие только время, предполагают дату 2001-01-01.

Модификаторы

После строки времени может следовать ноль или несколько модификаторов, изменяющих дату или толкование даты. Доступны следующие модификаторы:

NNN дней	Число дней, прибавляемое к времени.
NNN часов	Число часов, прибавляемое к времени.
NNN минут	Число минут, прибавляемое к времени.
NNN,NNNN секунд	Число секунд или миллисекунд, прибавляемое к времени.
NNN месяцев	Число месяцев, прибавляемое к времени.
NNN лет	Число лет, прибавляемое к времени.
начало месяца	Смещение времени назад к началу месяца.
начало года	Смещение времени назад к началу года.
начало дня	Смещение времени назад к началу дня.
день недели N	Смещение времени вперед на указанный день недели. (0 = воскресенье, 1 = понедельник и т.д.)
localtime	Преобразование даты в местное время
utc	Преобразование даты в формат UTC

Операторы

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

Общие операторы

Следующие двоичные операторы допускаются в блоке SQL и перечислены в порядке приоритета — от высшего до низшего:

|| * / % + - << >> & | < <= > >= = == != <> IN AND OR

Поддерживаются унарные префиксные операторы:

- ! ~ NOT

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

Следует отметить, что существует две разновидности операторов равенства и неравенства. Равенство может иметь форму = или == . Оператор неравенства может иметь вид!= или <> .

Оператор || является строковым оператором сцепления — он соединяет две строки своих операндов.

Оператор % выдает остаток от деления правого операнда на левый операнд.

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

Операторы SQL

LIKE

Оператор LIKE выполняет сравнение шаблонов.

Expr::= (column-name | expr) LIKE pattern pattern::= "[ string | % | _ ]"

Операнд справа от оператора LIKE содержит шаблон, а левые операнд содержит строку для соответствия шаблону. Символ процента (%) в шаблоне представляет собой подстановочный знак и соответствует любой последовательности символов в строке (или отсутствию символов). Символ подчеркивания (_) в шаблоне соответствует любому отдельному символу в строке. Любой другой символ соответствует самому себе или эквивалентному символу нижнего/верхнего регистра, то есть совпадения определяются вне зависимости от регистра. (Примечание. Ядро СУБД понимает только верхний/нижний регистр 7-битных символов латиницы. Следовательно, оператор LIKE учитывает регистра для 8-битных символов iso8859 или символов UTF-8. Например, выражение "a" LIKE "A" является TRUE , но "æ" LIKE "Æ" — FALSE). Зависимость символов латинского алфавита от регистра можно изменить при помощи свойства SQLConnection.caseSensitiveLike .

Если присутствует необязательное предложение ESCAPE , то выражение после ключевого слова ESCAPE должно приводить к строке, состоящей из одного символа. Этот символ можно использовать в шаблоне LIKE для соответствия литеральному проценту или символам подчеркивания. Escape-знак после символа процента, символ подчеркивания или сам по себе соответствует символу литерального процента, символу подчеркивания или escape-знаку в строке, соответственно.

GLOB

Оператор GLOB похож на LIKE , но использует синтаксис глобализации Unix-файла для своих подстановочных знаков. В отличие от LIKE , GLOB зависит от регистра.

IN

Оператор IN вычисляет, равен ли его левый операнд одному из значений правого операнда (набору значений в скобках).

In-expr::= expr IN (value-list) | expr IN (select-statement) | expr IN table-name value-list::= literal-value [, literal-value]*

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

BETWEEN...AND

Оператор BETWEEN...AND эквивалентен использованию двух выражений с операторами >= и <= . Например, выражение x BETWEEN y AND z эквивалентно x >= y AND x <= z .

NOT

Оператор NOT является оператором отрицания. Перед операторами GLOB , LIKE и IN можно поставить ключевое слово NOT для обращения значения теста (другими словами, для проверки того, что значение не соответствует указанному шаблону).

Параметры

Параметр указывает местозаполнитель в выражении для литерального значения, который заполняется во время выполнения путем присвоения значения ассоциативному массиву SQLStatement.parameters . Параметры могут иметь три формы:

Неподдерживаемые возможности SQL

Ограничения FOREIGN KEY . Разбор ограничений FOREIGN KEY выполняется, но они не применяются.
Триггеры . Триггеры FOR EACH STATEMENT не поддерживаются (все триггеры должны быть FOR EACH ROW). Триггеры INSTEAD OF не поддерживаются для таблиц (для представлений допускаются только триггеры INSTEAD OF). Рекурсивные триггеры (вызывающие самих себя) не поддерживаются.
ALTER TABLE . Поддерживаются только варианты RENAME TABLE и ADD COLUMN команды ALTER TABLE . Другие типы операций ALTER TABLE , такие как DROP COLUMN , ALTER COLUMN , ADD CONSTRAINT и т.д., пропускаются.
Вложенные транзакции . Допускается только одна активная транзакция.
RIGHT и FULL OUTER JOIN . RIGHT OUTER JOIN или FULL OUTER JOIN не поддерживаются.
Обновление VIEW . Представление доступно только для чтения. Для представления невозможно выполнить инструкцию DELETE , INSERT или UPDATE . Триггер INSTEAD OF , запускаемый при попытке выполнения DELETE , INSERT или UPDATE для представления, поддерживается и может использоваться для обновления вспомогательных таблиц в теле триггера.
GRANT и REVOKE . База данных представляет собой простой файл на диске; единственные применяемые разрешения доступа — это обычные разрешения доступа к файлам в базовой операционной системе. Команды GRANT и REVOKE , обычно существующие в клиентских/серверных реляционных СУБД, не реализованы.

Следующие элементы SQL и возможности SQLite поддерживаются в некоторых реализациях SQLite, но не поддерживаются в Adobe AIR. Большая часть этих возможностей доступна через методы класса SQLConnection.

Связанные с транзакциями элементы SQL (BEGIN , END , COMMIT , ROLLBACK) : Следующие функции доступны через связанными с транзакциями методы класса SQLConnection : SQLConnection.begin() , SQLConnection.commit() и SQLConnection.rollback() .
ANALYZE SQLConnection.analyze() .
ATTACH : Эта возможность доступна через метод SQLConnection.attach() .
COPY
CREATE VIRTUAL TABLE : Эта инструкция не поддерживается.
DETACH : Эта возможность доступна через метод SQLConnection.detach() .
PRAGMA : Эта инструкция не поддерживается.
VACUUM : Эта возможность доступна через метод SQLConnection.compact() .
Доступ к системной таблице отсутствует . Системные таблицы, в том числе sqlite_master и другие таблицы с префиксом "sqlite_" не доступны в инструкциях SQL. Среда времени выполнения включает API схемы, который представляет объектно-ориентированный способ доступа к данным схемы. Дополнительные сведения см. в описании метода SQLConnection.loadSchema() .
Функция SQLITE_VERSION() : Функция sqlite_version() не доступна для использования в инструкциях SQL.
Функции регулярных выражений (MATCH() и REGEX()) . Эти функции не доступны в инструкциях SQL.

Следующие возможности отличаются в различных реализациях SQLite и Adobe AIR:

Индексированные параметры инструкций . Во многих реализациях индексированные параметры инструкций основаны на единице. Однако в Adobe AIR индексируемые параметры инструкций основаны на нуле (т.е., первому параметру присваивается индекс 0, второму параметру — индекс 1 и т.д.).

Дополнительные возможности SQL

Следующие типы сходства столбцов по умолчанию не поддерживаются в SQLite, но поддерживаются в Adobe AIR:

Следующие типы литеральных значений по умолчанию не поддерживаются в SQLite, но поддерживаются в Adobe AIR:

Значение true . Представляет литеральное логическое значение true для работы со столбцами BOOLEAN.
Значение false . Представляет литеральное логическое значение false для работы со столбцами BOOLEAN.

Поддерживаемые типы данных

В отличие от большинства баз данных SQL, ядро СУБД SQL Adobe AIR не требует, чтобы значения в столбцах таблицы имени определенный тип. Наоборот, среда времени выполнения для управления типами данных использует две концепции: классы хранения и сходство столбцов. В этом разделе описаны классы хранения и сходство столбцов, а также то, как различия типов данных разрешаются в различных условиях:

Классы хранения

Классы хранения представляют типы фактических данных, которые используются для хранения значений в базе данных. Доступны следующие классы хранения.

NULL . Значение равно NULL .
INTEGER . Значение является подписанным целым числом.
REAL . Значение представляет числовое значение с плавающей запятой.
TEXT . Значение является текстовой строкой (ограничивается 256 МБ).
BLOB . Значение представляет большой двоичный объект (BLOB); другими словами, необработанные двоичные данные (ограничивается 256 МБ).

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

Литералам, являющимся частью инструкции SQL, назначается класс хранения TEXT, если они заключены в одинарные или двойные кавычки, INTEGER, если литерал указан в виде числа без кавычек и без десятичной точки или экспонента, REAL, если литерал представляет собой число без кавычек с десятичной точкой или экспонент, и NULL, если значение равно NULL. Литералы с классом хранения BLOB обозначаются как X"ABCD" . Дополнительные сведения см. в разделе .

Значениям, подставляемым в виде параметров при помощи ассоциативного массива SQLStatement.parameters , назначается класс хранения, которые больше всего напоминает привязку к исходному типу данных. Например, значения int привязываются как класс хранения INTEGER, значениям Number назначается класс хранения REAL, значениям String — класс хранения TEXT, а объектам ByteArray — класс хранения BLOB.

Сходство столбцов

Сходство столбца является рекомендуемым типом для данных в таком столбце. Если в столбце сохраняется значение (посредством инструкции INSERT или UPDATE), среда выполнения пытается преобразовать тип данных этого значение к заданному сходству. Например, если значение Date (экземпляр Date ActionScript или JavaScript) вставляется в столбец со сходством TEXT, значение Date преобразовывается в представление String (эквивалентно вызову метода toString() объекта) перед сохранением в базе данных. Если значение не удается преобразовать к заданному сходству, возникает ошибка и операция не выполняется. При извлечении значения из базы данных при помощи инструкции SELECT , оно возвращается в виде экземпляра класса, соответствующего сходству, независимо от того, было ли оно преобразовано из другого типа в момент сохранения.

Если столбец принимает значения NULL, значение null ActionScript или JavaScript можно использовать как значение параметра для хранения NULL в столбце. При извлечении значения класса хранения NULL в инструкции SELECT оно всегда возвращается как значение null ActionScript или JavaScript независимо от сходства столбца. Если столбец принимает значения NULL, следует всегда проверять значения, извлекаемые из этого столбца, чтобы определить, равны ли они null , прежде чем выполнить попытку приведения значения к ненулевому типу (такому как Number или Boolean).

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

TEXT (или STRING)
NUMERIC
INTEGER
REAL (или NUMBER)
BOOLEAN
XMLLIST
OBJECT

TEXT (или STRING)

Столбец со сходством TEXT или STRING хранит все данные с использованием классов хранения NULL, TEXT или BLOB. Если в столбец вставляются данные со сходством TEXT, они преобразуются в текстовую форму перед сохранением.

NUMERIC

Столбец со сходством NUMERIC содержит значения с использованием классов хранения NULL, REAL или INTEGER. При вставке текстовых данных в столбец NUMERIC, перед сохранением выполняется попытка их преобразования в целое число или вещественное число. Если преобразование выполняется успешно, значение сохраняется с использованием класса хранения INTEGER или REAL (например, значение "10.05" преобразуется перед сохранением в класс хранения REAL). В случае невозможности выполнения преобразования происходит ошибка. Попытка преобразования значения NULL не выполняется. Значение, извлекаемое из столбца NUMERIC, возвращается как экземпляр самого специфического числового типа, в который подходит значение. Другими словами, если значение является положительным целым числом или 0, оно возвращается как экземпляр uint. Если оно представляет отрицательное целое число, то возвращается как экземпляр int. И, наконец, если в нем присутствует часть после запятой (не целое число), то оно возвращается как экземпляр Number.

INTEGER

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

REAL (или NUMBER)

Поведение столбца со сходством REAL или NUMBER аналогично поведению столбца со сходством NUMERIC, однако здесь целочисленные значения принудительно преобразуются в представление с плавающей запятой. Значение в столбце REAL всегда возвращается из базы данных в виде экземпляра Number.

BOOLEAN

Столбец со сходством BOOLEAN хранит истинные (true) или ложные (false) значения. Столбец BOOLEAN принимает значение, являющееся экземпляром Boolean ActionScript или JavaScript. При попытке кода сохранить значение String, String, длина которого превышает ноль, считается "true", а пустое значение String — "false". Если код попытается сохранить числовые данные, то любые ненулевые значения сохраняются как "true", а 0 как "false". При извлечении значения Boolean при помощи инструкции SELECT , оно возвращается как экземпляр Boolean. Не-NULL значения хранятся с использованием класса хранения INTEGER (0 для "false" и 1 для "true") и преобразуются в объекты Boolean во время извлечения данных.

DATE

Столбец со сходством DATE хранит значения даты и времени. Столбец DATE может принимать значения, являющиеся экземплярами Date ActionScript или JavaScript Date. При попытке сохранить значение String в столбец DATE, среда выполнения попытает преобразовать его в юлианскую дату. В случае невозможности выполнения преобразования происходит ошибка. Если код попытается сохранить значение Number, int или uint, то попытка проверки данных не выполняется и значение считается допустимым значением даты по юлианскому календарю. При извлечении значения DATE при помощи инструкции SELECT оно автоматически преобразуется в экземпляр Date. Значения DATE хранятся в виде значений юлианской даты с использованием класса хранения REAL, поэтому операторы сортировки и сравнения работают так, как требуется.

XML или XMLLIST

Столбец со сходством XML или XMLLIST содержит структуры XML. При попытке кода сохранить данные в столбце XML при помощи параметра SQLStatement среда выполнения попытается преобразовать и проверить значение с помощью функции ActionScript XML() или XMLList() . В случае невозможности преобразования значения в допустимый XML происходит ошибка. При попытке сохранения данных с использованием текстового значения SQL литерала (например, INSERT INTO (col1) VALUES (" Invalid XML (no closing tag) ") , разбор значения или проверка не выполняется, поскольку его форма считается правильной. Если сохранить недопустимое значение, то при извлечении оно возвращает пустой объект XML. Значение Data XML и XMLLIST Data сохраняется с использованием класса хранения TEXT или NULL.

OBJECT

Столбец со сходством OBJECT содержит сложные объекты ActionScript или JavaScript, включая экземпляры класса Object, а также экземпляры подклассов Object, такие как экземпляры Array и даже экземпляры пользовательских классов. Сериализация данных столбца OBJECT выполняется в формате AMF3 и они сохраняются с использованием класса хранения BLOB. При извлечении значения выполняется его десериализация из AMF3, и оно возвращается в виде экземпляра класса в том виде, в котором оно было сохранено. Следует отметить, что некоторые классы ActionScript, в особенности объекты представления, можно десериализовать как экземпляры их исходного типа данных. Прежде чем сохранять экземпляр пользовательского класса, необходимо зарегистрировать псевдоним класса при помощи метода flash.net.registerClassAlias() (или в Flex, добавив к объявлению класса метаданные ). Кроме того, перед извлечением таких данных необходимо зарегистрировать такой же псевдоним для класса. Любые данные, правильную десериализацию которых невозможно выполнить по той причине, что класс изначально не поддается десериализации или псевдоним класса отсутствует или несогласован, возвращается как анонимный объект (экземпляр класса Object) со свойствами и значениями, соответствующими изначально сохраненному экземпляру.

NONE

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

Определение сходства

Сходство типа столбца определяется по объявленному типу столбца в инструкции CREATE TABLE . При определении типа действуют следующие правила.

Если тип данных столбца содержит любые строки "CHAR", "CLOB", "STRI" или "TEXT", то столбец имеет сходство TEXT/STRING. Следует отметить, что тип VARCHAR содержит строку "CHAR" и ему назначается сходство TEXT.
Если тип данных столбца содержит строки "BLOB" или тип данных не задан, то столбец имеет сходство NONE.
Если тип данных столбца содержит строку "XMLL", то столбец имеет сходство XMLLIST.
Если типом данных является строка "XML", то столбец имеет сходство XML.
Если тип данных содержит строку "OBJE", то столбец имеет сходство OBJECT.
Если тип данных содержит строку "BOOL", то столбец имеет сходство BOOLEAN.
Если тип данных содержит строку "DATE", то столбец имеет сходство DATE.
Если тип данных содержит строку "INT" (включая "UINT"), ему назначается сходство INTEGER.
Если тип данных столбца содержит любые строки "REAL", "NUMB", "FLOA" или "DOUB", то столбец имеет сходство REAL/NUMBER.
В противном случае, сходством будет NUMERIC.
Если таблица создана с помощью инструкции CREATE TABLE t AS SELECT... , то тип данных для всех столбов не задается и им назначается сходство NONE.

Типы данных и операторы сравнения

Поддерживаются операторы двоичного сравнения = , < , <= , >= и!= , а также операция проверки заданного членства, оператор IN и оператор троичного сравнения BETWEEN . Подробные сведения об этих операторах см. в разделе .

Результат сравнения зависит от классов хранения двух сравниваемых значений. При сравнении двух значений действуют следующие правила.

Значение с классом хранения NULL считается меньшим по отношению к любому другому значению (включая другое значение с классом хранения NULL).
Значение INTEGER или REAL меньше любого значения TEXT или BLOB. При сравнении INTEGER или REAL с другим значением INTEGER или REAL выполняется сравнение чисел.
Значение TEXT меньше значения BLOB. При сравнении двух значений TEXT выполняется двоичное сравнение.
При сравнении двух значений BLOB результат всегда определяется по двоичному сравнению.

При выполнении двоичных сравнений классов хранения числа и текста, перед выполнением преобразования база данных пытается преобразовать значения (если требуется). При сравнении классов хранения числа и текста действуют следующие правила (Примечание. Термин выражение , используемый в описанных далее правилах, включает любое скалярное выражение SQL или литерал, отличный от значения столбца. Например, если X и Y.Z представляют имена столбцов, то +X и +Y.Z считаются выражениями):

При сравнении значения столбца с результатом выражения сходство столбца применяется к результату выражения перед выполнением сравнения.
Если при сравнении двух значений столбцов один столбец имеет сходство INTEGER, REAL или NUMERIC, а второй нет, то сходство NUMERIC применяется к любым значениям с классом хранения TEXT, извлеченным из не NUMERIC столбца.
При сравнении результатов двух выражений преобразование не происходит. Результаты сравниваются "как есть". При сравнении строки с числом, последнее всегда меньше строки.

Троичный оператор BETWEEN всегда преобразуется в качестве эквивалента двоичному выражению. Например, a BETWEEN b AND c преобразуется к a >= b AND a <= c , даже если это означает, что разные сходства применяются к a при каждом сравнении, необходимом для вычисления выражения.

Выражения типа a IN (SELECT b ....) следуют трем правилам, перечисленным ранее для двоичного сравнения, то есть, аналогичны a = b . Например, если b — значение столбца, а a — выражение, то сходство b применяется к a перед любым сравнением. Выражение a IN (x, y, z) преобразуется к a = +x OR a = +y OR a = +z . Значения справа от оператора IN (в приведенном примере это значения x , y и z) считаются выражениями, даже если они являются значениями столбца. Если значение слева от оператора IN является столбцом, то используется сходство этого столбца. Если значение является выражением, то преобразование не происходит.

На порядок выполнения сравнений может также влиять предложение COLLATE . Дополнительные сведения см. в разделе .

Типы данных и математические операторы

По каждому из поддерживаемых математических операторов * , / , % , + и - применяется числовое сходство к каждому операнду перед вычислением выражения. Если какой-либо операнд не удается успешно преобразовать в класс хранения NUMERIC, результатом выражения будет NULL .

При использовании оператора сцепления || каждый операнд преобразуется в класс хранения TEXT перед вычислением выражения. Если какой-либо операнд не удается преобразовать в класс хранения NUMERIC, результатом выражения будет NULL . Невозможность преобразования значения может возникать в двух случаях: если значение операнда равно NULL , или есть это объект BLOB с классом хранения, отличным от TEXT.

Типы данных и сортировка

При сортировке значений при помощи предложения ORDER BY , на первое место ставится класс хранения NULL. Затем следуют значения INTEGER и REAL в числовом порядке, далее значения TEXT в двоичном порядке или в зависимости от заданной сортировки (BINARY или NOCASE). Завершают список значения BLOB в двоичном порядке. Перед сортировкой преобразования классов хранения не выполняется.

Типы данных и группировка

При группировке значений с помощью предложение GROUP BY , значения с различными классами хранения считаются разными. Исключением являются значения INTEGER и REAL, которые считаются равными, если их числа эквиваленты. Предложение GROUP BY не приводит к применению сходства к каким-либо значениям.

Типы данных и составные инструкции SELECT

Составные операторы SELECT — UNION , INTERSECT и EXCEPT — выполняют неявное сравнение значений. Перед выполнением этих сравнений к каждому значению может применяться сходство. Такое же сходство (если имеется) применяется ко всем значениям, которые могут быть возвращены в отдельном столбце результирующего набора составной инструкции SELECT . Применяемое сходство является сходством столбца, возвращаемого первым компонентом инструкции SELECT , имеющим значение столбца (а не какой-либо другой тип выражения) в этом положении. Если для заданного столбца составной инструкции SELECT ни один из компонентов инструкции SELECT не возвращает значение столбца, сходство не применяется к значениям из этого столбца перед их сравнением.

Обозначения, используемые в этом документе

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

Регистр текста
- ВЕРХНИЙ РЕГИСТР — ключевые слова SQL литерала написаны в верхнем регистре
- нижний регистр — термины местозаполнителей или имена предложений записаны в нижнем регистре
Символы определений
- ::= — обозначает определение предложения или выражения
Группировка и альтернативные символы
- | — символ прямой черты используется между альтернативными параметрами и может читаться как "или"
- — элементы в квадратных скобках являются необязательными; в квадратные скобки может быть заключен один элемент или набор альтернативных элементов
- () — круглые скобки, в которых заключены альтернативные варианты (набор элементов, разделенных символами прямой черты) обозначает обязательную группу элементов, то есть, набор элементов, которые являются возможными значениями отдельного обязательного элемента
Квантификаторы
- + — знак плюса после элемента в круглых скобках означает, что предшествующий ему элемент может встречаться 1 или более раз
- * — символ звездочки после элемента в квадратных скобках означает, что предшествующий ему (заключенный в скобки) элемент может встречаться 0 или более раз
Символы литерала
- * — символ звездочки в имени столбца или между круглыми скобками после имени функции обозначает символ звездочки, а не квантификатора "0 или более"
- . — символ точки представляет точку литерала
- , — символ запятой представляет запятую литерала
- () — пара круглых скобок, в которые заключено отдельное предложение или элемент обозначает, что скобки являются обязательными символами скобок литерала.
- Другие символы. Если отсутствуют другие обозначения, остальные символы представляют соответствующие символы литерала

Содержание статьи
1. Самые простые MySQL запросы
2. Простые SELECT (выбрать) запросы
3. Простые INSERT (новая запись) запросы
4. Простые UPDATE (перезаписать, дописать) запросы
5. Простые DELETE (удалить запись) запросы
6. Простые DROP (удалить таблицу) запросы
7. Сложные MySQL запросы
8. MySQL запросы и переменные PHP

1. Самые простые SQL запросы

1. Выведет список ВСЕХ баз.

SHOW databases;
2. Выведет список ВСЕХ таблиц в Базе Данных base_name.

SHOW tables in base_name;

2. Простые SELECT (выбрать) запросы к базе данных MySQL

SELECT – запрос, который выбирает уже существующие данные из БД. Для выбора можно указывать определённые параметры выбора. Например, суть запроса русским языком звучит так - ВЫБРАТЬ такие-то колонки ИЗ такой-то таблицы ГДЕ параметр такой-то колонки равен значению.

1. Выбирает ВСЕ данные в таблице tbl_name.

SELECT * FROM tbl_name;
2. Выведет количество записей в таблице tbl_name.

SELECT count(*) FROM tbl_name;
3. Выбирает (SELECT) из(FROM) таблицы tbl_name лимит (LIMIT) 3 записи, начиная с 2.

SELECT * FROM tbl_name LIMIT 2,3;
4. Выбирает (SELECT) ВСЕ (*) записи из (FROM) таблицы tbl_name и сортирует их (ORDER BY) по полю id по порядку.

SELECT * FROM tbl_name ORDER BY id;
5. Выбирает (SELECT) ВСЕ записи из (FROM) таблицы tbl_name и сортирует их (ORDER BY) по полю id в ОБРАТНОМ порядке.

SELECT * FROM tbl_name ORDER BY id DESC;
6. Выбирает (SELECT ) ВСЕ (*) записи из (FROM ) таблицы users и сортирует их (ORDER BY ) по полю id в порядке возрастания, лимит (LIMIT ) первые 5 записей.

SELECT * FROM users ORDER BY id LIMIT 5;
7. Выбирает все записи из таблицы users , где поле fname соответствует значению Gena .

SELECT * FROM users WHERE fname="Gena";
8. Выбирает все записи из таблицы users , где значение поля fname начинается с Ge .

SELECT * FROM users WHERE fname LIKE "Ge%";
9. Выбирает все записи из таблицы users , где fname заканчивается на na , и упорядочивает записи в порядке возрастания значения id .

SELECT * FROM users WHERE fname LIKE "%na" ORDER BY id;
10. Выбирает все данные из колонок fname , lname из таблице users .

SELECT fname, lname FROM users;

11. Допустим у Вас в таблице пользовательских данных есть страна. Так вот если Вы хотите вывести ТОЛЬКО список встречающихся значений (чтобы, например, Россия не выводилось 20 раз, а только один), то используем DISTINCT. Выведет, из массы повторяющихся значений Россия, Украина, Беларусь. Таким образом, из таблицы users колонки country будут выведены ВСЕ УНИКАЛЬНЫЕ значения

SELECT DISTINCT country FROM users;
12. Выбирает ВСЕ данные строк из таблицы users где age имеет значения 18,19 и 21.

SELECT * FROM users WHERE age IN (18,19,21);
13. Выбирает МАКСИМАЛЬНОЕ значение age в таблице users . То есть если у Вас в таблице самое большее значение age (с англ. возраст) равно 55, то результатом запроса будет 55.

SELECT max(age) FROM users;
14. Выберет данные из таблицы users по полям name и age ГДЕ age принимает самое маленькое значение.

SELECT name, min(age) FROM users;
15. Выберет данные из таблицы users по полю name ГДЕ id НЕ РАВЕН 2.

SELECT name FROM users WHERE id!="2";

3. Простые INSERT (новая запись) запросы

INSERT – запрос, который позволяет ПЕРВОНАЧАЛЬНО вставить запись в БД. То есть создаёт НОВУЮ запись (строчку) в БД.

1. Делает новую запись в таблице users , в поле name вставляет Сергей, а в поле age вставляет 25. Таким образом, в таблицу дописывается новая строки с данными значениями. Если колонок больше, то они оставшиеся останутся либо пустыми, либо с установленными по умолчанию значениями.

INSERT INTO users (name, age) VALUES ("Сергей", "25");

4. Простые UPDATE запросы к базе данных MySQL

UPDATE – запрос, который позволяет ПЕРЕЗАПИСАТЬ значения полей или ДОПИСАТЬ что-то в уже существующей строке в БД. Например, есть готовая строка, но в ней нужно перезаписать параметр возраста, так как он изменился со временем.

1. В таблице users age становится 18.

UPDATE users SET age = "18" WHERE id = "3";
2. Всё то же самое, что и в первом запросе, просто показан синтаксис запроса, где перезаписываются два поля и более.
В таблице users ГДЕ id равно 3 значение поля age становится 18, а country Россия.

UPDATE users SET age = "18", country = "Россия" WHERE id = "3";

5. Простые DELETE (удалить запись) запросы к базе данных MySQL

DELETE – запрос, который удаляет строку из таблицы.

1. Удаляет строку из таблицы users ГДЕ id равен 10.

DELETE FROM users WHERE id = "10";

6. Простые DROP (удалить таблицу) запросы к базе данных MySQL

DROP – запрос, который удаляет таблицу.

1. Удаляет целиком таблицу tbl_name .

DROP TABLE tbl_name;

7. Сложные запросы к базе данных MySQL

Любопытные запросы, которые могут пригодиться даже опытным пользователям

SELECT id,name,country FROM users,admins WHERE TO_DAYS(NOW()) - TO_DAYS(registration_date) <= 14 AND activation != "0" ORDER BY registration_date DESC;
Данный сложный запрос ВЫБИРАЕТ колонки id,name,country В ТАБЛИЦАХ users,admins ГДЕ registration_date (дата) не старше 14 дней И activation НЕ РАВНО 0 , СОРТИРОВАТЬ по registration_date в обратном порядке (новое в начале).

UPDATE users SET age = "18+" WHERE age = (SELECT age FROM users WHERE male = "man");
Выше указан пример так называемого запроса в запросе в SQL. Обновить возраст среди пользователей на 18+, где пол - мужской. Подобные варианты запроса не рекомендую. По личному опыту скажу, лучше создать несколько отдельных - они будут прорабатываться быстрее.

8. Запросы к базе данных MySQL и PHP

В MySQL запросы в PHP странице можно вставлять переменные в качестве сравниваемых и тп значений. Пара примеров

1. Выбирает все записи из таблицы users , где поле fname соответствует значению переменной $name .

SELECT * FROM users WHERE fname="$name";
2. В таблице users ГДЕ id равно 3 значение поля age изменяется на значение переменной $age.

UPDATE users SET age = "$age" WHERE id = "3";

Внимание! Если Вам интересен какой-либо ещё пример, то пишите вопрос в комментарии!

Синтаксис:

* где fields1 — поля для выборки через запятую, также можно указать все поля знаком *; table — имя таблицы, из которой вытаскиваем данные; conditions — условия выборки; fields2 — поле или поля через запятую, по которым выполнить сортировку; count — количество строк для выгрузки.
* запрос в квадратных скобках не является обязательным для выборки данных.

Простые примеры использования select

1. Обычная выборка данных:

> SELECT * FROM users

2. Выборка данных с объединением двух таблиц (JOIN):

SELECT u.name, r.* FROM users u JOIN users_rights r ON r.user_id=u.id

* в данном примере идет выборка данных с объединением таблиц users и users_rights . Объединяются они по полям user_id (в таблице users_rights) и id (users). Извлекается поле name из первой таблицы и все поля из второй.

3. Выборка с интервалом по времени и/или дате

а) известна точка начала и определенный временной интервал:

* будут выбраны данные за последний час (поле date ).

б) известны дата начала и дата окончания:

25.10.2017 и 25.11.2017 .

в) известны даты начала и окончания + время:

* выбираем данные в промежутке между 25.03.2018 0 часов 15 минут и 25.04.2018 15 часов 33 минуты и 9 секунд .

г) вытаскиваем данные за определенные месяц и год:

* извлечем данные, где в поле date присутствуют значения для апреля 2018 года.

4. Выборка максимального, минимального и среднего значения:

> SELECT max(area), min(area), avg(area) FROM country

* max — максимальное значение; min — минимальное; avg — среднее.

5. Использование длины строки:

* данный запрос должен показать всех пользователей, имя которых состоит из 5 символов.

Примеры более сложных запросов или используемых редко

1. Объединение с группировкой выбранных данных в одну строку (GROUP_CONCAT):

* из таблицы users извлекаются данные по полю id , все они помещаются в одну строку, значения разделяются запятыми .

2. Группировка данных по двум и более полям:

> SELECT * FROM users GROUP BY CONCAT(title, "::", birth)

* итого, в данном примере мы сделаем выгрузку данных из таблицы users и сгруппируем их по полям title и birth . Перед группировкой мы делаем объединение полей в одну строку с разделителем :: .

3. Объединение результатов из двух таблиц (UNION):

> (SELECT id, fio, address, "Пользователи" as type FROM users)
UNION
(SELECT id, fio, address, "Покупатели" as type FROM customers)

* в данном примере идет выборка данных из таблиц users и customers .

4. Выборка средних значений, сгруппированных за каждый час:

SELECT avg(temperature), DATE_FORMAT(datetimeupdate, "%Y-%m-%d %H") as hour_datetime FROM archive GROUP BY DATE_FORMAT(datetimeupdate, "%Y-%m-%d %H")

* здесь мы извлекаем среднее значение поля temperature из таблицы archive и группируем по полю datetimeupdate (с разделением времени за каждый час).

Вставка (INSERT)

Синтаксис 1:

> INSERT INTO

() VALUES ()

Синтаксис 2:

> INSERT INTO

VALUES ()

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

Примеры использования insert

1. Вставка нескольких строк одним запросом:

> INSERT INTO cities ("name", "country") VALUES ("Москва", "Россия"), ("Париж", "Франция"), ("Фунафути" ,"Тувалу");

* в данном примере мы одним SQL-запросом добавим 3 записи.

2. Вставка из другой таблицы (копирование строк, INSERT + SELECT):

* извлекаем все записи из таблицы cities , названия которых начинаются на «М» и заносим в таблицу cities-new .

Обновление (UPDATE)

Синтаксис:

* где table — имя таблицы; field — поле, для которого будем менять значение; value — новое значение; conditions — условие (без него делать update опасно — можно заменить все данные во всей таблице).

Обновление с использованием замены (REPLACE):

UPDATE

SET = REPLACE(, "<что меняем>", "<на что>");

UPDATE cities SET name = REPLACE(name, "Масква", "Москва");

Если мы хотим перестраховаться, результат замены можно сначала проверить с помощью SELECT:

Удаление (DELETE)

Синтаксис:

* где table — имя таблицы; conditions — условие (как и в случае с UPDATE, использовать DELETE без условия опасно — СУБД не запросит подтверждения, а просто удалит все данные).

Создание таблицы

Синтаксис:

> CREATE TABLE

( , )

> CREATE TABLE IF NOT EXISTS `users_rights` (
`id` int(10) unsigned NOT NULL,
`user_id` int(10) unsigned NOT NULL,
`rights` int(10) unsigned NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

* где table — имя таблицы (в примере users_rights ); field1, field2 — имя полей (в примере создается 3 поля — id, user_id, rights ); options1, options2 — параметры поля (в примере int(10) unsigned NOT NULL ); table options — общие параметры таблицы (в примере ENGINE=InnoDB DEFAULT CHARSET=utf8 ).

Использование запросов в PHP

Подключаемся к базе данных:

mysql_connect ("localhost", "login", "password") or die ("MySQL connect error");
mysql_select_db ("db_name");
mysql_query("SET NAMES "utf8"");

* где подключение выполняется к базе на локальном сервере (localhost ); учетные данные для подключения — login и password (соответственно, логин и пароль); в качестве базы используется db_name ; используемая кодировка UTF-8 .

Также можно создать постоянное подключение:

mysql_pconnect ("localhost", "login", "password") or die ("MySQL connect error");

* однако есть вероятность достигнуть максимально разрешенного лимита хостинга. Данным способом стоит пользоваться на собственных серверах, где мы сами можем контролировать ситуацию.

Завершить подключение:

* в PHP выполняется автоматически, кроме постоянных подключений (mysql_pconnect).

Запрос к MySQL (Mariadb) в PHP делается функцией mysql_query(), а извлечение данных из запроса — mysql_fetch_array():

$result = mysql_query("SELECT * FROM users");
while ($mass = mysql_fetch_array($result)) {
echo $mass . "
";
}

* в данном примере выполнен запрос к таблице users . Результат запроса помещен в переменную $result . Далее используется цикл while , каждая итерация которого извлекает массив данных и помещает его в переменную $mass — в каждой итерации мы работаем с одной строкой базы данных.

Используемая функция mysql_fetch_array() возвращает ассоциативный массив, с которым удобно работать, но есть еще альтернатива — mysql_fetch_row(), которая возвращает обычный нумерованный массив.

Экранирование

При необходимости включения в строку запроса спецсимвола, например, %, необходимо использовать экранирование с помощью символа обратного слэша — \

Например:

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

На этом все. Если Вам нужно помочь с выполнением запроса, пишите мне на почту