sys.dm_sql_referencing_entities (Transact-SQL)

Berlaku untuk: SQL Server (semua versi yang didukung) Azure SQL Database Azure SQL Managed Instance

Mengembalikan satu baris untuk setiap entitas dalam database saat ini yang mereferensikan entitas lain yang ditentukan pengguna berdasarkan nama. Dependensi antara dua entitas dibuat ketika satu entitas, yang disebut entitas yang direferensikan, muncul berdasarkan nama dalam ekspresi SQL yang bertahan dari entitas lain, yang disebut entitas referensi. Misalnya, jika jenis yang ditentukan pengguna (UDT) ditentukan sebagai entitas yang dirujuk, fungsi ini mengembalikan setiap entitas yang ditentukan pengguna yang mereferensikan jenis berdasarkan nama dalam definisinya. Fungsi ini tidak mengembalikan entitas dalam database lain yang dapat mereferensikan entitas yang ditentukan. Fungsi ini harus dijalankan dalam konteks database master untuk mengembalikan pemicu DDL tingkat server sebagai entitas referensi.

Anda dapat menggunakan fungsi manajemen dinamis ini untuk melaporkan jenis entitas berikut dalam database saat ini yang mereferensikan entitas yang ditentukan:

  • Entitas terikat skema atau tidak terikat skema

  • Pemicu DDL tingkat database

  • Pemicu DDL tingkat server

Berlaku untuk: SQL Server ( SQL Server 2008 dan yang lebih baru), SQL Database.

Ikon tautan topikKonvensi Sintaks Transact-SQL

Sintaks

sys.dm_sql_referencing_entities (  
    ' schema_name.referenced_entity_name ' , ' <referenced_class> ' )  
  
<referenced_class> ::=  
{  
    OBJECT  
  | TYPE  
  | XML_SCHEMA_COLLECTION  
  | PARTITION_FUNCTION  
}  

Argumen

schema_name.referenced_entity_name Adalah nama entitas yang dirujuk.

schema_name diperlukan kecuali ketika kelas yang dirujuk PARTITION_FUNCTION.

schema_name.referenced_entity_name adalah nvarchar(517).

<referenced_class> ::= { OBJECT | TYPE | XML_SCHEMA_COLLECTION | PARTITION_FUNCTION } Adalah kelas entitas yang dirujuk. Hanya satu kelas yang dapat ditentukan per pernyataan.

<referenced_class> adalah nvarchar(60).

Tabel Dikembalikan

Nama kolom Jenis data Deskripsi
referencing_schema_name nama sysname Skema tempat entitas referensi berada. Dapat diubah ke null.

NULL untuk pemicu DDL tingkat database dan tingkat server.
referencing_entity_name nama sysname Nama entitas referensi. Tidak dapat diubah ke null.
referencing_id int ID entitas referensi. Tidak dapat diubah ke null.
referencing_class tinyint Kelas entitas referensi. Tidak dapat diubah ke null.

1 = Objek

12 = Pemicu DDL tingkat database

13 = Pemicu DDL tingkat server
referencing_class_desc nvarchar(60) Deskripsi kelas entitas referensi.

OBJECT

DATABASE_DDL_TRIGGER

SERVER_DDL_TRIGGER
is_caller_dependent bit Menunjukkan resolusi ID entitas yang dirujuk terjadi pada durasi karena tergantung pada skema pemanggil.

1 = Entitas referensi berpotensi mereferensikan entitas; namun, resolusi ID entitas yang dirujuk bergantung pada pemanggil dan tidak dapat ditentukan. Ini hanya terjadi untuk referensi yang tidak terikat skema ke prosedur tersimpan, prosedur tersimpan yang diperluas, atau fungsi yang ditentukan pengguna yang disebut dalam pernyataan EXECUTE.

0 = Entitas yang dirujuk bukan dependen penelepon.

Pengecualian

Mengembalikan tataan hasil kosong di bawah salah satu kondisi berikut:

  • Objek sistem ditentukan.

  • Entitas yang ditentukan tidak ada di database saat ini.

  • Entitas yang ditentukan tidak mereferensikan entitas apa pun.

  • Parameter yang tidak valid diteruskan.

Mengembalikan kesalahan ketika entitas yang direferensikan yang ditentukan adalah prosedur tersimpan bernomor.

Keterangan

Tabel berikut ini mencantumkan jenis entitas tempat informasi dependensi dibuat dan dikelola. Informasi dependensi tidak dibuat atau dipertahankan untuk aturan, default, tabel sementara, prosedur tersimpan sementara, atau objek sistem.

Jenis entitas Entitas referensi Entitas yang dirujuk
Tabel Ya* Ya
Tampilan Ya Ya
Prosedur tersimpan Transact-SQL** Ya Ya
Prosedur tersimpan CLR Tidak Ya
Fungsi yang ditentukan pengguna Transact-SQL Ya Ya
Fungsi yang ditentukan pengguna CLR Tidak Ya
Pemicu CLR (DML dan DDL) Tidak Tidak
Pemicu DML Transact-SQL Ya Tidak
Pemicu DDL tingkat database Transact-SQL Ya Tidak
Pemicu DDL tingkat server Transact-SQL Ya Tidak
Prosedur tersimpan diperpanjang Tidak Ya
Antrean Tidak Ya
Sinonim Tidak Ya
Jenis (alias dan jenis yang ditentukan pengguna CLR) Tidak Ya
Koleksi skema XML Tidak Ya
Fungsi partisi Tidak Ya

* Tabel dilacak sebagai entitas referensi hanya ketika mereferensikan modul Transact-SQL, jenis yang ditentukan pengguna, atau koleksi skema XML dalam definisi kolom komputasi, batasan CHECK, atau batasan DEFAULT.

** Prosedur tersimpan bernomor dengan nilai bilangan bulat yang lebih besar dari 1 tidak dilacak sebagai entitas referensi atau referensi.

Izin

SQL Server 2008 - SQL Server 2012 (11.x)

  • Memerlukan izin CONTROL pada objek yang dirujuk. Ketika entitas yang dirujuk adalah fungsi partisi, izin CONTROL pada database diperlukan.

  • Memerlukan izin SELECT pada sys.dm_sql_referencing_entities. Secara default, izin SELECT diberikan kepada publik.

SQL Server 2014 (12.x) - SQL Server 2019 (15.x)

  • Tidak memerlukan izin pada objek yang dirujuk. Hasil parsial dapat dikembalikan jika pengguna memiliki VIEW DEFINITION hanya pada beberapa entitas referensi.

  • Memerlukan VIEW DEFINITION pada objek saat entitas referensi adalah objek .

  • Memerlukan VIEW DEFINITION pada database saat entitas referensi adalah pemicu DDL tingkat database.

  • Memerlukan LIHAT DEFINISI APA PUN di server ketika entitas referensi adalah pemicu DDL tingkat server.

Contoh

A. Mengembalikan entitas yang merujuk ke entitas tertentu

Contoh berikut mengembalikan entitas dalam database saat ini yang merujuk ke tabel yang ditentukan.

USE AdventureWorks2012;  
GO  
SELECT referencing_schema_name, referencing_entity_name, referencing_id, referencing_class_desc, is_caller_dependent  
FROM sys.dm_sql_referencing_entities ('Production.Product', 'OBJECT');  
GO  

B. Mengembalikan entitas yang merujuk ke jenis tertentu

Contoh berikut mengembalikan entitas yang mereferensikan jenis dbo.Flagalias . Kumpulan hasil menunjukkan bahwa dua prosedur tersimpan menggunakan jenis ini. Jenis dbo.Flag ini juga digunakan dalam definisi beberapa kolom dalam HumanResources.Employee tabel; namun, karena jenisnya tidak dalam definisi kolom komputasi, batasan CHECK, atau batasan DEFAULT dalam tabel, tidak ada baris yang dikembalikan untuk HumanResources.Employee tabel.

USE AdventureWorks2012;  
GO  
SELECT referencing_schema_name, referencing_entity_name, referencing_id, referencing_class_desc, is_caller_dependent  
FROM sys.dm_sql_referencing_entities ('dbo.Flag', 'TYPE');  
GO  

Berikut adalah hasil yang ditetapkan.

referencing_schema_name referencing_entity_name   referencing_id referencing_class_desc is_caller_dependent  
----------------------- -------------------------  ------------- ---------------------- -------------------  
HumanResources          uspUpdateEmployeeHireInfo  1803153469    OBJECT_OR_COLUMN       0  
HumanResources          uspUpdateEmployeeLogin     1819153526    OBJECT_OR_COLUMN       0  
(2 row(s) affected)`  

Lihat juga

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