드라이버 작업 추적
SQL Server용 Microsoft JDBC Driver에서는 추적 또는 로깅 기능을 사용하여 애플리케이션에서 사용되는 JDBC 드라이버 관련 문제를 해결할 수 있습니다. 추적 기능을 활성화하기 위해 JDBC 드라이버는 java.util.logging의 로깅 API를 사용합니다. 이 API는 Logger 및 LogRecord 개체를 만드는 클래스 집합을 제공합니다.
참고
JDBC 드라이버에 포함된 네이티브 구성 요소(sqljdbc_xa.dll)의 경우 BID(Built-In Diagnostics) 프레임워크를 사용하여 추적 기능을 활성화합니다. BID에 대한 자세한 내용은 SQL Server에서 데이터 액세스 추적을 참조하세요.
애플리케이션을 개발할 때 Logger 개체를 호출한 다음, LogRecord 개체를 만들고 Handler 개체에 전달하여 처리할 수 있습니다. 로거 및 처리기 개체는 둘 다 로깅 수준을 사용하며 필요에 따라 로깅 필터를 사용하여 처리되는 LogRecords를 조정합니다. 로깅 작업이 완료되면 Handler 개체는 필요에 따라 Formatter 개체를 사용하여 로그 정보를 게시합니다.
기본적으로 java.util.logging 프레임워크는 출력을 파일에 작성합니다. 이 출력 로그 파일은 JDBC 드라이버가 실행 중인 컨텍스트에 대한 쓰기 권한이 있어야 합니다.
참고
프로그램 추적에 여러 로깅 개체를 사용하는 방법에 대한 자세한 내용은 Sun Microsystems 웹 사이트의 Java Logging APIs 설명서(영문)를 참조하십시오.
다음 섹션에서는 로깅 수준 및 로깅 가능한 범주를 설명하고 애플리케이션에서 추적 기능을 활성화하는 방법에 대한 정보를 제공합니다.
로깅 수준
작성되는 모든 로그 메시지에는 연관된 로깅 수준이 있습니다. 로깅 수준은 로그 메시지의 중요도를 결정하며 java.util.logging의 Level 클래스에 의해 정의됩니다. 한 수준에서 로깅을 설정하면 상위 수준의 로깅도 모두 설정됩니다. 이 섹션에서는 공용 로깅 범주 및 내부 로깅 범주의 로깅 수준에 대해 설명합니다. 로깅 범주에 대한 자세한 내용은 이 문서의 로깅 범주 섹션을 참조하세요.
다음 표에서는 공용 로깅 범주에 대해 사용할 수 있는 각 로깅 수준에 대해 설명합니다.
| 속성 | 설명 |
|---|---|
| SEVERE | 심각한 오류를 나타내는 가장 높은 로깅 수준입니다. JDBC 드라이버에서 이 수준은 오류 및 예외를 보고하는 데 사용합니다. |
| WARNING | 잠재적인 문제를 의미합니다. |
| INFO | 정보 메시지를 제공합니다. |
| CONFIG | 구성 메시지를 제공합니다. JDBC 드라이버는 현재 구성 메시지를 제공하지 않습니다. |
| FINE | 공용 메서드에서 발생한 모든 예외를 포함하는 기본 추적 정보를 제공합니다. |
| FINER | 모든 공용 메서드 진입점 및 진출점과 관련 매개 변수 데이터 형식 및 공용 클래스의 모든 공용 속성을 포함하는 자세한 추적 정보를 제공합니다. 또한 입력 매개 변수, 출력 매개 변수 및 CLOB, BLOB, NCLOB, Reader, <stream> 반환 값 형식을 제외한 메서드 반환 값을 제공합니다. |
| FINEST | 매우 자세한 추적 정보를 제공합니다. 이 설정은 가장 낮은 로깅 수준입니다. |
| OFF | 로깅을 해제합니다. |
| ALL | 모든 메시지의 로깅을 활성화합니다. |
다음 표에서는 내부 로깅 범주에 대해 사용할 수 있는 각 로깅 수준에 대해 설명합니다.
| 속성 | 설명 |
|---|---|
| SEVERE | 심각한 오류를 나타내는 가장 높은 로깅 수준입니다. JDBC 드라이버에서 이 수준은 오류 및 예외를 보고하는 데 사용합니다. |
| WARNING | 잠재적인 문제를 의미합니다. |
| INFO | 정보 메시지를 제공합니다. |
| FINE | 기본 개체 생성 및 소멸을 포함한 추적 정보를 제공합니다. 또한 공용 메서드에서 발생한 모든 예외에 대한 정보도 제공합니다. |
| FINER | 모든 공용 메서드 진입점 및 진출점과 관련 매개 변수 데이터 형식 및 공용 클래스의 모든 공용 속성을 포함하는 자세한 추적 정보를 제공합니다. 또한 입력 매개 변수, 출력 매개 변수 및 CLOB, BLOB, NCLOB, Reader, <stream> 반환 값 형식을 제외한 메서드 반환 값을 제공합니다. JDBC 드라이버 버전 1.2에 포함된 로깅 범주 중 로깅 수준이 FINE인 범주는 SQLServerConnection, SQLServerStatement, XA, SQLServerDataSource입니다. 버전 2.0 릴리스에서부터 이들 범주는 FINER 수준으로 업그레이드되었습니다. |
| FINEST | 매우 자세한 추적 정보를 제공합니다. 이 설정은 가장 낮은 로깅 수준입니다. JDBC 드라이버 버전 1.2에 포함된 로깅 범주 중 로깅 수준이 FINEST인 범주는 TDS.DATA 및 TDS.TOKEN입니다. 버전 2.0 릴리스에서부터 FINEST 로깅 수준이 유지됩니다. |
| OFF | 로깅을 해제합니다. |
| ALL | 모든 메시지의 로깅을 활성화합니다. |
로깅 범주
Logger 개체를 만들 때 로그 정보를 가져올 명명된 엔터티나 범주가 어떤 것인지 이 개체에 알려야 합니다. JDBC 드라이버는 com.microsoft.sqlserver.jdbc 드라이버 패키지에 정의된 다음 공용 로깅 범주를 지원합니다.
| 속성 | 설명 |
|---|---|
| 연결 | SQLServerConnection 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINER로 설정할 수 있습니다. |
| 인수를 제거합니다. | SQLServerStatement 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINER로 설정할 수 있습니다. |
| DataSource | SQLServerDataSource 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINE으로 설정할 수 있습니다. |
| ResultSet | SQLServerResultSet 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINER로 설정할 수 있습니다. |
| 드라이버 | SQLServerDriver 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINER로 설정할 수 있습니다. |
| 복원력 | 유휴 연결 복원력 재연결에만 관련이 있는 SQLServerConnection 클래스의 메시지를 기록합니다. 애플리케이션에서는 로깅 수준을 FINE 및 FINER로 설정할 수 있습니다. |
| 리디렉션 | 연결 열기 다시 시도에만 관련이 있는 SQLServerConnection 클래스의 메시지를 기록합니다. 애플리케이션에서는 로깅 수준을 FINE으로 설정할 수 있습니다. |
Microsoft JDBC 드라이버 버전 2.0 이상에서는 드라이버가 다음 내부 로깅 범주에 대한 로깅 지원을 포함하는 com.microsoft.sqlserver.jdbc.internals 패키지를 제공합니다.
| 속성 | Description |
|---|---|
| AuthenticationJNI | Windows 통합 인증 문제에 관한 메시지를 로깅합니다(authenticationScheme 연결 속성이 암시적 또는 명시적으로 NativeAuthentication으로 설정된 경우). 애플리케이션에서는 로깅 수준을 FINEST 및 FINE으로 설정할 수 있습니다. |
| SQLServerConnection | SQLServerConnection 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINE 및 FINER로 설정할 수 있습니다. |
| SQLServerDataSource | SQLServerDataSource, SQLServerConnectionPoolDataSource 및 SQLServerPooledConnection 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINER로 설정할 수 있습니다. |
| InputStream | java.io.InputStream, java.io.Reader 및 varchar, nvarchar, varbinary 데이터 형식 등의 최댓값 지정자가 있는 데이터 형식과 관련된 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINER로 설정할 수 있습니다. |
| SQLServerException | SQLServerException 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINE으로 설정할 수 있습니다. |
| SQLServerResultSet | SQLServerResultSet 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINE, FINER 및 FINEST로 설정할 수 있습니다. |
| SQLServerStatement | SQLServerStatement 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINE, FINER 및 FINEST로 설정할 수 있습니다. |
| XA | SQLServerXADataSource 클래스의 모든 XA 트랜잭션에 대한 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINE 및 FINER로 설정할 수 있습니다. |
| KerbAuthentication | 유형 4 Kerberos 인증에 관한 메시지를 로깅합니다(authenticationScheme 연결 속성이 JavaKerberos로 설정된 경우). 애플리케이션에서는 로깅 수준을 FINE 또는 FINER로 설정할 수 있습니다. |
| TDS.DATA | 드라이버와 SQL 서버 간 TDS 프로토콜 수준 대화를 포함하는 메시지를 로깅합니다. 주고받는 각 TDS 패킷의 자세한 내용이 ASCII 및 16진수로 로깅됩니다. 로그인 자격 증명(사용자 이름 및 암호)은 로깅되지 않습니다. 다른 모든 데이터는 로깅됩니다. 이 범주는 매우 자세한 메시지를 작성하기 때문에 로깅 수준을 FINEST로 설정해야만 사용할 수 있습니다. |
| TDS.Channel | 이 범주는 SQL 서버와의 TCP 통신 채널의 동작을 추적합니다. 로깅된 메시지는 소켓을 열고 닫는 동작과 읽고 쓰는 동작을 포함합니다. 또한 이전에 SSL(Secure Sockets Layer)로 알려진 TLS(전송 계층 보안) 연결을 SQL 서버에 설정하는 경우와 관련된 메시지를 추적합니다. 이 범주는 로깅 수준을 FINE, FINER 또는 FINEST로 설정해야만 사용할 수 있습니다. |
| TDS.Writer | 이 범주는 TDS 채널에 대한 쓰기 동작을 추적합니다. 내용이 아닌 쓰기 길이만 추적됩니다. 또한 이 범주에서는 문의 실행을 취소하기 위해 주의 신호가 서버로 전송되는 경우의 문제를 추적합니다. 이 범주는 로깅 수준을 FINEST로 설정해야만 사용할 수 있습니다. |
| TDS.Reader | FINEST 수준에서 이 범주는 TDS 채널의 특정 읽기 동작을 추적합니다. FINEST 수준에서는 추적이 자세할 수 있습니다. WARNING 및 SEVERE 수준에서 이 범주는 드라이버가 연결을 닫기 전 SQL 서버에서 잘못된 TDS 프로토콜을 수신하는 경우 추적을 수행합니다. 이 범주는 로깅 수준을 FINER 또는 FINEST로 설정해야만 사용할 수 있습니다. |
| TDS.Command | 이 범주는 낮은 수준의 상태 전환 및 Transact-SQL 문 실행, ResultSet 커서 인출, 커밋 등 TDS 명령 실행과 관련된 기타 정보를 추적합니다. 이 범주는 로깅 수준을 FINEST로 설정해야만 사용할 수 있습니다. |
| TDS.TOKEN | 이 범주는 TDS 패킷 내의 토큰만 로깅하며 TDS.DATA 범주보다 정보가 덜 자세합니다. 이 범주는 로깅 수준을 FINEST로 설정해야만 사용할 수 있습니다. FINEST 수준에서 이 범주는 응답에서 처리되는 TDS 토큰을 추적합니다. SEVERE 수준에서 이 범주는 잘못된 TDS 토큰이 발견되는 경우 추적을 수행합니다. |
| SQLServerDatabaseMetaData | SQLServerDatabaseMetaData 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINE으로 설정할 수 있습니다. |
| SQLServerResultSetMetaData | SQLServerResultSetMetaData 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINE으로 설정할 수 있습니다. |
| SQLServerParameterMetaData | SQLServerParameterMetaData 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINE으로 설정할 수 있습니다. |
| SQLServerBlob | SQLServerBlob 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINE으로 설정할 수 있습니다. |
| SQLServerClob | SQLServerClob 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINE으로 설정할 수 있습니다. |
| SQLServerSQLXML | 내부 SQLServerSQLXML 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINE으로 설정할 수 있습니다. |
| SQLServerDriver | SQLServerDriver 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINE으로 설정할 수 있습니다. |
| SQLServerNClob | SQLServerNClob 클래스의 메시지를 로깅합니다. 애플리케이션에서는 로깅 수준을 FINE으로 설정할 수 있습니다. |
프로그래밍 방식으로 추적 활성화
Logger 개체를 만들고 로깅할 범주를 지시하여 프로그래밍 방식으로 추적을 활성화할 수 있습니다. 예를 들어 다음 코드에서는 SQL 문의 로깅을 활성화하는 방법을 보여 줍니다.
Logger logger = Logger.getLogger("com.microsoft.sqlserver.jdbc.Statement");
logger.setLevel(Level.FINER);
코드에서 로깅을 해제하려면 다음 코드를 사용합니다.
logger.setLevel(Level.OFF);
사용 가능한 모든 범주를 로깅하려면 다음 코드를 사용합니다.
Logger logger = Logger.getLogger("com.microsoft.sqlserver.jdbc");
logger.setLevel(Level.FINE);
특정 범주를 로깅하지 않으려면 다음 코드를 사용합니다.
Logger logger = Logger.getLogger("com.microsoft.sqlserver.jdbc.Statement");
logger.setLevel(Level.OFF);
Logging.Properties 파일을 사용하여 추적 활성화
JRE(Java Runtime Environment) 8 설치의 lib 디렉터리나 Java 9 이상의 conf 폴더에 있는 logging.properties 파일을 사용하여 추적을 활성화하는 방법도 있습니다. 이 파일은 추적 기능을 활성화할 때 사용할 로거 및 처리기의 기본 값을 설정하는 데 사용할 수 있습니다.
다음 구성은 logging.properties 파일에서 설정할 수 있는 예입니다.
# Specify the handler, the handlers will be installed during VM startup.
handlers= java.util.logging.FileHandler
# Default global logging level.
.level= OFF
# default file output is in user's home directory.
java.util.logging.FileHandler.pattern = %h/java%u.log
java.util.logging.FileHandler.limit = 5000000
java.util.logging.FileHandler.count = 20
java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter
java.util.logging.FileHandler.level = FINEST
# Facility specific properties.
com.microsoft.sqlserver.jdbc.level=FINEST
참고
java.util.logging의 일부인 LogManager 개체를 사용하여 logging.properties 파일의 속성을 설정할 수 있습니다.
참고 항목
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기