sys.sql_expression_dependencies (Transact-SQL)

Artículo
06/18/2013

Contiene una fila para cada dependencia por nombre en una entidad definida por el usuario en la base de datos actual. Se crea una dependencia entre dos entidades cuando una entidad, llamada entidad a la que se hace referencia, aparece por nombre en una expresión de SQL persistente de otra entidad, llamada entidad que hace la referencia. Por ejemplo, si en la definición de una vista se hace referencia a una tabla, la vista, como entidad que hace la referencia, depende de la tabla, la entidad a la que se hace referencia. Si desapareciera la tabla, la vista sería inservible.

Puede utilizar esta vista de catálogo para notificar información de dependencia de las entidades siguientes:

Entidades enlazadas a un esquema.
Entidades no enlazadas a un esquema.
Entidades entre servidores y entre bases de datos. Se notifican los nombres de entidad; en cambio, no se resuelve el identificador de la entidad.
Dependencias de nivel de columna en entidades enlazadas a un esquema. Se pueden devolver las dependencias de nivel de columna de los objetos no enlazados a un esquema usando sys.dm_sql_referenced_entities.
Desencadenadores DDL de nivel de servidor en el contexto de la base de datos master.

Nombre de la columna	Tipo de datos	Descripción
referencing_id	int	Identificador de la entidad que hace la referencia. No acepta valores NULL.
referencing_minor_id	int	Identificador de la columna cuando la entidad de referencia es una columna; en caso contrario, es 0. No acepta valores NULL.
referencing_class	tinyint	Clase de la entidad que hace la referencia. 1 = Objeto o columna 12 = Desencadenador DDL de base de datos 13 = Desencadenador DDL de servidor No acepta valores NULL.
referencing_class_desc	nvarchar(60)	Descripción de la clase de la entidad que hace la referencia. OBJECT_OR_COLUMN DATABASE_DDL_TRIGGER SERVER_DDL_TRIGGER No acepta valores NULL.
is_schema_bound_reference	bit	1 = La entidad a la que se hace referencia está enlazada a un esquema. 0 = La entidad a la que se hace referencia no está enlazada a un esquema. No acepta valores NULL.
referenced_class	tinyint	Clase de la entidad a la que se hace referencia. 1 = Objeto o columna 6 = Tipo 10 = Colección de esquemas XML 21 = Función de partición No acepta valores NULL.
referenced_class_desc	nvarchar(60)	Descripción de la clase de la entidad a la que se hace referencia. OBJECT_OR_COLUMN TYPE XML_SCHEMA_COLLECTION PARTITION_FUNCTION No acepta valores NULL.
referenced_server_name	sysname	Nombre del servidor de la entidad a la que se hace referencia. Esta columna se rellena para las dependencias entre servidores especificadas con un nombre de cuatro partes válido. Para obtener más información acerca de los nombres con varias partes, veaConvenciones de sintaxis de Transact-SQL (Transact-SQL). NULL para las entidades no enlazadas a un esquema a las que se hizo referencia sin especificar un nombre de cuatro partes. NULL para las entidades enlazadas a esquema porque deben estar en la misma base de datos y, por tanto, solo pueden definirse con un nombre de dos partes (schema.object).
referenced_database_name	sysname	Nombre de la base de datos de la entidad a la que se hace referencia. Esta columna se rellena para las referencias entre bases de datos o entre servidores especificadas con un nombre válido de tres o cuatro partes. NULL para las referencias no enlazadas a esquema especificadas con un nombre de una o dos partes. NULL para las entidades enlazadas a esquema porque deben estar en la misma base de datos y, por tanto, solo pueden definirse con un nombre de dos partes (schema.object).
referenced_schema_name	sysname	Esquema al que pertenece la entidad a la que se hace referencia. NULL para las referencias no enlazadas a esquema en las que se hacía referencia a la entidad sin especificar el nombre del esquema. Nunca es NULL para las referencias enlazadas a un esquema porque las entidades enlazadas a un esquema deben definirse y hacerse referencia con un nombre de dos partes.
referenced_entity_name	sysname	Nombre de la entidad a la que se hace referencia. No acepta valores NULL.
referenced_id	int	Identificador de la entidad a la que se hace referencia. Siempre es NULL para las referencias entre bases de datos o entre servidores. NULL para las referencias dentro de la base de datos si no se puede determinar el identificador. Para las referencias no enlazadas a un esquema, no se puede resolver el identificador en los casos siguientes: La entidad a la que se hace referencia no existe en la base de datos. El esquema de la entidad a la que se hace referencia depende del esquema del autor de la llamada y se resuelve en tiempo de ejecución. En este caso, is_caller_dependent se establece en 1. Nunca es NULL para las referencias enlazadas a un esquema.
referenced_minor_id	int	Identificador de la columna a la que se hace referencia cuando la entidad que hace la referencia es una columna; en caso contrario, es 0. No admite valores NULL. Una entidad a la que se hace referencia es una columna cuando una columna se identifica mediante un nombre en la entidad de referencia o cuando la entidad primaria se usa en una instrucción SELECT *.
is_caller_dependent	bit	Indica que el enlace de esquema de la entidad a la que se hace referencia se realiza en tiempo de ejecución; por consiguiente, la resolución del identificador de la entidad depende del esquema del autor de la llamada. Esto se produce cuando la entidad a la que se hace referencia es un procedimiento almacenado, un procedimiento almacenado extendido o una función definida por el usuario no enlazada a un esquema llamada en una instrucción EXECUTE. 1 = la entidad a la que se hace referencia es dependiente del autor de la llamada y se resuelve en tiempo de ejecución. En este caso, referenced_id es NULL. 0 = El identificador de la entidad a la que se hace referencia no es dependiente del autor de la llamada. Es siempre 0 para las referencias enlazadas a esquema y para las referencias entre bases de datos o entre servidores que especifican explícitamente un nombre de esquema. Por ejemplo, una referencia a una entidad con el formato EXEC MyDatabase.MySchema.MyProc no es dependiente del autor de la llamada. Sin embargo, una referencia con el formato EXEC MyDatabase..MyProc es dependiente del autor de la llamada.
is_ambiguous	bit	Indica que la referencia es ambigua y se puede resolver en tiempo de ejecución en una función definida por el usuario, un tipo definido por el usuario (UDT) o una referencia xquery a una columna de tipo xml. Por ejemplo, suponga que la instrucción SELECT Sales.GetOrder() FROM Sales.MySales está definida en un procedimiento almacenado. Hasta que no se ejecute el procedimiento almacenado, no se sabrá si Sales.GetOrder() es una función definida por el usuario en el esquema Sales o en la columna con nombre Sales de tipo UDT con un método denominado GetOrder(). 1 = La referencia es ambigua. 0 = La referencia no es ambigua o la entidad puede enlazarse correctamente cuando se llama a la vista. Siempre es 0 para las referencias enlazadas a un esquema.

Comentarios

La tabla siguiente enumera los tipos de entidades para las que se crea y mantiene la información de dependencia. La información de dependencia no se crea ni mantiene para reglas, valores predeterminados, tablas temporales, procedimientos almacenados temporales u objetos del sistema.

Tipo de entidad	Entidad que hace la referencia	Entidad a la que se hace referencia
Tabla	Sí*	Sí
Vista	Sí	Sí
Índice filtrado	Sí**	No
Estadísticas filtradas	Sí**	No
Procedimiento almacenado Transact-SQL***	Sí	Sí
procedimiento almacenado CLR	No	Sí
Función definida por el usuario de Transact-SQL	Sí	Sí
Función CLR definida por el usuario	No	Sí
Desencadenador CLR (DML y DDL)	No	No
Desencadenador DML de Transact-SQL	Sí	No
Desencadenador DDL de nivel de base de datos de Transact-SQL	Sí	No
Desencadenador DDL de nivel de servidor de Transact-SQL	Sí	No
Procedimientos almacenados extendidos	No	Sí
Cola	No	Sí
Sinónimo	No	Sí
Tipo (tipo CLR y alias definido por el usuario)	No	Sí
Colección de esquemas XML	No	Sí
Función de partición	No	Sí

* Se realiza el seguimiento de una tabla como una entidad de referencia solo si hace referencia a un módulo de Transact-SQL, un tipo definido por el usuario o una colección de esquemas XML en la definición de una columna calculada, restricción CHECK o restricción DEFAULT.

** Se realiza el seguimiento de cada una de las columnas usadas en el predicado de filtro como una entidad de referencia.

*** No se realiza el seguimiento de los procedimientos almacenados numerados con un valor entero mayor que 1 como la entidad que hace referencia ni como la entidad a la que se hace referencia.

Permisos

Necesita el permiso VIEW DEFINITION en la base de datos y el permiso SELECT en sys.sql_expression_dependencies para la base de datos. De forma predeterminada, el permiso SELECT solo se concede a los miembros del rol fijo de base de datos db_owner. Si se conceden los permisos SELECT y VIEW DEFINITION a otro usuario, el cesionario puede ver todas las dependencias en la base de datos.

Ejemplos

A.Devolver las entidades a las que otra entidad hace referencia

El ejemplo siguiente devuelve las tablas y columnas a las que se hace referencia en la vista Production.vProductAndDescription. La vista depende de las entidades (tablas y columnas) devueltas en referenced_entity_name y las columnas referenced_column_name.

USE AdventureWorks2012;
GO
SELECT OBJECT_NAME(referencing_id) AS referencing_entity_name, 
    o.type_desc AS referencing_desciption, 
    COALESCE(COL_NAME(referencing_id, referencing_minor_id), '(n/a)') AS referencing_minor_id, 
    referencing_class_desc, referenced_class_desc,
    referenced_server_name, referenced_database_name, referenced_schema_name,
    referenced_entity_name, 
    COALESCE(COL_NAME(referenced_id, referenced_minor_id), '(n/a)') AS referenced_column_name,
    is_caller_dependent, is_ambiguous
FROM sys.sql_expression_dependencies AS sed
INNER JOIN sys.objects AS o ON sed.referencing_id = o.object_id
WHERE referencing_id = OBJECT_ID(N'Production.vProductAndDescription');
GO

USE AdventureWorks2012;
GO
SELECT OBJECT_NAME(referencing_id) AS referencing_entity_name, 
    o.type_desc AS referencing_desciption, 
    COALESCE(COL_NAME(referencing_id, referencing_minor_id), '(n/a)') AS referencing_minor_id, 
    referencing_class_desc, referenced_class_desc,
    referenced_server_name, referenced_database_name, referenced_schema_name,
    referenced_entity_name, 
    COALESCE(COL_NAME(referenced_id, referenced_minor_id), '(n/a)') AS referenced_column_name,
    is_caller_dependent, is_ambiguous
FROM sys.sql_expression_dependencies AS sed
INNER JOIN sys.objects AS o ON sed.referencing_id = o.object_id
WHERE referencing_id = OBJECT_ID(N'Production.vProductAndDescription');
GO

B.Devolver las entidades que hacen referencia a otra entidad

El ejemplo siguiente devuelve las entidades que hacen referencia a la tabla Production.Product. Las entidades devueltas en la columna referencing_entity_name dependen de la tabla Product.

USE AdventureWorks2012;
GO
SELECT OBJECT_SCHEMA_NAME ( referencing_id ) AS referencing_schema_name,
    OBJECT_NAME(referencing_id) AS referencing_entity_name, 
    o.type_desc AS referencing_desciption, 
    COALESCE(COL_NAME(referencing_id, referencing_minor_id), '(n/a)') AS referencing_minor_id, 
    referencing_class_desc, referenced_class_desc,
    referenced_server_name, referenced_database_name, referenced_schema_name,
    referenced_entity_name, 
    COALESCE(COL_NAME(referenced_id, referenced_minor_id), '(n/a)') AS referenced_column_name,
    is_caller_dependent, is_ambiguous
FROM sys.sql_expression_dependencies AS sed
INNER JOIN sys.objects AS o ON sed.referencing_id = o.object_id
WHERE referenced_id = OBJECT_ID(N'Production.Product');
GO

USE AdventureWorks2012;
GO
SELECT OBJECT_SCHEMA_NAME ( referencing_id ) AS referencing_schema_name,
    OBJECT_NAME(referencing_id) AS referencing_entity_name, 
    o.type_desc AS referencing_desciption, 
    COALESCE(COL_NAME(referencing_id, referencing_minor_id), '(n/a)') AS referencing_minor_id, 
    referencing_class_desc, referenced_class_desc,
    referenced_server_name, referenced_database_name, referenced_schema_name,
    referenced_entity_name, 
    COALESCE(COL_NAME(referenced_id, referenced_minor_id), '(n/a)') AS referenced_column_name,
    is_caller_dependent, is_ambiguous
FROM sys.sql_expression_dependencies AS sed
INNER JOIN sys.objects AS o ON sed.referencing_id = o.object_id
WHERE referenced_id = OBJECT_ID(N'Production.Product');
GO

C.Devolver las dependencias entre bases de datos

El siguiente ejemplo devuelve todas las dependencias entre bases de datos. El ejemplo crea primero la base de datos db1 y dos procedimientos almacenados que hacen referencia a tablas en las bases de datos db2 y db3. A continuación, se consulta la tabla sys.sql_expression_dependencies para crear informes de las dependencias entre bases de datos entre los procedimientos y las tablas. Observe que se devuelve NULL en la columna referenced_schema_name para la entidad a la que se hace referencia t3 porque no se especificó un nombre de esquema para esa entidad en la definición del procedimiento.

CREATE DATABASE db1;
GO
USE db1;
GO
CREATE PROCEDURE p1 AS SELECT * FROM db2.s1.t1;
GO
CREATE PROCEDURE p2 AS
    UPDATE db3..t3
    SET c1 = c1 + 1;
GO
SELECT OBJECT_NAME (referencing_id),referenced_database_name, 
    referenced_schema_name, referenced_entity_name
FROM sys.sql_expression_dependencies
WHERE referenced_database_name IS NOT NULL;
GO
USE master;
GO
DROP DATABASE db1;
GO

CREATE DATABASE db1;
GO
USE db1;
GO
CREATE PROCEDURE p1 AS SELECT * FROM db2.s1.t1;
GO
CREATE PROCEDURE p2 AS
    UPDATE db3..t3
    SET c1 = c1 + 1;
GO
SELECT OBJECT_NAME (referencing_id),referenced_database_name, 
    referenced_schema_name, referenced_entity_name
FROM sys.sql_expression_dependencies
WHERE referenced_database_name IS NOT NULL;
GO
USE master;
GO
DROP DATABASE db1;
GO

Vea también

Referencia

sys.dm_sql_referenced_entities (Transact-SQL)

sys.dm_sql_referencing_entities (Transact-SQL)

Historial de cambios

Contenido actualizado
Se quita la frase "No se realiza un seguimiento de las dependencias de las columnas para las funciones CLR con valores de tabla" de la sección Notas.

Compartir a través de