Перейти к основному содержанию
Перейти к основному содержанию

Табличная функция Values

Табличная функция Values позволяет создать временное хранилище и заполнить столбцы значениями. Она полезна для быстрого тестирования или генерации образцов данных.

Примечание

Values — регистронезависимая функция. То есть VALUES и values одинаково допустимы.

Синтаксис​

Базовый синтаксис табличной функции VALUES выглядит следующим образом:

VALUES([structure,] values...)

Чаще всего используется как:

VALUES(
    ['column1_name Type1, column2_name Type2, ...'],
    (value1_row1, value2_row1, ...),
    (value1_row2, value2_row2, ...),
    ...
)

Аргументы​

  • column1_name Type1, ... (необязательный аргумент). String, задающая имена и типы столбцов. Если этот аргумент опущен, столбцы будут названы c1, c2 и т. д.
  • (value1_row1, value2_row1). Tuples, содержащие значения любого типа.
Примечание

Кортежи, разделённые запятыми, можно также заменить одиночными значениями. В этом случае каждое значение воспринимается как новая строка. См. раздел Примеры для подробностей.

Возвращаемое значение​

  • Возвращает временную таблицу, содержащую указанные значения.

Примеры​

SELECT *
FROM VALUES(
    'person String, place String',
    ('Noah', 'Paris'),
    ('Emma', 'Tokyo'),
    ('Liam', 'Sydney'),
    ('Olivia', 'Berlin'),
    ('Ilya', 'London'),
    ('Sophia', 'London'),
    ('Jackson', 'Madrid'),
    ('Alexey', 'Amsterdam'),
    ('Mason', 'Venice'),
    ('Isabella', 'Prague')
)

    ┌─человек──┬─место─────┐
 1. │ Noah     │ Париж     │
 2. │ Emma     │ Токио     │
 3. │ Liam     │ Сидней    │
 4. │ Olivia   │ Берлин    │
 5. │ Ilya     │ Лондон    │
 6. │ Sophia   │ Лондон    │
 7. │ Jackson  │ Мадрид    │
 8. │ Alexey   │ Амстердам │
 9. │ Mason    │ Венеция   │
10. │ Isabella │ Прага     │
    └──────────┴───────────┘

VALUES также может использоваться с отдельными значениями, а не с кортежами. Например:

SELECT *
FROM VALUES(
    'person String',
    'Noah',
    'Emma',
    'Liam',
    'Olivia',
    'Ilya',
    'Sophia',
    'Jackson',
    'Alexey',
    'Mason',
    'Isabella'
)

    ┌─person───┐
 1. │ Noah     │
 2. │ Emma     │
 3. │ Liam     │
 4. │ Olivia   │
 5. │ Ilya     │
 6. │ Sophia   │
 7. │ Jackson  │
 8. │ Alexey   │
 9. │ Mason    │
10. │ Isabella │
    └──────────┘

Или без указания спецификации столбцов ('column1_name Type1, column2_name Type2, ...' в синтаксисе), в этом случае столбцам автоматически присваиваются имена.

Например:

-- кортежи как значения
SELECT *
FROM VALUES(
    ('Noah', 'Paris'),
    ('Emma', 'Tokyo'),
    ('Liam', 'Sydney'),
    ('Olivia', 'Berlin'),
    ('Ilya', 'London'),
    ('Sophia', 'London'),
    ('Jackson', 'Madrid'),
    ('Alexey', 'Amsterdam'),
    ('Mason', 'Venice'),
    ('Isabella', 'Prague')
)

    ┌─c1───────┬─c2────────┐
 1. │ Noah     │ Paris     │
 2. │ Emma     │ Tokyo     │
 3. │ Liam     │ Sydney    │
 4. │ Olivia   │ Berlin    │
 5. │ Ilya     │ London    │
 6. │ Sophia   │ London    │
 7. │ Jackson  │ Madrid    │
 8. │ Alexey   │ Amsterdam │
 9. │ Mason    │ Venice    │
10. │ Isabella │ Prague    │
    └──────────┴───────────┘

-- отдельные значения
SELECT *
FROM VALUES(
    'Noah',
    'Emma',
    'Liam',
    'Olivia',
    'Ilya',
    'Sophia',
    'Jackson',
    'Alexey',
    'Mason',
    'Isabella'
)

    ┌─c1───────┐
 1. │ Noah     │
 2. │ Emma     │
 3. │ Liam     │
 4. │ Olivia   │
 5. │ Ilya     │
 6. │ Sophia   │
 7. │ Jackson  │
 8. │ Alexey   │
 9. │ Mason    │
10. │ Isabella │
    └──────────┘

См. также​