GENERATE_SERIES (Transact-SQL)

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

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

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

GENERATE_SERIES ( start , stop [ , step ] )

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

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

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

Указывает количество значений для постепенного увеличения или уменьшения между шагами в ряде. 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.

SELECT value
FROM GENERATE_SERIES(1, 10);

Вот результирующий набор.

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

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

Вот результирующий набор.

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

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

• SEQUENCES (Transact-SQL)
• Реляционные операторы (Transact-SQL)