Cláusula CONSTRAINT

Aplica-se a: SQL do Databricks Databricks Runtime

Adiciona uma chave primária informativa ou uma chave estrangeira informativa como parte de uma instrução CREATE TABLE ou CREATE MATERIALIZED VIEW.

Para adicionar uma restrição de verificação a uma tabela do Delta Lake, use ALTER TABLE após a criação da tabela.

Sintaxe

Use a cláusula table_constraint para definir restrições que abrangem diversas colunas ou para separar a sintaxe da definição de coluna.

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 ] [...]
       }
     }
   }

Use a cláusula column_constraint para definir restrições específicas a uma única definição de coluna.

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 |
      { RELY | NORELY } }

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

Para compatibilidade com dialetos SQL não padrão, especifique ENABLE NOVALIDATE em vez de NOT ENFORCED DEFERRABLE INITIALLY DEFERRED.

Parâmetros

• CONSTRAINTname

  Especifica opcionalmente um nome para a restrição. O nome deve ser exclusivo no esquema. Se nenhum nome for fornecido, o Azure Databricks gerará um.

• PRIMARY KEY ( key_column [ TIMESERIES ] [, …] ) [ constraint_option […] ]

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

  Adiciona uma restrição de chave primária informativa à tabela ou exibição materializada. Uma tabela ou exibição materializada pode ter no máximo uma chave primária.

  As colunas de chave primária são definidas implicitamente como NOT NULL.

  As restrições de chave primária não têm suporte para tabelas no catálogo hive_metastore.

  • key_column

    Uma coluna da tabela de assunto ou exibição materializada. Os nomes de colunas não devem ser repetidos.

  • TIMESERIES

    Aplica-se a: SQL do Databricks Databricks Runtime 13.3 LTS e versões posteriores

    Opcionalmente, rotula o componente de coluna de chave primária como representando uma série de horários.

• PRIMARY KEY [ constraint_option ] [...]

  Adiciona uma restrição de chave primária de coluna única à tabela ou à exibição materializada, usando a definição de coluna de chave anterior.

  Esse column_constraint é equivalente ao table_constraint

  PRIMARY KEY (key_column) [ constraint_option ] [...]

• FOREIGN KEY (foreign_key_column [, ...] ) REFERENCES parent_table [ ( parent_column [, ...] ) ] foreign_key_option

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

  Adiciona uma restrição de chave estrangeira informativa (integridade referencial) à tabela ou à exibição materializada.

  As restrições de chave estrangeira não têm suporte para tabelas no catálogo hive_metastore.

  Não são permitidas restrições de chave estrangeira que diferem somente na permutação das colunas de chave estrangeira.

  • foreign_key_column

    Uma coluna da tabela de assunto ou exibição materializada. Os nomes de colunas não devem ser repetidos. O tipo de dados de cada coluna deve corresponder ao tipo do parent_column correspondente. O número de colunas deve corresponder ao número de parent_columns. Duas chaves estrangeiras não podem compartilhar um conjunto idêntico de colunas de chave estrangeira.

  • parent_table

    Especifica a tabela ou a exibição materializada à qual a chave estrangeira se refere. A tabela deve ter uma restrição de PRIMARY KEY definida e você deve ter o privilégio SELECT na tabela.

  • parent_column

    Uma coluna na tabela pai ou na exibição materializada que faz parte de sua chave primária. Todas as colunas de chave primária da tabela pai ou do modo de exibição materializado devem ser listadas.

    Se as colunas pai não estiverem listadas, elas serão especificadas pela ordem fornecida na definição PRIMARY KEY.

  • FOREIGN KEY REFERENCES parent_table [ ( parent_column ) ] foreign_key_option

    Adiciona uma restrição de chave estrangeira de coluna única à tabela ou à exibição materializada, usando a definição de coluna de chave estrangeira anterior.

    Esse column_constraint é equivalente ao table_constraint

    FOREIGN KEY ( foreign_key_column ) REFERENCES parent_table [ ( parent_column ) ] foreign_key_option

• constraint_option

  Lista as propriedades das restrições. Todas as propriedades são opcionais, mas são implícitas por padrão. Cada propriedade pode ser especificada uma vez no máximo.

  • NOT ENFORCED

    O Azure Databricks não executa nenhuma ação para aplicá-la a linhas existentes ou novas.

  • DEFERRABLE

    A imposição da restrição pode ser adiada.

  • INITIALLY DEFERRED

    A imposição da restrição foi adiada.

  • NORELY ou RELY

    Aplica-se a: Databricks SQL Databricks Runtime 14.2 e superior às restrições de PRIMARY KEY

    Aplica-se a: Databricks Runtime 15.4 e superior às restrições de FOREIGN KEY

    Se RELY, o Azure Databricks poderá explorar a restrição para reescrever consultas. É responsabilidade do usuário garantir que a restrição seja atendida. Depender de uma restrição que não está satisfeita pode levar a resultados de consulta incorretos.

    O padrão é NORELY.

• foreign_key_option

  Lista as propriedades específicas de restrições de chave estrangeira. Todas as propriedades são opcionais, mas são implícitas por padrão. Cada propriedade pode ser especificada uma vez no máximo.

  • MATCH FULL

    Para que a restrição seja considerada verdadeira, todos os valores de coluna devem ser NOT NULL.

  • ON UPDATE NO ACTION

    Se o PRIMARY KEY pai for atualizado, o Azure Databricks não realizará nenhuma ação para restringir a atualização ou atualizar a chave estrangeira.

  • ON DELETE NO ACTION

    Se a linha pai for excluída, o Azure Databricks não realizará nenhuma ação para restringir a atividade, atualizar a chave estrangeira ou excluir a linha dependente.

Importante

O Azure Databricks não impõe restrições de chave primária ou de chave estrangeira. Confirme as restrições de chave antes de adicionar uma chave primária ou estrangeira. Seu processo de ingestão pode fornecer essa garantia ou é possível executar verificações em seus dados.

Exemplos

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

Artigos relacionados

• Cláusula ADD CONSTRAINT

• ALTER TABLE

• CREATE TABLE

• Cláusula DROP CONSTRAINT

• CRIAR A EXIBIÇÃO MATERIALIZADA