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

적용 대상:Applies to: 예SQL Server 2016(13.x)SQL Server 2016 (13.x)yesSQL Server 2016(13.x)SQL Server 2016 (13.x) 이상 예Azure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database 예Azure SQL Managed InstanceAzure SQL Managed InstanceYesAzure SQL Managed InstanceAzure SQL Managed Instance적용 대상:Applies to: 예SQL Server 2016(13.x)SQL Server 2016 (13.x)yesSQL Server 2016(13.x)SQL Server 2016 (13.x) and later 예Azure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database 예Azure SQL Managed InstanceAzure SQL Managed InstanceYesAzure SQL Managed InstanceAzure SQL Managed Instance

Transact-SQLTransact-SQL 지정 된 매개 변수화 형식 (simple 또는 강제) 아래에 있는 문의 stmt_sql_handle를 가져옵니다.Gets the stmt_sql_handle for a Transact-SQLTransact-SQL statement under given parameterization type (simple or forced). 이렇게 하면 텍스트를 알고 있을 때 stmt_sql_handle 를 사용 하 여 쿼리 저장소에 저장 된 쿼리를 참조할 수 있습니다.This allows you to refer to queries stored in the Query Store by using their stmt_sql_handle when you know their text.

항목 링크 아이콘 Transact-SQL 구문 표기 규칙Topic link icon Transact-SQL Syntax Conventions

구문Syntax

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

인수Arguments

query_sql_textquery_sql_text
핸들을 원하는 쿼리 저장소의 쿼리 텍스트입니다.Is the text of the query in the query store that you want the handle of. query_sql_textnvarchar (max) 이며 기본값은 없습니다.query_sql_text is a nvarchar(max), with no default.

query_param_typequery_param_type
쿼리의 매개 변수 형식입니다.Is the parameter type of the query. query_param_typetinyint 입니다.query_param_type is a tinyint. 가능한 값은Possible values are:

  • NULL-기본값은 0입니다.NULL - defaults to 0

  • 0 - 없음0 - None

  • 1-사용자1 - User

  • 2-단순2 - Simple

  • 3-강제3 - Forced

반환되는 열Columns Returned

다음 표에서는 sys.fn_stmt_sql_handle_from_sql_stmt 반환 하는 열을 나열 합니다.The following table lists the columns that sys.fn_stmt_sql_handle_from_sql_stmt returns.

열 이름Column name TypeType DescriptionDescription
statement_sql_handlestatement_sql_handle varbinary(64)varbinary(64) SQL 핸들입니다.The SQL handle.
query_sql_textquery_sql_text nvarchar(max)nvarchar(max) Transact-SQLTransact-SQL문의 텍스트입니다.The text of the Transact-SQLTransact-SQL statement.
query_parameterization_typequery_parameterization_type tinyinttinyint 쿼리 매개 변수화 형식입니다.The query parameterization type.

반환 코드 값Return Code Values

0(성공) 또는 1(실패)0 (success) or 1 (failure)

설명Remarks

사용 권한Permissions

데이터베이스에 대 한 EXECUTE 권한과 쿼리 저장소 카탈로그 뷰에 대 한 삭제 권한이 필요 합니다.Requires the EXECUTE permission on the database, and DELETE permission on the query store catalog views.

Examples

다음 예에서는 문을 실행 한 다음를 사용 하 여 sys.fn_stmt_sql_handle_from_sql_stmt 해당 문의 SQL 핸들을 반환 합니다.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 the function to correlate Query Store data with other dynamic management views. 다음 예제를 참조하세요.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;  

참고 항목See Also

Transact-sql)sp_query_store_force_plan ( sp_query_store_force_plan (Transact-SQL)
sp_query_store_remove_plan (Transct-sql&-SQL) sp_query_store_remove_plan (Transct-SQL)
Transact-sql)sp_query_store_unforce_plan ( sp_query_store_unforce_plan (Transact-SQL)
Transact-sql)sp_query_store_reset_exec_stats ( sp_query_store_reset_exec_stats (Transact-SQL)
Transact-sql)sp_query_store_flush_db ( sp_query_store_flush_db (Transact-SQL)
Transact-sql)sp_query_store_remove_query ( sp_query_store_remove_query (Transact-SQL)
Transact-sql)(카탈로그 뷰 쿼리 저장소 Query Store Catalog Views (Transact-SQL)
쿼리 저장소를 사용하여 성능 모니터링Monitoring Performance By Using the Query Store