Aracılığıyla paylaş


.alter table komutu

Şunlar için geçerlidir: ✅Microsoft FabricAzure Veri Gezgini

Komut .alter table :

  • "Korunan" sütunlardaki verilerin güvenliğini sağlar
  • Tablo sütunlarını yeniden sıralar
  • Yeni bir sütun şeması, docstringve klasörü varolan bir tabloya ayarlar ve varolan sütun şemasının, docstringve klasörünün üzerine yazar
  • Tablo adının kapsamını oluşturan belirli bir veritabanı bağlamında çalıştırılmalıdır

Uyarı

komutun .alter yanlış kullanılması veri kaybına neden olabilir.

İzinler

Bu komutu çalıştırmak için en az Tablo Yöneticisi izinlerine sahip olmanız gerekir.

Sözdizimi

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

Söz dizimi kuralları hakkında daha fazla bilgi edinin.

Parametreler

Ad Tür Zorunlu Açıklama
tableName string ✔️ Değiştirecek tablonun adı.
columnName, columnType string ✔️ Bu sütundaki veri türüne eşlenen mevcut veya yeni bir sütunun adı. Bu eşlemelerin listesi çıkış sütunu şemasını tanımlar.
propertyName, propertyValue string Anahtar-değer özellik çiftlerinin virgülle ayrılmış listesi. Desteklenen özelliklere bakın.

Uyarı

Komutta belirtilmeyen mevcut sütunlar bırakılır. Bu beklenmeyen veri kaybına neden olabilir.

İpucu

Varolan tablo şemasını değiştirmeden önce almak için kullanın .show table [tableName] cslschema .

Desteklenen özellikler

Adı Tür Açıklama
docstring string Eklenecek varlığı açıklayan serbest metin. Bu dize, varlık adlarının yanındaki çeşitli UX ayarlarında gösterilir.
folder string Tabloya eklenecek klasörün adı.

Komut verileri nasıl etkiler?

  • Komutta listelenen sütunlardaki mevcut veriler değiştirilmez
  • Komutta listelenmeyen sütunlardaki mevcut veriler silinir
  • Şemanın sonuna yeni sütunlar eklenecek
  • Yeni sütunlardaki verilerin null olduğu varsayılır
  • Tabloda belirtilen sırada aynı sütunlar bulunur

Not

Bir sütun türünü değiştirmeye çalışırsanız komut başarısız olur. Bunun yerine .alter column kullanın.

Uyarı

  • Sütunların sırasını dikkate almayan ve verileri yanlış sütunlara alma riskleriyle .alter table paralel olarak gerçekleşen veri alımı. Bunu önlemek için, alma işleminin bir eşleme nesnesi kullandığından veya komutu çalıştırırken alımı durdurdığından .alter table emin olun.
  • Veri alımı tablonun sütun şemasını değiştirebilir. Alma sırasında eklenen istenen sütunları yanlışlıkla kaldırmamaya dikkat edin.

Örnekler

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