sys.sql_expression_dependencies (Transact-SQL)
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.
Se aplica a: SQL Server (SQL Server 2008 a través de la versión actual). |
Nombre de 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:
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_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
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 NULL se devuelve 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