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';