.alter table komutu
Şunlar için geçerlidir: ✅Microsoft Fabric✅Azure 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ı,
docstring
ve klasörü varolan bir tabloya ayarlar ve varolan sütun şemasının,docstring
ve 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
.alter
table
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")
İ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. - Tablo bekletme ilkesini değiştirmek için bkz . .alter table policy retention.
- Tablo önbelleğe alma ilkesini değiştirmek için bkz . .alter table policy caching.
- Tablo güncelleştirme ilkesini değiştirmek için bkz . .alter table policy update.
- Tablo birleştirme ilkesini değiştirmek için bkz . .alter table policy merge.