Comment renommer une table dans PostgreSQL

Pour renommer une table dans PostgreSQL, on utilise l’instruction ALTER TABLE suivie de la clause RENAME TO.

Avant de continuer ta lecture, je voulais juste te parler de notre interface graphique PostgreSQL open source, Beekeeper Studio. Tu peux renommer un tableau d’un simple clic droit dans la barre latérale, et c’est gratuit pour PostgreSQL : télécharge-le ici.

Syntaxe

ALTER TABLE old_table_name RENAME TO new_table_name;

Exemple

Imaginons que tu as une table nommée customers et que tu veux la renommer en clients. La commande SQL serait :

ALTER TABLE customers RENAME TO clients;

Après avoir exécuté la commande ci-dessus, la table customers sera renommée en clients. Tu peux vérifier le changement de nom en interrogeant information_schema ou simplement en listant toutes les tables avec \d :

SELECT table_name 
FROM information_schema.tables 
WHERE table_schema = 'public';

Résultat attendu :

table_name 
--------------
clients
other_table

Renommer des tables avec des dépendances

Quand tu renommes une table, il est important de tenir compte des dépendances existantes, comme les clés étrangères, les index ou les triggers. PostgreSQL devrait les gérer automatiquement en mettant à jour les références vers la table renommée.

Exemple avec une clé étrangère

Supposons que la table orders possède une clé étrangère qui référence la table customers :

CREATE TABLE orders (
    order_id SERIAL PRIMARY KEY,
    customer_id INT REFERENCES customers(customer_id)
);

Quand tu renommes customers en clients, PostgreSQL met automatiquement à jour la référence de la clé étrangère :

ALTER TABLE customers RENAME TO clients;

Vérification

Pour t’assurer que la clé étrangère fonctionne toujours, tu peux exécuter une simple instruction INSERT :

INSERT INTO clients (customer_id) VALUES (1);

INSERT INTO orders (customer_id) VALUES (1);

Si la référence de la clé étrangère n’avait pas été mise à jour, le second INSERT échouerait. S’il réussit, c’est que PostgreSQL a bien mis à jour la référence.

Renommer une table dans un schéma

Si ta table se trouve dans un schéma précis, tu dois inclure le schéma dans la commande ALTER TABLE.

Exemple

Prenons une table sales.customers dans le schéma sales :

ALTER TABLE sales.customers RENAME TO clients;

La table sales.customers s’appelle désormais sales.clients. Tu peux le vérifier en listant les tables du schéma sales :

SELECT table_name 
FROM information_schema.tables 
WHERE table_schema = 'sales';

Résultat attendu

table_name
-----------
clients
other_table

Avec Beekeeper Studio

Renommer une table dans Beekeeper Studio, c’est tout simple :

1. Connecte-toi à ta base de données PostgreSQL avec Beekeeper Studio.
2. Dans le panneau de gauche, déplie le schéma qui contient la table pour voir la liste des tables.
3. Fais un clic droit sur la table à renommer et choisis l’option rename table.
4. Saisis le nouveau nom de la table et appuie sur Entrée.

Beekeeper Studio s’occupe du reste en envoyant la commande SQL appropriée à ta base de données PostgreSQL.

Points d’attention et bonnes pratiques

• Noms des index et des contraintes : si PostgreSQL met automatiquement à jour les dépendances comme les clés étrangères, il ne renomme pas les index ni les contraintes. Si leurs noms contiennent l’ancien nom de la table, tu devras peut-être les renommer à la main.

• Permissions : renommer une table ne modifie pas ses permissions. Les utilisateurs qui avaient accès à l’ancienne table auront le même accès à la table renommée.

• Dépendances des vues : si des vues dépendent de la table, elles continueront de fonctionner après le changement de nom, mais tu voudras peut-être les revoir et les mettre à jour par souci de clarté.

Conclusion

Renommer des tables dans PostgreSQL est une opération simple mais importante. Que tu travailles avec des tables dans différents schémas ou avec des dépendances, PostgreSQL gère le processus en douceur et s’assure que toutes les références sont correctement mises à jour. En suivant les bonnes pratiques et en comprenant le fonctionnement du renommage, tu préserves l’intégrité et l’organisation de ta base de données.

D’autres articles qui pourraient te plaire :

• Comment renommer une colonne dans PostgreSQL
• Comment utiliser les procédures stockées dans PostgreSQL