CREATE SEQUENCE

Descrição

O comando CREATE SEQUENCE cria um gerador de números seqüenciais, o que envolve a criação e a inicialização de uma tabela especial com uma única linha chamada nome. O usuário que executa o comando se torna o dono do gerador.

Se for fornecido o nome do esquema então a seqüência será criada no esquema especificado, senão será criada no esquema corrente. As seqüências temporárias são criadas em um esquema especial e, portanto, não pode ser fornecido o nome do esquema ao se criar uma seqüência temporária. O nome da seqüência deve ser distinto do nome de qualquer outra seqüência, tabela, índice ou visão no mesmo esquema.

Após a seqüência ser criada, podem ser utilizadas as funções nextval, currval e setval para operar na seqüência. Estas funções estão documentadas na Seção 9.12. [1] [2] [3] [4]

Embora não seja possível atualizar uma seqüência diretamente, pode ser feita uma consulta como

SELECT * FROM nome;

para examinar os parâmetros e o estado atual da seqüência. Em particular, o campo last_value da seqüência mostra o último valor alocado para alguma sessão (É claro que este valor poderá estar obsoleto no instante em que for exibido, se outras sessões estiverem chamando a função nextval).

Parâmetros

Observações

Para remover uma seqüência deve ser utilizado o comando DROP SEQUENCE.

As seqüências são baseadas na aritmética do tipo bigint e, portanto, a faixa de valores não pode exceder a faixa de um número inteiro de 8 bytes (-9223372036854775808 a 9223372036854775807). Em algumas plataformas mais antigas, pode não haver suporte do compilador para números inteiros de 8 bytes e, neste caso, as seqüências utilizam a aritmética do tipo integer regular (faixa de valores de -2147483648 a +2147483647).

Se for utilizada uma definição de cache maior que 1, para um objeto de seqüência que será utilizado ao mesmo tempo por várias sessões, poderão ocorrer resultados não esperados. Cada sessão irá alocar e armazenar no cache valores sucessivos da seqüência durante um acesso ao objeto de seqüência, e ajustar o valor de last_value do objeto de seqüência da forma apropriada. Depois disso, as próximas cache-1 utilizações de nextval pela sessão simplesmente retornarão os valores alocados anteriormente, sem acessar o objeto de seqüência. Portanto, todos os números alocados, mas não utilizados pela sessão, serão perdidos quando a sessão terminar, produzindo "buracos" na seqüência.

Além disso, embora haja garantia que as várias sessões alocam valores distintos da seqüência, os valores podem ser gerados fora de ordem quando são levadas em consideração todas as sessões. Por exemplo, definindo-se cache igual a 10, a sessão A pode reservar os valores 1..10 e retornar nextval=1, enquanto a sessão B pode reservar os valores 11..20 e retornar nextval=11 antes da sessão A ter gerado nextval=2. Portanto, com uma definição de cache igual a um é seguro assumir que os valores de nextval são gerados seqüencialmente; com uma definição de cache maior do que um apenas pode-se assumir que os valores de nextval são todos distintos, mas não que sejam gerados de forma inteiramente seqüencial. Também, o valor last_value reflete o último valor gerado por qualquer sessão, tenha ou não sido retornado por nextval.

Outra consideração a ser feita é que, neste tipo de seqüência, a execução de setval não será percebida pelas outras sessões enquanto estas não utilizarem todos os valores alocados armazenados no cache.

Exemplos

Criar uma seqüência ascendente chamada serial, começando por 101:

CREATE SEQUENCE serial START 101;

Selecionar o próximo valor desta seqüência:

SELECT nextval('serial');

 nextval
---------
     114

Se a função nextval for chamada duas vezes no mesmo comando a seqüência será incrementada duas vezes: [5]

SELECT nextval('serial'), nextval('serial');

 nextval | nextval
---------+---------
     115 |     116

Para que a seqüência não seja incrementada duas vezes deve ser utilizada a função nextval uma vez e currval na vez seguinte: [6]

SELECT nextval('serial'), currval('serial');

 nextval | currval
---------+---------
     117 |     117

Utilizar esta seqüência no comando INSERT:

INSERT INTO distribuidores VALUES (nextval('serial'), 'nada');

Atualizar o valor da seqüência após executar o comando COPY FROM:

BEGIN;
COPY distribuidores FROM 'arquivo_de_entrada';
SELECT setval('serial', max(id)) FROM distribuidores;
END;

Criar uma seqüência temporária que retorna um valor constante igual a área do Brasil (8.500.000 km²) [7]

CREATE TEMPORARY SEQUENCE area_brasil
    INCREMENT BY 2
    MINVALUE 8500000
    MAXVALUE 8500001
    START WITH 8500000
    CYCLE
    CACHE 1;

Testar a seqüência para ver se retorna um valor constante:

SELECT nextval('area_brasil') AS "Área do Brasil (km2)";

 Área do Brasil (km2)
----------------------
              8500000
(1 linha)

SELECT nextval('area_brasil') AS "Área do Brasil (km2)";

 Área do Brasil (km2)
----------------------
              8500000
(1 linha)

Compatibilidade

O comando CREATE SEQUENCE está especificado no SQL:2003. O PostgreSQL está em conformidade com o padrão, com as seguintes exceções:

• A expressão do padrão AS <data type> não é suportada.

• A obtenção do próximo valor é feita usando a função nextval() em vez da expressão do padrão NEXT VALUE FOR.