Partager via


sp_depends (Transact-SQL)

S'applique à : SQL Server

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 aux objets situés en dehors de la base de données actuelle ne sont pas signalées.

Important

Cette fonctionnalité sera supprimée dans une version future de 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 sys.dm_sql_referencing_entities et sys.dm_sql_referenced_entities à la place.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_depends [ @objname = ] N'objname'

<objname> ::=
{
    [ database_name. [ schema_name ] . | schema_name. ]
    object_name
}

[ ; ]

Arguments

[ @objname = ] N’objname'

@objname est nvarchar(776), sans valeur par défaut.

  • 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 à examiner pour les dépendances. L'objet peut être une table, une vue, une procédure stockée, une fonction définie par l'utilisateur ou un déclencheur. object_name est nvarchar(776), sans valeur par défaut.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Jeu de résultats

sp_depends affiche deux jeux de résultats.

Le jeu de résultats suivant montre les objets sur lesquels dépend @objname .

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) Spécifie si l’élément est mis à jour.
selected nvarchar(8) Spécifie si l’élément est utilisé dans une SELECT instruction.
column sysname Colonne ou paramètre sur lequel repose la dépendance.

Le jeu de résultats suivant montre les objets qui dépendent de @objname.

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.

autorisations

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

Exemples

R. Répertorier les dépendances sur 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 AdventureWorks2022. Le nom de schéma et le nom de la table sont tous deux spécifiés.

USE AdventureWorks2022;
GO
EXEC sp_depends @objname = N'Sales.Customer';

B. Répertorier les dépendances sur 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'AdventureWorks2022.Production.iWorkOrder';