Share via


sp_depends (Transact-SQL)

Affiche des informations sur les dépendances des objets de base de données, par exemple les vues et procédures qui dépendent d'une table ou vue, et les tables et vues dont dépend la vue ou 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.

Important

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez à la place sys.dm_sql_referencing_entities et sys.dm_sql_referenced_entities.

Icône Lien de rubriqueConventions 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)

Ensembles de résultats

sp_depends affiche deux ensembles de résultats.

Le jeu de résultats suivant affiche les objets dont dépend l'objet <object>.

Nom de 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.

Le jeu de résultats suivant affiche les objets qui dépendent de l'objet <object>.

Nom de 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.

Autorisations

Nécessite l'appartenance au rôle public.

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

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