CREATE TABLE

CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE nome_da_tabela (
  { nome_da_coluna tipo_de_dado [ DEFAULT expressão_padrão ] [ restrição_de_coluna [ ... ] ]
    | restrição_de_tabela
    | LIKE tabela_ancestral [ { INCLUDING | EXCLUDING } DEFAULTS ] }  [, ... ]
)
[ INHERITS ( tabela_ancestral [, ... ] ) ]
[ WITH OIDS | WITHOUT OIDS ]
[ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ]

onde restrição_de_coluna é:

[ CONSTRAINT nome_da_restrição ]
{ NOT NULL | NULL | UNIQUE | PRIMARY KEY | CHECK (expressão) |
  REFERENCES tabela_referenciada [ ( coluna_referenciada ) ]
    [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ]
    [ ON DELETE ação ] [ ON UPDATE ação ] }
    [ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ]

e restrição_de_tabela é:

[ CONSTRAINT nome_da_restrição ]
{ UNIQUE ( nome_da_coluna [, ... ] ) |
  PRIMARY KEY ( nome_da_coluna [, ... ] ) |
  CHECK ( expressão ) |
  FOREIGN KEY ( nome_da_coluna [, ... ] )
    REFERENCES tabela_referenciada [ ( coluna_referenciada [, ... ] ) ]
    [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE ação ] [ ON UPDATE ação ] }
    [ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ]

Descrição

O comando CREATE TABLE cria uma tabela, inicialmente vazia, no banco de dados corrente. O usuário que executa o comando se torna o dono da tabela. [1]

Se o nome do esquema for fornecido (por exemplo, CREATE TABLE meu_esquema.minha_tabela ...) então a tabela é criada no esquema especificado, senão é criada no esquema corrente. As tabelas temporárias são criadas em um esquema especial e, portanto, o nome do esquema não pode ser especificado ao se criar tabelas temporárias. O nome da tabela deve ser distinto do nome de qualquer outra tabela, seqüência, índice ou visão no mesmo esquema.

O comando CREATE TABLE também cria, automaticamente, o tipo de dado que representa o tipo composto correspondente a uma linha da tabela. Portanto, as tabelas não podem ter o mesmo nome de um tipo de dado existente no mesmo esquema.

Uma tabela não pode ter mais de 1600 colunas (Na prática o limite efetivo é menor, por causa da restrição do comprimento das tuplas).

As cláusulas de restrição opcionais especificam as restrições (ou testes) que as linhas novas ou modificadas devem satisfazer para a operação de inserção ou de modificação ser aceita. Uma restrição é um objeto SQL que ajuda a definir o conjunto de valores válidos para a tabela de várias maneiras.

Existem duas formas para definir restrições: restrições de tabela e restrições de coluna. A restrição de coluna é definida como parte da definição da coluna. A definição da restrição de tabela não é limitada a uma única coluna, podendo incluir mais de uma coluna. Toda restrição de coluna também pode ser escrita como restrição de tabela; a restrição de coluna é somente uma notação conveniente para ser usada quando a restrição afeta apenas uma coluna. [2]

Parâmetros

Observações

• Sempre que a aplicação faz uso de OIDs para identificar linhas específicas de uma tabela, é recomendado criar uma restrição de unicidade para a coluna oid da tabela, para garantir que os OIDs na tabela realmente identificam unicamente uma linha, mesmo após o contador reiniciar. Evite supor que os OIDs são únicos entre tabelas; se for necessário um identificador único para todo o banco de dados, use a combinação de tableoid (OID de tabela) com o OID de linha para esta finalidade (é provável que as versões futuras do PostgreSQL utilizem contadores OID separados para cada tabela e, então, será necessário, e não opcional, incluir o tableoid para se ter um identificador único para todo o banco de dados).

  Dica: Não se recomenda utilizar WITHOUT OIDS para tabelas sem chave primária, porque sem OID e sem chave de dados única fica difícil identificar uma linha específica.

• O PostgreSQL cria, automaticamente, um índice para cada restrição de unicidade e de chave primária para garantir a unicidade. Portanto, não é necessário criar explicitamente um índice para as colunas da chave primária (Consulte o comando CREATE INDEX para obter mais informações).
• As restrições de unicidade e de chave primária não são herdadas na implementação corrente, tornando o comportamento da combinação de herança com restrição de unicidade um tanto disfuncional. [3]

Exemplos

Criar a tabela filmes e a tabela distribuidores:

CREATE TABLE filmes (
    cod_filme   char(5) CONSTRAINT pk_filmes PRIMARY KEY,
    titulo      varchar(40) NOT NULL,
    did         integer NOT NULL,
    data_prod   date,
    tipo        varchar(10),
    duracao     interval hour to minute
);

CREATE TABLE distribuidores (
     did    integer PRIMARY KEY DEFAULT nextval('serial'),
     nome   varchar(40) NOT NULL CHECK (nome <> '')
);

Criar uma tabela com uma matriz de 2 dimensões:

CREATE TABLE matriz2d_int (
    matriz  int[][]
);

Definir uma restrição de unicidade para a tabela filmes. Restrições de unicidade usando a sintaxe de restrição de tabela podem ser definidas envolvendo uma ou mais colunas da tabela.

CREATE TABLE filmes (
    cod_filme   char(5),
    titulo      varchar(40),
    did         integer,
    data_prod   date,
    tipo        varchar(10),
    duracao     interval hour to minute,
    CONSTRAINT  unq_data_prod UNIQUE(data_prod)
);

Definir uma restrição de verificação, usando a sintaxe de restrição de coluna:

CREATE TABLE distribuidores (
    did     integer CHECK (did > 100),
    nome    varchar(40)
);

Definir uma restrição de verificação, usando a sintaxe de restrição de tabela:

CREATE TABLE distribuidores (
    did     integer,
    nome    varchar(40)
    CONSTRAINT chk_dist CHECK (did > 100 AND nome <> '')
);

Definir uma restrição de chave primária, usando a sintaxe de restrição de tabela, para a tabela filmes. As restrições de chave primária com sintaxe de restrição de tabela podem ser definidas usando uma ou mais colunas da tabela.

CREATE TABLE filmes (
    cod_filme   char(5),
    titulo      varchar(40),
    did         integer,
    data_prod   date,
    tipo        varchar(10),
    duracao     interval hour to minute,
    CONSTRAINT  pk_filmes PRIMARY KEY(cod_filme,titulo)
);

Definir a restrição de chave primária para a tabela distribuidores. Os dois exemplos abaixo são equivalentes, o primeiro utiliza a sintaxe de restrição de tabela, e o segundo utiliza a sintaxe de restrição de coluna.

CREATE TABLE distribuidores (
    did     integer,
    nome    varchar(40),
    PRIMARY KEY(did)
);

CREATE TABLE distribuidores (
    did     integer PRIMARY KEY,
    nome    varchar(40)
);

O comando abaixo atribui uma constante literal como valor padrão para a coluna nome, faz o valor padrão da coluna did ser gerado pela seleção do próximo valor de um objeto de seqüência, e faz o valor padrão da coluna data_mod ser o momento em que a linha foi inserida.

CREATE TABLE distribuidores (
    nome      varchar(40) DEFAULT 'Luso Filmes',
    did       integer DEFAULT nextval('seq_distribuidores'),
    data_mod  timestamp DEFAULT current_timestamp
);

Definir duas restrições de coluna NOT NULL na tabela distribuidores, sendo que uma delas recebe um nome fornecido:

CREATE TABLE distribuidores (
    did     integer CONSTRAINT nao_nulo NOT NULL,
    nome    varchar(40) NOT NULL
);

Definir uma restrição de unicidade para a coluna nome:

CREATE TABLE distribuidores (
    did     integer,
    nome    varchar(40) UNIQUE
);

O comando acima é equivalente ao mostrado abaixo, especificado como uma restrição de tabela:

CREATE TABLE distribuidores (
    did     integer,
    nome    varchar(40),
    UNIQUE(nome)
);

Compatibilidade

O comando CREATE TABLE está em conformidade com o SQL-92 e com um subconjunto do SQL:1999, com as exceções listadas abaixo.

Veja também

ALTER TABLE , DROP TABLE