CONSTRAINT 子句
适用于：
Databricks SQL Databricks Runtime
重要
此功能目前以公共预览版提供。
添加信息性主键或信息性外键作为 CREATE TABLE 或 CREATE MATERIALIZED VIEW 语句的一部分。
若要向 Delta Lake 表添加 CHECK 约束，请在创建表后使用 ALTER TABLE。
语法
使用 table_constraint 子句定义跨多个列的约束或将语法与列定义分开。
table_constraint
{ [ CONSTRAINT name ]
{ PRIMARY KEY ( key_column [ TIMESERIES ] [, ...] ) [ constraint_option [...] ] |
{ FOREIGN KEY ( foreign_key_column [, ...] )
REFERENCES parent_table [ ( parent_column [, ...] ) ]
[ foreign_key_option | constraint_option ] [...]
}
}
}
使用 column_constraint 子句定义特定于单个列定义的约束。
column_constraint
{ [ CONSTRAINT name ]
{ PRIMARY KEY [ constraint_option ] [...] |
{ [ FOREIGN KEY ]
REFERENCES parent_table [ ( parent_column [, ...] ) ]
[ foreign_key_option | constraint_option ] [...]
}
}
}
constraint_option
{ NOT ENFORCED |
DEFERRABLE |
INITIALLY DEFERRED |
NORELY }
foreign_key_option
{ MATCH FULL |
ON UPDATE NO ACTION |
ON DELETE NO ACTION }
为了与非标准 SQL 方言兼容，可以指定 ENABLE NOVALIDATE 而不是 NOT ENFORCED DEFERRABLE INITIALLY DEFERRED。
参数
CONSTRAINT name
（可选）指定约束的名称。 该名称在架构中必须唯一。 如果未提供任何名称，Azure Databricks 会生成一个。
PRIMARY KEY ( key_column [ TIMESERIES ] [, …] ) [ constraint_option […] ]
适用于：
Databricks SQL Databricks Runtime 11.3 LTS 及更高版本 仅 Unity Catalog向表或具体化视图添加信息性主键约束。 表或具体化视图最多可以有一个主键。
主键列隐式定义为
NOT NULL。hive_metastore目录中的表不支持主键约束。-
主题表或具体化视图的列。 列名不得重复。
TIMESERIES适用于：
Databricks SQL Databricks Runtime 13.3 LTS 及更高版本（可选）将主键列组件标记为表示时序。
-
PRIMARY KEY [ constraint_option ] [...]使用前面的键列定义将单个列主键约束添加到表或具体化视图。
此
column_constraint等同于table_constraintPRIMARY KEY (key_column) [ constraint_option ] [...]FOREIGN KEY (foreign_key_column [, ...] ) REFERENCES parent_table [ ( parent_column [, ...] ) ] foreign_key_option适用于：
Databricks SQL Databricks Runtime 11.3 LTS 及更高版本 仅 Unity Catalog向表或具体化视图添加信息性外键（引用完整性）约束。
hive_metastore目录中的表不支持外键约束。不允许使用仅在外键列的排列上有所不同的外键约束。
-
主题表或具体化视图的列。 列名不得重复。 每列的数据类型必须与匹配的
parent_column的类型相匹配。 列数必须与parent_column的数量相匹配。 两个外键不能共享一组相同的外键列。 -
指定外键引用的表或具体化视图。 该表必须具有定义的
PRIMARY KEY约束，并且你必须拥有该表或具体化视图。 -
父表或具体化视图中的列，该列是其主键的一部分。 必须列出父表或具体化视图的所有主键列。
如果未列出父列，则按
PRIMARY KEY定义中给出的顺序指定它们。 FOREIGN KEY REFERENCES parent_table [ ( parent_column ) ] foreign_key_option使用前面的外键列定义将单个列外键约束添加到表或具体化视图。
此
column_constraint等同于table_constraintFOREIGN KEY ( foreign_key_column ) REFERENCES parent_table [ ( parent_column ) ] foreign_key_option
-
constraint_option
列出约束的属性。 所有属性都是可选的，但默认为默示属性。 每个属性最多只能指定一次。
NOT ENFORCEDAzure Databricks 不对现有行或新行强制执行此操作。
DEFERRABLE可延迟强制执行约束。
INITIALLY DEFERRED延迟强制执行约束。
NORELYAzure Databricks 不会利用约束重写查询。
foreign_key_option
列出特定于外键约束的属性。 所有属性都是可选的，但默认为默示属性。 每个属性最多只能指定一次。
MATCH FULL要使约束被视为 true，所有列值都必须为
NOT NULL。ON UPDATE NO ACTION如果父级
PRIMARY KEY已更新，Azure Databricks 不会执行任何操作来限制更新或更新外键。ON DELETE NO ACTION如果父行已删除，Azure Databricks 不会执行任何操作来限制操作、更新外键或删除从属行。
重要
Azure Databricks 不会强制实施主键或外键约束。 请在添加主键或外键之前确认键约束。 引入过程可提供此类保证，你也可以针对数据运行检查。
示例
-- Create a table with a primary key
> CREATE TABLE persons(first_name STRING NOT NULL, last_name STRING NOT NULL, nickname STRING,
CONSTRAINT persons_pk PRIMARY KEY(first_name, last_name));
-- create a table with a foreign key
> CREATE TABLE pets(name STRING, owner_first_name STRING, owner_last_name STRING,
CONSTRAINT pets_persons_fk FOREIGN KEY (owner_first_name, owner_last_name) REFERENCES persons);
-- Create a table with a single column primary key and system generated name
> CREATE TABLE customers(customerid STRING NOT NULL PRIMARY KEY, name STRING);
-- Create a table with a names single column primary key and a named single column foreign key
> CREATE TABLE orders(orderid BIGINT NOT NULL CONSTRAINT orders_pk PRIMARY KEY,
customerid STRING CONSTRAINT orders_customers_fk REFERENCES customers);