Clause CONSTRAINT

S’applique à : Databricks SQL 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 |
      { RELY | 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

• CONSTRAINTnom

  (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.

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

  S’applique à : Databricks SQL Databricks Runtime 11.3 LTS et versions ultérieures 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 à : Databricks SQL Databricks Runtime 13.3 LTS et ultérieur

    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 à : Databricks SQL Databricks Runtime 11.3 LTS et versions ultérieures 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 de PRIMARY KEY définie et vous devez disposer du privilège SELECT sur la table.

  • 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 ou RELY

    S’applique à : Databricks SQL Databricks Runtime 14.2 et versions ultérieures pour les contraintes PRIMARY KEY

    S’applique à : Databricks Runtime 15.4 et versions ultérieures pour les contraintes FOREIGN KEY

    Si RELY, Azure Databricks peut exploiter la contrainte pour réécrire des requêtes. Il incombe à l’utilisateur de s’assurer que la contrainte est respectée. Si vous vous fiez à une contrainte qui n’est pas satisfaite, les résultats de la requête peuvent être erronés.

    Par défaut, il s’agit de NORELY.

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

Articles connexes

• Clause ADD CONSTRAINT

• ALTER TABLE

• CREATE TABLE

• Clause DROP CONSTRAINT

• CRÉER UNE VUE DÉMATÉRIALISÉE