.alter table komutu

Komut .alter table :

• "Korunan" sütunlardaki verilerin güvenliğini sağlar
• Tablo sütunlarını yeniden sıralar
• Yeni bir sütun şemasını, docstringve klasörünü var olan 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önetici izinlerine sahip olmanız gerekir.

Syntax

.altertableTablename(Columnname:columnType [, ...]) [with(propertyName=propertyValue [, ...])]

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

Parametreler

Ad	Tür	Gerekli	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	Description
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ı.

Komutun verileri nasıl etkilediği

• Komutta listelenen sütunlardaki mevcut veriler değiştirilmez
• Komutta listelenmeyen sütunlardaki mevcut veriler silinecek
• Şemanın sonuna yeni sütunlar eklenecek
• Yeni sütunlardaki verilerin null olduğu varsayılır
• Tabloda belirtilen sırayla 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 riskiyle .alter table paralel olarak gerçekleşen veri alımı. Bunu önlemek için, alımın bir eşleme nesnesi kullandığından veya komutu çalıştırırken alımı durdurdığından .alter table emin olun.
• Veri alımı bir 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")

İlgili içerik

Tablo ayarlarını korumak ve yalnızca belirli sütunları geçersiz kılmak veya genişletmek istediğinizde kullanın .alter-merge . Daha fazla bilgi için bkz . .alter-merge table.