Cláusula DROP CONSTRAINT

Aplica-se a: SQL do Databricks Databricks Runtime

Remove uma PRIMARY KEY, FOREIGN KEY ou restrição de CHECK da tabela.

Sintaxe

DROP { PRIMARY KEY [ IF EXISTS ] [ RESTRICT | CASCADE ] |
       FOREIGN KEY [ IF EXISTS ] ( column [, ...] ) |
       CONSTRAINT [ IF EXISTS ] name [ RESTRICT | CASCADE ] }

Parâmetros

• PRIMARY KEY [ IF EXISTS ]

  Aplica-se a: SQL do Databricks Databricks Runtime 11.3 LTS e versões posteriores Somente Catálogo do Unity

  Remove a chave primária da tabela.

• FOREIGN KEY [ IF EXISTS ] ( column [, …] )

  Aplica-se a: SQL do Databricks Databricks Runtime 11.3 LTS e versões posteriores Somente Catálogo do Unity

  Remove a chave estrangeira identificada pela lista ordenada de colunas.

• CONSTRAINT [ IF EXISTS ] name

  Remove a chave primária, a chave estrangeira ou a restrição de verificação identificada pelo nome. As restrições de verificação só podem ser removidas pelo nome.

• RESTRICT ou CASCADE

  Se você especificar RESTRICT e a chave primária for referenciada por qualquer chave estrangeira, a instrução falhará. Se você especificar CASCADE, a remoção da chave primária resultará na remoção de todas as chaves estrangeiras que fazem referência à tabela. O padrão é RESTRICT.

• IF EXISTS

  Se você especificar IF EXISTS, a instrução será ignorada se a tabela não tiver restrição de correspondência.

Exemplos

> 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);

> 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;

> ALTER TABLE pets ADD CONSTRAINT pets_name_not_cute_chk CHECK (length(name) < 20);

-- Drop the check constraint by name
> ALTER TABLE pets DROP CONSTRAINT pets_name_not_cute_chk;

-- Attempt to drop the primary key of persons by name
> ALTER TABLE persons DROP CONSTRAINT persons_pk RESTRICT;
  Error: A foreign key `pets_persons_fk` depends on the primary key

-- Drop the foreign key from pets by listing the columns
> ALTER TABLE pets DROP FOREIGN KEY IF EXISTS  (owner_first_name, owner_last_name);

-- Drop the primary key of persons
> ALTER TABLE persons DROP PRIMARY KEY CASCADE;

Artigos relacionados

• ALTER TABLE
• ADD CONSTRAINT