sys.dm_sql_referenced_entities (Transact-sql)

Kullanıcı tanımlı ad tanımında belirtilen başvuru varlık tarafından başvurulan her varlık için bir satır döndürür. Kullanıcı tanımlı bir varlık olarak adlandırılan iki varlık arasında bir bağımlılık oluşturulur başvurulan varlık, kalıcı bir sql ifadesi olarak adlandırılan başka bir kullanıcı tarafından tanımlanan varlık adı görünür varlık başvuran. Örneğin, bir saklı yordam belirtilen başvuru varlık ise, bu işlevi başvurulan kullanıcı tanımlı tüm varlıklar gibi tabloları, görünümleri, kullanıcı tanımlı türler (UDTs), saklı yordam döndürür veya diğer saklı yordamlar.

Belirtilen başvuru varlık tarafından başvurulan varlıkları aşağıdaki türlerde rapor için bu dinamik yönetimi işlevini kullanabilirsiniz:

• Şemaya bağlı varlıklar

• Olmayan-şemaya bağlı varlıklar

• Geçici veritabanı ve sunucu çapraz varlıkları

• Sütun düzeyi bağımlılıkları şemaya bağlı ve olmayan-şemaya bağlı varlıklar

• Kullanıcı tanımlı türler (diğer ad ve clr udt)

• xml şema koleksiyonları

• Bölüm işlevleri

Sözdizimi

sys.dm_sql_referenced_entities (
    ' [ schema_name. ] referencing_entity_name ' , ' <referencing_class> ' )

<referencing_class> ::=
{
    OBJECT
  | DATABASE_DDL_TRIGGER
  | SERVER_DDL_TRIGGER
}

Bağımsız değişkenler

• [ schema_name. ] referencing_entity_name
  Başvuru varlık addır. schema_namebaşvuru sınıf nesnesi olduğunda gereklidir.

  schema_name.referencing_entity_nameis nvarchar(517).

• <referencing_class>::= { OBJECT | DATABASE_DDL_TRIGGER | SERVER_DDL_TRIGGER}
  Belirtilen sınıf varlık başvuran. Yalnızca bir sınıf deyimi belirtilebilir.

  <referencing_class>is nvarchar(60).

Dönen Tablo

Kural dışı durumlar

Aşağıdaki koşullardan herhangi biri altında ayarlamak boş bir sonuç döndürür:

• Sistem nesnesi belirtilir.

• Belirtilen varlık geçerli veritabanında yok.

• Belirtilen varlık, tüm varlıkları başvurmuyor.

• Geçersiz bir parametre geçirildi.

Belirtilen başvuru varlık numaralandırılmış bir saklı yordamı bir hata döndürür.

Hata olduğunda sütun bağımlılıkları çözümlenemeyen 2020 döndürür. Bu hata, nesne düzeyi bağımlılıkları döndürme sorgu engellemez. Daha fazla bilgi için, bkz. Troubleshooting SQL Dependencies.

Açıklamalar

Bu başvuru sunucu düzeyinde ddl tetikleyici varlıkları dönmek için herhangi bir veritabanı bağlamında bu işlev çalıştırılır.

Aşağıdaki tabloda, kendisi için bağımlılık bilgileri oluşturulan ve saklanan varlıklar türlerini listeler. Bağımlılık bilgilerini oluşturulmaz veya kuralları, varsayılanlar, geçici tablolar, geçici saklı yordamlar veya sistem nesneleri için yapılmaktadır.

* Tablo yalnızca başvurduğu bir başvuru varlık izlenir bir Transact-SQLmodülü, türü kullanıcı tanımlı veya hesaplanmış sütun, check kısıtlaması veya default kısıtlaması tanımında xml şema koleksiyonu.

** Numaralandırılmış saklı yordamlar ile 1 ya da bir başvuru veya başvurulan varlık olarak izlenmez daha büyük bir tamsayı değeri.

Daha fazla bilgi için, bkz. Understanding SQL Dependencies.

İzinler

Üzerinde select izni gerektirir sys.dm_sql_referenced_entitiesve başvuru varlık tanımını izni. Varsayılan olarak, için select izni verilir public. Başvuru varlık veritabanı düzeyinde ddl tetikleyici olduğunda veritabanı üzerinde görünüm tanımı izni veya veritabanı ddl TETIKLEYICI alter veritabanı izni gerektirir. Başvuru varlık sunucu düzeyinde ddl tetikleyici olduğunda sunucu üzerinde görünüm tanımı HIÇBIR izni gerektirir.

Örnekler

A.Veritabanı düzeyinde ddl tetikleyici tarafından başvurulan varlıkları döndürme

Aşağıdaki örnek veritabanı düzeyinde ddl tetikleyici tarafından başvurulan varlıkları (tablolar ve sütunlar) verir 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.Bir nesne tarafından başvurulan varlıkları döndürme

Aşağıdaki örnek kullanıcı tanımlı işlevi tarafından başvurulan varlıkları verir 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.Sütun bağımlılıkları döndürme

Aşağıdaki örnek tablo oluşturur Table1ile hesaplanan sütun csütun toplamı olarak tanımlanan ave b. sys.dm_sql_referenced_entitiesGörünümü sonra çağırdı. Görünüm, hesaplanan sütun tanımlanan her sütun için iki satır döndürür.

USE AdventureWorks2012;
GO
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

Sonuç kümesi buradadır.

schema_name table_name referenced_column referencing_column

----------- ---------- ----------------- ------------------

dbo         Table1     a                 c

dbo         Table1     b                 c

D.Şema-bağlı olmayan sütun bağımlılıkları döndürme

Aşağıdaki örnek Table1ve Table2ve saklı yordam Proc1. Prosedürü referanslar Table2varolmayan tablo Table1. Görünüm sys.dm_sql_referenced_entitiesbaşvuru varlık belirtilen saklı yordamı çalıştırın. Sonuç kümesi için bir satır gösterir Table1ve 3 satır için Table2. Çünkü Table1yok, Sütun bağımlılıkları çözümlenemeyen ve döndürülen hata 2020. is_all_columns_found0 Sütun döndürür Table1değil keşfedilen sütun olduğunu bildiren.

USE AdventureWorks2012;
GO
IF OBJECT_ID ( 'dbo.Table1', 'U' ) IS NOT NULL 
    DROP TABLE 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

Sonuç kümesi buradadır.

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 1The 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.Dinamik bağımlılık bakım gösteren

Aşağıdaki örnek, örnek bağımlılıkları dinamik olarak tutulan göstermek için d genişletir. İlk örnek oluşturur Table1, hangi örnek d. çıkarıldı Sonra sys.dm_sql_referenced_entitiesyeniden başvuru varlık belirtilen saklı yordamı çalıştırın. Sonuç kümesi gösterir tablolar ve saklı yordam tanımlanan kendi ilgili sütunları döndürülür. Ayrıca, is_all_columns_foundsütun döndürür tüm nesneler ve sütunlar için 1.

USE AdventureWorks2012;
GO
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

Sonuç kümesi buradadır.

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.Geri dönen nesne veya sütun kullanımı

Aşağıdaki örnek verir nesneleri ve sütun bağımlılıkları saklı yordam HumanResources.uspUpdateEmployeePersonalInfo. Bu yordam güncelleştirmeleri sütunları NationalIDNumber, BirthDate, MaritalStatus, ve Gender, Employeetablosu üzerinde belirtilen temel BusinessEntityIDdeğer. Başka bir saklı yordam upsLogErrortanımlı bir try…Yürütme hataları yakalamak için catch bloğu. is_selected, is_updated, Ve is_select_allsütunları bu nesneleri ve sütunları başvuru nesnesi içinde nasıl kullanıldığı hakkında bilgi dönmek. Tablo ve değiştirilmesi sütun 1 is_updated sütununda belirtilir. BusinessEntityIDSütun yalnızca seçili ve saklı yordam uspLogErrorne seçilen ne güncellenmiştir.

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');

Sonuç kümesi buradadır.

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

Ayrıca bkz.

Başvuru

sys.dm_sql_referencing_entities (Transact-sql)

c.sys.sql_expression_dependencies (Transact-sql)