Comando .alter table

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati

Il comando .alter table:

• Protegge i dati nelle colonne "mantenute"
• Riordinare le colonne della tabella
• Imposta un nuovo schema di colonna, docstringe una cartella su una tabella esistente, sovrascrivendo lo schema di colonna esistente, docstringe la cartella
• Deve essere eseguito nel contesto di un database specifico che definisce l'ambito del nome della tabella

Avviso

L'uso del .alter comando in modo non corretto può causare la perdita di dati.

Autorizzazioni

Per eseguire questo comando, è necessario disporre almeno delle autorizzazioni di amministratore tabella .

Sintassi

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

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Digita	Obbligatorio	Descrizione
tableName	string	✔️	Nome della tabella da modificare.
columnName, columnType	string	✔️	Nome di una colonna esistente o nuova mappata al tipo di dati in tale colonna. L'elenco di questi mapping definisce lo schema della colonna di output.
propertyName, propertyValue	string		Elenco delimitato da virgole di coppie di proprietà chiave-valore. Vedere le proprietà supportate.

Avviso

Le colonne esistenti non specificate nel comando verranno eliminate. Ciò potrebbe causare una perdita di dati imprevista.

Suggerimento

Usare .show table [tableName] cslschema per ottenere lo schema di tabella esistente prima di modificarlo.

Proprietà supportate

Nome	Tipo	Descrizione
docstring	string	Testo libero che descrive l'entità da aggiungere. Questa stringa viene presentata in varie impostazioni dell'esperienza utente accanto ai nomi delle entità.
folder	string	Nome della cartella da aggiungere alla tabella.

Impatto del comando sui dati

• I dati esistenti nelle colonne elencate nel comando non verranno modificati
• I dati esistenti nelle colonne non elencati nel comando verranno eliminati
• Nuove colonne verranno aggiunte alla fine dello schema
• Si presuppone che i dati nelle nuove colonne siano Null
• La tabella avrà le stesse colonne, nello stesso ordine, come specificato

Nota

Se si tenta di modificare un tipo di colonna, il comando avrà esito negativo. Utilizzare invece .alter column.

Avviso

• Inserimento di dati che ignora l'ordine delle colonne e si verifica in parallelo con .alter table i rischi di inserimento dei dati nelle colonne errate. Per evitare questo problema, assicurarsi che l'inserimento usi un oggetto di mapping o interrompa l'inserimento durante l'esecuzione del .alter table comando.
• L'inserimento dati può modificare lo schema delle colonne di una tabella. Prestare attenzione a non rimuovere accidentalmente le colonne desiderate aggiunte durante l'inserimento.

Esempi

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

Contenuto correlato

• Usare .alter-merge quando si desidera mantenere le impostazioni della tabella ed eseguire l'override o espandere solo determinate colonne. Per altre informazioni, vedere tabella .alter-merge.
• Per modificare i criteri di conservazione delle tabelle, vedere .alter table policy retention ..
• Per modificare i criteri di memorizzazione nella cache della tabella, vedere .alter table policy caching.To change the table caching policy, see .alter table policy caching.
• Per modificare i criteri di aggiornamento della tabella, vedere .alter table policy update.To change the table update, see .alter table policy update.
• Per modificare i criteri di unione delle tabelle, vedere .alter table policy merge.