Delen via

ALTER TABLE ... COLUMN clausule

Van toepassing op:aangevinkt als ja Databricks SQL aangevinkt als ja Databricks Runtime

Hiermee wordt een kolom in een tabel of gerealiseerde weergave of een veld in een kolom in een Delta Lake-tabel toegevoegd, gewijzigd of verwijderd.

Vereiste machtigingen

Als u Unity Catalog gebruikt, moet u gemachtigd zijn MODIFY voor het volgende:

  • ALTER COLUMN
  • ADD COLUMN
  • DROP COLUMN

Voor alle andere bewerkingen is het eigendom van de tabel vereist.

Syntaxis

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

VOEG COLUMN clausule TOE

Deze component wordt niet ondersteund voor JDBC gegevensbronnen.

Voegt een of meer kolommen toe aan de tabel of velden aan bestaande kolommen in een Delta Lake-tabel.

Notitie

Wanneer u een kolom aan een bestaande Delta-tabel toevoegt, kunt u geen DEFAULT waarde definiëren. Alle kolommen die aan Delta-tabellen worden toegevoegd, worden behandeld als NULL voor bestaande rijen. Nadat u een kolom hebt toegevoegd, kunt u desgewenst een standaardwaarde voor de kolom definiëren, maar dit wordt alleen toegepast op nieuwe rijen die in de tabel zijn ingevoegd. Gebruik de volgende syntaxis:

ALTER TABLE table_name ALTER COLUMN column_name SET DEFAULT default_expression

Syntaxis

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

Parameterwaarden

  • column_identifier

    De naam van de kolom die moet worden toegevoegd. De naam moet uniek zijn in de tabel.

    Tenzij FIRST of AFTER name worden opgegeven, wordt de kolom of het veld aan het einde toegevoegd.

  • field_name

    De volledig gekwalificeerde naam van het veld dat moet worden toegevoegd aan een bestaande kolom. Alle onderdelen van het pad naar het geneste veld moeten bestaan en de veldnaam zelf moet uniek zijn.

    Gebruik de volgende speciale namen om velden toe te voegen aan structs die zijn genest in ARRAY of MAP typen:

    • ELEMENT om naar een ARRAY element te navigeren.
    • KEY om naar een MAP sleutel te navigeren.
    • VALUE om naar een MAP waarde te navigeren.

    Bijvoorbeeld: phonenumbers.element.countrycode voegt het veld countrycode toe aan elk element van de phonenumbers matrix.

  • DEFAULT default_expression

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 11.3 LTS en hoger

    Definieert een DEFAULT waarde voor de kolom die wordt gebruikt voor INSERT en MERGE ... INSERT wanneer de kolom niet is opgegeven. Alle STRING literals en STRING-functies in de standaarduitdrukking gebruiken UTF8_BINARY collatie.

    Als er geen standaardwaarde is opgegeven, wordt DEFAULT NULL geïmpliceerd voor nulbare kolommen.

    default_expression kan bestaan uit letterlijke waarden en ingebouwde SQL-functies of -operators, met uitzondering van:

    default_expression mag geen subquery bevatten.

    DEFAULTwordt ondersteund voor CSV, JSONen PARQUETORC bronnen.

  • data_type

    Hiermee geeft u het gegevenstype van de kolom of het veld op. Niet alle gegevenstypen die worden ondersteund door Azure Databricks, worden ondersteund door alle gegevensbronnen.

  • COLLATE collatie_naam

    Voor data_typeSTRING geeft u desgewenst de sortering op die moet worden gebruikt met de kolom of het veld. Als de UTF8_BINARY sortering niet is opgegeven, is dit van toepassing.

  • COMMENT comment

    Een optionele letterlijke STRING beschrijving van de toegevoegde kolom of het toegevoegde veld.

    Als u een door AI gegenereerde opmerking wilt toevoegen voor een tabel- of tabelkolom die wordt beheerd door Unity Catalog, raadpleegt u Door AI gegenereerde opmerkingen toevoegen aan Unity Catalog-objecten.

  • FIRST

    Als u de kolom opgeeft, wordt de kolom toegevoegd als de eerste kolom van de tabel, of wordt het veld toegevoegd als het eerste veld in de struct die de kolom bevat.

  • AFTER Id

    Als de kolom of het veld wordt opgegeven, wordt deze direct na veld of kolom identifier toegevoegd.

  • MASK-clausule

    Van toepassing op:aangevinkt als ja Databricks SQL aangevinkt als ja Databricks Runtime 12.2 LTS en hoger aangevinkt als ja en alleen Unity Catalog

    Belangrijk

    Deze functie is beschikbaar als openbare preview.

    Voegt een kolommaskerfunctie toe om gevoelige gegevens anoniem te maken. Alle volgende query's van die kolom ontvangen het resultaat van het evalueren van die functie ten opzichte van de kolom in plaats van de oorspronkelijke waarde van de kolom. Dit kan handig zijn voor verfijnde toegangsbeheerdoeleinden, waarbij de functie de identiteit of groepslidmaatschappen van de aanroepende gebruiker kan inspecteren om te bepalen of de waarde moet worden bewerkt.

ALTER-clausule COLUMN

Van toepassing op:aangevinkt als ja Databricks SQL aangevinkt als ja Databricks Runtime

Hiermee wijzigt u een eigenschap of de locatie van een kolom.

Syntaxis

 { 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 }
  [, ... ]

Vóór Databricks Runtime 16.3 biedt de component geen ondersteuning voor het wijzigen van meerdere kolommen in één component.

{ ALTER | CHANGE } [ COLUMN ]
  { column_identifier | field_name }
  { SET { MASK clause } |
    DROP MASK |
    SET TAGS clause |
    UNSET TAGS clause }

Parameterwaarden

  • column_identifier

    De naam van de kolom die gewijzigd moet worden.

    Als er meer dan eens naar een kolomidentificatie wordt verwezen, genereert Azure Databricks de fout NOT_SUPPORTED_CHANGE_SAME_COLUMN.

  • field_name

    De volledig gekwalificeerde naam van het veld dat moet worden gewijzigd. Alle elementen van het pad naar het geneste veld moeten aanwezig zijn.

    Als een veldnaam meer dan eens wordt gerefereerd, geeft Azure Databricks de foutmelding NOT_SUPPORTED_CHANGE_SAME_COLUMN.

  • COMMENT comment

    Hiermee wijzigt u de beschrijving van de column_name kolom. comment moet een STRING literal zijn.

  • FIRST of AFTERid

    Hiermee verplaatst u de kolom van de huidige positie naar de voorzijde (FIRST) of onmiddellijk AFTER de identifier. Deze clausule wordt alleen ondersteund als table_name een Delta-tabel is.

  • TYPE datatype

    Van toepassing op: vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 15.2 en hoger

    Hiermee wijzigt u het gegevenstype van de column_name kolom.

    Deze clausule wordt alleen ondersteund als table_name een Delta-tabel is.

    De volgende typewijzigingen worden ondersteund voor alle Delta-tabellen:

    • De grootte van een VARCHAR kolom vergroten, bijvoorbeeld van VARCHAR(5) naar VARCHAR(10)
    • Het type van een CHAR kolom wijzigen in een VARCHAR, bijvoorbeeld van CHAR(5) in VARCHAR(5)
    • Het type van een CHAR of VARCHAR kolom wijzigen in STRING, bijvoorbeeld van VARCHAR(10) naar STRING.

    De volgende typewijzigingen worden ondersteund voor Delta-tabellen die delta.enableTypeWidening zijn ingesteld op true:

    Belangrijk

    Deze functie bevindt zich in openbare preview in Databricks Runtime 15.2 en hoger.

    Brontype Ondersteunde uitgebreidere typen
    BYTE SHORT INT, BIGINT, DECIMALDOUBLE
    SHORT INT,BIGINT,DECIMAL,DOUBLE
    INT BIGINT, , DECIMALDOUBLE
    BIGINT DECIMAL, DOUBLE
    FLOAT DOUBLE
    DECIMAL DECIMAL met meer precisie en schaal
    DATE TIMESTAMP_NTZ

    Voor meer gedetailleerde informatie over type widening, zie Type widening.

  • SET NOT NULL of DROP NOT NULL

    Hiermee wijzigt u het domein van geldige kolomwaarden om null-waarden SET NOT NULLuit te sluiten of null-waarden DROP NOT NULLop te nemen. Deze optie wordt alleen ondersteund voor Delta Lake-tabellen. Delta Lake zorgt ervoor dat de beperking geldig is voor alle bestaande en nieuwe gegevens.

  • SYNC IDENTITY

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 10.4 LTS en hoger

    Synchroniseer de metagegevens van een identiteitskolom met de werkelijke gegevens. Wanneer u uw eigen waarden naar een identiteitskolom schrijft, voldoet deze mogelijk niet aan de metagegevens. Met deze optie wordt de status geëvalueerd en worden de metagegevens bijgewerkt zodat deze consistent zijn met de werkelijke gegevens. Na deze opdracht begint de volgende automatisch toegewezen identiteitswaarde vanaf start + (n + 1) * step, waarbij n de kleinste waarde is die voldoet aan start + n * step >= max() (voor een positieve stap).

    Deze optie wordt alleen ondersteund voor identiteitskolommen in Delta Lake-tabellen.

  • DROP DEFAULT

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 11.3 LTS en hoger

    Hiermee verwijdert u de standaardexpressie uit de kolom. Voor null-kolommen is dit gelijk aan SET DEFAULT NULL. Voor kolommen die met NOT NULL zijn gedefinieerd, moet u een waarde opgeven bij elke toekomstige INSERT operatie.

  • SET DEFAULT default_expression

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 11.3 LTS en hoger

    Definieert een DEFAULT waarde voor de kolom die wordt gebruikt voor INSERT en MERGE ... INSERT wanneer de kolom niet is opgegeven.

    Als er geen standaardwaarde is opgegeven DEFAULT NULL , wordt dit geïmpliceerd voor null-kolommen.

    default_expression kan bestaan uit letterlijke waarden, ingebouwde SQL-functies of operators, met uitzondering van:

    default_expressionmag geen subquery bevatten.

    DEFAULTwordt ondersteund voor CSV, JSONen ORCPARQUET bronnen.

    Wanneer u de standaardwaarde definieert voor een nieuw toegevoegde kolom, is de standaardwaarde van toepassing op alle bestaande rijen. Als de standaardwaarde een niet-deterministische functie bevat, zoals rand of current_timestamp de waarde eenmaal wordt berekend wanneer de ALTER TABLE waarde wordt uitgevoerd en wordt toegepast als een constante voor bestaande rijen. Voor nieuw ingevoegde rijen wordt de standaardexpressie eenmaal per rij uitgevoerd.

    Wanneer u een standaardinstelling instelt met behulp van ALTER COLUMN, worden bestaande rijen niet beïnvloed door die wijziging.

  • SET MASK-clausule

    Van toepassing op:aangevinkt als ja Databricks SQL aangevinkt als ja Databricks Runtime 12.2 LTS en hoger aangevinkt als ja en alleen Unity Catalog

    Belangrijk

    Deze functie is beschikbaar als openbare preview.

    Voegt een kolommaskerfunctie toe om gevoelige gegevens anoniem te maken. Alle volgende query's van die kolom ontvangen het resultaat van het evalueren van die functie ten opzichte van de kolom in plaats van de oorspronkelijke waarde van de kolom. Dit kan handig zijn voor verfijnde toegangsbeheerdoeleinden, waarbij de functie de identiteit of groepslidmaatschappen van de aanroepende gebruiker kan inspecteren om te bepalen of de waarde moet worden bewerkt.

  • DROP MASK

    Van toepassing op:aangevinkt als ja alleen op Unity Catalog

    Belangrijk

    Deze functie is beschikbaar als openbare preview.

    Hiermee verwijdert u het kolommasker voor deze kolom, indien van toepassing. Toekomstige query's van deze kolom ontvangen de oorspronkelijke waarden van de kolom.

  • SET TAGS ( { tag_name = tag_value } [, ...] )

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger

    Tags toepassen op de kolom. U moet gemachtigd zijn APPLY TAG om tags toe te voegen aan de kolom.

    • tag_name

      Een letterlijkeSTRING. De tag_name naam moet uniek zijn binnen de tabel of kolom.

    • tag_value

      Een letterlijkeSTRING.

  • UNSET TAGS ( tag_name [, ...] )

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger

    Verwijder tags uit de kolom. U moet gemachtigd zijn APPLY TAG om tags uit de kolom te verwijderen.

    • tag_name

      Een letterlijkeSTRING. De tag_name naam moet uniek zijn binnen de tabel of kolom.

DROP-clause COLUMN

Belangrijk

Deze functie is beschikbaar als openbare preview.

Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 11.3 LTS en hoger

Verwijder een of meer kolommen of velden in een relatie.

Wanneer u een kolom of veld neerzet, moet u afhankelijke controlebeperkingen en gegenereerde kolommen verwijderen.

Zie Kolommen hernoemen en verwijderen met Delta Lake-kolomtoewijzing voor vereisten.

Syntaxis

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

Parameterwaarden

  • IF EXISTS

    Wanneer u opgeeft IF EXISTS, negeert Azure Databricks een poging om kolommen te verwijderen die niet bestaan. Anders veroorzaakt het verwijderen van niet-bestaande kolommen een fout.

  • column_identifier

    De naam van de bestaande kolom.

  • field_name

    De volledig gekwalificeerde naam van een bestaand veld.

RENAME COLUMN clausule

Belangrijk

Deze functie is beschikbaar als openbare preview.

Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 10.4 LTS en hoger

Wijzigt de naam van een kolom of veld in een Delta Lake-tabel die is ingeschakeld voor kolomtoewijzing.

Wanneer u de naam van een kolom of veld wijzigt, moet u ook afhankelijke controlebeperkingen en gegenereerde kolommen wijzigen. Alle primaire sleutels en externe sleutels die de kolom bevatten, worden verwijderd. In het geval van refererende sleutels moet u de eigenaar zijn van de tabel waarop de refererende sleutel is gedefinieerd.

Voor vereisten en hoe u kolomtoewijzing kunt inschakelen, zie Naam en het laten vervallen van kolommen met Delta Lake-kolomtoewijzing.

Syntaxis

RENAME COLUMN { column_identifier TO to_column_identifier|
                field_name TO to_field_identifier }

Parameterwaarden

Voorbeelden

Zie ALTER TABLE voorbeelden.