sys.dm_sql_referenced_entities(Transact-SQL)

적용 대상: 예SQL Server(지원되는 모든 버전) 예Azure SQL Database

에서 지정한 참조 엔터티의 정의에서 이름으로 참조되는 각 사용자 정의 엔터티에 대해 하나의 행을 SQL Server 반환합니다. 참조된 엔터티라고 하는 하나의 사용자 정의 엔터티가 참조하는 엔터티라고 하는 다른 사용자 정의 엔터티의 지속형 SQL 식에 이름으로 표시될 때 두 엔터티 간의 종속성이 만들어집니다. 예를 들어 저장 프로시저가 지정된 참조 엔터티인 경우 이 함수는 테이블, 뷰, UDT(사용자 정의 형식), 또는 다른 저장 프로시저 등 이 저장 프로시저에서 참조되는 모든 사용자 정의 엔터티를 반환합니다.

이러한 동적 관리 함수를 사용하면 지정된 참조 엔터티에 의해 참조되는 다음과 같은 엔터티 유형을 보고할 수 있습니다.

  • 스키마 바운드 엔터티

  • 비스키마 바운드 엔터티

  • 데이터베이스 간 및 서버 간 엔터티

  • 스키마 바운드 엔터티 및 비스키마 바운드 엔터티의 열 수준 종속성

  • 사용자 정의 형식(별칭 및 CLR UDT)

  • XML 스키마 컬렉션

  • 파티션 함수

구문

sys.dm_sql_referenced_entities (  
    ' [ schema_name. ] referencing_entity_name ' ,
    ' <referencing_class> ' )  
  
<referencing_class> ::=  
{  
    OBJECT  
  | DATABASE_DDL_TRIGGER  
  | SERVER_DDL_TRIGGER  
}  

인수

[ schema_name. ] referencing_entity_name
참조 엔터티의 이름입니다. 참조 클래스가 OBJECT인 경우 schema_name 필요합니다.

schema_name.referencing_entity_name은 nvarchar(517) 입니다.

<referencing_class> ::= { OBJECT | DATABASE_DDL_TRIGGER | SERVER_DDL_TRIGGER }
지정된 참조 엔터티의 클래스입니다. 각 문에는 하나의 클래스만 지정할 수 있습니다.

<referencing_class> nvarchar(60) 입니다.

반환된 테이블

열 이름 데이터 형식 Description
referencing_minor_id int 참조 엔터티가 열인 경우 열 ID이며 그렇지 않은 경우 0입니다. Null을 허용하지 않습니다.
referenced_server_name sysname 참조된 엔터티의 서버 이름입니다.

이 열은 네 부분으로 된 올바른 이름을 지정하여 생성되는 서버 간 종속성에 대해 채워집니다. 다중 파트 이름에 대 한 자세한 내용은 참조 하세요. Transact-SQL 구문 규칙 (Transact-SQL)합니다.

네 부분으로 된 이름 지정 없이 엔터티가 참조된 비스키마 바운드 종속성의 경우 NULL입니다.

스키마 바운드 엔터티는 동일한 데이터베이스에 있어야 하므로 두 부분으로 구성된 (schema.object) 이름을 사용하여 정의할 수 있기 때문에 NULL입니다.
referenced_database_name sysname 참조된 엔터티의 데이터베이스 이름입니다.

이 열은 세 부분 또는 네 부분으로 된 올바른 이름을 지정하여 생성되는 데이터베이스 간 또는 서버 간 참조에 대해 채워집니다.

한 부분 또는 두 부분으로 된 이름을 사용하여 지정된 비스키마 바운드 참조의 경우 NULL입니다.

스키마 바운드 엔터티는 동일한 데이터베이스에 있어야 하므로 두 부분으로 구성된 (schema.object) 이름을 사용하여 정의할 수 있기 때문에 NULL입니다.
referenced_schema_name sysname 참조된 엔터티가 속한 스키마입니다.

스키마 이름 지정 없이 엔터티가 참조되는 비스키마 바운드 참조의 경우 NULL입니다.

스키마 바운드 참조의 경우 NULL일 수 없습니다.
referenced_entity_name sysname 참조된 엔터티의 이름입니다. Null을 허용하지 않습니다.
referenced_minor_name sysname 참조된 엔터티가 열인 경우 열 이름이며 그렇지 않은 경우 NULL입니다. 예를 들어 참조된 엔터티 자체를 나열하는 행에서 referenced_minor_name은 NULL입니다.

열이 참조 엔터티에서 이름으로 식별되거나 부모 엔터티가 SELECT * 문에 사용된 경우 참조된 엔터티는 열입니다.
referenced_id int 참조된 엔터티의 ID입니다. referenced_minor_id가 0이 아닌 경우 referenced_id는 열이 정의된 엔터티입니다.

서버 간 참조의 경우 항상 NULL입니다.

데이터베이스 간 참조의 경우 데이터베이스가 오프라인 상태이거나 엔터티를 바인딩할 수 없어 ID를 확인할 수 없으면 NULL입니다.

데이터베이스 내 참조의 경우 ID를 확인할 수 없으면 NULL입니다. 스키마 바운드가 아닌 참조의 경우 참조된 엔터티가 데이터베이스에 없거나 이름 확인이 호출자 종속된 경우 ID를 확인할 수 없습니다. 후자의 경우 is_caller_dependent 1로 설정됩니다.

스키마 바운드 참조의 경우 NULL일 수 없습니다.
referenced_minor_id int 참조된 엔터티가 열인 경우 열 ID이며 그렇지 않은 경우 0입니다. 예를 들어 참조된 엔터티 자체를 나열하는 행에서 referenced_minor_is는 0입니다.

비스키마 바운드 참조의 경우 모든 참조된 엔터티를 바인딩할 수 있는 경우에만 열 종속성이 보고됩니다. 바인딩할 수 없는 참조된 엔터티가 있는 경우 열 수준 종속성이 보고되지 않으며 referenced_minor_id는 0입니다. 예 4를 참조하십시오.
referenced_class tinyint 참조된 엔터티의 클래스입니다.

1 = 개체 또는 열

6 = 형식

10 = XML 스키마 컬렉션

21 = 파티션 함수
referenced_class_desc nvarchar(60) 참조된 엔터티의 클래스에 대한 설명입니다.

OBJECT_OR_COLUMN

TYPE

XML_SCHEMA_COLLECTION

PARTITION_FUNCTION
is_caller_dependent bit 참조된 엔터티에 대한 스키마 바인딩이 런타임에 발생하며 따라서 엔터티 ID 확인은 호출자의 스키마에 종속됨을 나타냅니다. 이는 참조된 엔터티가 EXECUTE 문 내에서 호출되는 저장 프로시저, 확장 저장 프로시저 또는 사용자 정의 함수인 경우 발생합니다.

1 = 참조된 엔터티가 호출자에 종속되고 런타임에 확인됩니다. 이 경우 referenced_id는 NULL입니다.

0 = 참조된 엔터티 ID가 호출자에 종속되지 않습니다. 스키마 이름을 명시적으로 지정하는 스키마 바운드 참조와 데이터베이스 간 및 서버 간 참조의 경우 항상 0입니다. 예를 들어 EXEC MyDatabase.MySchema.MyProc 형식의 엔터티에 대한 참조는 호출자에 종속되지 않습니다. 하지만 EXEC MyDatabase..MyProc 형식의 참조는 호출자에 종속됩니다.
is_ambiguous bit 참조가 모호 하며 런타임에 사용자 정의 함수, UDT (사용자 정의 형식) 또는 xml 형식의 열에 대 한 xquery 참조로 확인 될 수 있음을 나타냅니다. 예를 들어 저장 프로시저에 SELECT Sales.GetOrder() FROM Sales.MySales 문이 정의된 경우 Sales.GetOrder()Sales 스키마의 사용자 정의 함수인지, 아니면 Sales라는 메서드가 있는 UDT 형식의 GetOrder() 열인지는 저장 프로시저가 실행될 때까지 알 수 없습니다.

1 = 사용자 정의 함수 또는 열 UDT(사용자 정의 형식) 메서드에 대한 참조가 모호합니다.

0 = 참조가 분명하거나 함수가 호출될 때 엔터티를 성공적으로 바인딩할 수 있습니다.

스키마 바운드 참조의 경우 항상 0입니다.
is_selected bit 1 = 개체 또는 열이 선택됩니다.
is_updated bit 1 = 개체 또는 열이 수정됩니다.
is_select_all bit 1 = 개체가 SELECT * 절에서 사용됩니다(개체 수준만 해당).
is_all_columns_found bit 1 = 개체에 대한 모든 열 종속성을 찾을 수 있습니다.

0 = 개체에 대한 열 종속성을 찾을 수 없습니다.
is_insert_all bit 1 = 열 목록이 없는 INSERT 문에서 개체가 사용 됩니다 (개체 수준만 해당).

이 열은 SQL Server 2016에 추가 되었습니다.
is_incomplete bit 1 = 개체 또는 열에 바인딩 오류가 있으며 불완전 합니다.

이 열은 SQL Server 2016 s p 2에 추가 되었습니다.
     

예외

다음과 같은 경우 빈 결과 집합을 반환합니다.

  • 시스템 개체가 지정되어 있습니다.

  • 지정된 엔터티가 현재 데이터베이스에 없습니다.

  • 지정된 엔터티가 아무런 엔터티도 참조하지 않습니다.

  • 잘못된 매개 변수가 전달되었습니다.

지정된 참조 엔터티가 번호가 매겨진 저장 프로시저인 경우 오류를 반환합니다.

열 종속성을 확인할 수 없으면 오류 2020을 반환합니다. 이 오류가 발생해도 쿼리는 개체 수준 종속성을 반환합니다.

설명

이 함수는 데이터베이스 컨텍스트에서 실행되어 서버 수준 DDL 트리거를 참조하는 엔터티를 반환할 수 있습니다.

다음 표에서는 종속성 정보가 생성 및 유지되는 엔터티 유형을 보여 줍니다. 종속성 정보는 규칙, 기본값, 임시 테이블, 임시 저장 프로시저 또는 시스템 개체에 대해서는 생성 및 유지되지 않습니다.

엔터티 유형 참조 엔터티 참조된 엔터티
테이블 예*
보기
Transact-SQL 저장 프로시저**
CLR 저장 프로시저
Transact-SQL 사용자 정의 함수
CLR 사용자 정의 함수
CLR 트리거(DML 및 DDL)
Transact-SQL DML 트리거 Yes
Transact-SQL 데이터베이스 수준 DDL 트리거 Yes
Transact-SQL 서버 수준 DDL 트리거 Yes
확장된 저장 프로시저
동의어
형식(별칭 및 CLR 사용자 정의 형식)
XML 스키마 컬렉션
파티션 함수
     

* 테이블은 Transact-SQL 계산 열, CHECK 제약 조건 또는 DEFAULT 제약 조건 정의에서 모듈, 사용자 정의 형식 또는 XML 스키마 컬렉션을 참조 하는 경우에만 참조 엔터티로 추적 됩니다.

** 정수 값 1보다 큰 번호가 있는 저장 프로시저는 참조 엔터티나 참조된 엔터티로 추적되지 않습니다.

사용 권한

sys.dm_sql_referenced_entities에 대한 SELECT 권한 및 참조 엔터티에 대한 VIEW DEFINITION 권한이 필요합니다. 기본적으로 SELECT 권한은 public에 부여됩니다. 참조 엔터티가 데이터 수준 DDL 트리거인 경우 데이터베이스에 대한 ALTER DATABASE DDL TRIGGER 권한 또는 데이터베이스에 대한 VIEW DEFINITION 권한이 필요합니다. 참조 엔터티가 서버 수준 DDL 트리거인 경우 서버에 대한 VIEW ANY DEFINITION 권한이 필요합니다.

예제

A. 데이터베이스 수준 DDL 트리거에서 참조 하는 엔터티 반환

다음 예에서는 데이터베이스 수준 DDL 트리거 ddlDatabaseTriggerLog에 의해 참조되는 엔터티(테이블 및 열)를 반환합니다.

USE AdventureWorks2012;  
GO  
SELECT
        referenced_schema_name,
        referenced_entity_name,
        referenced_minor_name,
        referenced_minor_id,
        referenced_class_desc
    FROM
        sys.dm_sql_referenced_entities (
            'ddlDatabaseTriggerLog',
            'DATABASE_DDL_TRIGGER')
;
GO  

B. 개체에서 참조 하는 엔터티 반환

다음 예에서는 사용자 정의 함수 dbo.ufnGetContactInformation에 의해 참조되는 엔터티를 반환합니다.

USE AdventureWorks2012;  
GO  
SELECT
        referenced_schema_name,
        referenced_entity_name,
        referenced_minor_name,
        referenced_minor_id,
        referenced_class_desc,
        is_caller_dependent,
        is_ambiguous
    FROM
        sys.dm_sql_referenced_entities (
            'dbo.ufnGetContactInformation',
            'OBJECT')
;
GO  

C. 열 종속성 반환

다음 예에서는 Table1 열과 c 열의 합계로 정의되는 계산 열 a가 포함된 b 테이블을 만듭니다. 그런 다음 sys.dm_sql_referenced_entities 뷰를 호출합니다. 이 뷰는 계산 열에 정의된 각 열마다 하나씩 두 개의 행을 반환합니다.

CREATE TABLE dbo.Table1 (a int, b int, c AS a + b);  
GO  
SELECT
        referenced_schema_name AS schema_name,  
        referenced_entity_name AS table_name,  
        referenced_minor_name  AS referenced_column,  
        COALESCE(
            COL_NAME(OBJECT_ID(N'dbo.Table1'),
            referencing_minor_id),
            'N/A') AS referencing_column_name  
    FROM
        sys.dm_sql_referenced_entities ('dbo.Table1', 'OBJECT')
;
GO

-- Remove the table.  
DROP TABLE dbo.Table1;  
GO  

결과 집합은 다음과 같습니다.

schema_name table_name referenced_column referencing_column  
----------- ---------- ----------------- ------------------  
dbo         Table1     a                 c  
dbo         Table1     b                 c  

D. 비스키마 바운드 열 종속성 반환

다음 예에서는 Table1을 삭제하고 Table2 및 저장 프로시저 Proc1을 만듭니다. 이 프로시저는 Table2 및 존재하지 않는 테이블 Table1을 참조합니다. 저장 프로시저가 참조 엔터티로 지정되어 sys.dm_sql_referenced_entities 뷰가 실행됩니다. 결과 집합에는 Table1에 대한 행 하나와 Table2에 대한 행 세 개가 표시됩니다. Table1이 없기 때문에 열 종속성을 확인할 수 없고 오류 2020이 반환됩니다. is_all_columns_found 열은 Table1에 대해 검색할 수 없는 열이 있음을 나타내는 0을 반환합니다.

DROP TABLE IF EXISTS dbo.Table1;
GO  
CREATE TABLE dbo.Table2 (c1 int, c2 int);  
GO  
CREATE PROCEDURE dbo.Proc1 AS  
    SELECT a, b, c FROM Table1;  
    SELECT c1, c2 FROM Table2;  
GO  
SELECT
        referenced_id,
        referenced_entity_name AS table_name,
        referenced_minor_name  AS referenced_column_name,
        is_all_columns_found
    FROM
        sys.dm_sql_referenced_entities ('dbo.Proc1', 'OBJECT');
GO  

결과 집합은 다음과 같습니다.

referenced_id table_name   referenced_column_name  is_all_columns_found  
------------- ------------ ----------------------- --------------------  
935674381     Table2       NULL                    1  
935674381     Table2       C1                      1  
935674381     Table2       C2                      1  
NULL          Table1       NULL                    0  

Msg 2020, Level 16, State 1, Line 1
The dependencies reported for entity "dbo.Proc1" might not include
 references to all columns. This is either because the entity
 references an object that does not exist or because of an error
 in one or more statements in the entity.  Before rerunning the
 query, ensure that there are no errors in the entity and that
 all objects referenced by the entity exist.

E. 동적 종속성 유지 관리 설명

이 예에서는 D 예제가 실행 되었다고 가정 합니다. 예 E에서는 종속성이 동적으로 유지 되 고 있음을 보여 줍니다. 이 예제에서는 다음 작업을 수행 합니다.

  1. Table1예 D에서 삭제 된를 다시 만듭니다.
  2. 그러면 sys.dm_sql_referenced_entities 저장 프로시저가 참조 엔터티로 지정 되어 실행이 다시 실행 됩니다.

결과 집합에는 저장 프로시저에 정의 된 테이블 및 각 열이 반환 되는 것이 표시 됩니다. 또한 is_all_columns_found 열은 모든 개체 및 열에 대해 1을 반환합니다.

CREATE TABLE Table1 (a int, b int, c AS a + b);  
GO   
SELECT
        referenced_id,
        referenced_entity_name AS table_name,
        referenced_minor_name  AS column_name,
        is_all_columns_found
    FROM
        sys.dm_sql_referenced_entities ('dbo.Proc1', 'OBJECT');
GO  
DROP TABLE Table1, Table2;  
DROP PROC Proc1;  
GO  

결과 집합은 다음과 같습니다.

referenced_id table_name   referenced_column_name  is_all_columns_found  
------------- ------------ ----------------------- --------------------  
935674381     Table2       NULL                    1 
935674381     Table2       c1                      1 
935674381     Table2       c2                      1 
967674495     Table1       NULL                    1 
967674495     Table1       a                       1  
967674495     Table1       b                       1  
967674495     Table1       c                       1  

F. 개체 또는 열 사용법 반환

다음 예에서는 저장 프로시저 HumanResources.uspUpdateEmployeePersonalInfo의 개체 및 열 종속성을 반환합니다. 이 프로시저는 지정 된 NationalIDNumber BirthDate,``MaritalStatus 값을 Gender Employee 기준으로 테이블의, 및 열을 업데이트 합니다 BusinessEntityID . 다른 저장 프로시저 upsLogError 는 TRY ... 실행 오류를 캡처하기 위한 CATCH 블록입니다. is_selected, is_updatedis_select_all 열은 참조하는 개체 내에 이러한 개체 및 열이 사용되는 방식에 대한 정보를 반환합니다. 수정된 테이블 및 열은 is_updated 열에서 1로 표시됩니다. BusinessEntityID 열만 선택되며 저장 프로시저 uspLogError는 선택되거나 수정되지 않습니다.

USE AdventureWorks2012;
GO
SELECT
        referenced_entity_name AS table_name,
        referenced_minor_name  AS column_name,
        is_selected,  is_updated,  is_select_all
    FROM
        sys.dm_sql_referenced_entities(
            'HumanResources.uspUpdateEmployeePersonalInfo',
            'OBJECT')
;

결과 집합은 다음과 같습니다.

table_name    column_name         is_selected is_updated is_select_all  
------------- ------------------- ----------- ---------- -------------  
uspLogError   NULL                0           0          0  
Employee      NULL                0           1          0  
Employee      BusinessEntityID    1           0          0  
Employee      NationalIDNumber    0           1          0  
Employee      BirthDate           0           1          0  
Employee      MaritalStatus       0           1          0  
Employee      Gender              0           1          0

참고 항목

sys.dm_sql_referencing_entities(Transact-SQL)
sys.sql_expression_dependencies(Transact-SQL)