4D Doc Center : ALTER TABLE

4D v13.4

ALTER TABLE



	Commande ALTER TABLE ALTER TABLE nom_sql {ADD definição_coluna [PRIMARY KEY] [TRAILING] \| DROP nom_sql \| ADD definição_chave_primária \| DROP PRIMARY KEY \| ADD definição_chave_externa \| DROP CONSTRAINT nom_sql \| [{ENABLE \| DISABLE} REPLICATE] \| [{ENABLE \| DISABLE} AUTO_INCREMENT] \| [{ENABLE \| DISABLE} AUTO_GENERATE] \| SET SCHEMA nom_sql}

Descrição

O comando ALTER TABLE se utiliza para modificar uma tabela existente (nom_sql). Pode realizar uma das seguintes ações:
Passar ADD definição_coluna adiciona uma coluna a tabela. A palavra chave PRIMARY KEY se utiliza para definir a chave primária quando é adicionada uma coluna. A palavra chave TRAILING força a criação da coluna a criar logo da última coluna existente da tabela no arquivo de estrutura. Esta opção é útil quando as colunas que contém dados foram eliminados da tabela (sem que os dados tenham sido apagados), para evitar que os dados existentes sejam atribuídos a nova coluna.
Passar DROP nom_sql elimina a coluna nom_sql da tabela.
Passar ADD definição_chave_primária adiciona uma chave primária (PRIMARY KEY) a tabela.
Passar DROP PRIMARY KEY elimina a chave primária (PRIMARY KEY) da tabela.
Passar ADD definição_chave_externa adiciona uma chave externa (FOREIGN KEY) a tabela.
Passar DROP CONSTRAINT nom_sql elimina a restrição especificada por nom_sql da tabela.
Passar ENABLE REPLICATE ou DISABLE REPLICATE ativa ou desativa o mecanismo que permite a replicação da tabela (ver a seção Replicação via SQL ).
Passar ENABLE AUTO_INCREMENT ou DISABLE AUTO_INCREMENT ativa ou desativa a opção "Auto incrementar" para os campos de tipo inteiro longo.
Passar ENABLE AUTO_GENERATE ou DISABLE AUTO_GENERATE ativa ou desativa a opção "Auto UUID" dos campos Alfa de tipo UUID.
Passar SET SCHEMA nom_sql transfere a tabela ao esquema nom_sql.

Exemplo

Este exemplo cria uma tabela, insere um conjunto de valores nela, depois adiciona uma coluna Num_Tel, insere outro conjunto de valores e depois elimina a coluna ID:

CREATE TABLE ACTOR_FANS
(ID INT32, Nom VARCHAR);

INSERT INTO ACTOR_FANS
(ID, Nom)
VALUES(1, 'Francis');

ALTER TABLE ACTOR_FANS
ADD Num_Tel VARCHAR;

INSERT INTO ACTOR_FANS
(ID, Nom, Num_Tel)
VALUES (2, 'Florence', '01446677888');

ALTER TABLE ACTOR_FANS
DROP ID;