4.2. Выражения значения
- 4.2.1. Ссылки на столбцы
- 4.2.2. Позиционные параметры
- 4.2.3. Индексы элементов
- 4.2.4. Выбор поля
- 4.2.5. Применение оператора
- 4.2.6. Вызовы функций
- 4.2.7. Агрегатные выражения
- 4.2.8. Вызовы оконных функций
- 4.2.9. Приведения типов
- 4.2.10. Применение правил сортировки
- 4.2.11. Скалярные подзапросы
- 4.2.12. Конструкторы массивов
- 4.2.13. Конструкторы табличных строк
- 4.2.14. Правила вычисления выражений
- 4.2.2. Позиционные параметры
Выражения значения применяются в самых разных контекстах, например в списке результатов команды SELECT
, в значениях столбцов в INSERT
или UPDATE
или в условиях поиска во многих командах. Результат такого выражения иногда называют скаляром, чтобы отличить его от результата табличного выражения (который представляет собой таблицу). А сами выражения значения часто называют скалярными (или просто выражениями). Синтаксис таких выражений позволяет вычислять значения из примитивных частей, используя арифметические, логические и другие операции.
Выражениями значения являются:
Константа или непосредственное значение
Ссылка на столбец
Ссылка на позиционный параметр в теле определения функции или подготовленного оператора
Выражение с индексом
Выражение выбора поля
Применение оператора
Вызов функции
Агрегатное выражение
Вызов оконной функции
Приведение типов
Применение правил сортировки
Скалярный подзапрос
Конструктор массива
Конструктор табличной строки
Кроме того, выражением значения являются скобки (предназначенные для группировки подвыражений и переопределения приоритета )
В дополнение к этому списку есть ещё несколько конструкций, которые можно классифицировать как выражения, хотя они не соответствуют общим синтаксическим правилам. Они обычно имеют вид функции или оператора и будут рассмотрены в соответствующем разделе Главы 9. Пример такой конструкции — предложение IS NULL
.
Мы уже обсудили константы в Подразделе 4.1.2. В следующих разделах рассматриваются остальные варианты.
4.2.1. Ссылки на столбцы
Ссылку на столбец можно записать в форме:
отношение
.имя_столбца
Здесь отношение
— имя таблицы (возможно, полное, с именем схемы) или её псевдоним, определённый в предложении FROM
. Это имя и разделяющую точку можно опустить, если имя столбца уникально среди всех таблиц, задействованных в текущем запросе. (См. также Главу 7.)
4.2.2. Позиционные параметры
Ссылка на позиционный параметр применяется для обращения к значению, переданному в SQL-оператор извне. Параметры используются в определениях SQL-функций и подготовленных операторов. Некоторые клиентские библиотеки также поддерживают передачу значений данных отдельно от самой SQL-команды, и в этом случае параметры позволяют ссылаться на такие значения. Ссылка на параметр записывается в следующей форме:
$число
Например, рассмотрим следующее определение функции dept
:
CREATE FUNCTION dept(text) RETURNS dept AS $$ SELECT * FROM dept WHERE name = $1 $$ LANGUAGE SQL;
Здесь $1
всегда будет ссылаться на значение первого аргумента функции.
4.2.3. Индексы элементов
Если в выражении вы имеете дело с массивом, то можно извлечь определённый его элемент, написав:
выражение
[индекс
]
или несколько соседних элементов («срез массива»):
выражение
[нижний_индекс
:верхний_индекс
]
(Здесь квадратные скобки [ ]
должны присутствовать буквально.) Каждый индекс
сам по себе является выражением, результат которого округляется к ближайшему целому.
В общем случае выражение
массива должно заключаться в круглые скобки, но их можно опустить, когда выражение с индексом — это просто ссылка на столбец или позиционный параметр. Кроме того, можно соединить несколько индексов, если исходный массив многомерный. Например:
моя_таблица.столбец_массив[4] моя_таблица.столбец_массив_2d[17][34] $1[10:42] (функция_массив(a,b))[42]
В последней строке круглые скобки необходимы. Подробнее массивы рассматриваются в Разделе 8.15.
4.2.4. Выбор поля
Если результат выражения — значение составного типа (строка таблицы), тогда определённое поле этой строки можно извлечь, написав:
выражение
.имя_поля
В общем случае выражение
такого типа должно заключаться в круглые скобки, но их можно опустить, когда это ссылка на таблицу или позиционный параметр. Например:
моя_таблица.столбец $1.столбец (функция_кортеж(a,b)).стол3
(Таким образом, полная ссылка на столбец — это просто частный случай выбора поля.) Важный особый случай здесь — извлечение поля из столбца составного типа:
(составной_столбец).поле (моя_таблица.составной_столбец).поле
Здесь скобки нужны, чтобы показать, что составной_столбец
— это имя столбца, а не таблицы, и что моя_таблица
— имя таблицы, а не схемы.
Вы можете запросить все поля составного значения, написав .*
:
(составной_столбец).*
Эта запись действует по-разному в зависимости от контекста; подробнее об этом говорится в Подразделе 8.16.5.
4.2.5. Применение оператора
Существуют три возможных синтаксиса применения операторов:
выражение оператор выражение (бинарный инфиксный оператор) |
оператор выражение (унарный префиксный оператор) |
выражение оператор (унарный постфиксный оператор) |
где оператор
соответствует синтаксическим правилам, описанным в Подразделе 4.1.3, либо это одно из ключевых слов AND
, OR
и NOT
, либо полное имя оператора в форме:
OPERATOR(
схема
.
имя_оператора
)
Существование конкретных операторов и их тип (унарный или бинарный) зависит от того, как и какие операторы определены системой и пользователем. Встроенные операторы описаны в Главе 9.
4.2.6. Вызовы функций
Вызов функции записывается просто как имя функции (возможно, дополненное именем схемы) и список аргументов в скобках:
имя_функции
([выражение
[,выражение
... ]])
Например, так вычисляется квадратный корень из 2:
sqrt(2)
Список встроенных функций приведён в Главе 9. Пользователь также может определить и другие функции.
Выполняя запросы в базе данных, где одни пользователи могут не доверять другим, в записи вызовов функций соблюдайте меры предосторожности, описанные в Разделе 10.3.
Аргументам могут быть присвоены необязательные имена. Подробнее об этом см. Раздел 4.3.
Примечание
Функцию, принимающую один аргумент составного типа, можно также вызывать, используя синтаксис выбора поля, и наоборот, выбор поля можно записать в функциональном стиле. То есть записи col(table)
и table.col
равносильны и взаимозаменяемы. Это поведение не оговорено стандартом SQL, но реализовано в Postgres Pro, так как это позволяет использовать функции для эмуляции «вычисляемых полей». Подробнее это описано в Подразделе 8.16.5.
4.2.7. Агрегатные выражения
Агрегатное выражение представляет собой применение агрегатной функции к строкам, выбранным запросом. Агрегатная функция сводит множество входных значений к одному выходному, как например, сумма или среднее. Агрегатное выражение может записываться следующим образом:
агрегатная_функция
(выражение
[ , ... ] [предложение_order_by
] ) [ FILTER ( WHEREусловие_фильтра
) ]агрегатная_функция
(ALLвыражение
[ , ... ] [предложение_order_by
] ) [ FILTER ( WHEREусловие_фильтра
) ]агрегатная_функция
(DISTINCTвыражение
[ , ... ] [предложение_order_by
] ) [ FILTER ( WHEREусловие_фильтра
) ]агрегатная_функция
( * ) [ FILTER ( WHEREусловие_фильтра
) ]агрегатная_функция
( [выражение
[ , ... ] ] ) WITHIN GROUP (предложение_order_by
) [ FILTER ( WHEREусловие_фильтра
) ]
Здесь агрегатная_функция
— имя ранее определённой агрегатной функции (возможно, дополненное именем схемы), выражение
— любое выражение значения, не содержащее в себе агрегатного выражения или вызова оконной функции. Необязательные предложения предложение_order_by
и условие_фильтра
описываются ниже.
В первой форме агрегатного выражения агрегатная функция вызывается для каждой строки. Вторая форма эквивалентна первой, так как указание ALL
подразумевается по умолчанию. В третьей форме агрегатная функция вызывается для всех различных значений выражения (или набора различных значений, для нескольких выражений), выделенных во входных данных. В четвёртой форме агрегатная функция вызывается для каждой строки, так как никакого конкретного значения не указано (обычно это имеет смысл только для функции count(*)
). В последней форме используются сортирующие агрегатные функции, которые будут описаны ниже.
Большинство агрегатных функций игнорируют значения NULL, так что строки, для которых выражения выдают одно или несколько значений NULL, отбрасываются. Это можно считать истинным для всех встроенных операторов, если явно не говорится об обратном.
Например, count(*)
подсчитает общее количество строк, а count(f1)
только количество строк, в которых f1
не NULL (так как count
игнорирует NULL), а count(distinct f1)
подсчитает число различных и отличных от NULL значений столбца f1
.
Обычно строки данных передаются агрегатной функции в неопределённом порядке и во многих случаях это не имеет значения, например функция min
выдаёт один и тот же результат независимо от порядка поступающих данных. Однако некоторые агрегатные функции (такие как array_agg
и string_agg
) выдают результаты, зависящие от порядка данных. Для таких агрегатных функций можно добавить предложение_order_by
и задать нужный порядок. Это предложение_order_by
имеет тот же синтаксис, что и предложение ORDER BY
на уровне запроса, как описано в Разделе 7.5, за исключением того, что его выражения должны быть просто выражениями, а не именами результирующих столбцов или числами. Например:
SELECT array_agg(a ORDER BY b DESC) FROM table;
Заметьте, что при использовании агрегатных функций с несколькими аргументами, предложение ORDER BY
идёт после всех аргументов. Например, надо писать так:
SELECT string_agg(a, ',' ORDER BY a) FROM table;
а не так:
SELECT string_agg(a ORDER BY a, ',') FROM table; -- неправильно
Последний вариант синтаксически допустим, но он представляет собой вызов агрегатной функции одного аргумента с двумя ключами ORDER BY
(при этом второй не имеет смысла, так как это константа).
Если предложение_order_by
дополнено указанием DISTINCT
, тогда все выражения ORDER BY
должны соответствовать обычным аргументам агрегатной функции; то есть вы не можете сортировать строки по выражению, не включённому в список DISTINCT
.
Примечание
Возможность указывать и DISTINCT
, и ORDER BY
в агрегатной функции — это расширение Postgres Pro.
При добавлении ORDER BY
в обычный список аргументов агрегатной функции, описанном до этого, выполняется сортировка строк для «обычной» агрегатной функции, для которой сортировка необязательна. Но есть подмножество агрегатных функций, сортирующие агрегатные функции, для которых предложение_order
является обязательным, обычно потому, что вычисление этой функции имеет смысл только при определённой сортировке входных строк. Типичными примерами сортирующих агрегатных функций являются вычисления ранга и процентиля. Для сортирующей агрегатной функции предложение_order_by
записывается внутри WITHIN GROUP (...)
, что иллюстрирует последний пример, приведённый выше. Выражения в предложении_order_by
вычисляются однократно для каждой входной строки как аргументы обычной агрегатной функции, сортируются в соответствии с требованием предложения_order_by
и поступают в агрегатную функции как входящие аргументы. (Если же предложение_order_by
находится не в WITHIN GROUP
, оно не передаётся как аргумент(ы) агрегатной функции.) Выражения-аргументы, предшествующие WITHIN GROUP
, (если они есть), называются непосредственными аргументами, а выражения, указанные в предложении_order_by
— агрегируемыми аргументами. В отличие от аргументов обычной агрегатной функции, непосредственные аргументы вычисляются однократно для каждого вызова функции, а не для каждой строки. Это значит, что они могут содержать переменные, только если эти переменные сгруппированы в GROUP BY
; это суть то же ограничение, что действовало бы, будь эти непосредственные аргументы вне агрегатного выражения. Непосредственные аргументы обычно используются, например, для указания значения процентиля, которое имеет смысл, только если это конкретное число для всего расчёта агрегатной функции. Список непосредственных аргументов может быть пуст; в этом случае запишите просто ()
, но не (*)
. (На самом деле Postgres Pro примет обе записи, но только первая соответствует стандарту SQL.)
Пример вызова сортирующей агрегатной функции:
SELECT percentile_cont(0.5) WITHIN GROUP (ORDER BY income) FROM households; percentile_cont ----------------- 50489
она получает 50-ый процентиль, или медиану, значения столбца income
из таблицы households
. В данном случае 0.5
— это непосредственный аргумент; если бы дробь процентиля менялась от строки к строке, это не имело бы смысла.
Если добавлено предложение FILTER
, агрегатной функции подаются только те входные строки, для которых условие_фильтра
вычисляется как истинное; другие строки отбрасываются. Например:
SELECT count(*) AS unfiltered, count(*) FILTER (WHERE i < 5) AS filtered FROM generate_series(1,10) AS s(i); unfiltered | filtered ------------+---------- 10 | 4 (1 row)
Предопределённые агрегатные функции описаны в Разделе 9.20. Пользователь также может определить другие агрегатные функции.
Агрегатное выражение может фигурировать только в списке результатов или в предложении HAVING
команды SELECT
. Во всех остальных предложениях, например WHERE
, они запрещены, так как эти предложения логически вычисляются до того, как формируются результаты агрегатных функций.
Когда агрегатное выражение используется в подзапросе (см. Подраздел 4.2.11 и Раздел 9.22), оно обычно вычисляется для всех строк подзапроса. Но если в аргументах (или в условии_filter
) агрегатной функции есть только переменные внешнего уровня, агрегатная функция относится к ближайшему внешнему уровню и вычисляется для всех строк соответствующего запроса. Такое агрегатное выражение в целом является внешней ссылкой для своего подзапроса и на каждом вычислении считается константой. При этом допустимое положение агрегатной функции ограничивается списком результатов и предложением HAVING
на том уровне запросов, где она находится.
4.2.8. Вызовы оконных функций
Вызов оконной функции представляет собой применение функции, подобной агрегатной, к некоторому набору строк, выбранному запросом. В отличие от обычных агрегатных функций, оконные функции не связаны с группировкой выбранных строк в одну — каждая строка остаётся отдельной в результате запроса. Однако оконная функция может просканировать все строки, вошедшие в группу текущей строки согласно указанию (списку PARTITION BY
) при вызове оконной функции. Вызов оконной функции может иметь следующие формы:
имя_функции
([выражение
[,выражение
... ]]) [ FILTER ( WHEREусловие_фильтра
) ] OVERимя_окна
имя_функции
([выражение
[,выражение
... ]]) [ FILTER ( WHEREусловие_фильтра
) ] OVER (определение_окна
)имя_функции
( * ) [ FILTER ( WHEREусловие_фильтра
) ] OVERимя_окна
имя_функции
( * ) [ FILTER ( WHEREусловие_фильтра
) ] OVER (определение_окна
)
Здесь определение_окна
записывается в виде:
[имя_существующего_окна
] [ PARTITION BYвыражение
[, ...] ] [ ORDER BYвыражение
[ ASC | DESC | USINGоператор
] [ NULLS { FIRST | LAST } ] [, ...] ] [определение_рамки
]
и необязательное определение_рамки
может иметь вид:
{ RANGE | ROWS }начало_рамки
{ RANGE | ROWS } BETWEENначало_рамки
ANDконец_рамки
Здесь начало_рамки
и конец_рамки
задаются одним из следующих способов:
UNBOUNDED PRECEDINGзначение
PRECEDING CURRENT ROWзначение
FOLLOWING UNBOUNDED FOLLOWING
Здесь выражение
— это любое выражение значения, не содержащее вызовов оконных функций.
имя_окна
— ссылка на именованное окно, определённое предложением WINDOW
в данном запросе. Также возможно написать в скобках полное определение_окна
, используя тот же синтаксис определения именованного окна в предложении WINDOW
; подробнее это описано в справке по SELECT. Стоит отметить, что запись OVER имя_окна
не полностью равнозначна OVER (имя_окна)
; последний вариант подразумевает копирование и изменение определения окна и не будет допустимым, если определение этого окна включает определение рамки.
Указание PARTITION BY
группирует строки запроса в разделы, которые затем обрабатываются оконной функцией независимо друг от друга. PARTITION BY
работает подобно предложению GROUP BY
на уровне запроса, за исключением того, что его аргументы всегда просто выражения, а не имена выходных столбцов или числа. Без PARTITION BY
все строки, выдаваемые запросом, рассматриваются как один раздел. Указание ORDER BY
определяет порядок, в котором оконная функция обрабатывает строки раздела. Оно так же подобно предложению ORDER BY
на уровне запроса и так же не принимает имена выходных столбцов или числа. Без ORDER BY
строки обрабатываются в неопределённом порядке.
определение_рамки
задаёт набор строк, образующих рамку окна, которая представляет собой подмножество строк текущего раздела и используется для оконных функций, работающих с рамкой, а не со всем разделом. Рамку можно указать в режимах RANGE
или ROWS
; в любом случае она начинается с положения начало_рамки
и заканчивается положением конец_рамки
. Если конец_рамки
опущен, подразумевается CURRENT ROW
(текущая строка).
Если начало_рамки
задано как UNBOUNDED PRECEDING
, рамка начинается с первой строки раздела, а если конец_рамки
определён как UNBOUNDED FOLLOWING
, рамка заканчивается последней строкой раздела.
В режиме RANGE
начало_рамки
, заданное как CURRENT ROW
, определяет в качестве начала первую родственную строку (строку, которую ORDER BY
считает равной текущей), тогда как конец_рамки
, заданный как CURRENT ROW
, определяет концом рамки последнюю родственную (для ORDER BY
) строку. В режиме ROWS
вариант CURRENT ROW
просто обозначает текущую строку.
Варианты значение
PRECEDING
и значение
FOLLOWING
допускаются только в режиме ROWS
. Они указывают, что рамка начинается или заканчивается со сдвигом на заданное число строк перед или после заданной строки. Здесь значение
должно быть целочисленным выражением, не содержащим переменные, агрегатные или оконные функции, и может быть нулевым, что будет означать выбор текущей строки.
По умолчанию рамка определяется как RANGE UNBOUNDED PRECEDING
, что равносильно расширенному определению RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW
. С указанием ORDER BY
это означает, что рамка будет включать все строки от начала раздела до последней строки, родственной текущей (для ORDER BY
). Без ORDER BY
в рамку включаются все строки раздела, так как все они считаются родственными текущей.
Действуют также ограничения: начало_рамки
не может определяться как UNBOUNDED FOLLOWING
, а конец_рамки
— UNBOUNDED PRECEDING
, и конец_рамки
не может определяться раньше, чем начало_рамки
— например, запись RANGE BETWEEN CURRENT ROW AND
недопустима.значение
PRECEDING
Если добавлено предложение FILTER
, оконной функции подаются только те входные строки, для которых условие_фильтра
вычисляется как истинное; другие строки отбрасываются. Предложение FILTER
допускается только для агрегирующих оконных функций.
Встроенные оконные функции описаны в Таблице 9.56, но этот набор можно расширить, создавая собственные функции. Кроме того, в качестве оконных функций можно использовать любые встроенные или пользовательские обычные агрегатные функции (сортирующие агрегатные функции использовать в качестве оконных нельзя).
Запись со звёздочкой (*
) применяется при вызове агрегатных функций в качестве оконных, например count(*) OVER (PARTITION BY x ORDER BY y)
. Звёздочка (*
) обычно не применяется для не агрегатных оконных функций. Агрегатные оконные функции, в отличие от обычных агрегатных функций, не допускают использования DISTINCT
и ORDER BY
в списке аргументов.
Вызовы оконных функций разрешены в запросах только в списке SELECT
и в предложении ORDER BY
.
Дополнительно об оконных функциях можно узнать в Разделе 3.5, Разделе 9.21 и Подразделе 7.2.5.
4.2.9. Приведения типов
Приведение типа определяет преобразование данных из одного типа в другой. Postgres Pro воспринимает две равносильные записи приведения типов:
CAST (выражение
ASтип
)выражение
::тип
Запись с CAST
соответствует стандарту SQL, тогда как вариант с ::
— историческое наследие Postgres Pro.
Когда приведению подвергается значение выражения известного типа, происходит преобразование типа во время выполнения. Это приведение будет успешным, только если определён подходящий оператор преобразования типов. Обратите внимание на небольшое отличие от приведения констант, описанного в Подразделе 4.1.2.7. Приведение строки в чистом виде представляет собой начальное присваивание строковой константы и оно будет успешным для любого типа (конечно, если строка содержит значение, приемлемое для данного типа данных).
Неявное приведение типа можно опустить, если возможно однозначно определить, какой тип должно иметь выражение (например, когда оно присваивается столбцу таблицы); в таких случаях система автоматически преобразует тип. Однако автоматическое преобразование выполняется только для приведений с пометкой «допускается неявное применение» в системных каталогах. Все остальные приведения должны записываться явно. Это ограничение позволяет избежать сюрпризов с неявным преобразованием.
Также можно записать приведение типа как вызов функции:
имя_типа
(выражение
)
Однако это будет работать только для типов, имена которых являются также допустимыми именами функций. Например, double precision
так использовать нельзя, а float8
(альтернативное название того же типа) — можно. Кроме того, имена типов interval
, time
и timestamp
из-за синтаксического конфликта можно использовать в такой записи только в кавычках. Таким образом, запись приведения типа в виде вызова функции провоцирует несоответствия и, возможно, лучше будет её не применять.
Примечание
Приведение типа, представленное в виде вызова функции, на самом деле соответствует внутреннему механизму. Даже при использовании двух стандартных типов записи внутри происходит вызов зарегистрированной функции, выполняющей преобразование. По соглашению именем такой функции преобразования является имя выходного типа, и таким образом запись «в виде вызова функции» есть не что иное, как прямой вызов нижележащей функции преобразования. При создании переносимого приложения на это поведение, конечно, не следует рассчитывать. Подробнее это описано в справке CREATE CAST.
4.2.10. Применение правил сортировки
Предложение COLLATE
переопределяет правило сортировки выражения. Оно добавляется после выражения:
выражение
COLLATEправило_сортировки
где правило_сортировки
— идентификатор правила, возможно дополненный именем схемы. Предложение COLLATE
связывает выражение сильнее, чем операторы, так что при необходимости следует использовать скобки.
Если правило сортировки не определено явно, система либо выбирает его по столбцам, которые используются в выражении, либо, если таких столбцов нет, переключается на установленное для базы данных правило сортировки по умолчанию.
Предложение COLLATE
имеет два распространённых применения: переопределение порядка сортировки в предложении ORDER BY
, например:
SELECT a, b, c FROM tbl WHERE ... ORDER BY a COLLATE "C";
и переопределение правил сортировки при вызове функций или операторов, возвращающих языкозависимые результаты, например:
SELECT * FROM tbl WHERE a > 'foo' COLLATE "C";
Заметьте, что в последнем случае предложение COLLATE
добавлено к аргументу оператора, на действие которого мы хотим повлиять. При этом не имеет значения, к какому именно аргументу оператора или функции добавляется COLLATE
, так как правило сортировки, применяемое к оператору или функции, выбирается при рассмотрении всех аргументов, а явное предложение COLLATE
переопределяет правила сортировки для всех других аргументов. (Однако добавление разных предложений COLLATE
к нескольким аргументам будет ошибкой. Подробнее об этом см. Раздел 22.2.) Таким образом, эта команда выдаст тот же результат:
SELECT * FROM tbl WHERE a COLLATE "C" > 'foo';
Но это будет ошибкой:
SELECT * FROM tbl WHERE (a > 'foo') COLLATE "C";
здесь правило сортировки нельзя применить к результату оператора >
, который имеет несравниваемый тип данных boolean
.
4.2.11. Скалярные подзапросы
Скалярный подзапрос — это обычный запрос SELECT
в скобках, который возвращает ровно одну строку и один столбец. (Написание запросов освещается в Главе 7.) После выполнения запроса SELECT
его единственный результат используется в окружающем его выражении. В качестве скалярного подзапроса нельзя использовать запросы, возвращающие более одной строки или столбца. (Но если в результате выполнения подзапрос не вернёт строк, скалярный результат считается равным NULL.) В подзапросе можно ссылаться на переменные из окружающего запроса; в процессе одного вычисления подзапроса они будут считаться константами. Другие выражения с подзапросами описаны в Разделе 9.22.
Например, следующий запрос находит самый населённый город в каждом штате:
SELECT name, (SELECT max(pop) FROM cities WHERE cities.state = states.name) FROM states;
4.2.12. Конструкторы массивов
Конструктор массива — это выражение, которое создаёт массив, определяя значения его элементов. Конструктор простого массива состоит из ключевого слова ARRAY
, открывающей квадратной скобки [
, списка выражений (разделённых запятыми), задающих значения элементов массива, и закрывающей квадратной скобки ]
. Например:
SELECT ARRAY[1,2,3+4]; array --------- {1,2,7} (1 row)
По умолчанию типом элементов массива считается общий тип для всех выражений, определённый по правилам, действующим и для конструкций UNION
и CASE
(см. Раздел 10.5). Вы можете переопределить его явно, приведя конструктор массива к требуемому типу, например:
SELECT ARRAY[1,2,22.7]::integer[]; array ---------- {1,2,23} (1 row)
Это равносильно тому, что привести к нужному типу каждое выражение по отдельности. Подробнее приведение типов описано в Подразделе 4.2.9.
Многомерные массивы можно образовывать, вкладывая конструкторы массивов. При этом во внутренних конструкторах слово ARRAY
можно опускать. Например, результат работы этих конструкторов одинаков:
SELECT ARRAY[ARRAY[1,2], ARRAY[3,4]]; array --------------- {{1,2},{3,4}} (1 row) SELECT ARRAY[[1,2],[3,4]]; array --------------- {{1,2},{3,4}} (1 row)
Многомерные массивы должны быть прямоугольными, и поэтому внутренние конструкторы одного уровня должны создавать вложенные массивы одинаковой размерности. Любое приведение типа, применённое к внешнему конструктору ARRAY
, автоматически распространяется на все внутренние.
Элементы многомерного массива можно создавать не только вложенными конструкторами ARRAY
, но и другими способами, позволяющими получить массивы нужного типа. Например:
CREATE TABLE arr(f1 int[], f2 int[]); INSERT INTO arr VALUES (ARRAY[[1,2],[3,4]], ARRAY[[5,6],[7,8]]); SELECT ARRAY[f1, f2, '{{9,10},{11,12}}'::int[]] FROM arr; array ------------------------------------------------ {{{1,2},{3,4}},{{5,6},{7,8}},{{9,10},{11,12}}} (1 row)
Вы можете создать и пустой массив, но так как массив не может быть не типизированным, вы должны явно привести пустой массив к нужному типу. Например:
SELECT ARRAY[]::integer[]; array ------- {} (1 row)
Также возможно создать массив из результатов подзапроса. В этом случае конструктор массива записывается так же с ключевым словом ARRAY
, за которым в круглых скобках следует подзапрос. Например:
SELECT ARRAY(SELECT oid FROM pg_proc WHERE proname LIKE 'bytea%'); array ----------------------------------------------------------------------- {2011,1954,1948,1952,1951,1244,1950,2005,1949,1953,2006,31,2412,2413} (1 row) SELECT ARRAY(SELECT ARRAY[i, i*2] FROM generate_series(1,5) AS a(i)); array ---------------------------------- {{1,2},{2,4},{3,6},{4,8},{5,10}} (1 row)
Такой подзапрос должен возвращать один столбец. Если этот столбец имеет тип, отличный от массива, результирующий одномерный массив будет включать элементы для каждой строки-результата подзапроса и типом элемента будет тип столбца результата. Если же тип столбца — массив, будет создан массив того же типа, но большей размерности; в любом случае во всех строках подзапроса должны выдаваться массивы одинаковой размерности, чтобы можно было получить прямоугольный результат.
Индексы массива, созданного конструктором ARRAY
, всегда начинаются с одного. Подробнее о массивах вы узнаете в Разделе 8.15.
4.2.13. Конструкторы табличных строк
Конструктор табличной строки — это выражение, создающее строку или кортеж (или составное значение) из значений его аргументов-полей. Конструктор строки состоит из ключевого слова ROW
, открывающей круглой скобки, нуля или нескольких выражений (разделённых запятыми), определяющих значения полей, и закрывающей скобки. Например:
SELECT ROW(1,2.5,'this is a test');
Если в списке более одного выражения, ключевое слово ROW
можно опустить.
Конструктор строки поддерживает запись составное_значение
.*
, при этом данное значение будет развёрнуто в список элементов, так же, как в записи .*
на верхнем уровне списка SELECT
(см. Подраздел 8.16.5). Например, если таблица t
содержит столбцы f1
и f2
, эти записи равнозначны:
SELECT ROW(t.*, 42) FROM t; SELECT ROW(t.f1, t.f2, 42) FROM t;
Примечание
До версии PostgreSQL 8.2 запись .*
не разворачивалась в конструкторах строк, так что выражение ROW(t.*, 42)
создавало составное значение из двух полей, в котором первое поле так же было составным. Новое поведение обычно более полезно. Если вам нужно получить прежнее поведение, чтобы одно значение строки было вложено в другое, напишите внутреннее значение без .*
, например: ROW(t, 42)
.
По умолчанию значение, созданное выражением ROW
, имеет тип анонимной записи. Если необходимо, его можно привести к именованному составному типу — либо к типу строки таблицы, либо составному типу, созданному оператором CREATE TYPE AS
. Явное приведение может потребоваться для достижения однозначности. Например:
CREATE TABLE mytable(f1 int, f2 float, f3 text); CREATE FUNCTION getf1(mytable) RETURNS int AS 'SELECT $1.f1' LANGUAGE SQL; -- Приведение не требуется, так как существует только одна getf1() SELECT getf1(ROW(1,2.5,'this is a test')); getf1 ------- 1 (1 row) CREATE TYPE myrowtype AS (f1 int, f2 text, f3 numeric); CREATE FUNCTION getf1(myrowtype) RETURNS int AS 'SELECT $1.f1' LANGUAGE SQL; -- Теперь приведение необходимо для однозначного выбора функции: SELECT getf1(ROW(1,2.5,'this is a test')); ОШИБКА: функция getf1(record) не уникальна SELECT getf1(ROW(1,2.5,'this is a test')::mytable); getf1 ------- 1 (1 row) SELECT getf1(CAST(ROW(11,'this is a test',2.5) AS myrowtype)); getf1 ------- 11 (1 row)
Используя конструктор строк (кортежей), можно создавать составное значение для сохранения в столбце составного типа или для передачи функции, принимающей составной параметр. Также вы можете сравнить два составных значения или проверить их с помощью IS NULL
или IS NOT NULL
, например:
SELECT ROW(1,2.5,'this is a test') = ROW(1, 3, 'not the same'); -- выбрать все строки, содержащие только NULL SELECT ROW(table.*) IS NULL FROM table;
Подробнее см. Раздел 9.23. Конструкторы строк также могут использоваться в сочетании с подзапросами, как описано в Разделе 9.22.
4.2.14. Правила вычисления выражений
Порядок вычисления подвыражений не определён. В частности, аргументы оператора или функции не обязательно вычисляются слева направо или в любом другом фиксированном порядке.
Более того, если результат выражения можно получить, вычисляя только некоторые его части, тогда другие подвыражения не будут вычисляться вовсе. Например, если написать:
SELECT true OR somefunc();
тогда функция somefunc()
не будет вызываться (возможно). То же самое справедливо для записи:
SELECT somefunc() OR true;
Заметьте, что это отличается от «оптимизации» вычисления логических операторов слева направо, реализованной в некоторых языках программирования.
Как следствие, в сложных выражениях не стоит использовать функции с побочными эффектами. Особенно опасно рассчитывать на порядок вычисления или побочные эффекты в предложениях WHERE
и HAVING
, так как эти предложения тщательно оптимизируются при построении плана выполнения. Логические выражения (сочетания AND
/OR
/NOT
) в этих предложениях могут быть видоизменены любым способом, допустимым законами Булевой алгебры.
Когда порядок вычисления важен, его можно зафиксировать с помощью конструкции CASE
(см. Раздел 9.17). Например, такой способ избежать деления на ноль в предложении WHERE
ненадёжен:
SELECT ... WHERE x > 0 AND y/x > 1.5;
Безопасный вариант:
SELECT ... WHERE CASE WHEN x > 0 THEN y/x > 1.5 ELSE false END;
Применяемая так конструкция CASE
защищает выражение от оптимизации, поэтому использовать её нужно только при необходимости. (В данном случае было бы лучше решить проблему, переписав условие как y > 1.5*x
.)
Однако CASE
не всегда спасает в подобных случаях. Показанный выше приём плох тем, что не предотвращает раннее вычисление константных подвыражений. Как описано в Разделе 34.6, функции и операторы, помеченные как IMMUTABLE
, могут вычисляться при планировании, а не выполнении запроса. Поэтому в примере
SELECT CASE WHEN x > 0 THEN x ELSE 1/0 END FROM tab;
, скорее всего, произойдёт деление на ноль из-за того, что планировщик попытается упростить константное подвыражение, даже если во всех строках в таблице x > 0
, а значит во время выполнения ветвь ELSE
никогда не будет выполняться.
Хотя этот конкретный пример может показаться надуманным, похожие ситуации, в которых неявно появляются константы, могут возникать и в запросах внутри функций, так как значения аргументов функции и локальных переменных при планировании могут быть заменены константами. Поэтому, например, в функциях PL/pgSQL гораздо безопаснее для защиты от рискованных вычислений использовать конструкцию IF
-THEN
-ELSE
, чем выражение CASE
.
Ещё один подобный недостаток этого подхода в том, что CASE
не может предотвратить вычисление заключённого в нём агрегатного выражения, так как агрегатные выражения вычисляются перед всеми остальными в списке SELECT
или предложении HAVING
. Например, в следующем запросе может возникнуть ошибка деления на ноль, несмотря на то, что он вроде бы защищён от неё:
SELECT CASE WHEN min(employees) > 0 THEN avg(expenses / employees) END FROM departments;
Агрегатные функции min()
и avg()
вычисляются независимо по всем входным строкам, так что если в какой-то строке поле employees
окажется равным нулю, деление на ноль произойдёт раньше, чем станет возможным проверить результат функции min()
. Поэтому, чтобы проблемные входные строки изначально не попали в агрегатную функцию, следует воспользоваться предложениями WHERE
или FILTER
.