Comando .alter-merge table
Si applica a: ✅Microsoft Fabric✅Azure Esplora dati
Il comando .alter-merge table:
- Protegge i dati nelle colonne esistenti
- Aggiunge nuove colonne,
docstringe a una tabella esistente - Deve essere eseguito nel contesto di un database specifico che definisce l'ambito del nome della tabella
Autorizzazioni
Per eseguire questo comando, è necessario disporre almeno delle autorizzazioni di amministratore tabella .
Sintassi
.alter-mergetable 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. |
Nota
Se si tenta di modificare un tipo di colonna, il comando avrà esito negativo. Utilizzare invece .alter column.
Suggerimento
Usare .show table [tableName] cslschema per ottenere lo schema di colonna 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 non verranno modificati o eliminati
- Nuove colonne verranno aggiunte alla fine dello schema
- Si presuppone che i dati nelle nuove colonne siano Null
Esempi
.alter-merge table MyTable (ColumnX:string, ColumnY:int)
.alter-merge table MyTable (ColumnX:string, ColumnY:int) with (docstring = "Some documentation", folder = "Folder1")
Contenuto correlato
Usare il .alter comando table per ridefinire ulteriormente le impostazioni della tabella. Per altre informazioni, vedere .alter table.