Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
(연관된 글이 1개 있습니다.)

SqlCommand를 이용해 Microsoft SQL 서버의 쿼리 실행 계획을 구하는 방법

보통, SSMS 도구를 이용해 쿼리 실행 계획을 보게 되는데요. 직접 쿼리해서 구해오는 것도 가능합니다.

How do I obtain a Query Execution Plan?
; http://stackoverflow.com/questions/7359702/how-do-i-obtain-a-query-execution-plan

위의 글에 설명된 것처럼, 다음의 5가지 중에 하나를 실행해 주면 이후의 쿼리에 대해 실행 계획을 별도의 resultset으로 반환받게 됩니다.

  • SET SHOWPLAN_TEXT ON
  • SET SHOWPLAN_ALL ON
  • SET SHOWPLAN_XML ON
  • SET STATISTICS PROFILE ON
  • SET STATISTICS XML ON

동작 유무를 확인하기 위해 곧바로 SSMS의 쿼리 창에서 직접 테스트를 해볼 수도 있겠지요. ^^

getting an execution plan in C#
; http://dbaspot.com/sqlserver-programming/467308-getting-execution-plan-c.html

제 테스트 DB에서는 다음과 같은 쿼리를 수행해 봤고,

USE UnitTestDB2
GO

SET SHOWPLAN_TEXT ON
go

select * from mytable
go

SET SHOWPLAN_TEXT OFF
GO

예상했던대로 SSMS에서는 2개의 resultset으로 결과를 반환하는데, 하나는 쿼리 수행 문이고 또 다른 하나는 쿼리 실행 계획입니다.

query_plan_in_cs_1.png




그런데, C#에서 ADO.NET을 이용해 쿼리를 수행하는 경우 이를 하나의 Command에 넣으면 오류가 발생합니다.

command.CommandText = "SET SHOWPLAN_TEXT ON; select * from mytable; SET SHOWPLAN_TEXT OFF";
reader = command.ExecuteReader();

Unhandled Exception: System.Data.SqlClient.SqlException: The SET SHOWPLAN statements must be the only statements in the batch.
   at System.Data.SqlClient.SqlConnection.OnError(SqlException exception, Boolean breakConnection)
   at System.Data.SqlClient.SqlInternalConnection.OnError(SqlException exception, Boolean breakConnection)
   ...[생략]...
   at ConsoleApplication1.Program.Main(String[] args) in d:\...\ConsoleApplication1\Program.cs:line 28

즉, 한 줄에 넣으면 안 되고 하나의 Connection에 연이어서 쿼리를 수행해야 합니다.

command.CommandText = "SET SHOWPLAN_TEXT ON";
command.ExecuteNonQuery();

command.CommandText = "select * from mytable";
reader = command.ExecuteReader();

if (reader != null)
{
    using (reader)
    {
        do
        {
            while (reader.Read())
            {
                Console.WriteLine(reader[0]);
            }

        } while (reader.NextResult());
    }
}

command.CommandText = "SET SHOWPLAN_TEXT OFF";
command.ExecuteNonQuery();

그런데, 재미있는 특징이 하나 있습니다. 일반적으로 ADO.NET 쿼리 실행 시에 Parameterized Query 방식을 쓰게 되는데요.

command.CommandText = "SET SHOWPLAN_TEXT ON; ";
command.ExecuteNonQuery();

SqlParameter param = new SqlParameter("@id", System.Data.SqlDbType.Int);
param.Value = 0;
command.Parameters.Add(param);
command.CommandText = "select * from mytable WHERE id <> @id";
reader = command.ExecuteReader();

일단 이렇게 Command.Parameters 컬렉션에 인자가 들어가면 해당 쿼리 수행은 실행 계획의 영향을 받지도 않을 뿐더러 그렇다고 쿼리가 수행되지도 않습니다. 그냥 결과 자체를 반환하지 않습니다.

그럼 어떻게 하냐고요? ^^ 할 수 없습니다. 그냥 ad-hoc 쿼리 식으로 입력해 줘야 합니다.

command.CommandText = "SET SHOWPLAN_TEXT ON; ";
command.ExecuteNonQuery();

command.CommandText = "select * from mytable WHERE id <> 0";
reader = command.ExecuteReader();

성공하면 첫 번째 resultset에서 쿼리를 얻고,

select * from mytable WHERE id <> 0 

다음 resultset에서 실행 계획을 얻습니다.

  |--Clustered Index Seek(OBJECT:([UnitTestDB2].[dbo].[mytable].[PK_mytable]), S
EEK:([UnitTestDB2].[dbo].[mytable].[id] < (0) OR [UnitTestDB2].[dbo].[mytable].[
id] > (0)) ORDERED FORWARD)

(첨부된 파일은 위의 소스 코드를 반영한 프로젝트입니다.)




참고로 자바의 경우 "Microsoft SQL Server JDBC Driver"를 이용해서,

자바에서 "Microsoft SQL Server JDBC Driver" 사용하는 방법
; https://www.sysnet.pe.kr/2/0/1116

다음과 같은 소스코드로 가져올 수 있습니다.

import java.sql.*;

public class DBTest {

    public static void main(String[] args) 
    {
        String connectionString = "jdbc:sqlserver://...[서버주소]...:1433;databaseName=...[DB명]...;user=...[계정]...;password=...[암호]...";
            
        Connection con = null;
        Statement stmt = null;
        ResultSet rs = null;
              
        try {
            Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
            con = DriverManager.getConnection(connectionString);

            String plan = "SET SHOWPLAN_TEXT ON";
            stmt = con.createStatement();
            stmt.execute(plan);

            String SQL = "SELECT * FROM Account";
            stmt = con.createStatement();
            rs = stmt.executeQuery(SQL);
                
            while (rs.next()) {
                System.out.println(rs.getString(1));
            }
                
            stmt.getMoreResults();
            rs = stmt.getResultSet();
                
            while (rs.next()) {
                System.out.println(rs.getString(1));
            }
                
            plan = "SET SHOWPLAN_TEXT OFF";
            stmt = con.createStatement();
            stmt.execute(plan);
        }
        catch (Exception e) {
            e.printStackTrace();
        }
        finally {
            if (rs != null) try { rs.close(); } catch(Exception e) {}
            if (stmt != null) try { stmt.close(); } catch(Exception e) {}
            if (con != null) try { con.close(); } catch(Exception e) {}
        }
    }
}





[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 10/17/2021]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
14000정성태8/18/20256오류 유형: 979. ERROR: failed to solve: failed to read dockerfile: open Dockerfile: no such file or directory
13999정성태8/15/2025665닷넷: 2355. C# 14 - (8) null 조건부 연산자 개선 - 대입문에도 사용 가능파일 다운로드1
13998정성태8/14/2025766닷넷: 2354. C# 14 - (7) 확장 메서드에 정적 메서드와 속성 지원을 위한 전용 구문 추가파일 다운로드1
13997정성태8/14/2025901Linux: 120. docker 컨테이너로 매핑된 볼륨에 컨테이너 측의 사용자 ID를 유지하면서 복사하는 방법
13996정성태8/13/2025554오류 유형: 978. Unable to find the requested .Net Framework Data Provider.
13995정성태8/13/2025604개발 환경 구성: 754. Visual C++ - 리눅스 빌드를 위한 Ubuntu 18 docker 컨테이너 설정
13994정성태8/12/2025636오류 유형: 977. SQL Server - User, group, or role '...' already exists in the current database. (Microsoft SQL Server, Error: 15023)
13993정성태8/11/2025953오류 유형: 976. Microsoft.ML.OnnxRuntimeGenAI 패키지 사용 시 "cublasLt64_12.dll" which is missing. (Error 126: "The specified module could not be found.") 오류
13992정성태8/11/20251126닷넷: 2353. C# - Foundry Local을 이용한 gpt-oss-20b 모델 사용파일 다운로드1
13991정성태8/9/20251058오류 유형: 975. winget - Foundry Local 패키지 업데이트가 안 되는 문제
13990정성태8/8/2025820Windows: 283. Time zone 설정이 없는 Windows Server 2025
13989정성태8/8/20251203닷넷: 2352. C# - Windows S-mode 환경인지 체크하는 방법파일 다운로드1
13988정성태8/8/20251342오류 유형: 974. 비주얼 스튜디오 업데이트 시 잠김 파일 경고 - Visual Studio Standard Collector Service 150 (VSStandardCollectorService150)
13987정성태8/7/20251004닷넷: 2351. C# 14 - (6) event와 생성자에도 partial 메서드 적용파일 다운로드1
13986정성태8/6/20251093닷넷: 2350. C# 14 - (5) 람다 매개 변수에 접근자가 있는 경우에도 타입 생략 가능파일 다운로드1
13985정성태8/6/20251438오류 유형: 973. "wsl --install" 명령어 수행 시 "The server name or address could not be resolved"
13984정성태8/6/20251213Windows: 282. 윈도우 운영체제에 추가된 ssh 서버(Win32-OpenSSH)
13983정성태8/4/20251298오류 유형: 972. Microsoft.Data.SqlClient 6.1.0 버전부터 .NET 8 이상만 지원
13982정성태8/2/20251701개발 환경 구성: 753. CentOS 7 컨테이너 내에서 openssh 서버 호스팅
13981정성태8/1/20251382오류 유형: 971. CentOS 7에서 yum 사용 시 "Could not resolve host: mirrorlist.centos.org; Unknown error"
13980정성태7/31/20251557Linux: 119. eBPF - BPF_PROG_TYPE_CGROUP_SOCK 유형에서 정상 동작하지 않는 BPF_CORE_READ (2)
13979정성태7/30/20251866Linux: 118. eBPF - BPF_PROG_TYPE_CGROUP_SOCK 유형에서 정상 동작하지 않는 BPF_CORE_READ
13978정성태7/29/20251700오류 유형: 970. 파일 복사 시 "Data error (cyclic redundancy check). (0x80070017)" 에러
13977정성태7/28/20252016닷넷: 2349. C# 14 - (4) 문자열 리터럴을 utf-8 인코딩으로 저장파일 다운로드1
13976정성태7/25/20251864닷넷: 2348. C# - 카카오 카나나 모델 + Microsoft.ML.OnnxRuntimeGenAI 예제파일 다운로드1
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...