PostgreSQL ALTER TABLE : Ajouter et renommer une colonne

Par : Saule genévrier Saule genévrier
Hours Le kit de préparation mis à jour

⚡ Résumé intelligent

PostgreSQL La commande ALTER TABLE modifie la structure d'une table existante, vous permettant d'ajouter ou de supprimer des colonnes, de renommer une colonne ou la table entière, de définir des valeurs par défaut et d'attacher des contraintes de vérification sans recréer l'objet.

  • 🧱 syntaxe: L'action ALTER TABLE nom-de-table effectue une modification structurelle par instruction.
  • ➕ Ajouter une colonne : L'instruction ADD nom-de-colonne type-de-données ajoute une nouvelle colonne au tableau.
  • ️ Renommer: RENAME COLUMN et RENAME TO permettent de modifier le nom d'une colonne ou le nom d'une table.
  • ⚙️ Valeur par défaut: La commande ALTER COLUMN SET DEFAULT fournit une valeur pour les futures lignes INSERT.
  • 🛡️ Vérifier la contrainte : L'option AJOUTER UNE VÉRIFICATION valide les nouvelles données et rejette les valeurs qui ne respectent pas la règle.
  • 🤖 Migrations IA : Les assistants IA rédigent les scripts ALTER TABLE et les vérifient pour un déploiement sûr.
En savoir plus

PostgreSQL ALTER TABLE

Qu'est-ce que ALTER TABLE dans PostgreSQL?

Le ALTER TABLE Cette commande permet de modifier la structure d'un PostgreSQL table. C'est la commande utilisée pour modifier les colonnes ou le nom d'une table, sans la supprimer.ping et recréer l'objet.

Syntaxe

Voici la syntaxe du PostgreSQL Commande ALTER TABLE :

ALTER TABLE table-name action;

Le paramètre « nom_table » correspond au nom de la table à modifier. Le paramètre « action » correspond à l’action à effectuer, comme par exemple modifier le nom ou le type de données d’une colonne.

Description

La commande ALTER TABLE modifie la définition d'une table existante. Il prend les sous-formulaires suivants :

  • AJOUTER UNE COLONNE: cette commande utilise une syntaxe similaire à celle de la commande CREATE TABLE pour ajouter une nouvelle colonne à une table.
  • COLONNE DE DÉPOSE: pour la chuteping une colonne de table. Les contraintes et les index imposés aux colonnes seront également supprimés.
  • Définir/supprimer la valeur par défautPermet de définir ou de supprimer la valeur par défaut d'une colonne. La modification ne s'applique qu'aux opérations suivantes. INSÉRER les instructions.
  • SET/DROP NON NULL: modifie si une colonne autorise ou non les valeurs nulles.
  • STATISTIQUES DE L'ENSEMBLE: pour définir la cible de collecte de statistiques pour chaque colonne pour les opérations ANALYZE.
  • STOCKAGE DES ENSEMBLES: pour définir le mode de stockage d'une colonne, qu'elle soit en ligne ou dans une table supplémentaire.
  • ENSEMBLE SANS OIDES: utilisé pour supprimer l'ancienne colonne OID de la table.
  • RENOMMER: pour changer le nom de la table ou le nom d'une colonne.
  • AJOUTER table_constraint: utilisé pour ajouter une nouvelle contrainte à une table. Il utilise la même syntaxe que le CREER LA TABLE commander.
  • CONTRAINTE DE CHUTE: utilisé pour la chuteping une contrainte de table.
  • PROPRIÉTAIRE: pour changer le propriétaire d'une table, d'une séquence, d'un index ou d'une vue pour un utilisateur spécifique.
  • CLUSTER: pour marquer une table à utiliser pour de futures opérations de cluster.

Modification d'une colonne

Une colonne peut être modifiée de plusieurs manières. Ces modifications s'effectuent à l'aide de la commande ALTER TABLE. Examinons-les ci-dessous.

Ajout d'une nouvelle colonne

Pour ajouter une nouvelle colonne à un PostgreSQL table, la commande ALTER TABLE est utilisée avec la syntaxe suivante :

ALTER TABLE table-name
  ADD new-column-name column-definition;

Le nom de la table est le nom de la table à modifier. Le nom de la nouvelle colonne est le nom de la nouvelle colonne à ajouter. La définition de la colonne est la définition de la colonne. Type de données de la nouvelle colonne. Voir le tableau Livre ci-dessous :

PostgreSQL Exemple de ALTER TABLE

Le tableau comporte deux colonnes : « id » et « name ». Nous devons ajouter une nouvelle colonne au tableau et la nommer « author ». Il suffit d’exécuter la commande suivante :

ALTER TABLE Book
  ADD author VARCHAR(50);

Après avoir exécuté la commande ci-dessus, la table Book se présente désormais comme suit :

PostgreSQL Exemple de ALTER TABLE

La nouvelle colonne a été ajoutée avec succès.

Renommer une colonne de tableau

Nous pouvons utiliser la commande ALTER TABLE pour changer le nom d'une colonne. Dans ce cas, la commande est utilisée avec la syntaxe suivante :

ALTER TABLE table-name
  RENAME COLUMN old-name TO new-name;

Le nom de la table est le nom de la table dont la colonne doit être renommée. L'ancien nom est le nom actuel de la colonne, et le nouveau nom est son nouveau nom. Prenons l'exemple de la table Book ci-dessous :

Livre:

PostgreSQL Exemple de ALTER TABLE

Nous devons renommer la colonne « auteur » en « auteur_du_livre ». Voici la commande :

ALTER TABLE Book
  RENAME COLUMN author TO book_author;

Après avoir exécuté la commande, nous pouvons visualiser la structure de la table :

PostgreSQL Exemple de ALTER TABLE

Le nom de la colonne a été modifié avec succès.

ARTICLES LIÉS

Définition d'une valeur par défaut pour une colonne

Il est possible de définir une valeur par défaut pour une colonne. Ainsi, même si aucune valeur n'est spécifiée lors des opérations d'insertion, la valeur par défaut sera utilisée. Dans ce cas, la commande ALTER TABLE peut être utilisée avec la syntaxe suivante :

ALTER TABLE table-name ALTER COLUMN column-name [SET DEFAULT value];

Le nom de la table correspond à la table dont la colonne doit être modifiée. Le nom de la colonne correspond à la colonne dont la valeur par défaut doit être définie, et la valeur correspond à la valeur par défaut de cette colonne. Prenons l'exemple de la table Book ci-dessous :

PostgreSQL Exemple de ALTER TABLE

Nous devons définir une valeur par défaut pour la colonne book_author. Nous pouvons exécuter la commande suivante :

ALTER TABLE Book ALTER COLUMN book_author SET DEFAULT 'Nicholas Samuel';

Maintenant, insérons une ligne dans le tableau :

INSERT INTO Book (id, name)
 VALUES (6, 'PostgreSQL for Beginners');

Veuillez noter que nous n'avons renseigné que deux colonnes : « id » et « name ». Cependant, la valeur par défaut a été utilisée pour la colonne « book_author ».

PostgreSQL Exemple de ALTER TABLE

Ajout d'une contrainte de vérification

Une contrainte de vérification permet de valider les enregistrements insérés dans une table. Nous pouvons le faire en combinant la commande ALTER TABLE avec l'instruction ADD CHECK. Syntaxe:

ALTER TABLE table-name ADD CHECK expression;

Le nom de la table est celui de la table à modifier, et l'expression est la contrainte à imposer à la colonne de cette table. Modifions la colonne book_author de la table Book afin qu'elle n'accepte que les valeurs Nicholas et Samuel :

ALTER TABLE Book ADD CHECK (book_author IN ('Nicholas', 'Samuel'));

Essayons maintenant d'insérer une valeur autre que Nicholas ou Samuel dans la colonne book_author de la table Book :

INSERT INTO Book
VALUES(7, 'Meilleur PostgreSQL Book', 'Gregory Bush');

L'instruction renverra l'erreur suivante :

PostgreSQL Exemple de ALTER TABLE

L'opération d'insertion a échoué car nous avons violé la contrainte de vérification.

Renommer une table

Voici la syntaxe de la commande ALTER TABLE pour renommer une table :

ALTER TABLE table-name
  RENAME TO new-table-name;

Le nom actuel de la table est indiqué, et le nouveau nom de la table est le nouveau nom qui lui sera attribué. Par exemple, changeons le nom de la table « Book » en « Books » :

ALTER TABLE Book
  RENAME TO Books;

Utiliser pgAdmin

Jusqu'à présent, les actions ont été exécutées depuis l'interface SQL. Voyons maintenant comment réaliser ces mêmes actions visuellement à l'aide de pgAdmin.

Ajout d'une nouvelle colonne

Étape 1) Connectez-vous à votre compte pgAdmin.

Étape 2)

  1. Dans la barre de navigation de gauche, cliquez sur Bases de données.
  2. Cliquez sur Démo.

PostgreSQL Exemple de ALTER TABLE

Étape 3) Tapez la requête dans l'éditeur de requêtes :

ALTER TABLE Book
  ADD author VARCHAR(50);

Étape 4) Cliquez sur le bouton Exécuter.

PostgreSQL Exemple de ALTER TABLE

Étape 5) Pour vérifier si la colonne a été ajoutée, procédez comme suit :

  1. Cliquez sur Bases de données dans la navigation de gauche.
  2. Développez Démo.
  3. Développez les schémas.
  4. Développez Public.
  5. Développez les tableaux.
  6. Développez le livre.
  7. Développez les colonnes.

PostgreSQL Exemple de ALTER TABLE

La colonne aurait dû être ajoutée, comme indiqué ci-dessous :

PostgreSQL Exemple de ALTER TABLE

Renommer une colonne de tableau

Étape 1) Connectez-vous à votre compte pgAdmin.

Étape 2)

  1. Dans la barre de navigation de gauche, cliquez sur Bases de données.
  2. Cliquez sur Démo.

PostgreSQL Exemple de ALTER TABLE

Étape 3) Tapez la requête dans l'éditeur de requêtes :

ALTER TABLE Book
  RENAME COLUMN author TO book_author;

Étape 4) Cliquez sur le bouton Exécuter.

PostgreSQL Exemple de ALTER TABLE

Étape 5) Pour vérifier si la modification a réussi, développez les colonnes du tableau des livres comme précédemment :

PostgreSQL Exemple de ALTER TABLE

Les colonnes devraient maintenant être les suivantes :

PostgreSQL Exemple de ALTER TABLE

La colonne a été modifiée avec succès.

Définition d'une valeur par défaut pour une colonne

Étape 1) Connectez-vous à votre compte pgAdmin.

Étape 2)

  1. Dans la barre de navigation de gauche, cliquez sur Bases de données.
  2. Cliquez sur Démo.

PostgreSQL Exemple de ALTER TABLE

Étape 3) Tapez la requête dans l'éditeur de requêtes :

ALTER TABLE Book ALTER COLUMN book_author SET DEFAULT 'Nicholas Samuel';

Étape 4) Cliquez sur le bouton Exécuter.

PostgreSQL Exemple de ALTER TABLE

Étape 5) Pour tester, exécutez la commande suivante dans l'éditeur de requêtes :

INSERT INTO Book (id, name)
 VALUES (6, 'PostgreSQL for Beginners')

Étape 6) Maintenant, nous pouvons interroger la table pour vérifier si la valeur par défaut a été insérée dans la colonne book_author :

PostgreSQL Exemple de ALTER TABLE

Ajout d'une contrainte de vérification

Étape 1) Connectez-vous à votre compte pgAdmin.

Étape 2)

  1. Dans la barre de navigation de gauche, cliquez sur Bases de données.
  2. Cliquez sur Démo.

PostgreSQL Exemple de ALTER TABLE

Étape 3) Tapez la requête dans l'éditeur de requêtes :

ALTER TABLE Book ADD CHECK (book_author IN ('Nicholas', 'Samuel'))

Étape 4) Cliquez sur le bouton Exécuter.

PostgreSQL Exemple de ALTER TABLE

Étape 5) Pour tester cela, saisissez la requête suivante dans l'éditeur de requêtes et cliquez sur le bouton Exécuter :

INSERT INTO Book
VALUES(7, 'Meilleur PostgreSQL Book', 'Gregory Bush');

PostgreSQL Exemple de ALTER TABLE

Il renverra ce qui suit :

PostgreSQL Exemple de ALTER TABLE

Renommer une table

Étape 1) Connectez-vous à votre compte pgAdmin.

Étape 2)

  1. Dans la barre de navigation de gauche, cliquez sur Bases de données.
  2. Cliquez sur Démo.

PostgreSQL Exemple de ALTER TABLE

Étape 3) Tapez la requête dans l'éditeur de requêtes :

ALTER TABLE Book
  RENAME TO Books;

Étape 4) Cliquez sur le bouton Exécuter.

PostgreSQL Exemple de ALTER TABLE

Étape 5) Pour vérifier si la table a été renommée, développez Bases de données > Démo > Schémas > Public > Tables :

PostgreSQL Exemple de ALTER TABLE

La table a été renommée avec succès.

Téléchargez la base de données utilisée dans ce tutoriel

FAQ

Utilisez la commande ALTER TABLE nom_table ALTER COLUMN nom_colonne TYPE nouveau_type. Ajoutez une clause USING lorsque les valeurs doivent être converties, par exemple : ALTER COLUMN prix TYPE numeric USING prix::numeric. PostgreSQL réécrit la colonne et vérifie que les données existantes correspondent au nouveau type.

Uniquement si la valeur par défaut est volatile. PostgreSQL 11. L'ajout d'une colonne avec une valeur par défaut constante met à jour le catalogue instantanément sans réécrire les lignes. Une valeur par défaut appelant une fonction entraîne toujours une réécriture complète de la table et un verrouillage plus strict.

Non. PostgreSQL Il est impossible de modifier une contrainte existante. Supprimez la contrainte existante avec DROP CONSTRAINT, puis ajoutez la contrainte corrigée avec ADD CONSTRAINT. Encadrez ces deux instructions dans une transaction afin que la table soit toujours soumise à la règle.

Énumérez plusieurs actions séparées par des virgules : ALTER TABLE Book ADD COLUMN price int, ADD COLUMN isbn text. PostgreSQL Applique chaque modification en une seule passe, ce qui est plus rapide et assure la cohérence du tableau.

Utilisez ALTER TABLE nom_table ADD PRIMARY KEY (colonne) ou ADD CONSTRAINT nom_clé_clé PRIMARY KEY (colonne). La colonne doit contenir des valeurs uniques et non nulles ; PostgreSQL crée automatiquement un index unique de support lors de la création de la clé.

La commande RENAME modifie uniquement le nom de la table dans le catalogue système. Les lignes, index et contraintes stockés restent inchangés. Les vues ou fonctions qui référencent l'ancien nom peuvent nécessiter une mise à jour ultérieure.

Les assistants IA génèrent des scripts ALTER TABLE à partir d'une modification décrite, ordonnent correctement les étapes ADD, RENAME et de contrainte, et ajoutent des clauses USING pour les conversions de type. Ils signalent également les opérations qui réécrivent de grandes tables ou qui activent des verrous importants.

Oui. Un copilote IA analyse une migration, signale les risques de verrouillage ou de réécriture complète de tables, suggère le traitement par lots ou la création simultanée d'index, et recommande l'encapsulation.ping modifications apportées à une transaction, ce qui rend les mises à jour de schéma plus sûres à déployer.

Résumez cet article avec :