No SQL Server 2022 (16.x) e versões posteriores, a função GENERATE_SERIES é uma ferramenta poderosa para criar uma sequência de números dentro de um intervalo especificado. Seja para fins de testes, análises de dados ou outros cenários, essa função permite gerar números de forma eficiente e flexível. Neste post, vamos explorar como usar essa função e entender seus detalhes.

O que é a Função GENERATE_SERIES?

A função GENERATE_SERIES foi introduzida no SQL Server 2022 (16.x) e também está disponível no Banco de Dados SQL do Azure e Instância Gerenciada de SQL do Azure. Ela gera uma sequência de números dentro de um intervalo definido pelo usuário, com a possibilidade de especificar o valor de incremento ou decremento entre os números.

Aplicações da Função

A função GENERATE_SERIES pode ser muito útil em diversas situações, incluindo:

• Criação de intervalos sequenciais: Para gerar números em sequência, como datas ou identificadores.
• Testes e validações: Para realizar testes em dados gerados automaticamente, sem a necessidade de inserir manualmente os números.
• Análise de Dados: Ao gerar séries numéricas, você pode usar essas sequências como base para operações analíticas.

Requisitos de Compatibilidade

Para usar a função GENERATE_SERIES, é necessário que o banco de dados esteja com o nível de compatibilidade configurado como 160 ou superior. Caso contrário, o SQL Server não reconhecerá a função. Para verificar ou alterar o nível de compatibilidade do banco de dados, use o comando:

ALTER DATABASE NomeDoBanco SET COMPATIBILITY_LEVEL = 160;

Isso garante que você poderá aproveitar os recursos do SQL Server 2022 e versões mais recentes.

Sintaxe da Função GENERATE_SERIES

A sintaxe da função GENERATE_SERIES é simples e fácil de usar:

GENERATE_SERIES (start, stop [, step])

Argumentos:

• start: O valor inicial do intervalo (pode ser tinyint, smallint, int, bigint, decimal, ou numeric).
• stop: O valor final do intervalo, que deve ser do mesmo tipo de dados que o start.
• step (opcional): O valor que indica o incremento ou decremento entre os números na sequência. O valor padrão é 1, mas você pode personalizar conforme a necessidade. O valor de step não pode ser zero.

Tipos de Retorno

A função retorna uma tabela com uma coluna única chamada value, que contém a sequência gerada. O tipo de dados da coluna será o mesmo de start e stop.

---

Exemplo

Gerando uma sequência de números inteiros de 1 a 10 (incremento padrão de 1)

Este exemplo gera uma série de números inteiros de 1 a 10, com o incremento padrão de 1:

SELECT value FROM GENERATE_SERIES(1, 10);

Resultado:

value
1
2
3
4
5
6
7
8
9
10

---

Considerações Finais

A função GENERATE_SERIES no SQL Server 2022 (16.x) é uma ferramenta valiosa para gerar séries de números sequenciais. Seja para fins analíticos, de teste ou de cálculos, ela oferece flexibilidade e eficiência, sem a necessidade de manipulações complexas.