sp_depends (Transact-SQL)
Affiche des informations sur les dépendances des objets de base de données, tels que : les vues et les procédures qui dépendant d'une table ou d'une vue, et les tables et les vues dont dépendent la vue ou la procédure. Les références à des objets qui se situent en dehors de la base de données active ne sont pas signalées.
Conventions de la syntaxe de Transact-SQL
Syntaxe
sp_depends [ @objname = ] '<object>'
<object> ::=
{
[ database_name. [ schema_name ] . | schema_name.
object_name
}
Arguments
- database_name
Nom de la base de données.
- schema_name
Nom du schéma auquel appartient l'objet.
- object_name
Objet de base de données dont les dépendances doivent être analysées. L'objet peut être une table, une vue, une procédure stockée, une fonction définie par l'utilisateur ou un déclencheur. bject_name est de type nvarchar(776), sans valeur par défaut.
Valeurs des codes de retour
0 (succès) ou 1 (échec)
Notes
Un objet qui fait référence à un autre objet est considéré comme dépendant de l'objet. sp_depends détermine les dépendances en consultant la vue de catalogue sys.sql_dependencies.
Autorisations
Nécessite l'appartenance au rôle public.
Ensembles de résultats
sp_depends affiche deux ensembles de résultats.
L'ensemble de résultats suivant montre les objets dont dépend l'objet <object>.
Nom de la colonne | Type de données | Description |
---|---|---|
name |
nvarchar(257) |
Nom de l'élément pour lequel il existe une dépendance. |
type |
nvarchar(16) |
Type de l'élément. |
updated |
nvarchar(7) |
Indique si l'élément est mis à jour. |
selected |
nvarchar(8) |
Indique si l'objet est utilisé dans une instruction SELECT. |
column |
sysname |
Colonne ou paramètre sur lequel repose la dépendance. |
L'ensemble de résultats suivant montre les objets qui dépendent de l'objet <object>.
Nom de la colonne | Type de données | Description |
---|---|---|
name |
nvarchar(257) |
Nom de l'élément pour lequel il existe une dépendance. |
type |
nvarchar(16) |
Type de l'élément. |
Exemples
A. Établissement de la liste des dépendances d'une table
L'exemple suivant établit la liste des objets de base de données qui dépendent de la table Sales.Customer
de la base de données AdventureWorks
. Le nom de schéma et le nom de la table sont tous deux spécifiés.
USE AdventureWorks
GO
EXEC sp_depends @objname = N'Sales.Customer' ;
Voici l'ensemble des résultats.
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. Établissement des dépendances d'un déclencheur.
L'exemple suivant établit la liste des objets de base de données dont dépend le déclencheur iWorkOrder
.
EXEC sp_depends @objname = N'AdventureWorks.Production.iWorkOrder' ;
Voir aussi
Référence
Procédures stockées du moteur de base de données (Transact-SQL)
EXECUTE (Transact-SQL)
sp_help (Transact-SQL)
Procédures stockées système (Transact-SQL)
sys.sql_dependencies (Transact-SQL)
Autres ressources
Description des dépendances SQL