Partage via

Clause CONSTRAINT

  • Article

S’applique à :case marquée oui Databricks SQL case marquée oui Databricks Runtime

Ajoute une clé primaire informationnelle ou une clé étrangère informationnelle dans le cadre d’une instruction CREATE TABLE ou CREATE MATERIALIZED VIEW .

Pour ajouter une contrainte de validation à une table Delta Lake, utilisez ALTER TABLE une fois la table créée.

Syntaxe

Utilisez la clause table_constraint pour définir des contraintes qui s’étendent sur plusieurs colonnes ou pour séparer la syntaxe de la définition de colonne.

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

Utilisez la clause column_constraint pour définir des contraintes spécifiques à une définition de colonne unique.

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 }

Pour la compatibilité avec les dialectes SQL non standard, vous pouvez spécifier ENABLE NOVALIDATE au lieu de NOT ENFORCED DEFERRABLE INITIALLY DEFERRED.

Paramètres

  • CONSTRAINT nom

    (Facultatif) Spécifie un nom pour la contrainte. Le nom doit être unique au sein du schéma. Si aucun nom n’est fourni, Azure Databricks en génère un.

  • CLÉ PRIMAIRE ( key_column [ TIMESERIES ] [, …] ) [ constraint_option […] ]

    S’applique à :coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 11.3 LTS et versions ultérieures case marquée oui Unity Catalog uniquement

    Ajoute une contrainte de clé primaire informationnelle à la table ou à la vue matérialisée. Une table ou une vue matérialisée ne peut avoir plus d’une clé primaire.

    Les colonnes de clé primaire sont implicitement définies comme NOT NULL.

    Les contraintes de clé primaire ne sont pas prises en charge pour les tables du catalogue hive_metastore.

    • key_column

      Une colonne de la table ou de la vue matérialisée du sujet. Les noms de colonnes ne doivent pas être répétés.

    • TIMESERIES

      S’applique à :coche marquée oui Databricks SQL case marquée oui Databricks Runtime 13.3 LTS et versions ultérieures

      Vous pouvez éventuellement étiqueter le composant de colonne de clé primaire comme représentant une série chronologique.

  • PRIMARY KEY [ constraint_option ] [...]

    Ajoute une contrainte de clé primaire à une colonne à la table ou à la vue matérialisée, en utilisant la définition de la colonne clé précédente.

    Cette column_constraint est équivalente à la table_constraint

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

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

    S’applique à :coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 11.3 LTS et versions ultérieures case marquée oui Unity Catalog uniquement

    Ajoute une contrainte de clé étrangère informationnelle (intégrité référentielle) à la table ou à la vue matérialisée.

    Les contraintes de clé étrangère ne sont pas prises en charge pour les tables du catalogue hive_metastore.

    Les contraintes de clé étrangère qui diffèrent seulement dans la permutation des colonnes de clé étrangère ne sont pas autorisées.

    • foreign_key_column

      Une colonne de la table ou de la vue matérialisée du sujet. Les noms de colonnes ne doivent pas être répétés. Le type de données du domaine doit correspondre au type de la parent_column correspondante. Le nombre de colonnes doit correspondre au nombre de parent_column. Deux clés étrangères ne peuvent pas partager un ensemble identique de colonnes de clé étrangère.

    • parent_table

      Spécifie la table ou la vue matérialisée à laquelle la clé étrangère fait référence. La table doit avoir une contrainte PRIMARY KEY définie et vous devez être propriétaire de cette table ou de cette vue matérialisée.

    • parent_column

      Colonne de la table parente ou de la vue matérialisée qui fait partie de sa clé primaire. Toutes les colonnes de clé primaire de la table parent ou de la vue matérialisée doivent être répertoriées.

      Si des colonnes parentes ne sont pas listées, elles sont spécifiées dans l’ordre donné dans la définition de PRIMARY KEY.

    • FOREIGN KEY REFERENCES parent_table [ ( parent_column ) ] foreign_key_option

      Ajoute une contrainte de clé étrangère à colonne unique à la table ou à la vue matérialisée, en utilisant la définition de colonne de clé étrangère précédente.

      Cette column_constraint est équivalente à la table_constraint

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

  • option_contrainte

    Liste les propriétés des contraintes. Toutes les propriétés sont facultatives mais implicites par défaut. Chaque propriété ne peut être spécifiée qu’une seule fois.

    • NOT ENFORCED

      Azure Databricks n’effectue aucune action pour l’appliquer pour les lignes existantes ou nouvelles.

    • DEFERRABLE

      L’application d’une contrainte peut être différée.

    • INITIALLY DEFERRED

      L’application d’une contrainte est différée.

    • NORELY

      Azure Databricks n’exploite pas la contrainte pour réécrire une requête.

  • option_clé_étrangère

    Liste les propriétés spécifiques aux contraintes de clé étrangère. Toutes les propriétés sont facultatives mais implicites par défaut. Chaque propriété ne peut être spécifiée qu’une seule fois.

    • MATCH FULL

      Pour que la contrainte soit considérée comme vraie, toutes les valeurs de colonne doivent être NOT NULL.

    • ON UPDATE NO ACTION

      Si la PRIMARY KEY parente est mise à jour, Azure Databricks n’effectue aucune action pour limiter la mise à jour ou pour mettre à jour la clé étrangère.

    • ON DELETE NO ACTION

      Si la ligne parente est supprimée, Azure Databricks n’effectue aucune action pour restreindre l’action, mettre à jour la clé étrangère ou supprimer la ligne dépendante.

Important

Azure Databricks n’applique pas de contraintes de clé primaire ou de clé étrangère. Vérifiez les contraintes de clé avant d’ajouter une clé primaire ou étrangère. Votre processus d’ingestion peut fournir une telle assurance ou bien vous pouvez effectuer des vérifications sur vos données.

Exemples

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