sys.fn_get_sql (Transact-SQL)
Aplica-se: 
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. |
| criptografados | 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)