GENERATE_SERIES (Transact-SQL)

  • Статья

Область применения: конечная точка аналитики SQL Server 2022 (16.x) База данных SQL Azure Управляемый экземпляр SQL Azure SQL в хранилище Microsoft Fabricв Microsoft Fabric

Создает ряд чисел в пределах заданного интервала. Интервал и шаг между значениями рядов определяются пользователем.

Уровень совместимости 160

GENERATE_SERIES Требуется, чтобы уровень совместимости был не менее 160. Если уровень совместимости меньше 160, ядро СУБД не может найти функциюGENERATE_SERIES.

Сведения об изменении уровня совместимости базы данных см. в статье Просмотр или изменение уровня совместимости базы данных.

Соглашения о синтаксисе Transact-SQL

Синтаксис

GENERATE_SERIES ( start , stop [ , step ] )

Аргументы

Начало

Первое значение в интервале. start указывается как переменная, литерал или скалярное выражение типа tinyint, smallint, int, bigint, decimal или numeric.

stop

Последнее значение в интервале. stop указывается как переменная, литерал или скалярное выражение типа tinyint, smallint, int, bigint, decimal или numeric. Ряд останавливается после того, как последнее созданное значение шага превышает значение stop.

Тип данных для stopдолжен соответствовать типу данных для start.

[ шаг ]

Указывает количество значений для постепенного увеличения или уменьшения между шагами в ряде. step является выражением типа tinyint, smallint, int, bigint, decimal или numeric. step может быть отрицательным или положительным, но не может быть равным нулю (0).

Этот аргумент является необязательным. Значение по умолчанию для step равно 1, если start меньше, чем stop. В противном случае значение по умолчанию равно 1, если start имеет значение больше, чем stop.

Если start имеет значение меньше, чем stop и для step указано отрицательное значение, или если значение start больше, чем stop и для step указано положительное значение, то возвращается пустой результирующий набор.

Типы возвращаемых данных

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

Разрешения

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

Примеры

В следующих примерах демонстрируется синтаксис вызова GENERATE_SERIES.

А. Создание ряда целых чисел в диапазоне от 1 до 10 с шагом приращения 1 (по умолчанию)

SELECT value
FROM GENERATE_SERIES(1, 10);

Результирующий набор:

value
-----------
1
2
3
4
5
6
7
8
9
10

B. Создание ряда целых чисел в диапазоне от 1 до 50 с шагом приращения в 5

SELECT value
FROM GENERATE_SERIES(1, 50, 5);

Результирующий набор:

value
-----------
1
6
11
16
21
26
31
36
41
46

C. Создание ряда десятичных чисел в диапазоне от 0,0 до 1,0 с шагом приращения в 0,1

DECLARE @start decimal(2, 1) = 0.0;
DECLARE @stop decimal(2, 1) = 1.0;
DECLARE @step decimal(2, 1) = 0.1;

SELECT value
FROM GENERATE_SERIES(@start, @stop, @step);

Результирующий набор:

value
---------------------------------------
0.0
0.1
0.2
0.3
0.4
0.5
0.6
0.7
0.8
0.9
1.0

Связанный контент