sp_depends (Transact-SQL)

Aplica-se a: 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';