CREATE SEQUENCE

CREATE SEQUENCE: define um novo gerador de sequência.

Sintaxe compatível

CREATE SEQUENCE [ IF NOT EXISTS ] name CACHE cache
    [ AS data_type ]
    [ INCREMENT [ BY ] increment ]
    [ MINVALUE minvalue | NO MINVALUE ] [ MAXVALUE maxvalue | NO MAXVALUE ]
    [ [ NO ] CYCLE ]
    [ START [ WITH ] start ]
    [ OWNED BY { table_name.column_name | NONE } ]

where data_type is BIGINT
      and cache = 1 or cache >= 65536

Descrição

CREATE SEQUENCE cria um gerador de números de sequência. Isso requer a criação e inicialização de uma nova tabela especial de linha única com name. O gerador pertencerá ao usuário que está emitindo o comando.

Se um nome de esquema for fornecido, a visualização será criada no esquema especificado. Do contrário, a visualização será criada no esquema atual. O nome da sequência deve ser diferente do nome de qualquer outra relação (tabela, sequência, índice, visualização, visão materializada ou tabela estrangeira) no mesmo esquema.

Depois de criar uma sequência, use as funções nextval, currval e setval para operar nela. Essas funções estão documentadas em Funções de manipulação de sequências.

Embora seja possível atualizar uma sequência diretamente, você pode usar uma consulta como:

SELECT * FROM name;

para examinar alguns dos parâmetros e o estado atual de uma sequência. O campo last_value da sequência, especialmente, mostra o último valor alocado por qualquer sessão. (Obviamente, esse valor pode estar obsoleto no momento em que for impresso, se outras sessões estiverem fazendo chamadas nextval ativamente.) Outros parâmetros, como increment e maxvalue, podem ser observados na visualização pg_sequences.

Parâmetros

Observações

Use DROP SEQUENCE para remover uma sequência.

Como as sequências são baseadas na aritmética bigint, o intervalo não pode exceder o intervalo de um inteiro de 8 bytes (-9223372036854775808 to 9223372036854775807).

Visto que as chamadas nextval e setval nunca são revertidas, não será possível usar objetos de sequência se for necessária uma atribuição de números de sequência “sem intervalos”.

Cada sessão alocará e armazenará em cache valores de sequência sucessivos durante um acesso ao objeto de sequência e aumentará o last_value do objeto de sequência adequadamente. Em seguida, os próximos usos de cache-1 de nextval dentro dessa sessão simplesmente exibirão os valores pré-alocados, sem tocar no objeto de sequência. Portanto, quaisquer números alocados, mas não usados em uma sessão, serão perdidos quando essa sessão terminar, gerando “lacunas” na sequência.

Além disso, embora exista a garantia de que várias sessões alocarão valores de sequência distintos, os valores poderão ser gerados fora da sequência quando todas as sessões forem consideradas. Por exemplo, com uma configuração de cache de 10, a sessão A pode reservar valores 1..10 e exibir nextval=1 e a sessão B pode reservar valores 11..20 e exibir nextval=11 antes que a sessão A tenha gerado nextval=2. Portanto, com uma configuração de cache igual a um, é seguro presumir que os valores nextval serão gerados sequencialmente; com uma configuração de cache maior que um, você só deve presumir que todos os valores nextval serão distintos, não que serão gerados de uma forma puramente sequencial. Além disso, last_value exibirá o valor mais recente reservado por qualquer sessão, independentemente de ele já ter sido exibido por nextval.

Outra consideração é que a execução de setval em tal sequência não será percebida por outras sessões enquanto elas não usarem todos os valores pré-alocados que armazenaram em cache.

Exemplos

Crie uma sequência crescente chamada serial, começando com 101:

CREATE SEQUENCE serial CACHE 65536 START 101;

Selecione o próximo número dessa sequência:

SELECT nextval('serial');

 nextval
---------
     101

Selecione o próximo número dessa sequência:

SELECT nextval('serial');

 nextval
---------
     102

Use essa sequência em um comando INSERT:

INSERT INTO distributors VALUES (nextval('serial'), 'nothing');

Redefina a sequência para um valor específico usando setval:

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

 nextval
---------
     201

Compatibilidade

CREATE SEQUENCE segue o padrão SQL, com as seguintes exceções: