Perintah .alter table

Beralih layanan menggunakan daftar drop-down Versi . Pelajari selengkapnya tentang navigasi.
Berlaku untuk: ✅ Microsoft Fabric ✅ Azure Data Explorer

Perintah .alter table:

  • Mengamankan data dalam kolom "dipertahankan"
  • Menyusun ulang kolom tabel
  • Menetapkan skema kolom, docstring, dan folder baru ke tabel yang sudah ada, menimpa skema kolom, docstring, dan folder yang sudah ada
  • Harus berjalan dalam konteks database tertentu yang mencakup nama tabel

Peringatan

Menggunakan perintah .alter dengan tidak benar dapat menyebabkan hilangnya data.

Izin

Anda harus memiliki setidaknya izin Admin Tabel untuk menjalankan perintah ini.

Sintaks

.alter table tableName(columnName:columnType [, ...]) [with( propertyName=propertyValue [, ...]])

Pelajari selengkapnya tentang konvensi sintaksis.

Parameter

Nama Tipe Wajib Deskripsi
tableName string ✔️ Nama tabel yang akan diubah.
columnName, columnType string ✔️ Nama kolom yang sudah ada atau baru dipetakan ke jenis data di kolom tersebut. Daftar pemetaan ini menentukan skema kolom output.
propertyName, propertyValue string Daftar pasangan properti kunci-nilai yang dipisahkan koma. Lihat properti yang didukung.

Peringatan

Kolom yang sudah ada yang tidak ditentukan dalam perintah akan dihilangkan. Ini dapat menyebabkan kehilangan data yang tidak terduga.

Tip

Gunakan .show table [tableName] cslschema untuk mendapatkan skema tabel yang ada sebelum Anda mengubahnya.

Properti yang didukung

Nama Tipe Deskripsi
docstring string Teks gratis yang menjelaskan entitas yang akan ditambahkan. String ini ditampilkan dalam berbagai pengaturan UX di samping nama entitas.
folder string Nama folder yang akan ditambahkan ke tabel.

Bagaimana perintah memengaruhi data

  • Data yang ada dalam kolom yang tercantum dalam perintah tidak akan dimodifikasi
  • Data yang ada dalam kolom yang tidak tercantum dalam perintah akan dihapus
  • Kolom baru akan ditambahkan ke akhir skema
  • Data dalam kolom baru diasumsikan null
  • Tabel akan memiliki kolom yang sama, dalam urutan yang sama, seperti yang ditentukan

Catatan

Jika Anda mencoba mengubah jenis kolom, perintah akan gagal. Gunakan .alter column sebagai gantinya.

Peringatan

  • Penyerapan data yang mengalihkan urutan kolom dan terjadi secara paralel dengan .alter table risiko menyerap data ke dalam kolom yang salah. Untuk mencegah hal ini, pastikan bahwa penyerapan menggunakan objek pemetaan atau hentikan penyerapan saat menjalankan .alter table perintah.
  • Penyerapan data dapat mengubah skema kolom tabel. Berhati-hatilah untuk tidak secara tidak sengaja menghapus kolom yang diinginkan yang ditambahkan selama penyerapan.

Contoh

.alter table MyTable (ColumnX:string, ColumnY:int) 
.alter table MyTable (ColumnX:string, ColumnY:int) with (docstring = "Some documentation", folder = "Folder1")

Konten terkait

  • Last updated on