CREATE DOMAIN

Descrição

O comando CREATE DOMAIN cria um domínio. O domínio é, essencialmente, um tipo de dado com restrições opcionais (restrições no conjunto de valores permitidos). O usuário que cria o domínio se torna o seu dono. [1] [2] [3]

Se for fornecido o nome do esquema (por exemplo, CREATE DOMAIN meu_esquema.meu_dominio ...), então o domínio será criado no esquema especificado, senão será criado no esquema corrente. O nome do domínio deve ser único entre os tipos e domínios existentes no esquema do domínio.

Domínios são úteis para reunir restrições comuns em campos em um único local para manutenção. Por exemplo, várias tabelas podem conter colunas de endereço de correio eletrônico, todas requerendo a mesma restrição de verificação (CHECK). Em vez de definir as restrições em cada tabela individualmente, pode ser definido um domínio.

Parâmetros

Exemplos

Este exemplo cria o tipo de dado us_postal_code (código postal americano), e usa este tipo na definição da tabela. É utilizada uma expressão regular para verificar se o valor se parece com um código postal americano válido.

CREATE DOMAIN us_postal_code AS TEXT
CHECK(
   VALUE ~ '^\\d{5}$'
OR VALUE ~ '^\\d{5}-\\d{4}$'
);

CREATE TABLE us_snail_addy (
  address_id SERIAL PRIMARY KEY,
  street1 TEXT NOT NULL,
  street2 TEXT,
  street3 TEXT,
  city TEXT NOT NULL,
  postal us_postal_code NOT NULL
);

Este exemplo cria o domínio dom_cep (código de endereçamento postal brasileiro), e usa este domínio na definição de uma função e de uma tabela. Abaixo estão mostrados os comandos para criar o domínio, a função que utiliza o domínio no parâmetro, e a tabela que utiliza o domínio na coluna. [4]

CREATE DOMAIN dom_cep AS text
    CONSTRAINT chk_cep
        CHECK (VALUE ~ '^\\d{8}$');
CREATE FUNCTION formata_cep(cep dom_cep) RETURNS TEXT AS $$
BEGIN
    RETURN substr(cep,1,5) || '-' || substr(cep,6,3);
END;
$$ LANGUAGE plpgsql;
CREATE TABLE tbl_cep (cep dom_cep);

Foram feitos três testes para a função: No primeiro teste a cadeia de caracteres é convertida explicitamente para o domínio dom_cep; No segundo teste a cadeia de caracteres é passada diretamente sem nenhuma conversão explícita, mas atende a restrição de verificação do domínio; No terceiro teste a cadeia de caracteres é passada diretamente sem nenhuma conversão explícita, e não atende a restrição de verificação do domínio (não possui 8 dígitos, apenas 7).

=> SELECT formata_cep(CAST('20031050' AS dom_cep));

 formata_cep
-------------
 20031-050
(1 linha)

=> SELECT formata_cep('20031050');

 formata_cep
-------------
 20031-050
(1 linha)

=> SELECT formata_cep('2003105');

ERRO:  valor para domínio dom_cep viola restrição de verificação "chk_cep"

Como pode ser visto pelos resultados, no primeiro teste o domínio foi aceito corretamente, no segundo teste foi feita a conversão implícita e o valor foi aceito, e no terceiro teste a conversão implícita não foi bem-sucedida porque a cadeia de caracteres viola a restrição de verificação chk_cep.

Também foram feitos três testes de inserção na tabela, com resultados semelhantes aos obtidos na utilização da função:

=> INSERT INTO tbl_cep VALUES (CAST('20031050' AS dom_cep));
INSERT 0 1
=> INSERT INTO tbl_cep VALUES ('20031050');
INSERT 0 1
=> INSERT INTO tbl_cep VALUES ('2003105');
ERRO:  valor para domínio dom_cep viola restrição de verificação "chk_cep"

Compatibilidade

O comando CREATE DOMAIN está em conformidade com o padrão SQL.

Consulte também