sp_depends (Transact-SQL)

Artigo
02/01/2025

Aplica-se: SQL Server

Exibe informações sobre dependências de objeto de banco de dados, como as exibições e procedimentos que dependem de uma tabela ou exibição e, as tabelas e exibições que dependem da exibição ou procedimento. As referências a objetos fora do banco de dados atual não são relatadas.

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Em vez disso, use sys.dm_sql_referencing_entities e sys.dm_sql_referenced_entities .

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_depends [ @objname = ] N'objname'

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

[ ; ]

Argumentos

@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 de banco de dados a ser examinado em busca de dependências. O objeto pode ser uma tabela, exibição, procedimento armazenado, função definida pelo o usuário ou gatilho. object_name é nvarchar(776), sem padrão.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

sp_depends exibe dois conjuntos de resultados.

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

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

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

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

Permissões

Requer associação à função pública .

Exemplos

R. Listar dependências em uma tabela

O exemplo a seguir lista os objetos de banco de dados que dependem da tabela Sales.Customer do banco de dados AdventureWorks2022. São especificados o nome do esquema e da tabela.

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

B. Listar dependências em um gatilho

O exemplo a seguir lista os objetos de banco de dados dos quais o gatilho depende iWorkOrder.

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

Compartilhar via