.alter table parancs

A .alter table parancs:

• Adatok védelme "megőrzött" oszlopokban
• Táblázatoszlopok átrendezése
• Új oszlopséma és docstringmappa beállítása egy meglévő táblára, felülírva a meglévő oszlopséma, docstringés mappa értékét
• Egy adott adatbázis környezetében kell futnia, amely a tábla nevét hatókörbe helyezi

Figyelmeztetés

.alter A parancs helytelen használata adatvesztéshez vezethet.

Engedélyek

A parancs futtatásához legalább Table Rendszergazda engedéllyel kell rendelkeznie.

Syntax

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

További információ a szintaxis konvenciókról.

Paraméterek

Név	Típus	Kötelező	Leírás
tableName	string	✔️	A módosítandó tábla neve.
columnName, columnType	string	✔️	Egy meglévő vagy új oszlop neve, amely az adott oszlop adattípusára van leképezve. A leképezések listája határozza meg a kimeneti oszlop sémáját.
propertyName, propertyValue	string		Kulcs-érték tulajdonságpárok vesszővel tagolt listája. Tekintse meg a támogatott tulajdonságokat.

Figyelmeztetés

A parancsban nem megadott meglévő oszlopok elvesznek. Ez váratlan adatvesztéshez vezethet.

Tipp

A módosítás .show table [tableName] cslschema előtt lekérheti a meglévő táblasémát.

Támogatott tulajdonságok

Név	Típus	Description
docstring	string	A hozzáadni kívánt entitást leíró szabad szöveg. Ez a sztring az entitásnevek mellett található különböző felhasználói felületi beállításokban jelenik meg.
folder	string	A táblához hozzáadni kívánt mappa neve.

Hogyan befolyásolja a parancs az adatokat?

• A parancsban felsorolt oszlopokban lévő meglévő adatok nem lesznek módosítva
• A parancsban nem szereplő oszlopokban lévő meglévő adatok törlődnek
• Új oszlopok lesznek hozzáadva a séma végéhez
• Az új oszlopokban lévő adatok null értékűnek minősülnek
• A táblában ugyanazok az oszlopok lesznek, ugyanabban a sorrendben, mint a megadott

Megjegyzés

Ha megpróbál módosítani egy oszloptípust, a parancs sikertelen lesz. A .alter column használható helyette.

Figyelmeztetés

• Adatbetöltés, amely figyelmen kívül hagyja az oszlopok sorrendjét, és párhuzamosan történik azzal a kockázattal, .alter table hogy az adatokat nem a megfelelő oszlopokba töltik be. Ennek megakadályozásához győződjön meg arról, hogy a betöltés leképezési objektumot használ, vagy állítsa le a betöltést a .alter table parancs futtatása közben.
• Az adatbetöltés módosíthatja egy tábla oszlopsémáit. Ügyeljen arra, hogy ne távolítsa el véletlenül a betöltés során hozzáadott kívánt oszlopokat.

Példák

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

Kapcsolódó tartalom

Akkor használja .alter-merge , ha meg szeretné őrizni a táblázat beállításait, és csak bizonyos oszlopok felülbírálása vagy kibontása. További információ: .alter-merge table.