sp_depends (Transact-SQL)

  • Artigo

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. Não são informadas referências para objetos fora do banco de dados atual.

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 = ] '<object>'   
  
<object> ::=  
{  
    [ database_name. [ schema_name ] . | schema_name.  
    object_name  
}

Argumentos

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 que será examinado para verificar se há 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 (êxito) ou 1 (falha)

Conjuntos de resultados

sp_depends exibe dois conjuntos de resultados.

O conjunto de resultados a seguir mostra os objetos dos quais <o objeto> depende.

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

O conjunto de resultados a seguir mostra os objetos que dependem do <objeto>.

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

Permissões

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

Exemplos

R. Listando as 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. Listando as dependências de 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' ;

Confira também

Procedimentos armazenados do mecanismo de banco de dados (Transact-SQL)
EXECUTE (Transact-SQL)
sp_help (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)
sys.sql_dependencies (Transact-SQL)