Comment résoudre le code d'erreur 1060 dans SQL Server? (Étape par étape)

Publié: 2025-08-07

Si vous travaillez dans SQL Server et voyez une erreur qui dit quelque chose comme:
«Erreur 1060: nom de colonne en double» ne paniquez pas. Cela a l'air sérieux, mais c'est une erreur courante.

Cela apparaît généralement lorsque vous essayez de changer une table en ajoutant une nouvelle colonne, mais le nom de la colonne existe déjà. Peut-être que vous n'avez pas remarqué que c'était là. Peut-être que le script a fonctionné deux fois. Quoi qu'il en soit, SQL Server ne fait que vous faire savoir: "Hé, cette colonne existe déjà, je ne peux pas l'ajouter à nouveau."

Décomposons-le de manière simple afin que vous puissiez le réparer rapidement et l'éviter plus tard.

Que signifie le code d'erreur SQL Server 1060?

Que signifie le code d'erreur SQL Server 1060

L'erreur 1060 signifie que SQL Server vous empêche d'ajouter une colonne avec un nom déjà dans le tableau.

Il s'appelle une erreur de «nom de colonne en double» . Disons que votre table a déjà une colonne nommée user_email . Si vous essayez d'ajouter une autre colonne avec le même nom à l'aide ALTER TABLE , SQL Server lance l'erreur 1060 pour arrêter la duplication.

Ce n'est pas un bug. C'est juste la façon de protéger SQL de protéger votre structure de base de données.

Raisons courantes pour lesquelles SQL Server affiche le code d'erreur 1060

Cette erreur apparaît généralement lorsque vous travaillez sur la conception de la table ou l'exécution de scripts. Peu importe que vous le fassiez dans SQL Server Management Studio (SSMS) ou dans un fichier de script - il s'agit de la façon dont la commande est écrite.

Voici des situations quotidiennes où l'erreur 1060 apparaît:

  • Vous essayez d' ajouter une colonne qui existe déjà
  • Vous exécutez le même script deux fois sans vérifier la colonne
  • Vous copiez un script d'un autre développeur qui ajoute un champ en double
  • Vous restaurez une base de données et exécutez des mises à jour qui sont confrontées à un conflit
  • Vous utilisez des outils d'automatisation qui appliquent le même changement de schéma plus d'une fois
  • Vous modifiez de grandes tables et perdez la trace des noms de colonne
  • Vous migrez une ancienne application et essayez de synchroniser de nouvelles colonnes

Il est facile de rencontrer, en particulier sur des projets partagés ou des changements de schéma importants.

Comment corriger le code d'erreur SQL Server 1060?

Cette erreur semble effrayante au début, mais elle est généralement très facile à réparer. Vous essayez simplement d'ajouter une colonne qui existe déjà dans le tableau. La clé consiste donc à éviter la duplication ou à la gérer en toute sécurité .

Essayez ces correctifs un par un. La plupart du temps, Fix # 1 ou Fix # 2 le résoudra immédiatement.

Correction n ° 1: Vérifiez si la colonne existe déjà

Avant d'essayer d'ajouter une nouvelle colonne, vérifiez d'abord la table pour voir si cette colonne est déjà là.

Vous pouvez utiliser cette requête SQL:

SELECT COLUMN_NAME
FROM INFORMATION_SCHEMA.COLUMNS
WHERE TABLE_NAME = 'your_table_name'

Cela montrera toutes les colonnes à l'intérieur de la table. Si la colonne que vous essayez d'ajouter est déjà répertoriée, c'est votre problème. Vous n'avez pas besoin de l'ajouter à nouveau - supprimez cette partie de votre script. Ceci est la première étape la plus sûre.

Correction # 2: Utiliser IF NOT EXISTS dans votre déclaration alter

SQL Server n'autorise pas directement la logique à l'intérieur IF NOT EXISTS ALTER TABLE , mais vous pouvez envelopper votre commande alter à l'intérieur d'un bloc IF comme ceci:

IF NOT EXISTS (
SELECT * FROM INFORMATION_SCHEMA.COLUMNS
WHERE TABLE_NAME = 'your_table_name'
AND COLUMN_NAME = 'your_column_name'
)
BEGIN
ALTER TABLE your_table_name
ADD your_column_name VARCHAR(255)
END

Cela vérifie d'abord. Si la colonne n'est pas là, cela l'ajoute. S'il est déjà là, il saute la commande, aucune erreur. C'est le meilleur correctif pour la plupart des scripts qui pourraient fonctionner plus d'une fois.

Correction n ° 3: examinez et nettoyez vos scripts SQL

Parfois, le problème n'est pas dans votre code - c'est dans combien de fois ce code s'exécute. Si vous travaillez avec de longs scripts SQL ou des fichiers de migration, vérifiez les commandes ALTER TABLE répétées. Peut-être que la même colonne est ajoutée plus d'une fois par accident.

De plus, si vous avez copié une partie d'un script d'une autre source, vérifiez qu'il ne contient pas de commandes en double pour la même table. Cette étape de nettoyage est particulièrement utile lors de la gestion de plusieurs changements.

Correction # 4: renommer ou supprimer la colonne en double (si nécessaire)

Si la colonne existe déjà mais n'est plus nécessaire ou a le mauvais nom, vous voudrez peut-être le laisser tomber ou le renommer avant d'en ajouter un nouveau.

Pour laisser tomber une colonne:

ALTER TABLE your_table_name
DROP COLUMN your_column_name

Pour renommer une colonne (SQL Server 2016+):

EXEC sp_rename 'your_table_name.old_column_name', 'new_column_name', 'COLUMN'

AVERTISSEMENT: Les colonnes abandonnées ou renommées peuvent casser votre application si la colonne est utilisée ailleurs. Utilisez-le uniquement si vous êtes sûr que la colonne est sûre à supprimer ou à modifier.

Correction # 5: Utilisez SQL Server Management Studio (SSMS) pour vérifier le schéma

Parfois, cela aide à voir les choses visuellement. Ouvrez les SSM, connectez-vous à votre base de données et développez le tableau. Vous verrez tous les noms de colonne répertoriés. Cela facilite le repérer si la colonne est déjà là ou a été ajoutée avec une orthographe différente.

Une fois confirmé, vous pouvez revenir à votre script et modifier ou sauter en toute sécurité cette colonne. SSMS est idéal pour le double rechange avant d'apporter des modifications, surtout si vous n'êtes pas sûr.

Meilleures pratiques pour éviter le code d'erreur SQL Server 1060

Cette erreur est standard, mais il est également facile d'éviter une fois que vous savez comment le gérer. Voici quelques conseils qui peuvent vous éviter de le frapper à nouveau à l'avenir:

  • Vérifiez toujours si la colonne existe déjà avant de l'ajouter
  • Utiliser IF NOT EXISTS de logique dans vos scripts (lorsqu'il est pris en charge)
  • Tenez-vous à la dénomination de colonne claire et cohérente
  • Ne pas exécuter la même table alter plus d'une fois sauf si nécessaire
  • Gardez un enregistrement des modifications du schéma dans un journal de modification ou un contrôle de version
  • Testez de nouveaux scripts sur une base de données de mise en scène avant de passer en direct
  • Utilisez des outils comme SSMS pour vérifier visuellement les colonnes de table
  • Évitez le SQL de copie sans savoir ce qu'il fait

Ces petites habitudes peuvent vous aider à écrire des scripts plus propres et à éviter des problèmes comme l'erreur 1060.

Conclusion

L'erreur SQL Server 1060 peut sembler déroutante, mais cela signifie simplement que vous avez essayé d'ajouter une colonne qui existe déjà. SQL fait simplement son travail pour protéger votre structure de table.

Le correctif est généralement simple: vérifiez votre liste de colonnes, ajustez le script ou ajoutez une condition pour éviter les doublons. Une fois que vous comprenez ce qui l'a causé, il est facile d'éviter à l'avenir.

Ce type d'erreur est typique dans le travail SQL. Plus vous pratiquez et testez vos scripts, plus il est facile.