sp_depends (Transact-SQL)
テーブルまたはビューに従属するビューおよびプロシージャ、ビューまたはプロシージャが従属するテーブルおよびビューなど、データベース オブジェクトの従属性に関する情報を表示します。現在のデータベース内に存在しないオブジェクトへの参照はレポートされません。
.gif "トピック リンク アイコン")
構文
sp_depends [ @objname = ] '<object>'
<object> ::=
{
[ database_name. [ schema_name ] . | schema_name.
object_name
}
引数
- database_name
データベースの名前を指定します。
- schema_name
オブジェクトが所属するスキーマの名前を指定します。
- object_name
従属性を調べるデータベース オブジェクトを指定します。オブジェクトにはテーブル、ビュー、ストアド プロシージャ、ユーザー定義関数、またはトリガを指定できます。object_name のデータ型は nvarchar(776) で、既定値はありません。
リターン コードの値
0 (成功) または 1 (失敗)
結果セット
sp_depends では、2 種類の結果セットが表示されます。
次の結果セットでは、<object> が従属するオブジェクトが示されます。
| 列名 | データ型 | 説明 |
|---|---|---|
name |
nvarchar(257) |
従属性が存在するアイテムの名前。 |
type |
nvarchar(16) |
アイテムの種類。 |
updated |
nvarchar(7) |
アイテムが更新されているかどうかを示します。 |
selected |
nvarchar(8) |
アイテムが SELECT ステートメントで使用されているかどうかを示します。 |
column |
sysname |
従属性が存在する列またはパラメータ。 |
次の結果セットでは、<object> に従属するオブジェクトが示されます。
| 列名 | データ型 | 説明 |
|---|---|---|
name |
nvarchar(257) |
従属性が存在するアイテムの名前。 |
type |
nvarchar(16) |
アイテムの種類。 |
解説
別のオブジェクトを参照するオブジェクトは、そのオブジェクトに従属すると見なされます。sp_depends では、sys.sql_dependencies カタログ ビューが確認され、従属性が存在するかどうかが判別されます。
権限
public ロールのメンバシップが必要です。
例
A. テーブルの従属性を一覧表示する
次の例では、AdventureWorks データベース内の Sales.Customer テーブルに従属するデータベース オブジェクトを一覧表示します。ここではスキーマ名とテーブル名の両方を指定します。
USE AdventureWorks
GO
EXEC sp_depends @objname = N'Sales.Customer' ;
以下に結果セットを示します。
In the current database, the specified object references the following:
Name type updated selected column
----------------------------------------------------------------
Dbo.ufnLeadingZeros scalar function no no NULL
Sales.Customer user table no no CustomerID
In the current database, the specified object is referenced by the following:
name type
------------------------------- ----------------
Sales.CK_Customer_CustomerType check cns
Sales.Customer user table
Sales.vIndividualCustomer view
Sales.vStoreWithDemographics view
B. トリガの従属性を一覧表示する
次の例では、トリガ iWorkOrder が従属するデータベース オブジェクトを一覧表示します。
EXEC sp_depends @objname = N'AdventureWorks.Production.iWorkOrder' ;
参照
関連項目
データベース エンジンのストアド プロシージャ (Transact-SQL)
EXECUTE (Transact-SQL)
sp_help (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)
sys.sql_dependencies (Transact-SQL)