Bagaimana cara menyelesaikan kode kesalahan 1060 di SQL Server? (Langkah demi langkah)

Diterbitkan: 2025-08-07

Jika Anda bekerja di SQL Server dan melihat kesalahan yang mengatakan sesuatu seperti:
“Kesalahan 1060: nama kolom duplikat” jangan panik. Itu terlihat serius, tapi itu kesalahan umum.

Ini biasanya muncul ketika Anda mencoba mengubah tabel dengan menambahkan kolom baru, tetapi nama kolom sudah ada. Mungkin Anda tidak menyadarinya di sana. Mungkin naskahnya berlari dua kali. Either way, SQL Server hanya memberi tahu Anda, "Hei, kolom ini sudah ada, saya tidak bisa menambahkannya lagi."

Mari kita hancurkan dengan cara yang sederhana sehingga Anda dapat memperbaikinya dengan cepat dan menghindarinya nanti.

Apa arti kode kesalahan SQL Server 1060?

Apa arti kode kesalahan SQL Server 1060

Kesalahan 1060 berarti SQL Server memblokir Anda dari menambahkan kolom dengan nama yang sudah ada di tabel.

Ini disebut kesalahan "duplikat nama kolom" . Katakanlah tabel Anda sudah memiliki kolom bernama user_email . Jika Anda mencoba menambahkan kolom lain dengan nama yang sama menggunakan ALTER TABLE , SQL Server melempar kesalahan 1060 untuk menghentikan duplikasi.

Itu bukan bug. Ini hanya cara SQL untuk melindungi struktur basis data Anda.

Alasan Umum Mengapa SQL Server Menampilkan Kode Kesalahan 1060

Kesalahan ini biasanya muncul saat Anda mengerjakan desain atau skrip yang berjalan di meja. Tidak masalah jika Anda melakukannya di SQL Server Management Studio (SSMS) atau file skrip - ini tentang bagaimana perintah tersebut ditulis.

Berikut adalah situasi sehari -hari di mana kesalahan 1060 muncul:

Anda mencoba menambahkan kolom yang sudah ada
Anda menjalankan skrip yang sama dua kali tanpa memeriksa kolom
Anda menyalin skrip dari pengembang lain yang menambahkan bidang duplikat
Anda memulihkan database dan menjalankan pembaruan konflik itu
Anda menggunakan alat otomatisasi yang menerapkan perubahan skema yang sama lebih dari sekali
Anda mengedit meja besar dan kehilangan jejak nama kolom
Anda memigrasi aplikasi lama dan mencoba menyinkronkan kolom baru

Sangat mudah untuk bertemu, terutama pada proyek bersama atau perubahan skema yang signifikan.

Bagaimana cara memperbaiki kode kesalahan SQL Server 1060?

Kesalahan ini terlihat menakutkan pada awalnya, tetapi biasanya sangat mudah diperbaiki. Anda hanya mencoba menambahkan kolom yang sudah ada di tabel. Jadi kuncinya adalah menghindari duplikasi atau menanganinya dengan aman .

Coba perbaikan ini satu per satu. Sebagian besar waktu, memperbaiki #1 atau Fix #2 akan segera menyelesaikannya.

Perbaiki #1: Periksa apakah kolom sudah ada

Sebelum Anda mencoba menambahkan kolom baru, pertama -tama periksa tabel untuk melihat apakah kolom itu sudah ada.

Anda dapat menggunakan kueri SQL ini:

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

Ini akan menampilkan semua kolom di dalam tabel. Jika kolom yang Anda coba tambahkan sudah terdaftar, itulah masalah Anda. Anda tidak perlu menambahkannya lagi - menghapus bagian itu dari skrip Anda. Ini adalah langkah pertama yang paling aman.

Perbaiki #2: Gunakan `IF NOT EXISTS` dalam pernyataan alter Anda

SQL Server tidak mengizinkan logika yang tepat IF NOT EXISTS di dalam ALTER TABLE secara langsung, tetapi Anda dapat membungkus perintah alter Anda di dalam blok IF ini:

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

Ini memeriksa dulu. Jika kolom tidak ada, itu menambahkannya. Jika sudah ada di sana, ia melewatkan perintah, tidak ada kesalahan. Ini adalah perbaikan terbaik untuk sebagian besar skrip yang mungkin berjalan lebih dari sekali.

Perbaiki #3: Tinjau dan bersihkan skrip SQL Anda

Terkadang masalahnya tidak ada dalam kode Anda - berapa kali kode berjalan. Jika Anda bekerja dengan skrip SQL panjang atau file migrasi, periksa perintah ALTER TABLE berulang. Mungkin kolom yang sama ditambahkan lebih dari sekali secara tidak sengaja.

Juga, jika Anda menyalin bagian dari skrip dari sumber lain, periksa ganda bahwa itu tidak berisi perintah duplikat untuk tabel yang sama. Langkah pembersihan ini sangat membantu ketika mengelola banyak perubahan.

Fix #4: Ganti nama atau letakkan kolom duplikat (jika diperlukan)

Jika kolom sudah ada tetapi tidak lagi diperlukan atau memiliki nama yang salah, Anda mungkin ingin menjatuhkannya atau mengganti nama sebelum menambahkan yang baru.

Untuk menjatuhkan kolom:

ALTER TABLE your_table_name
DROP COLUMN your_column_name

Untuk mengganti nama kolom (SQL Server 2016+):

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

PERINGATAN: Kolom menjatuhkan atau mengganti nama dapat merusak aplikasi Anda jika kolom sedang digunakan di tempat lain. Hanya gunakan ini jika Anda yakin kolom aman untuk dihapus atau diubah.

Perbaiki #5: Gunakan SQL Server Management Studio (SSMS) untuk memeriksa skema

Terkadang, itu membantu melihat sesuatu secara visual. Buka SSM, sambungkan ke database Anda, dan perluas tabel. Anda akan melihat semua nama kolom yang terdaftar. Ini membuatnya lebih mudah untuk dikenali jika kolom sudah ada atau ditambahkan dengan ejaan yang berbeda.

Setelah dikonfirmasi, Anda dapat kembali ke skrip Anda dan dengan aman mengedit atau melewatkan kolom itu. SSM sangat bagus untuk memeriksa ganda sebelum melakukan perubahan, terutama jika Anda tidak yakin.

Praktik Terbaik Untuk Menghindari Kode Kesalahan SQL Server 1060

Kesalahan ini standar, tetapi juga mudah dihindari begitu Anda tahu cara menanganinya. Berikut adalah beberapa tips yang dapat menyelamatkan Anda dari memukulnya lagi di masa depan:

Selalu periksa apakah kolom sudah ada sebelum menambahkannya
Gunakan IF NOT EXISTS logika dalam skrip Anda (saat didukung)
Tetap menempel pada penamaan kolom yang jelas dan konsisten
Jangan menjalankan tabel alter yang sama lebih dari sekali kecuali diperlukan
Simpan catatan perubahan skema dalam log perubahan atau kontrol versi
Uji skrip baru pada database pementasan sebelum ditayangkan
Gunakan alat seperti SSM untuk memeriksa kolom tabel secara visual
Hindari SQL Copy-Pasting tanpa mengetahui apa yang dilakukannya

Kebiasaan kecil ini dapat membantu Anda menulis skrip yang lebih bersih dan menghindari masalah seperti kesalahan 1060.

Kesimpulan

Kesalahan SQL Server 1060 mungkin terlihat membingungkan, tetapi itu berarti Anda mencoba menambahkan kolom yang sudah ada. SQL hanya melakukan tugasnya untuk melindungi struktur meja Anda.

Perbaikan biasanya sederhana: Periksa daftar kolom Anda, sesuaikan skrip, atau tambahkan kondisi untuk mencegah duplikat. Setelah Anda memahami apa yang menyebabkannya, mudah dihindari di masa depan.

Kesalahan semacam ini khas dalam pekerjaan SQL. Semakin banyak Anda berlatih dan menguji skrip Anda, semakin mudah didapat.