Tabel of weergave wijzigen

Naam van tabel of weergave wijzigen

ALTER [TABLE|VIEW] [db_name.]table_name RENAME TO [db_name.]new_table_name

Wijzig de naam van een bestaande tabel of weergave. Als de naam van de doeltabel al bestaat, wordt er een uitzondering gemaakt. Deze bewerking biedt geen ondersteuning voor het verplaatsen van tabellen tussen databases.

Bij het wijzigen van de naam van een tabel voor beheerde tabellen wordt de locatie van de tabel verplaatst; Bij niet-mande (externe) tabellen wordt de locatie van de tabel niet verplaatst door de naam van een tabel te wijzigen.

Zie Beheerde en niet-beheerde tabellen voor meer informatie over beheerde en niet-beheerde (externe) tabellen.

Tabel- of weergave-eigenschappen instellen

ALTER [TABLE|VIEW] table_name SET TBLPROPERTIES (key1=val1, key2=val2, ...)

Stel de eigenschappen van een bestaande tabel of weergave in. Als een bepaalde eigenschap al is ingesteld, wordt de oude waarde overgenomen door de nieuwe.

Notitie

  • Namen van eigenschappen zijn casegevoelig. Als u en key1 later hebt ingesteld, wordt Key1 er een nieuwe tabel-eigenschap gemaakt.

  • Voer het volgende uit om tabeleigenschappen weer te geven:

    DESCRIBE EXTENDED table_name
    

Een tabelcommenter instellen

Voer het volgende uit om een tabelcommenter in te stellen:

ALTER TABLE table_name SET TBLPROPERTIES ('comment' = 'A table comment.')

Tabel- of weergave-eigenschappen neerzetten

ALTER (TABLE|VIEW) table_name UNSET TBLPROPERTIES
    [IF EXISTS] (key1, key2, ...)

Een of meer eigenschappen van een bestaande tabel of weergave neerzetten. Als een opgegeven eigenschap niet bestaat, wordt er een uitzondering geworpen.

IF EXISTS

Als een opgegeven eigenschap niet bestaat, gebeurt er niets.

SerDe- of SerDe-eigenschappen instellen

ALTER TABLE table_name [PARTITION part_spec] SET SERDE serde
    [WITH SERDEPROPERTIES (key1=val1, key2=val2, ...)]

ALTER TABLE table_name [PARTITION part_spec]
    SET SERDEPROPERTIES (key1=val1, key2=val2, ...)

part_spec:
    : (part_col_name1=val1, part_col_name2=val2, ...)

Stel de serde- of serde-eigenschappen van een tabel of partitie in. Als een opgegeven SerDe-eigenschap al is ingesteld, overschreven deze de oude waarde met de nieuwe. Het instellen van de SerDe is alleen toegestaan voor tabellen die zijn gemaakt met de Hive-indeling.

Eigenaar toewijzen

ALTER (TABLE|VIEW) object-name OWNER TO `user_name@user_domain.com`

Wijs een eigenaar toe aan de tabel of weergave.

Delta Lake-schema-constructies

Delta Lake ondersteunt aanvullende constructies voor het wijzigen van het tabelschema: kolommen toevoegen, wijzigen en vervangen.

Zie Schema expliciet bijwerken voor het toevoegen, wijzigen en vervangen van kolomvoorbeelden.

Kolommen toevoegen

ALTER TABLE table_name ADD COLUMNS (col_name data_type [COMMENT col_comment] [FIRST|AFTER colA_name], ...)

ALTER TABLE table_name ADD COLUMNS (col_name.nested_col_name data_type [COMMENT col_comment] [FIRST|AFTER colA_name], ...)

Kolommen toevoegen aan een bestaande tabel. Het ondersteunt het toevoegen van geneste kolommen. Als er al een kolom met dezelfde naam in de tabel of dezelfde geneste struct bestaat, wordt er een uitzondering geworpen.

Kolommen wijzigen

ALTER TABLE table_name (ALTER|CHANGE) [COLUMN] alterColumnAction

ALTER TABLE table_name (ALTER|CHANGE) [COLUMN] alterColumnAction

alterColumnAction:
    : TYPE dataType
    : [COMMENT col_comment]
    : [FIRST|AFTER colA_name]
    : (SET | DROP) NOT NULL

Een kolomdefinitie van een bestaande tabel wijzigen. U kunt het gegevenstype, de opmerking, de null-waarde van een kolom wijzigen of de volgorde van kolommen wijzigen.

Notitie

Beschikbaar in Databricks Runtime 7.0 en hoger.

Kolommen wijzigen (Hive-syntaxis)

ALTER TABLE table_name CHANGE [COLUMN] col_name col_name data_type [COMMENT col_comment] [FIRST|AFTER colA_name]

ALTER TABLE table_name CHANGE [COLUMN] col_name.nested_col_name col_name data_type [COMMENT col_comment] [FIRST|AFTER colA_name]

Een kolomdefinitie van een bestaande tabel wijzigen. U kunt de opmerking van de kolom wijzigen en de volgorde van kolommen wijzigen.

Notitie

In Databricks Runtime 7.0 en hoger kunt u niet CHANGE COLUMN gebruiken:

  • De inhoud van complexe gegevenstypen zoals structs wijzigen. Gebruik in ADD COLUMNS plaats daarvan om nieuwe kolommen toe te voegen aan geneste velden ALTER COLUMN of om de eigenschappen van een geneste kolom te wijzigen.
  • Om de null-waarde van een kolom in een Delta-tabel te vereenversen. Gebruik in plaats daarvan ALTER TABLE table_name ALTER COLUMN column_name DROP NOT NULL .

Kolommen vervangen

ALTER TABLE table_name REPLACE COLUMNS (col_name1 col_type1 [COMMENT col_comment1], ...)

Vervang de kolomdefinities van een bestaande tabel. Het ondersteunt het wijzigen van de opmerkingen van kolommen, het toevoegen van kolommen en het opnieuw ordenen van kolommen. Als opgegeven kolomdefinities niet compatibel zijn met de bestaande definities, wordt er een uitzondering gemaakt.