предложение ADD CONSTRAINT

2025-05-20

Область применения: флажок отмечен Databricks SQL Databricks Runtime

Добавляет информационный первичный ключ, информационный внешний ключ или принудительное ограничение проверки в существующую таблицу Delta Lake, материализованное представление или потоковую таблицу.

Синтаксис

ADD [check_constraint | key_constraint ]

check_constraint
    CONSTRAINT name CHECK ( condition ) [ ENFORCED ]

key_constraint
    { [ CONSTRAINT name ]
      {
        PRIMARY KEY ( key_column [ TIMESERIES ] [, ...] ) [ constraint_option [...] ] |
        { FOREIGN KEY (foreign_key_column [, ...] )
          REFERENCES parent_relation [ ( parent_column [, ...] ] )
          [ constraint_option | foreign_key_option ] [...]
      }
    }

constraint_option
    { NOT ENFORCED |
      DEFERRABLE |
      INITIALLY DEFERRED |
      { NORELY | RELY } }

foreign_key_option
    { MATCH FULL |
      ON UPDATE NO ACTION |
      ON DELETE NO ACTION }

Для совместимости с нестандартными диалектами SQL можно указать ENABLE NOVALIDATE вместо NOT ENFORCED DEFERRABLE INITIALLY DEFERRED.

Параметры

check_constraint

Определяет ограничение проверки для отношения.
- CONSTRAINT имя
  
  Задает имя ограничения. Имя должно быть уникальным в связи.
- CHECK ( условие)
  
  Отношение DEFAULT COLLATION должно быть UTF8_BINARY к моменту добавления ограничения.
  
  condition должно быть детерминированным выражением, возвращающим BOOLEAN значение.
  
  condition может состоять из литералов, идентификаторов столбцов в отношениях, а также детерминированных встроенных функций и операторов SQL, кроме следующих:
  - Агрегатные функции
  - Аналитические оконные функции
  - Функции окна ранжирования
  - Функции, генерирующие табличные значения
  - столбцы STRING с параметрами сортировки, отличными от UTF8_BINARY
  Кроме того, condition не должен содержать какой-либо вложенный запрос.
  
  Чтобы ограничение CHECK было удовлетворено в Azure Databricks, оно должно быть равным true.
  
  Delta Lake проверяет допустимость ограничения проверки как для новых, так и для существующих данных. Если любая существующая строка нарушает ограничение, возникает ошибка.
key_constraint

Внимание

Эта функция предоставляется в режиме общедоступной предварительной версии.

Область применения: Databricks SQL Databricks Runtime 11.3 LTS и выше

Определяет информационное первичное или информационное ограничение внешнего ключа для отношения. Ограничения информационных ключей не применяются, но могут повысить производительность, поддерживая оптимизацию запросов .
- CONSTRAINT имя
  
  При необходимости задает имя ограничения. Имя должно быть уникальным в схеме. Если имя не указано, Azure Databricks создаст его.
- PRIMARY KEY ( key_column [ TIMESERIES ] [, ...] ) [ constraint_option [...] ]
  
  Применимо к: только в Unity Catalog
  
  Добавляет ограничение первичного ключа в отношение. Отношение может иметь не более одного первичного ключа.
  
  Ограничения первичного ключа не поддерживаются для отношений в каталоге hive_metastore .
- ключевой_столбец
  
  Столбец отношения субъекта, определенного как NOT NULL. Имена столбцов не должны повторяться.
- TIMESERIES
  
  Область применения: Databricks SQL Databricks Runtime 13.3 LTS и выше
  
  При необходимости обозначение компонента столбца первичного ключа как представляющего временной ряд.
- FOREIGN KEY ( foreign_key_column [, ...] ) REFERENCES parent_relation [ ( parent_column [, ...] ) ] foreign_key_option
  
  Применимо к: только в Unity Catalog
  
  Добавляет ограничение внешнего ключа (целостности ссылок) в отношение.
  
  Ограничения внешнего ключа не поддерживаются для отношений в каталоге hive_metastore .
  - столбец_внешнего_ключа
    
    Столбец отношения субъекта. Имена столбцов не должны повторяться. Тип данных каждого столбца должен соответствовать типу соответствующего parent_column. Число столбцов должно соответствовать количеству parent_columns. Два внешних ключа не могут иметь идентичный набор столбцов внешнего ключа.
  - parent_relation
    
    Указывает отношение, к котором ссылается внешний ключ. Отношение должно иметь определенное PRIMARY KEY ограничение, и необходимо иметь SELECT привилегию на отношение.
  - родительский_столбец
    
    Столбец родительского отношения, который является частью его первичного ключа. Все столбцы первичного ключа родительского отношения должны быть перечислены.
    
    Если родительские столбцы не указаны, они подразумеваются в порядке, указанном в определении PRIMARY KEY.
  Ограничения внешнего ключа, которые отличаются только в перемутации столбцов внешнего ключа, запрещены.
- constraint_option
  
  Выводит свойства ограничений. Все свойства являются необязательными, но подразумеваются по умолчанию. Каждое свойство может быть указано не более одного раза.
  - NOT ENFORCED
    
    Azure Databricks не выполняет никаких действий, чтобы применить его для существующих или новых строк.
  - DEFERRABLE
    
    Принудительное применение ограничений может быть отложено.
  - INITIALLY DEFERRED
    
    Принудительное применение ограничений откладывается.
  - NORELY или RELY
    
    Область применения: Databricks SQL Databricks Runtime 14.2 и выше для PRIMARY KEY ограничений
    
    Применимо к: Databricks SQL Databricks Runtime 15.4 и более поздних версиях для ограничений FOREIGN KEY
    
    Если RELY, Azure Databricks может использовать ограничение для перезаписи запросов. Это ответственность пользователя за обеспечение удовлетворения ограничения. Использование ограничения, которое не удовлетворено, может привести к неправильным результатам запроса.
    
    Значение по умолчанию — NORELY.
- foreign_key_option
  
  Выводит свойства, относящиеся к ограничениям внешнего ключа. Все свойства являются необязательными, но подразумеваются по умолчанию. Каждое свойство может быть указано не более одного раза.
  - MATCH FULL
    
    Чтобы ограничение считалось истинным, все значения столбцов должны быть NOT NULL.
  - ON UPDATE NO ACTION
    
    Если родитель PRIMARY KEY обновлен, Azure Databricks не принимает никаких мер для ограничения обновления или изменения внешнего ключа.
  - ON DELETE NO ACTION
    
    Если родительская строка удалена Azure Databricks, не выполняет никаких действий, чтобы ограничить действие, обновить внешний ключ или удалить зависимые строки.

Внимание

Azure Databricks не применяет ограничения первичного ключа или внешнего ключа. Подтвердите ограничения ключа перед добавлением первичного или внешнего ключа. Процесс инжеста может обеспечить такую гарантию, или вы можете выполнить проверку данных.

Примеры

-- Add a primary key
> CREATE TABLE persons(first_name STRING NOT NULL, last_name STRING NOT NULL, nickname STRING);
> ALTER TABLE persons ADD CONSTRAINT persons_pk PRIMARY KEY(first_name, last_name);

-- Add a foreign key which Databricks does not enforce, but can rely upon.
> CREATE TABLE pets(name STRING, owner_first_name STRING, owner_last_name STRING);
> ALTER TABLE pets ADD CONSTRAINT pets_persons_fk
    FOREIGN KEY(owner_first_name, owner_last_name) REFERENCES persons
    NOT ENFORCED RELY;

-- Add a check contraint
> ALTER TABLE pets ADD CONSTRAINT pets_name_not_cute_chk CHECK (length(name) < 20);

Поделиться через

предложение ADD CONSTRAINT

Синтаксис

Параметры

Примеры

Связанные статьи

Обратная связь

Дополнительные ресурсы