sys.fn_stmt_sql_handle_from_sql_stmt (Transact-SQL)sys.fn_stmt_sql_handle_from_sql_stmt (Transact-SQL)

APLICA-SE A: simSQL Server simBanco de Dados SQL do Azure nãoSQL Data Warehouse do Azure nãoParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Obtém o stmt_sql_handle para um Transact-SQLTransact-SQL instrução sob considerando o tipo de parametrização (simple ou forçado).Gets the stmt_sql_handle for a Transact-SQLTransact-SQL statement under given parameterization type (simple or forced). Isso permite que você se referir a consultas armazenadas no Store a consulta usando seus stmt_sql_handle quando você souber que seu texto.This allows you to refer to queries stored in the Query Store by using their stmt_sql_handle when you know their text.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

sys.fn_stmt_sql_handle_from_sql_stmt   
(  
    'query_sql_text',   
    [ query_param_type   
) [;]  

ArgumentosArguments

query_sql_textquery_sql_text
É o texto da consulta no repositório de consultas que você deseja que o identificador do.Is the text of the query in the query store that you want the handle of. query_sql_text é um nvarchar (max) , sem padrão.query_sql_text is a nvarchar(max), with no default.

query_param_typequery_param_type
É o tipo de parâmetro da consulta.Is the parameter type of the query. query_param_type é um tinyint.query_param_type is a tinyint. Os valores possíveis são:Possible values are:

  • NULO - padrão é 0NULL - defaults to 0

  • 0 – none0 - None

  • 1 - usuário1 - User

  • 2 - simples2 - Simple

  • 3 - forçada3 - Forced

Colunas retornadasColumns Returned

A tabela a seguir lista as colunas que sys.fn_stmt_sql_handle_from_sql_stmt retorna.The following table lists the columns that sys.fn_stmt_sql_handle_from_sql_stmt returns.

Nome da colunaColumn name typeType DescriçãoDescription
statement_sql_handlestatement_sql_handle varbinary(64)varbinary(64) O identificador SQL.The SQL handle.
query_sql_textquery_sql_text nvarchar(max)nvarchar(max) O texto do Transact-SQLTransact-SQL instrução.The text of the Transact-SQLTransact-SQL statement.
query_parameterization_typequery_parameterization_type tinyinttinyint O tipo de parametrização de consulta.The query parameterization type.

Valores do código de retornoReturn Code Values

0 (êxito) ou 1 (falha)0 (success) or 1 (failure)

ComentáriosRemarks

PermissõesPermissions

Requer o EXECUTE permissão no banco de dados, e excluir permissão em exibições de catálogo de repositório de consultas.Requires the EXECUTE permission on the database, and DELETE permission on the query store catalog views.

ExemplosExamples

O exemplo a seguir executa uma instrução e, em seguida, usa sys.fn_stmt_sql_handle_from_sql_stmt para retornar o identificador SQL dessa instrução.The following example executes a statement, and then uses sys.fn_stmt_sql_handle_from_sql_stmt to return the SQL handle of that statement.

SELECT * FROM sys.databases;   
SELECT * FROM sys.fn_stmt_sql_handle_from_sql_stmt('SELECT * FROM sys.databases', NULL);  

Use a função para correlacionar dados de consulta Store com outros modos de exibição de gerenciamento dinâmico.Use the function to correlate Query Store data with other dynamic management views. O exemplo a seguir:The following example:

SELECT qt.query_text_id, q.query_id, qt.query_sql_text, qt.statement_sql_handle,  
q.context_settings_id, qs.statement_context_id   
FROM sys.query_store_query_text AS qt  
JOIN sys.query_store_query AS q   
    ON qt.query_text_id = q.query_id  
CROSS APPLY sys.fn_stmt_sql_handle_from_sql_stmt (qt.query_sql_text, null) AS fn_handle_from_stmt  
JOIN sys.dm_exec_query_stats AS qs   
    ON fn_handle_from_stmt.statement_sql_handle = qs.statement_sql_handle;  

Consulte tambémSee Also

sp_query_store_force_plan (Transact-SQL) sp_query_store_force_plan (Transact-SQL)
sp_query_store_remove_plan (Transct-SQL) sp_query_store_remove_plan (Transct-SQL)
sp_query_store_unforce_plan (Transact-SQL) sp_query_store_unforce_plan (Transact-SQL)
sp_query_store_reset_exec_stats (Transact-SQL) sp_query_store_reset_exec_stats (Transact-SQL)
sp_query_store_flush_db (Transact-SQL) sp_query_store_flush_db (Transact-SQL)
sp_query_store_remove_query (Transact-SQL) sp_query_store_remove_query (Transact-SQL)
Exibições de Catálogo do Repositório de Consultas (Transact-SQL) Query Store Catalog Views (Transact-SQL)
Monitorando o desempenho com o repositório de consultasMonitoring Performance By Using the Query Store