Partilhar via


sp_depends (Transact-SQL)

Aplica-se a:SQL Server

Apresenta informações sobre dependências de objetos da base de dados, como as vistas e procedimentos que dependem de uma tabela ou vista, e as tabelas e vistas das quais a vista ou procedimento depende. As referências a objetos fora da base de dados atual não são reportadas.

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Usa sys.dm_sql_referencing_entities e sys.dm_sql_referenced_entities em vez disso.

Transact-SQL convenções de sintaxe

Sintaxe

sp_depends [ @objname = ] N'objname'

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

[ ; ]

Arguments

[ @objname = ] N'objname'

@objname é nvarchar(776), sem padrão.

  • database_name

    O nome do banco de dados.

  • schema_name

    O nome do esquema ao qual o objeto pertence.

  • object_name

    O objeto da base de dados para examinar dependências. O objeto pode ser uma tabela, vista, procedimento armazenado, função definida pelo utilizador ou trigger. object_name é nvarchar(776), sem padrão.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

sp_depends mostra dois conjuntos de resultados.

O conjunto de resultados seguinte mostra os objetos dos quais @objname depende.

Nome da coluna Tipo de dados Description
name nvarchar(257) Nome do item para o qual existe uma dependência.
type Nvarchar(16) Tipo do artigo.
updated nvarchar(7) Especifica se o item foi atualizado.
selected nvarchar(8) Especifica se o item é usado numa SELECT declaração.
column sysname Coluna ou parâmetro sobre o qual a dependência existe.

O conjunto de resultados seguinte mostra os objetos que dependem de @objname.

Nome da coluna Tipo de dados Description
name nvarchar(257) Nome do item para o qual existe uma dependência.
type Nvarchar(16) Tipo do artigo.

Permissions

Requer adesão à função pública de .

Examples

A. Listar dependências numa tabela

O exemplo seguinte lista os objetos da base de dados que dependem da Sales.Customer tabela na AdventureWorks2025 base de dados. Tanto o nome do esquema como o nome da tabela são especificados.

USE AdventureWorks2022;
GO

EXECUTE sp_depends @objname = N'Sales.Customer';

B. Listar dependências num gatilho

O exemplo seguinte lista os objetos da base de dados dos quais o gatilho iWorkOrder depende.

EXECUTE sp_depends @objname = N'AdventureWorks2022.Production.iWorkOrder';