alter

Syntax

alter table tableObj add columnName columnType;
alter table tableObj drop [column] columnName;
alter table tableObj rename [column] columnName to newColumnName;

Arguments

tableObj can be an in-memory table, a stream table, a DFS table, or a dimension table.

colNames is a string scalar indicating the name of the column to be added.

newColNames is a string scalar indicating the name of the column to be modified.

colTypes is a scalar indicating the data type of the column.

Details

The alter statement is used to add, delete or rename columns to an existing table. Note that the TSDB engine only supports the add operation.

Examples

if(existsDatabase("dfs://test")) dropDatabase("dfs://test")
create database "dfs://test" partitioned by VALUE(1..10), HASH([SYMBOL, 40]), engine='OLAP', atomic='TRANS', chunkGranularity='TABLE'

create table "dfs://test"."pt"(
    id INT,
    deviceId SYMBOL,
    date DATE[comment="time_col", compress="delta"],
    value DOUBLE,
     isFin BOOL
)
partitioned by ID, deviceID

pt = loadTable("dfs://test", `pt)
alter table pt add location SYMBOL;
pt = loadTable("dfs://test", `pt)
pt.schema().colDefs
name typeString typeInt extra comment
id INT 4
deviceId SYMBOL 17
date DATE 6 time_col
value DOUBLE 16
isFin BOOL 1
location SYMBOL 17
alter table pt rename location to loc
pt = loadTable("dfs://test", `pt)
pt.schema().colDefs
name typeString typeInt extra comment
id INT 4
deviceId SYMBOL 17
date DATE 6 time_col
value DOUBLE 16
isFin BOOL 1
loc SYMBOL 17
alter table pt drop value
pt = loadTable("dfs://test", `pt)
pt.schema().colDefs
name typeString typeInt extra comment
id INT 4
deviceId SYMBOL 17
date DATE 6 time_col
isFin BOOL 1
loc SYMBOL 17

Related functions: addColumn, dropColumns!, rename!.