sys.fn_get_sql (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server

Retorna o texto da instrução SQL do identificador SQL especificado.

Importante

Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Em vez disso, use sys.dm_exec_sql_text. Para obter mais informações, consulte sys.dm_exec_sql_text (Transact-SQL).

Convenções de sintaxe de Transact-SQL

Sintaxe

  
sys.fn_get_sql ( SqlHandle )

Argumentos

SqlHandle
É o valor do identificador. SqlHandle é varbinary(64) sem padrão.

Tabelas retornadas

Nome da coluna Tipo de dados Descrição
dbid smallint ID do banco de dados. Para instruções SQL preparadas e ad hoc, a ID do banco de dados no qual as instruções foram compiladas.
objectid int ID do objeto do banco de dados. É NULL para instruções SQL ad hoc.
número smallint Indica o número do grupo e se os procedimentos estão agrupados.

0 = Entradas não são procedimentos.

NULL = Instruções SQL ad hoc.
encrypted bit Indica se o objeto está criptografado.

0 = não criptografado

1 = Criptografado
text text É o texto da instrução SQL. É NULL para objetos criptografados.

Comentários

Você pode obter um identificador SQL válido na coluna sql_handle da exibição de gerenciamento dinâmico do sys.dm_exec_requests (Transact-SQL ).

Se você passar um identificador que não existe mais no cache, fn_get_sql retornará um conjunto de resultados vazio. Se você passar um identificador inválido, o lote parará e uma mensagem de erro será retornada.

O Mecanismo de Banco de Dados do SQL Server não pode armazenar em cache algumas instruções Transact-SQL, como instruções de cópia em massa e instruções com literais de cadeia de caracteres maiores que 8 KB. Identificadores para essas instruções não podem ser recuperados usando fn_get_sql.

A coluna de texto do conjunto de resultados é filtrada para texto que pode conter senhas. Para obter mais informações sobre procedimentos armazenados relacionados à segurança que não são monitorados, consulte Filtrar um rastreamento.

A função fn_get_sql retorna informações semelhantes ao comando DBCC INPUTBUFFER . Veja, a seguir, exemplos de quando a função fn_get_sql pode ser usada, porque o DBCC INPUTBUFFER não pode ser usado:

  • Quando eventos têm mais de 255 caracteres.

  • Quando você tem que retornar o nível mais alto de aninhamento atual de um procedimento armazenado. Por exemplo, há dois procedimentos armazenados que são nomeados sp_1 e sp_2. Se sp_1 chamar sp_2 e você obtiver o identificador da exibição de gerenciamento dinâmico sys.dm_exec_requests enquanto sp_2 estiver sendo executado, a função fn_get_sql retornará informações sobre sp_2. Além disso, a função fn_get_sql retorna o texto completo do procedimento armazenado no nível atual de aninhamento mais alto.

Permissões

O usuário precisa da permissão VIEW SERVER STATE no servidor.

Exemplos

Administradores de banco de dados podem usar a função fn_get_sql, conforme mostrado no exemplo a seguir, para ajudar a diagnosticar processos de problemas. Depois de identificar a ID de sessão de um problema, o administrador pode recuperar o identificador SQL daquela sessão, chamar fn_get_sql com o identificador e, em seguida, usar os deslocamentos de início e de término para determinar o texto SQL da ID de sessão do problema.

DECLARE @Handle varbinary(64);  
SELECT @Handle = sql_handle   
FROM sys.dm_exec_requests   
WHERE session_id = 52 and request_id = 0;  
SELECT * FROM sys.fn_get_sql(@Handle);  
GO

Confira também

DBCC INPUTBUFFER (Transact-SQL)
sys.sysprocesses (Transact-SQL)
sys.dm_exec_requests (Transact-SQL)