alterStandardTableColumn

Last updated: February 13, 2026

Modifies column properties on an existing Snowflake standard table.

Available attributes

Attribute

Type

Description

Required

catalogName

String

Name of the catalog (database) containing the table

No

schemaName

String

Name of the schema containing the table

No

tableName

String

Name of the table containing the column

Yes

columnName

String

Name of the column to alter

Yes

ifExists

Boolean

Only execute if the table exists

No

Nullable

Controls the NOT NULL constraint on the column.

alterNullable nested attributes

Attribute

Type

Description

Required

setNotNull

Boolean

If true, adds NOT NULL constraint

No*

dropNotNull

Boolean

If true, removes NOT NULL constraint

No*

*Exactly one of setNotNull or dropNotNull must be true.

loading

loading

loading

loading

Data type

Changes the column data type. Snowflake supports increasing precision or length for compatible types.

alterDataType nested attributes

Attribute

Type

Description

Required

newDataType

String

The new data type

Yes

loading

loading

loading

loading

Default value

Sets or drops the default value for a column. Note: Snowflake only supports SET DEFAULT for sequence-based defaults.

alterDefault nested attributes

Attribute

Type

Description

Required

newSequenceDefault

String

Sequence expression (e.g., SEQ.NEXTVAL)

No*

dropDefault

Boolean

If true, drops the default value

No*

*Exactly one of newSequenceDefault or dropDefault must be specified.

loading

loading

loading

loading

Masking policy

Sets or unsets a masking policy on the column.

alterMaskingPolicy nested attributes

Attribute

Type

Description

Required

policyName

String

Name of the masking policy to apply

No*

using

String

Additional columns for conditional masking

No

force

Boolean

If true, forces policy replacement

No

unsetPolicy

Boolean

If true, removes the masking policy

No*

*Specify either policyName to set or unsetPolicy to remove.

loading

loading

loading

loading

Projection policy

Sets or unsets a projection policy on the column.

alterProjectionPolicy nested attributes

Attribute

Type

Description

Required

policyName

String

Name of the projection policy

No*

force

Boolean

If true, forces policy replacement

No

unsetPolicy

Boolean

If true, removes the projection policy

No*

*Specify either policyName to set or unsetPolicy to remove.

loading

loading

loading

loading

Comment

Sets or unsets the column comment.

alterColumnComment nested attributes

Attribute

Type

Description

Required

newComment

String

New comment text

No*

unsetComment

Boolean

If true, removes the comment

No*

*Exactly one of newComment or unsetComment must be specified.

loading

loading

loading

loading

Tags

Sets or unsets tags on the column.

alterColumnTags nested attributes

Attribute

Type

Description

Required

setTags

Object

Map of tag names to values to set

No*

unsetTags

Object

List of tag names to unset

No*

*Exactly one of setTags or unsetTags must be specified.

loading

loading

loading

loading