4D Doc Center : ALTER TABLE

4D v14

ALTER TABLE



	Commande ALTER TABLE ALTER TABLE nom_sql {ADD définition_colonne [PRIMARY KEY] [TRAILING] \| DROP nom_sql \| ADD définition_clé_primaire \| DROP PRIMARY KEY \| ADD définition_clé_étrangère \| DROP CONSTRAINT nom_sql \| [{ENABLE \| DISABLE} REPLICATE] \| [{ENABLE \| DISABLE} LOG] \| [{ENABLE \| DISABLE} AUTO_INCREMENT] \| [{ENABLE \| DISABLE} AUTO_GENERATE] \| SET SCHEMA nom_sql}

Description

La commande ALTER TABLE permet de modifier la table existante désignée par l'argument nom_sql. Vous pouvez effectuer l'une des actions suivantes :
Passer ADD définition_colonne ajoute une colonne à la table. Le mot-clé PRIMARY KEY permet de définir la clé primaire au moment de l’ajout de la colonne.
Le mot-clé TRAILING force la création de la colonne après la dernière colonne existante de la table dans le fichier de structure. Cette option est utile dans le cas où des colonnes comportant des données ont été supprimées dans la table (sans que les données aient été effacées), afin d’éviter que les données existantes soient réaffectées à la nouvelle colonne.
Passer DROP nom_sql supprime la colonne nom_sql de la table.
Passer ADD définition_clé_primaire ajoute une clé primaire (PRIMARY KEY) à la table.
Passer DROP PRIMARY KEY supprime la clé primaire (PRIMARY KEY) de la table.
Passer ADD définition_clé_étrangère ajoute une clé étrangère (FOREIGN KEY) à la table.
Passer DROP CONSTRAINT nom_sql supprime la contrainte spécifiée par nom_sql de la table.
Passer ENABLE REPLICATE ou DISABLE REPLICATE permet d’activer et d’inactiver le mécanisme autorisant la réplication de la table (cf. section Réplication via le SQL).
Passer ENABLE LOG ou DISABLE LOG permet d’activer et d’inactiver la journalisation de la table.
Passer ENABLE AUTO_INCREMENT ou DISABLE AUTO_INCREMENT permet d’activer et d’inactiver l’option "Incrémentation auto" des champs de type entier long.
Passer ENABLE AUTO_GENERATE ou DISABLE AUTO_GENERATE permet d’activer et d’inactiver l’option "UUID auto" des champs alpha de type UUID.

Passer SET SCHEMA nom_sql transfère la table vers le schéma nom_sql.

La commande retourne une erreur :

lorsque le paramètre optionnel ENABLE LOG est passé et qu’aucune clé primaire valide n’est définie,
si vous tentez de modifier ou de supprimer la définition de clé primaire de la table sans désactiver la journalisation via DISABLE LOG.

Exemple

Cet exemple crée une table, y insère un ensemble de valeurs, puis ajoute une colonne Num_Tel, insère un autre ensemble de valeurs puis supprime la colonne ID :

CREATE TABLE ACTEUR_FANS
(ID INT32, Nom VARCHAR);

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

ALTER TABLE ACTEUR_FANS
ADD Num_Tel VARCHAR;

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

ALTER TABLE ACTEUR_FANS
DROP ID;