Assert (operador de Showplan)

Actualizado: 14 de abril de 2006

El operador Assert comprueba una condición. Por ejemplo, valida la integridad referencial o se asegura de que una subconsulta escalar devuelve una fila. Por cada fila de entrada, el operador Assert evalúa la expresión de la columna Argument del plan de ejecución. Si la expresión da como resultado NULL, la fila se pasa a través del operador Assert y continúa la ejecución de la consulta. Si la expresión da como resultado un valor distinto a NULL, se generará el error apropiado.

Assert es un operador físico.

Icono del plan de ejecución gráfico

Ejemplos

A. Validar una restricción CHECK

En el ejemplo siguiente se actualiza el valor de la columna Gender para un Id. de empleado concreto de la tabla Employee. La tabla tiene una restricción CHECK que limita los valores aceptados en la columna a los valores "F" y "M". La salida del plan de ejecución de consultas muestra que el optimizador de consultas usa el operador Assert para validar el valor especificado en la instrucción UPDATE respecto a la restricción CHECK y genera un error si no se cumplen las condiciones de la restricción.

USE AdventureWorks;
GO
SET NOCOUNT ON;
GO
SET SHOWPLAN_ALL ON;
GO
UPDATE HumanResources.Employee
SET Gender = 'X' WHERE EmployeeID = 1;
GO
SET SHOWPLAN_ALL OFF;
GO

La salida del plan de ejecución del operador Assert se muestra a continuación.

PhysicalOp 
-----------------------------------------------------------------------
Assert

Argument
-----------------------------------------------------------------------
WHERE:(CASE WHEN upper([AdventureWorks].[HumanResources].[Employee].[Gender])<>N'F' AND 
upper([AdventureWorks].[HumanResources].[Employee].[Gender])<>N'M' THEN 
    (0) ELSE NULL END)

B. Validar una restricción FOREIGN KEY

En el ejemplo siguiente se elimina una fila de la tabla Person.Contact. En este caso, hay seis tablas que tienen una referencia de clave externa a la columna ContactID de esta tabla. La salida del plan de ejecución de consultas muestra que el optimizador de consultas utiliza el operador Assert para validar la instrucción DELETE respecto a cada una de estas restricciones.

USE AdventureWorks;
GO
SET NOCOUNT ON;
go
SET SHOWPLAN_ALL ON;
GO
DELETE Person.Contact WHERE ContactID = 1209;
GO
SET SHOWPLAN_ALL OFF;
GO

La salida del plan de ejecución del operador Assert se muestra a continuación.

PhysicalOp 
-----------------------------------------------------------------------
Assert

Argument
-----------------------------------------------------------------------
WHERE:(CASE WHEN NOT [Expr1030] IS NULL THEN (0) ELSE CASE WHEN NOT 
[Expr1031] IS NULL THEN (1) ELSE CASE WHEN NOT [Expr1032] IS NULL THEN 
(2) ELSE CASE WHEN NOT [Expr1033] IS NULL THEN (3) ELSE CASE WHEN NOT 
[Expr1034] IS NULL THEN (4) ELSE CASE WHEN NOT [Expr1035] IS NULL THEN (5) ELSE NULL END END END END END END)

C. Validar una subconsulta escalar

En el ejemplo siguiente se usa una subconsulta en la cláusula WHERE de la consulta. En este ejemplo se usa deliberadamente una subconsulta que devuelve varias filas para hacer que el operador Assert genere un error. La salida del plan de ejecución de consultas muestra que el optimizador de consultas usa el operador Assert para asegurarse de que la subconsulta especificada en la instrucción SELECT devuelva una sola fila.

USE AdventureWorks;
GO
SET NOCOUNT ON;
go
SET SHOWPLAN_ALL ON;
GO
SELECT EmployeeID 
FROM HumanResources.Employee
WHERE ContactID = (SELECT ContactID FROM Person.Contact);
GO
SET SHOWPLAN_ALL OFF;
GO
-- Run the query again to display the error message raised by the 
-- Assert Operator.
SELECT EmployeeID 
FROM HumanResources.Employee
WHERE ContactID = (SELECT ContactID FROM Person.Contact);
GO

La salida del plan de ejecución del operador Assert se muestra a continuación.

PhysicalOp 
-----------------------------------------------------------------------
Assert

Argument
-----------------------------------------------------------------------
WHERE:(CASE WHEN [Expr1007]>(1) THEN (0) ELSE NULL END)

Vea también

Tareas

Cómo mostrar un plan de ejecución real

Conceptos

Referencia sobre operadores lógicos y físicos
Mostrar planes de ejecución mediante las opciones SET del plan de presentación (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión	Historial
14 de abril de 2006	Contenido nuevo: Se agregó la sección Ejemplo.