sys.dm_sql_referencing_entities (Transact-SQL)
Restituisce una riga per ogni entità nel database corrente che fa riferimento a un'altra entità definita dall'utente in base al nome. Una dipendenza tra due entità viene creata quando un'entità, detta entità con riferimenti, viene visualizzata in base al nome in un'espressione SQL persistente di un'altra entità, detta entità di riferimento. Ad esempio, se un tipo definito dall'utente (UDT) è specificato come entità con riferimenti, questa funzione restituisce ogni entità definita dall'utente che nella propria definizione fa riferimento a quel tipo in base al nome. La funzione non restituisce entità negli altri database che possono fare riferimento all'entità specificata. Questa funzione deve essere eseguita nel contesto del database master perché restituisca un trigger DDL a livello di server come entità di riferimento.
È possibile utilizzare questa funzione a gestione dinamica per creare un report sui seguenti tipi di entità del database corrente che fanno riferimento all'entità specificata:
Entità associate o non associate a schema
Trigger DDL a livello di database
Trigger DDL a livello di server
.gif "Icona di collegamento a un argomento")
Sintassi
sys.dm_sql_referencing_entities (
' schema_name.referenced_entity_name ' , ' <referenced_class> ' )
<referenced_class> ::=
{
OBJECT
| TYPE
| XML_SCHEMA_COLLECTION
| PARTITION_FUNCTION
}
Argomenti
schema_name.referenced_entity_name
Nome dell'entità a cui si fa riferimento.schema_name è obbligatorio, eccetto quando la classe a cui si fa riferimento è PARTITION_FUNCTION.
schema_name.referenced_entity_name è di tipo nvarchar(517).
<referenced_class> ::= { OBJECT | TYPE | XML_SCHEMA_COLLECTION | PARTITION_FUNCTION }
Classe dell'entità a cui si fa riferimento. È possibile specificare solo una classe per istruzione.<referenced_class> è di tipo nvarchar(60).
Tabella restituita
Nome colonna |
Tipo di dati |
Descrizione |
|---|---|---|
referencing_schema_name |
sysname |
Schema a cui appartiene l'entità di riferimento. Ammette valori Null. NULL per trigger DDL a livello di database e a livello di server. |
referencing_entity_name |
sysname |
Nome dell'entità di riferimento. Non ammette valori Null. |
referencing_id |
int |
ID dell'entità di riferimento. Non ammette valori Null. |
referencing_class |
tinyint |
Classe dell'entità di riferimento. Non ammette valori Null. 1 = Oggetto 12 = Trigger DDL a livello di database 13 = Trigger DDL a livello di server |
referencing_class_desc |
nvarchar(60) |
Descrizione della classe dell'entità di riferimento. OBJECT DATABASE_DDL_TRIGGER SERVER_DDL_TRIGGER |
is_caller_dependent |
bit |
Indica che la risoluzione dell'ID dell'entità a cui si fa riferimento si verifica in fase di esecuzione poiché dipende dallo schema del chiamante. 1 = L'entità di riferimento ha la possibilità di fare riferimento all'entità, tuttavia la risoluzione dell'ID dell'entità a cui si fa riferimento è dipendente dal chiamante e non può essere determinata. Ciò avviene solo per riferimenti a stored procedure non associati a schema, stored procedure estese o funzioni definite dall'utente chiamate all'interno di un'istruzione EXECUTE. 0 = L'entità a cui si fa riferimento non è dipendente dal chiamante. |
Eccezioni
In una delle seguenti condizioni, restituisce un set di risultati vuoto:
Viene specificato un oggetto di sistema.
L'entità specificata non è presente nel database corrente.
L'entità specificata non fa riferimento ad alcuna entità.
Viene passato un parametro non valido.
Restituisce un errore quando l'entità a cui si fa riferimento specificata è una stored procedure numerata.
Osservazioni
Nella tabella seguente sono elencati i tipi di entità per i quali vengono create e gestite le informazioni sulle dipendenze. Le informazioni sulla dipendenza non vengono create né gestite per regole, impostazioni predefinite, tabelle temporanee, stored procedure temporanee o oggetti di sistema.
Tipo di entità |
Entità di riferimento |
Entità con riferimenti |
|---|---|---|
Tabella |
Sì* |
Sì |
Vista |
Sì |
Sì |
Stored procedure Transact-SQL** |
Sì |
Sì |
Stored procedure CLR |
No |
Sì |
Funzione Transact-SQL definita dall'utente |
Sì |
Sì |
Funzione CLR definita dall'utente |
No |
Sì |
Trigger CLR (DML e DDL) |
No |
No |
Trigger DML Transact-SQL |
Sì |
No |
Trigger DDL Transact-SQL a livello di database |
Sì |
No |
Trigger DDL Transact-SQL a livello di server |
Sì |
No |
Stored procedure estese |
No |
Sì |
Coda |
No |
Sì |
Sinonimo |
No |
Sì |
Tipo (alias e tipo di CLR definito dall'utente) |
No |
Sì |
Raccolta di XML Schema |
No |
Sì |
Funzione di partizione |
No |
Sì |
* Una tabella è registrata come un'entità di riferimento solo quando fa riferimento al modulo Transact-SQL, a un tipo definito dall'utente o a una raccolta di XML Schema nella definizione di una colonna calcolata, un vincolo CHECK o un vincolo DEFAULT.
** Le stored procedure numerate con un valore integer maggiore di 1 non vengono registrate come entità di riferimento o entità con riferimenti.
Per ulteriori informazioni, vedere Informazioni sulle dipendenze SQL.
Autorizzazioni
Richiede l'autorizzazione CONTROL per l'entità a cui si fa riferimento e l'autorizzazione SELECT per sys.dm_sql_referencing_entities. Quando l'entità a cui si fa riferimento è una funzione di partizione, è necessaria l'autorizzazione CONTROL per il database. Per impostazione predefinita, l'autorizzazione SELECT è concessa a public.
Esempi
A. Restituzione delle entità che fanno riferimento a un'entità specificata
Nell'esempio seguente vengono restituite le entità nel database corrente che fanno riferimento alla tabella specificata.
USE AdventureWorks2008R2;
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. Restituzione delle entità che fanno riferimento a un tipo specificato
Nell'esempio seguente vengono restituite le entità che fanno riferimento al tipo alias dbo.Flag. Il set di risultati mostra che questo tipo è utilizzato da due stored procedure. Il tipo dbo.Flag è utilizzato anche nella definizione di diverse colonne nella tabella HumanResources.Employee. Poiché, tuttavia, il tipo non è presente nella definizione di una colonna calcolata, un vincolo CHECK o un vincolo DEFAULT nella tabella, non viene restituita alcuna riga per la tabella HumanResources.Employee.
USE AdventureWorks2008R2;
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
Set di risultati:
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 righe interessate)
Vedere anche