В PostgreSQL функция ARRAY_PREPEND используется для добавления элемента в начало массива. Эта функция принимает два аргумента: элемент, который необходимо добавить, и массив, к которому он будет добавлен.
Синтаксис
ARRAY_PREPEND(элемент, массив)
Первый аргумент — значение, которое будет добавлено в начало массива. Второй аргумент — массив, к которому применяется операция.
Примеры использования
Добавление элемента в массив
SELECT ARRAY_PREPEND(0, ARRAY[1, 2, 3]);
Результат:
{0,1,2,3}
Применение в запросах
При работе с таблицами ARRAY_PREPEND позволяет обновлять значения массивов:
UPDATE users
SET tags = ARRAY_PREPEND('новый', tags)
WHERE id = 1;
Использование с NULL
Если массив имеет значение NULL, ARRAY_PREPEND создаст новый массив с указанным элементом:
SELECT ARRAY_PREPEND('начало', NULL::text[]);
Результат:
{"начало"}