sys.sql_dependencies (Transact-SQL)

Actualizado: 12 de diciembre de 2006

Contiene una fila por cada dependencia de una entidad (independiente) conforme a su referencia en la expresión o instrucciones SQL que definen otro objeto (dependiente) que hace la referencia. La vista sys.sql_dependencies está diseñada para realizar un seguimiento de las dependencias por nombre entre entidades. Para cada fila de sys.sql_dependencies, la entidad a la que se hace referencia aparece por nombre en una expresión SQL persistente del objeto de referencia. Además, si el objeto al que se hace referencia tiene una expresión enlazada a esquemas, se exige la dependencia. Para obtener más información, vea Descripción de las dependencias SQL.

Notas

Las dependencias se establecen durante la ejecución de CREATE sólo si la entidad a la que se hace referencia (independiente) existe en el momento en que se crea el objeto que hace la referencia (dependiente). Debido a la resolución diferida de nombres, la entidad a la que se hace referencia no tiene que existir en el momento de la creación. En este caso, no se crea una fila de dependencias. Además, las entidades a las que se hace referencia mediante SQL dinámico no establecen dependencias.

Si la entidad a la que se hace referencia (independiente) se quita con DROP, la fila de dependencias se elimina automáticamente. Para volver a establecer la fila de dependencias, debe volver a crear ambas con CREATE en el orden de dependencia correcto.

Tanto en las dependencias enlazadas como no enlazadas a esquemas se realiza un seguimiento de los objetos. Las restricciones CHECK, los valores predeterminados y las referencias a columnas están enlazados a esquemas de forma predeterminada. En las dependencias de los tipos, colecciones de esquemas XML y funciones de partición sólo se realiza un seguimiento de las dependencias enlazadas a esquemas. En el Service Pack 1 de SQL Server 2005 y versiones anteriores, los parámetros definidos en una función Transact-SQL o un procedimiento están vinculados implícitamente por esquemas. Por lo tanto, los parámetros que dependen de un tipo definido por el usuario CLR, un alias o una colección de esquemas XML pueden verse mediante la vista de catálogo sys.sql_dependencies. Sin embargo, esto también significa que no se puede cambiar el nombre de estos objetos. En el Service Pack 2 de SQL Server 2005, en la vista de catálogo sólo se realiza un seguimiento de los parámetros que dependen de estos objetos si el módulo Transact-SQL se crea con un enlace de esquema. Un tipo definido por el usuario CLR, un alias o una colección de esquemas XML utilizada como un parámetro en un módulo que no está enlazado mediante esquemas, se pueden cambiar de nombre, pero es posible que la definición del módulo se deba actualizar mediante sp_refreshsqlmodule.

Ejemplos

A. Buscar las dependencias en una función especificada

El siguiente ejemplo devuelve las dependencias en una función especificada. Antes de ejecutar la consulta siguiente, reemplace <database_name> y <schema_name.function_name> por nombres válidos.

USE <database_name>;
GO
SELECT OBJECT_NAME(object_id) AS referencing_object_name
    ,COALESCE(COL_NAME(object_id, column_id), '(n/a)') AS referencing_column_name
    ,*
FROM sys.sql_dependencies
WHERE referenced_major_id = OBJECT_ID('<schema_name.function_name>')
ORDER BY OBJECT_NAME(object_id), COL_NAME(object_id, column_id);
GO 

B. Buscar las restricciones CHECK que dependen de un tipo definido por el usuario CLR

Antes de ejecutar la consulta siguiente, reemplace <database_name> por un nombre válido y <schema_name.data_type_name> por un nombre del tipo definido por el usuario CLR del esquema válido.

USE <database_name>;
GO
SELECT SCHEMA_NAME(o.schema_id) AS schema_name
    ,OBJECT_NAME(o.parent_object_id) AS table_name
    ,OBJECT_NAME(o.object_id) AS constraint_name
FROM sys.sql_dependencies AS d
JOIN sys.objects AS o ON o.object_id = d.object_id
WHERE referenced_major_id = TYPE_ID('<schema_name.data_type_name>')
    AND class = 2 -- schema-bound references to type
    AND OBJECTPROPERTY(o.object_id, 'IsCheckCnst') = 1; -- exclude non-CHECK dependencies
GO

C. Buscar vistas, funciones Transact-SQL y procedimientos almacenados Transact-SQL que dependen de un tipo definido por el usuario CLR o un tipo de datos de alias

La consulta siguiente devuelve todas las dependencias enlazadas a esquemas en vistas, funciones Transact-SQL y procedimientos almacenados Transact-SQL de un tipo definido por el usuario CLR determinado o de un tipo de alias.

USE <database_name>;
GO
SELECT SCHEMA_NAME(o.schema_id) AS dependent_object_schema
  ,OBJECT_NAME(o.object_id) AS dependent_object_name
  ,o.type_desc AS dependent_object_type
  ,d.class_desc AS kind_of_dependency
  ,TYPE_NAME (d.referenced_major_id) AS type_name
FROM sys.sql_dependencies AS d 
JOIN sys.objects AS o
  ON d.object_id = o.object_id
  AND o.type IN ('FN','IF','TF', 'V', 'P')
WHERE d.class = 2 -- dependencies on types
  AND d.referenced_major_id = TYPE_ID('<schema_name.data_type_name>')
ORDER BY dependent_object_schema, dependent_object_name;
GO

Vea también

Referencia

Vistas de catálogo (Transact-SQL)
Vistas de catálogo de objetos (Transact-SQL)
sp_rename (Transact-SQL)
sp_refreshsqlmodule (Transact-SQL)

Otros recursos

Implementar tipos definidos por el usuario
Descripción de las dependencias SQL
Consultar las preguntas más frecuentes (P+F) del catálogo del sistema de SQL Server
Administrar colecciones de esquemas XML en el servidor

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios