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 del nivel de columna en entidades enlazadas a un esquema. Se pueden devolver las dependencias del nivel de columna de los objetos no enlazados a un esquema usando sys.dm_sql_referenced_entities.

  • Desencadenadores DDL a nivel de servidor en el contexto de la base de datos maestra.

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 información sobre los nombres de varias partes, consulte Convenciones 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 consiguiente, 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 de tres o cuatro partes válido.

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 consiguiente, 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 un esquema en las que se hizo 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 acepta valores NULL.

Una entidad a la que se hace referencia es una columna cuando una columna se identifica por un nombre en la entidad que hace la 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 resuelve en tiempo de ejecución a 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.

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í*

Ver

Índice filtrado

Sí**

No

Estadísticas filtradas

Sí**

No

Procedimiento almacenado Transact-SQL***

Procedimiento almacenado CLR

No

Función definida por el usuario de Transact-SQL

Función definida por el usuario CLR

No

Desencadenador CLR (DML y DDL)

No

Ninguno

Desencadenador DML de Transact-SQL

No

Desencadenador DLL de nivel de base de datos de Transact-SQL

No

Desencadenador DDL de servidor Transact-SQL

No

Procedimientos almacenados extendidos

No

Cola

No

Sinónimo

No

Tipo (tipo CLR y alias definido por el usuario)

No

Colección de esquemas XML

No

Función de partición

No

* Se realiza el seguimiento de una tabla como una entidad que hace la referencia solo si hace referencia a un módulo Transact-SQL, tipo definido por el usuario o 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.

Para obtener más información, vea Descripción de las dependencias SQL.

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, solo se permite el permiso SELECT a los miembros de la función de base de datos fija 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.

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 AdventureWorks;
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 AdventureWorks;
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



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.

Adiciones de comunidad

AGREGAR
Mostrar: