Compartir vía

Cláusula CONSTRAINT

  • Artículo

Se aplica a: casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime

Agrega una clave principal informativa o una clave externa informativa como parte de una instrucción CREATE TABLE o CREATE MATERIALIZED VIEW.

Para agregar una restricción de comprobación a una tabla de Delta Lake, use ALTER TABLE una vez creada la tabla.

Sintaxis

Use la cláusula table_constraint para definir restricciones que abarquen varias columnas o para separar la sintaxis de la definición de columnas.

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 la cláusula column_constraint para definir restricciones específicas de una única definición de columna.

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 la compatibilidad con dialectos no estándar de SQL, puede especificar ENABLE NOVALIDATE en lugar de NOT ENFORCED DEFERRABLE INITIALLY DEFERRED.

Parámetros

  • CONSTRAINTname

    Especifica un nombre opcional para la restricción. El nombre debe ser único dentro del esquema. Si no se proporciona ningún nombre, Azure Databricks generará uno.

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

    Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 11.3 LTS y versiones posteriores casilla marcada como Sí solo Unity Catalog

    Agrega una restricción de clave principal informativa a la tabla o vista materializada. Una tabla o vista materializada puede tener como máximo una clave principal.

    Las columnas de clave principal se definen implícitamente como NOT NULL.

    Las restricciones de clave principal no se admiten para las tablas del catálogo hive_metastore.

    • key_column

      Columna de la tabla de asunto o vista materializada. Los nombres de columna no se deben repetir.

    • TIMESERIES

      Se aplica a: casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 13.3 LTS y versiones posteriores

      Opcionalmente, etiqueta el componente de columna de clave principal para indicar que representa una serie temporal.

  • PRIMARY KEY [ constraint_option ] [...]

    Agrega una restricción de clave principal de columna única a la tabla o vista materializada mediante la definición de la columna de clave precedente.

    column_constraint es equivalente a table_constraint.

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

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

    Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 11.3 LTS y versiones posteriores casilla marcada como Sí solo Unity Catalog

    Agrega una restricción de clave externa informativa (integridad referencial) a la tabla o vista materializada.

    Las restricciones de clave externa no se admiten para las tablas del catálogo hive_metastore.

    No se permiten restricciones de clave externa que solo difieren en la permutación de las columnas de la clave externa.

    • foreign_key_column

      Columna de la tabla de asunto o vista materializada. Los nombres de columna no se deben repetir. El tipo de datos de cada columna debe coincidir con el tipo de la columna coincidente especificada como parent_column. El número de columnas debe coincidir con el número de apariciones de parent_column. Dos claves externas no pueden compartir un conjunto idéntico de columnas de clave externa.

    • parent_table

      Especifica la tabla o vista materializada a la que hace referencia la clave externa. La tabla debe tener una restricción PRIMARY KEY definida y debe tener el privilegio SELECT en la tabla.

    • parent_column

      Columna de la tabla primaria o vista materializada que forma parte de su clave principal. Se deben enumerar todas las columnas de clave principal de la tabla primaria o la vista materializada.

      Si no se enumeran las columnas primarias, se especifican según el orden determinado en la definición PRIMARY KEY.

    • FOREIGN KEY REFERENCES parent_table [ ( parent_column ) ] foreign_key_option

      Agrega una restricción de clave externa de columna única a la tabla o vista materializada mediante la definición de la columna de clave externa precedente.

      column_constraint es equivalente a table_constraint.

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

  • constraint_option

    Enumera las propiedades de las restricciones. Todas las propiedades son opcionales pero implícitas de manera predeterminada. Cada propiedad se puede especificar como máximo una vez.

    • NOT ENFORCED

      Azure Databricks no realiza ninguna acción para aplicarla a las filas existentes o nuevas.

    • DEFERRABLE

      La aplicación de las restricciones se puede aplazar.

    • INITIALLY DEFERRED

      Se aplaza la aplicación de las restricciones.

    • NORELY o RELY

      Se aplica a: casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime 14.2 y versiones posteriores para restricciones de PRIMARY KEY

      Se aplica a: casilla marcada como Sí Databricks Runtime 15.4 y versiones posteriores para restricciones de FOREIGN KEY

      Si RELY, Azure Databricks puede aprovechar la restricción para reescribir las consultas. Es responsabilidad del usuario asegurarse de que se cumple la restricción. Confiar en una restricción que no se cumple puede provocar resultados de consulta incorrectos.

      El valor predeterminado es NORELY.

  • foreign_key_option

    Enumera las propiedades específicas de las restricciones de clave externa. Todas las propiedades son opcionales pero implícitas de manera predeterminada. Cada propiedad se puede especificar como máximo una vez.

    • MATCH FULL

      Para que la restricción se considere como True, todos los valores de columna deben ser NOT NULL.

    • ON UPDATE NO ACTION

      Si se actualiza el elemento primario PRIMARY KEY, Azure Databricks no realizará ninguna acción para restringir la actualización ni actualizará la clave externa.

    • ON DELETE NO ACTION

      Si se elimina la fila primaria, Azure Databricks no realizará ninguna acción para restringir la acción, actualizar la clave externa ni eliminar la fila dependiente.

Importante

Azure Databricks no aplica restricciones de clave principal ni de clave externa. Confirme las restricciones de clave antes de agregar una clave principal o externa. El proceso de ingesta puede proporcionar dicha garantía o también puede ejecutar comprobaciones en los datos.

Ejemplos

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