Tweet

Coluna de Auto-incremento no PostgreSQL com SERIAL 

No PostgreSQL existe um tipo especial de objeto de banco de dados chamado de Sequência, que permite gerar, como o nome diz, uma sequência de números inteiros. Usamos esse objeto, normalmente, para gerar valores em um campo de chave primária de forma automatizada. Assim, podemos criar um campo de auto-incremento no PostgreSQL.

Para tal, usamos a palavra-chave SERIAL (que é um pseudo-tipo) ao criarmos uma tabela, para identificar a coluna que receberá os valores sequenciais.

Ao usarmos a palavra-chave SERIAL, o PostgreSQL irá criar um objeto de sequência e configurar o próximo valor numérico gerado como valor padrão da coluna em si. Além disso, a restrição NOT NULL é adicionada automaticamente à coluna, pois ela sempre terá um valor associado.

Além do pseudo-tipo SERIAL, o PostgreSQL também possui outros pseudo-tipos para geração de sequências, como o SMALLSERIAL e BIGSERIAL. A tabela a seguir mostra as características de cada um desses pseudo-tipos:

Nome do Pseudo-Tipo	Tamanho	Faixa de Valores
SMALLSERIAL	2 bytes	de 1 a 32.767
SERIAL	4 bytes	de 1 a 2.147.483.647
BIGSERIAL	8 bytes	de 1 a 9.223.372.036.854.775.807

Exemplo

Vejamos um exemplo de emprego de sequência de auto-incremento.

CREATE TABLE Funcionarios (
 IdFunc SERIAL PRIMARY KEY,
 NomeFunc VARCHAR(60),
 DescrCargo TEXT
);

A coluna IdFunc é a coluna que receberá dados numéricos sequenciais, por conta do emprego da palavra SERIAL.

Testando

Para testar o auto-incremento vamos inserir alguns registros na tabela de funcionários criada anteriormente. Note que não devemos inserir dados na coluna IdFunc, pois seus valores serão gerados automaticamente para cada registro inserido.

INSERT INTO Funcionarios (NomeFunc, DescrCargo)
VALUES
('Fábio','CEO da Bóson Treinamentos em Tecnologia'),
('Sandra','Diretora da Okinawa Foods'),
('Ana','Relações Públicas do jornal Diário do Naturalista);

Para ver o resultado, basta realizar uma consulta simples aos dados da tabela:

SELECT * FROM Funcionarios;

Resultado:

Note os valores sequenciais na coluna idFunc, criados automaticamente.

Se acrescentarmos a cláusula RETURNING ao inserir linhas na tabela, será retornado o valor gerado na coluna de auto incremento, como no exemplo a seguir:

INSERT INTO Funcionarios (NomeFunc, DescrCargo)
VALUES
('Monica','Pesquisadora de Novas Tecnologias na Bóson Treinamentos')
RETURNING IdFunc;

Resultado:

Note que ao inserir o novo registro é exibido na saída de dados o valor da coluna de auto-incremento que foi gerado – no caso, o número 4. Se realizarmos uma nova consulta à tabela veremos esse valor associado ao novo registro:

SELECT * FROM Funcionarios;

É isso aí! Mostramos nesta lição como criar uma coluna de auto-incremento em PostgreSQL usando SERIAL. Falaremos mais sobre outros tipos de sequências em ma próxima lição.

Até mais!

Anterior: Como criar tabelas no PostgreSQL com CREATE TABLE