适用于:
Databricks SQL
Databricks Runtime
添加信息性主键、信息外键或信息性唯一约束作为或CREATE TABLE语句的一CREATE MATERIALIZED VIEW部分。
若要将 check 约束添加到 Delta Lake 表,请在创建表后使用 ALTER TABLE。
要为度量视图添加信息关系约束,请使用 ALTER VIEW (Beta)。 参见 度量视图之间的关系。
语法
使用 table_constraint 子句定义跨多个列的约束或将语法与列定义分开。
table_constraint
{ [ CONSTRAINT name ]
{ PRIMARY KEY ( key_column [ TIMESERIES ] [, ...] ) [ constraint_option [...] ] |
UNIQUE ( key_column [, ...] ) [ 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 ] [...] |
UNIQUE [ constraint_option ] [...] |
{ [ FOREIGN KEY ]
REFERENCES parent_table [ ( parent_column [, ...] ) ]
[ foreign_key_option | constraint_option ] [...]
}
}
}
constraint_option
{ NOT ENFORCED |
DEFERRABLE |
INITIALLY DEFERRED |
{ RELY | NORELY } }
foreign_key_option
{ MATCH FULL |
ON UPDATE NO ACTION |
ON DELETE NO ACTION }
为了与非标准 SQL 方言兼容,可以指定 ENABLE NOVALIDATE 而不是 NOT ENFORCED DEFERRABLE INITIALLY DEFERRED。
参数
CONSTRAINT名字(可选)指定约束的名称。 该名称在架构中必须唯一。 如果未提供任何名称,Azure Databricks 会生成一个。
PRIMARY KEY(key_column [ TIMESERIES ] [,... ] )[ constraint_option ] "适用于:
Databricks SQL
Databricks Runtime 11.3 LTS 及更高版本
仅 Unity 目录向表或具体化视图添加信息性主键约束。 表或具体化视图最多可以有一个主键。
主键列隐式定义为
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 ] [...]UNIQUE ( key_column [, ...] ) [ constraint_option [...] ]适用于:
Databricks SQL
Databricks Runtime 18.2 及更高
”,仅限 Unity 目录向表添加信息性唯一约束。 表可以具有多个唯一约束。
目录中的
hive_metastore表不支持唯一约束。约束中的
UNIQUE列可以为 null,包括外键引用约束时。NULLUNIQUE列中的值被视为彼此不同的值,因此重复NULL值不会违反约束的UNIQUE语义。-
主题表的列。 列名不得重复。
-
UNIQUE [ constraint_option ] [...]使用前面的键列定义将单个列唯一约束添加到表中。
此
column_constraint等同于table_constraintUNIQUE (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 目录向表或具体化视图添加信息性外键(引用完整性)约束。
hive_metastore目录中的表不支持外键约束。不允许使用仅在外键列的排列上有所不同的外键约束。
-
主题表或具体化视图的列。 列名不得重复。 每列的数据类型必须与匹配的
parent_column的类型相匹配。 列数必须与parent_column的数量相匹配。 两个外键不能共享一组相同的外键列。 -
指定外键引用的表或具体化视图。 该表必须具有定义的
PRIMARY KEY约束,或者,在 Databricks Runtime 18.2 及更高版本中,必须具有定义的UNIQUE约束,并且必须对表具有SELECT权限。 -
父表或具体化视图中的列,它是其主键的一部分,或者,在 Databricks Runtime 18.2 及更高版本中,是唯一约束的一部分。 必须列出父表或具体化视图的所有主键列或唯一约束列。
如果未列出父列,则按
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
-
约束选项
列出约束的属性。 所有属性都是可选的,但默认为默示属性。 每个属性最多只能指定一次。
NOT ENFORCEDAzure Databricks 不对现有行或新行强制执行此操作。
DEFERRABLE可延迟强制执行约束。
INITIALLY DEFERRED延迟强制执行约束。
NORELY或RELY适用于:
Databricks SQL
Databricks Runtime 14.2 及更高版本(适用于 PRIMARY KEY约束)适用于:
Databricks SQL
Databricks Runtime 15.4 及更高版本(适用于 FOREIGN KEY约束)适用于:
Databricks SQL
Databricks Runtime 18.2 及更高版本的约束UNIQUE如果
RELY,Azure Databricks 可能会利用约束来重写和优化查询。 用户负责确保满足约束。 依赖于未被满足的约束可能会导致查询结果不正确。 与此RELY相关的查询优化需要专业级或无服务器SQL仓库,或者无服务器计算,而经典SQL仓库不支持。默认为
NORELY。
外键选项
列出特定于外键约束的属性。 所有属性都是可选的,但默认为默示属性。 每个属性最多只能指定一次。
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);
-- Create a table with a column unique constraint
> CREATE TABLE person_contacts(first_name STRING NOT NULL, last_name STRING NOT NULL,
nickname STRING UNIQUE);
-- Create a table with a multi-column unique constraint
> CREATE TABLE person_accounts(first_name STRING NOT NULL, last_name STRING NOT NULL, account_id STRING,
CONSTRAINT person_accounts_uq UNIQUE(first_name, last_name));
-- Create a table with a foreign key that references a unique column
> CREATE TABLE pet_tags(tag STRING NOT NULL, owner_nickname STRING,
CONSTRAINT pet_tags_owner_fk FOREIGN KEY (owner_nickname) REFERENCES person_contacts(nickname));