table_constraint (Transact-SQL)

Sintaxis

[ CONSTRAINT constraint_name ] 
{ 
    { PRIMARY KEY | UNIQUE } 
        [ CLUSTERED | NONCLUSTERED ] 
        (column [ ASC | DESC ] [ ,...n ] )
        [ WITH FILLFACTOR =fillfactor 
        [ WITH ( <index_option>[ , ...n ] ) ]
        [ ON { partition_scheme_name (partition_column_name ... )
          | filegroup | "default" } ] 
    | FOREIGN KEY 
        (column [ ,...n ] )
        REFERENCES referenced_table_name [ ( ref_column [ ,...n ] ) ] 
        [ ON DELETE { NO ACTION | CASCADE | SET NULL | SET DEFAULT } ] 
        [ ON UPDATE { NO ACTION | CASCADE | SET NULL | SET DEFAULT } ] 
        [ NOT FOR REPLICATION ] 
    | DEFAULT constant_expression FOR column [ WITH VALUES ] 
    | CHECK [ NOT FOR REPLICATION ] (logical_expression )
}

Argumentos

• CONSTRAINT
  Especifica el inicio de una definición para una restricción PRIMARY KEY, UNIQUE, FOREIGN KEY o CHECK o una definición DEFAULT.

• constraint_name
  Es el nombre de la restricción. Los nombres de restricción deben seguir las reglas de los identificadores, excepto en que el nombre no puede empezar por un signo de número (#). Si no se proporciona el parámetro constraint_name, se asigna a la restricción un nombre generado por el sistema.

• PRIMARY KEY
  Es una restricción que aplica la integridad de entidad para una columna o columnas especificadas mediante un índice único. Solo se puede crear una restricción PRIMARY KEY por cada tabla.

• UNIQUE
  Es una restricción que proporciona integridad de entidad para una columna o columnas especificadas mediante un índice único.

• CLUSTERED | NONCLUSTERED
  Especifica que se ha creado un índice clúster o no clúster para la restricción PRIMARY KEY o UNIQUE. Las restricciones PRIMARY KEY tienen el valor predeterminado CLUSTERED. Las restricciones UNIQUE tienen el valor predeterminado NONCLUSTERED.

  Si en una tabla ya existe una restricción o índice agrupado, no se puede especificar CLUSTERED. Si en una tabla ya existe una restricción o índice agrupado, el valor predeterminado de la restricción PRIMARY KEY es NONCLUSTERED.

  Las columnas con los tipos de datos ntext, text, varchar(max), nvarchar(max), varbinary(max), xml o image no se pueden especificar como columnas de un índice.

• column
  Es una columna o lista de columnas especificadas entre paréntesis que se utilizan en una nueva restricción.

• [ ASC | DESC ]
  Especifica cómo se ordenan la columna o las columnas que participan en las restricciones de la tabla. El valor predeterminado es ASC.

• WITH FILLFACTOR **=**fillfactor
  Especifica cuánto se debe llenar cada página de índice del Motor de base de datos utilizada para almacenar los datos de índice. Los valores de fillfactor especificados por el usuario pueden estar comprendidos entre 1 y 100. Si no se especifica un valor, el valor predeterminado es 0.

  Importante
  La documentación de WITH FILLFACTOR = fillfactor como la única opción de índice que se aplica a las restricciones PRIMARY KEY o UNIQUE se mantiene por compatibilidad con versiones anteriores. No obstante, no se documentará de esta forma en las futuras versiones. Es posible especificar otras opciones de índice en la cláusula index_option de ALTER TABLE.

• ON { partition_scheme_name**(partition_column_name)** | filegroup| "default" }
  Especifica la ubicación de almacenamiento del índice creado para la restricción. Si se especifica partition_scheme_name, el índice se divide en particiones y las particiones se asignan a los grupos de archivos que se han especificado mediante partition_scheme_name. Si se especifica el parámetro filegroup, el índice se crea en el grupo de archivos indicado. Si se especifica el parámetro "default" o si no se especifica ON en ningún caso, el índice se crea en el mismo grupo de archivos que la tabla. Si se especifica ON al agregar un índice clúster para una restricción PRIMARY KEY o UNIQUE, la tabla completa se mueve al grupo de archivos especificado cuando se crea el índice clúster.

  En este contexto, default no es una palabra clave; es un identificador del grupo de archivos predeterminado y debe delimitarse, como en ON "default" u ON [default]. Si se especifica el parámetro "default", la opción QUOTED_IDENTIFIER debe ser ON para la sesión actual. Ésta es la configuración predeterminada. Para obtener más información, vea SET QUOTED_IDENTIFIER (Transact-SQL).

• FOREIGN KEY REFERENCES
  Es una restricción que proporciona integridad referencial para los datos de la columna. Las restricciones FOREIGN KEY exigen que cada valor de la columna exista en la columna especificada de la tabla a la que se hace referencia.

• referenced_table_name
  Es la tabla a la que hace referencia la restricción FOREIGN KEY.

• ref_column
  Es una columna o lista de columnas entre paréntesis a la que hace referencia la nueva restricción FOREIGN KEY.

• ON DELETE { NO ACTION | CASCADE | SET NULL | SET DEFAULT }
  Especifica la acción que se produce en las filas de la tabla modificada, si esas filas tienen una relación referencial y la fila a la que se hace referencia se elimina de la tabla primaria. El valor predeterminado es NO ACTION.

  • NO ACTION
    El SQL Server Database Engine (Motor de base de datos de SQL Server) genera un error y se revierte la acción de eliminación de la fila de la tabla primaria.

  • CASCADE
    Si esa fila se elimina de la tabla primaria, las filas correspondientes se eliminan de la tabla de referencia.

  • SET NULL
    Cuando se elimina la fila correspondiente de la tabla primaria, todos los valores que componen la clave externa se establecen en NULL. Para que esta restricción se ejecute, las columnas de clave externa deben aceptar valores NULL.

  • SET DEFAULT
    Cuando se elimina la fila correspondiente de la tabla primaria, todos los valores que componen la clave externa se establecen en sus valores predeterminados. Para que esta restricción se ejecute, todas las columnas de clave externa deben tener definiciones predeterminadas. Si una columna acepta valores NULL y no se ha establecido un valor predeterminado explícito, NULL se convierte en el valor predeterminado explícito de dicha columna.

  No especifique CASCADE si la tabla se va a incluir en una publicación de mezcla que utiliza registros lógicos. Para obtener más información acerca de los registros lógicos, vea Agrupar cambios en filas relacionadas con registros lógicos.

  No se puede definir la acción ON DELETE CASCADE si ya existe un desencadenador INSTEAD OF en ON DELETE en la tabla que se está modificando.

  Por ejemplo, en la base de datos AdventureWorks2008R2, la tabla ProductVendor tiene una relación referencial con la tabla Vendor. La clave externa ProductVendor.VendorID hace referencia a la clave principal Vendor.VendorID.

  Si se ejecuta una instrucción DELETE en una fila de la tabla Vendor y se especifica una acción ON DELETE CASCADE para ProductVendor.VendorID, el Motor de base de datos comprueba una o más filas dependientes de la tabla ProductVendor. Si existe alguna, se eliminarán las filas dependientes de la tabla ProductVendor, así como la fila a la que se hace referencia de la tabla Vendor.

  Por el contrario, si se especifica NO ACTION, el Motor de base de datos genera un error y revierte la acción de eliminación de la fila Vendor si al menos hay una fila en la tabla ProductVendor que haga referencia a dicha fila.

• ON UPDATE { NO ACTION | CASCADE | SET NULL | SET DEFAULT }
  Especifica la acción que se produce en las filas de la tabla modificada cuando esas filas tienen una relación referencial y la fila a la que se hace referencia se actualiza en la tabla primaria. El valor predeterminado es NO ACTION.

  • NO ACTION
    El Motor de base de datos genera un error y se revierte la acción de actualización de la fila de la tabla primaria.

  • CASCADE
    Si esa fila se actualiza en la tabla primaria, las filas correspondientes se actualizan en la tabla de referencia.

  • SET NULL
    Cuando se actualiza la fila correspondiente en la tabla primaria, todos los valores que componen la clave externa se establecen en NULL. Para que esta restricción se ejecute, las columnas de clave externa deben aceptar valores NULL.

  • SET DEFAULT
    Cuando se actualiza la fila correspondiente en la tabla primaria, todos los valores que componen la clave externa se establecen en sus valores predeterminados. Para que esta restricción se ejecute, todas las columnas de clave externa deben tener definiciones predeterminadas. Si una columna acepta valores NULL y no se ha establecido un valor predeterminado explícito, NULL se convierte en el valor predeterminado explícito de dicha columna.

  No especifique CASCADE si la tabla se va a incluir en una publicación de mezcla que utiliza registros lógicos. Para obtener más información acerca de los registros lógicos, vea Agrupar cambios en filas relacionadas con registros lógicos.

  No se puede definir ON UPDATE CASCADE, SET DEFAULT o SET NULL si ya existe un desencadenador INSTEAD OF en ON UPDATE en la tabla que se va a modificar.

  Por ejemplo, en la base de datos AdventureWorks2008R2, la tabla ProductVendor tiene una relación referencial con la tabla Vendor. La clave externa ProductVendor.VendorID hace referencia a la clave principal Vendor.BusinessEntityID.

  Si se ejecuta una instrucción UPDATE en una fila de la tabla Vendor y se especifica una acción ON UPDATE CASCADE para ProductVendor.BusinessEntityID, Motor de base de datos comprueba si hay una o más filas dependientes de la tabla ProductVendor. Si existe alguna, se actualizarán la fila dependiente de la tabla ProductVendor, así como la fila a la que se hace referencia de la tabla Vendor.

  Por el contrario, si se especifica NO ACTION, el Motor de base de datos genera un error y revierte la acción de actualización en la fila Vendor si al menos hay una fila en la tabla ProductVendor que haga referencia a dicha fila.

• NOT FOR REPLICATION
  Se puede especificar para restricciones FOREIGN KEY y CHECK. Si se especifica esta cláusula para una restricción, ésta no se aplica cuando los agentes de replicación realizan operaciones de inserción, actualización o eliminación. Para obtener más información, vea Controlar restricciones, identidades y desencadenadores con NOT FOR REPLICATION.

• DEFAULT
  Especifica el valor predeterminado de la columna. Las definiciones DEFAULT se pueden utilizar para proporcionar valores a una nueva columna de las filas existentes de datos. Las definiciones DEFAULT no se pueden agregar a las columnas que tengan un tipo de datos timestamp, una propiedad IDENTITY, una definición DEFAULT existente o un valor predeterminado enlazado. Si la columna tiene un valor predeterminado existente, éste debe quitarse para poder agregar uno nuevo. Si se especifica un valor predeterminado para una columna de un tipo definido por el usuario, dicho tipo debe ser compatible con la conversión implícita de constant_expression en el tipo definido por el usuario. Para mantener la compatibilidad con versiones anteriores de SQL Server, se puede asignar un nombre de restricción a una definición DEFAULT.

• constant_expression
  Es un valor literal, un valor NULL o una función del sistema que se utiliza como valor predeterminado de la columna. Si constant_expression se utiliza junto con una columna definida como de tipo Microsoft .NET Framework definido por el usuario, la implementación del tipo debe ser compatible con la conversión implícita de constant_expression en el tipo definido por el usuario.

• FOR column
  Especifica la columna asociada a una definición DEFAULT de nivel de tabla.

• WITH VALUES
  Especifica que el valor dado en DEFAULT constant_expression se almacena en una nueva columna que se agrega a las filas existentes. WITH VALUES solo puede especificarse cuando se especifique DEFAULT en una cláusula de columna ADD. Si la columna agregada permite valores NULL y se ha especificado WITH VALUES, el valor predeterminado se almacena en la nueva columna que se agrega a las filas existentes. Si no se especifica WITH VALUES para las columnas que permiten valores NULL, el valor NULL se almacena en la nueva columna en las filas existentes. Si la nueva columna no permite valores NULL, el valor predeterminado se almacena en las nuevas filas, independientemente de que se especifique o no WITH VALUES.

• CHECK
  Es una restricción que exige la integridad del dominio al limitar los valores posibles que se pueden escribir en una o varias columnas.

• logical_expression
  Es una expresión lógica empleada en una restricción CHECK que devuelve TRUE o FALSE. El parámetro logical_expression usado con las restricciones CHECK no puede hacer referencia a otra tabla, aunque sí a otras columnas de la misma tabla para la misma fila. La expresión no puede hacer referencia a un tipo de datos de alias.

Comentarios

Cuando se agregan restricciones FOREIGN KEY o CHECK, se comprueba si hay infracciones de restricción en todos los datos existentes a menos que se especifique la opción WITH NOCHECK. Si se produce alguna infracción, ALTER TABLE no se ejecuta correctamente y se devuelve un error. Cuando se agrega una nueva restricción PRIMARY KEY o UNIQUE a una columna existente, los datos de las columnas deben ser únicos. Si se detectan valores duplicados, ALTER TABLE no se ejecuta correctamente. La opción WITH NOCHECK no tiene efecto cuando se agregan restricciones PRIMARY KEY o UNIQUE.

Cada restricción PRIMARY KEY y UNIQUE genera un índice. El número de restricciones UNIQUE y PRIMARY KEY no puede hacer que el número de índices de la tabla supere 999 índices no clúster y 1 índice clúster. Las restricciones de clave externa no generan automáticamente un índice. Sin embargo, las columnas de clave externa suelen emplearse en los criterios de combinación en consultas mediante la correspondencia de la columna o columnas de la restricción de clave externa de una tabla y la columna o columnas de la clave única o principal de la otra tabla. Un índice de las columnas de clave externa permite al Motor de base de datos buscar con rapidez datos relacionados en la tabla de clave externa.

Ejemplos

Para obtener ejemplos, vea ALTER TABLE (Transact-SQL).

Vea también

Referencia

Conceptos