createTable with standardTable

Last updated: January 27, 2026

Creates a standard table in Snowflake with Snowflake-specific features such as clustering, change tracking, data retention, policies, tags, and contacts. This extends core Liquibase's createTable change type.

Note: Automatic rollback drops the table.

Known limitation: Snowflake snapshots created with Liquibase Secure 5.1 are incompatible with earlier versions due to enhanced object type detection for TABLES and VIEWS. Regenerate all snapshots with 5.1 after upgrading to avoid false differences in diff and diff-changelog operations.

Available attributes

Attribute

Type

Description

Required

catalogName

String

Name of the catalog (database)

No

schemaName

String

Name of the schema

No

tableName

String

Name of the table to create

Yes

remarks

String

Comment describing the table

No

replaceIfExists

Boolean

If true, replaces existing table with OR REPLACE*

No

ifNotExists

Boolean

If true, only creates if table doesn't exist*

No

isTransient

Boolean

If true, creates a transient table (no Fail-safe)**

No

temporary

Boolean

If true, creates a temporary table**

No

clusterBy

String

Comma-separated list of columns for clustering

No

dataRetentionTimeInDays

Integer

Time Travel retention period (0-90 days)

No

maxDataExtensionTimeInDays

Integer

Maximum extension beyond retention period

No

changeTracking

Boolean

If true, enables change data capture (CDC)

No

enableSchemaEvolution

Boolean

If true, enables flexible schema changes

No

defaultDdlCollation

String

Default collation for string columns (e.g., utf8)

No

copyGrants

Boolean

If true, copies grants from existing table***

No

*replaceIfExists and ifNotExistsare mutually exclusive.

**isTransient and temporaryare mutually exclusive.

***copyGrants requires replaceIfExists=true.

Nested elements

Element

Type

Description

columnStandardTable

Column definition

Column with Snowflake-specific properties

tags

MapWrapper

Key-value pairs of tags to apply

contacts

MapWrapper

Contact purposes to contact names****

rowAccessPolicy

RowAccessPolicy

Row-level security policy

aggregationPolicy

AggregationPolicy

Privacy-preserving aggregation policy

joinPolicy

JoinPolicy

Policy controlling join operations

****Valid contact purposes: steward, support, approver(case-insensitive).

columnStandardTable

Snowflake-specific column element. See columnStandardTable for attributes and nested elements.

loading

loading

loading

loading