ALTER TABLE Clausola COLUMN

Articolo
11/20/2024

Si applica a: segno di spunta sì Databricks SQL Databricks Runtime

Aggiunge, modifica o elimina una colonna in una tabella o un campo in una colonna di una tabella Delta Lake.

Autorizzazioni necessarie

Se si usa il catalogo Unity, è necessario disporre MODIFY delle autorizzazioni per:

ALTER COLUMN
Aggiungi colonna
.drop column

Tutte le altre operazioni richiedono la proprietà della tabella.

Sintassi

ALTER TABLE table_name
   { ADD COLUMN clause |
     ALTER COLUMN clause |
     DROP COLUMN clause |
     RENAME COLUMN clause }

Clausola ADD COLUMN

Questa clausola non è supportata per le JDBC origini dati.

Aggiunge una o più colonne alla tabella o ai campi alle colonne esistenti in una tabella Delta Lake.

Nota

Quando si aggiunge una colonna a una tabella Delta esistente, non è possibile definire un DEFAULT valore. Tutte le colonne aggiunte alle tabelle Delta vengono considerate come NULL per le righe esistenti. Dopo aver aggiunto una colonna, è possibile definire facoltativamente un valore predefinito per la colonna, ma viene applicato solo per le nuove righe inserite nella tabella. Usare la sintassi seguente:

ALTER TABLE table_name ALTER COLUMN column_name SET DEFAULT default_expression

Sintassi

{ ADD [ COLUMN | COLUMNS ]
  ( { { column_identifier | field_name } data_type
      [ DEFAULT clause ] [ COMMENT comment ] [ FIRST | AFTER identifier ]
      [ MASK clause ] } [, ...] ) }

Parametri

column_identifier

Nome della colonna da aggiungere. Il nome deve essere univoco all'interno della tabella.

A meno che FIRST non venga specificata la AFTER name colonna o il campo verrà accodato alla fine.
field_name

Nome completo del campo da aggiungere a una colonna esistente. Tutti i componenti del percorso del campo annidato devono esistere e il nome del campo stesso deve essere univoco.
DEFAULT default_expression

Si applica a: Databricks SQL Databricks Runtime 11.3 LTS e versioni successive

Definisce un DEFAULT valore per la colonna utilizzata su INSERT e MERGE ... INSERT quando la colonna non viene specificata.

Se non viene specificato alcun valore predefinito, DEFAULT NULL è implicito per le colonne nullable.

default_expression può essere composto da valori letterali e funzioni o operatori SQL predefiniti, ad eccezione di:
- Funzioni di aggregazione
- Funzioni di finestra analitica
- Funzioni della finestra di classificazione
- Funzioni generatore con valori di tabella
default_expression non deve contenere alcuna sottoquery.

DEFAULTè supportato per le origini CSV, JSON, PARQUET, e ORC.
data_type

Specifica il tipo di dati della colonna o del campo. Non tutti i tipi di dati supportati da Azure Databricks sono supportati da tutte le origini dati.
COMMENT comment

Valore letterale facoltativo STRING che descrive la colonna o il campo aggiunto.

Per aggiungere un commento generato dall’intelligenza artificiale per una tabella o una colonna di tabella gestita dal catalogo unity, vedere Aggiungere commenti generati dall'intelligenza artificiale agli oggetti del catalogo unity.
FIRST

Se viene specificata la colonna verrà aggiunta come prima colonna della tabella oppure il campo verrà aggiunto come primo campo di nello struct contenitore.
AFTERidentificatore

Se si specifica la colonna o il campo verrà aggiunto immediatamente dopo il campo o la colonna identifier.
Clausola MASK

Si applica a: Solo Databricks SQL Databricks Runtime 12.2 LTS e versioni successive al catalogo Unity

Importante

Questa funzionalità è disponibile in anteprima pubblica.

Aggiunge una funzione maschera di colonna per rendere anonimi i dati sensibili. Tutte le query successive da tale colonna riceveranno il risultato della valutazione di tale funzione sulla colonna al posto del valore originale della colonna. Ciò può essere utile per scopi di controllo di accesso con granularità fine, in cui la funzione può esaminare l'identità o le appartenenze a gruppi dell'utente che richiama per stabilire se redigere il valore.

Clausola ALTER COLUMN

Si applica a: segno di spunta sì Databricks SQL Databricks Runtime

Modifica una proprietà o la posizione di una colonna.

Sintassi

{ { ALTER | CHANGE } [ COLUMN ] { column_identifier | field_name }
  { COMMENT comment |
    { FIRST | AFTER column_identifier } |
    { SET | DROP } NOT NULL |
    TYPE data_type |
    SET DEFAULT clause |
    DROP DEFAULT |
    SYNC IDENTITY |
    SET { MASK clause } |
    DROP MASK |
    SET TAGS clause |
    UNSET TAGS clause } }

Parametri

column_identifier

Nome della colonna da rimuovere.
field_name

Nome completo del campo da modificare. Tutti i componenti del percorso del campo annidato devono esistere.
COMMENT comment

Cambiare la descrizione della colonna column_name. comment deve essere un valore STRING letterale.
FIRST o un AFTERidentificatore

Sposta la colonna dalla posizione corrente alla parte anteriore (FIRST) o immediatamente AFTER all'oggetto identifier. Questa clausola è supportata solo se table_name è una tabella Delta.

TYPEdata_type

Si applica a: segno di spunta sì Databricks SQL Databricks Runtime 15.2 e versioni successive

Cambia il tipo di dati della colonna column_name.

Questa clausola è supportata solo se table_name è una tabella Delta.

Per tutte le tabelle Delta sono supportate le modifiche di tipo seguenti:

Aumento delle dimensioni di una VARCHAR colonna, ad esempio da VARCHAR(5) a VARCHAR(10)
Modificare il tipo di una colonna CHAR in VARCHAR, ad esempio da CHAR(5) in VARCHAR(5)
Modificare il tipo di una colonna CHAR o VARCHAR in STRING, ad esempio, da VARCHAR(10) in STRING.

Le modifiche di tipo seguenti sono supportate per le tabelle Delta con delta.enableTypeWidening impostato su true:

Importante

Questa funzionalità è disponibile in anteprima pubblica in Databricks Runtime 15.2 e versioni successive.

Tipo di origine	Altri tipi supportati
`BYTE`	`SHORT`, `INT`, `BIGINT`, `DECIMALDOUBLE`
`SHORT`	`INT`, `BIGINT`, `DECIMALDOUBLE`
`INT`	`BIGINT`, `DECIMAL`, `DOUBLE`
`BIGINT`	`DECIMAL`, `DOUBLE`
`FLOAT`	`DOUBLE`
`DECIMAL`	`DECIMAL` con maggiore precisione e scala
`DATE`	`TIMESTAMP_NTZ`

Per informazioni più dettagliate sull'estensione dei tipi, vedere Estensione dei tipi.

SET NOT NULL oppure DROP NOT NULL

Modifica il dominio dei valori di colonna validi per escludere i SET NOT NULLvalori Null oppure includere valori DROP NOT NULLNull. Questa opzione è supportata solo per le tabelle Delta Lake. Delta Lake garantisce che il vincolo sia valido per tutti i dati nuovi e esistenti.
SYNC IDENTITY

Si applica a: Databricks SQL Databricks Runtime 10.4 LTS e versioni successive

Sincronizzare i metadati di una colonna Identity con i dati effettivi. Quando si scrivono valori personalizzati in una colonna Identity, potrebbe non essere conforme ai metadati. Questa opzione valuta lo stato e aggiorna i metadati in modo che siano coerenti con i dati effettivi. Dopo questo comando, il valore identity assegnato automaticamente verrà avviato da start + (n + 1) * step, dove n è il valore più piccolo che soddisfa start + n * step >= max() (per un passaggio positivo).

Questa opzione è supportata solo per le colonne Identity nelle tabelle Delta Lake.
DROP DEFAULT

Si applica a: Databricks SQL Databricks Runtime 11.3 LTS e versioni successive

Rimuove l'espressione predefinita dalla colonna. Per le colonne nullable equivale a SET DEFAULT NULL. Per le colonne definite con NOT NULL è necessario fornire un valore per ogni operazione futura INSERT
SET DEFAULT default_expression

Si applica a: Databricks SQL Databricks Runtime 11.3 LTS e versioni successive

Definisce un DEFAULT valore per la colonna utilizzata su INSERT e MERGE ... INSERT quando la colonna non viene specificata.

Se non viene specificato DEFAULT NULL alcun valore predefinito è implicito per le colonne nullable.

default_expression può essere composto da valori letterali, funzioni SQL predefinite o operatori ad eccezione di:
- Funzioni di aggregazione
- Funzioni di finestra analitica
- Funzioni della finestra di classificazione
- Funzioni generatore con valori di tabella
default_expression non deve contenere una sottoquery.

DEFAULTè supportato per le origini CSV, JSON, ORC, e PARQUET.

Quando si definisce l'impostazione predefinita per una colonna appena aggiunta, l'impostazione predefinita si applica a tutte le righe preesistenti. Se il valore predefinito include una funzione non deterministica, rand ad esempio o current_timestamp il valore, viene calcolato una volta quando ALTER TABLE viene eseguito e applicato come costante alle righe preesistenti. Per le righe appena inserite, l'espressione predefinita viene eseguita una volta per ogni riga.

Quando si imposta un valore predefinito usando ALTER COLUMN, le righe esistenti non sono interessate da tale modifica.
SETClausola MASK

Si applica a: Solo Databricks SQL Databricks Runtime 12.2 LTS e versioni successive al catalogo Unity

Importante

Questa funzionalità è disponibile in anteprima pubblica.

Aggiunge una funzione maschera di colonna per rendere anonimi i dati sensibili. Tutte le query successive da tale colonna riceveranno il risultato della valutazione di tale funzione sulla colonna al posto del valore originale della colonna. Ciò può essere utile per scopi di controllo di accesso con granularità fine, in cui la funzione può esaminare l'identità o le appartenenze a gruppi dell'utente che richiama per stabilire se redigere il valore.
DROP MASK

Si applica a: solo catalogo Unity

Importante

Questa funzionalità è disponibile in anteprima pubblica.

Rimuove la maschera di colonna per questa colonna, se presente. Le query future di questa colonna riceveranno i valori originali della colonna.
SET TAGS ( { tag_name = tag_value } [, ...] )

Si applica a: Databricks SQL Databricks Runtime 13.3 LTS e versioni successive

Applicare tag alla colonna. È necessario disporre APPLY TAG dell'autorizzazione per aggiungere tag alla colonna.
- tag_name
  
  Valore letterale STRING. tag_name deve essere univoco all'interno della tabella o della colonna.
- tag_value
  
  Valore letterale STRING.
UNSET TAGS ( tag_name [, ...] )

Si applica a: Databricks SQL Databricks Runtime 13.3 LTS e versioni successive

Rimuovere i tag dalla colonna. È necessario disporre APPLY TAG dell'autorizzazione per rimuovere i tag dalla colonna.
- tag_name
  
  Valore letterale STRING. tag_name deve essere univoco all'interno della tabella o della colonna.

Clausola DROP COLUMN

Importante

Questa funzionalità è disponibile in anteprima pubblica.

Si applica a: segno di spunta sì Databricks SQL Databricks Runtime 11.3 LTS e versioni successive

Eliminare una o più colonne o campi in una tabella Delta Lake.

Quando si rilascia una colonna o un campo, è necessario eliminare vincoli check dipendenti e colonne generate.

Per i requisiti, vedere Rinominare ed eliminare colonne con mapping di colonne Delta Lake.

Sintassi

DROP [COLUMN | COLUMNS] [ IF EXISTS ] ( { {column_identifier | field_name} [, ...] )

Parametri

IF EXISTS

Quando si specifica IF EXISTS, Azure Databricks ignora un tentativo di eliminare colonne che non esistono. In caso contrario, l'eliminazione di colonne non esistenti genererà un errore.
column_identifier

Nome della colonna esistente.
field_name

Nome completo di un campo esistente.

Clausola RENAME COLUMN

Importante

Questa funzionalità è disponibile in anteprima pubblica.

Si applica a: segno di spunta sì Databricks SQL Databricks Runtime 10.4 LTS e versioni successive

Rinomina una colonna o un campo in una tabella Delta Lake abilitata per il mapping delle colonne.

Quando si rinomina una colonna o un campo, è anche necessario modificare i vincoli check dipendenti e le colonne generate. Tutte le chiavi primarie e le chiavi esterne che usano la colonna verranno eliminate. Nel caso di chiavi esterne, è necessario essere proprietari della tabella in cui è definita la chiave esterna.

Per i requisiti e come abilitare il mapping delle colonne, vedere Rinominare ed eliminare colonne con mapping di colonne Delta Lake.

Sintassi

RENAME COLUMN { column_identifier TO to_column_identifier|
                field_name TO to_field_identifier }

Parametri

column_identifier

Nome della colonna esistente.
to_column_identifier

Identificatore della colonna. L’identificatore deve essere univoco all'interno della tabella.
field_name

Nome completo esistente di un campo.
to_field_identifier

Nuovo identificatore di campo. L'identificatore deve essere univoco all'interno dello struct locale.

Esempi

Per altri esempi, vedere ALTER TABLE.

Condividi tramite

ALTER TABLE Clausola COLUMN

Autorizzazioni necessarie

Sintassi

Clausola ADD COLUMN

Sintassi

Parametri

Clausola ALTER COLUMN

Sintassi

Parametri

Clausola DROP COLUMN

Sintassi

Parametri

Clausola RENAME COLUMN

Sintassi

Parametri

Esempi

Commenti e suggerimenti

Risorse aggiuntive

Condividi tramite

ALTER TABLE Clausola COLUMN

Autorizzazioni necessarie

Sintassi

Clausola ADD COLUMN

Sintassi

Parametri

Clausola ALTER COLUMN

Sintassi

Parametri

Clausola DROP COLUMN

Sintassi

Parametri

Clausola RENAME COLUMN

Sintassi

Parametri

Esempi

Articoli correlati

Commenti e suggerimenti

Risorse aggiuntive