2025년 JDBC Driver 릴리스 정보¶
이 문서에는 JDBC Driver 에 대한 릴리스 정보가 있는데, 해당되는 경우 다음을 포함합니다.
동작 변경 사항
새로운 기능
고객이 직면한 버그 수정
Snowflake는 JDBC Driver 업데이트에 의미 체계 버전 관리를 사용합니다.
설명서는 JDBC 드라이버 섹션을 참조하십시오.
버전 3.18.1(2025년 6월 5일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
기본값 JVM 알고리즘으로 신뢰 관리자를 초기화할 때 발생하는 신뢰 관리자 초기화 문제를 수정했습니다.
버전 3.17.1(2025년 6월 5일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
기본값 JVM 알고리즘으로 신뢰 관리자를 초기화할 때 발생하는 신뢰 관리자 초기화 문제를 수정했습니다.
버전 3.21.1(2025년 6월 4일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
기본값 JVM 알고리즘으로 신뢰 관리자를 초기화할 때 발생하는 신뢰 관리자 초기화 문제를 수정했습니다.
버전 3.20.1(2025년 6월 4일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
기본값 JVM 알고리즘으로 신뢰 관리자를 초기화할 때 발생하는 신뢰 관리자 초기화 문제를 수정했습니다.
버전 3.22.1(2025년 6월 3일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
기본값 JVM 알고리즘으로 신뢰 관리자를 초기화할 때 발생하는 신뢰 관리자 초기화 문제를 수정했습니다.
버전 3.24.2(2025년 5월 31일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
기본값 JVM 알고리즘으로 신뢰 관리자를 초기화할 때 발생하는 신뢰 관리자 초기화 문제를 수정했습니다.
버전 3.24.1(2025년 5월 28일)¶
새로운 기능과 업데이트¶
Snowflake JDBC 드라이버가 시작하는 다양한 요청에 사용자 정의 HTTP 헤더를 삽입하는 유연한 방법을 제공하기 위해
HttpHeadersCustomizer
인터페이스를 추가했습니다LOCAL_APPLICATION
default for theclientId
및clientSecret
OAUTH 매개 변수에 추가했습니다.
버그 수정 사항¶
BindUploader
로 삽입할 때 04.10.1582(그레고리오 개혁) 이전의 타임스탬프 처리를 수정했습니다.파일에 액세스할 수 없을 때 캐시 파일에 쓰는 NPE 처리를 수정했습니다.
AWS 에 대한 워크플로 ID 페더레이션 요청 서명을 수정했습니다.
버전 3.24.0(2025년 4월 30일)¶
비공개 미리 보기(PrPr) 기능¶
AWS, Azure, GCP 및 Kubernetes 플랫폼에서 워크플로 ID 페더레이션에 대한 지원이 추가되었습니다.
면책 조항:
이 기능은
SF_ENABLE_EXPERIMENTAL_AUTHENTICATION
환경 변수를:codenowrap:true
로 설정해야 액세스할 수 있습니다.이 기능은 프로덕션이 아닌 데이터에만 사용해야 합니다.
이 PrPr 기능은 지원팀에서 담당하지 않습니다. 그러나 제품 및 엔지니어링 팀은 PrPr 단계에서 이용할 수 있습니다.
참여 및 설명서는 계정 팀에 문의하십시오.
새로운 기능과 업데이트¶
PAT, OAuth 2.0 승인 코드 플로우, OAuth 2.0 클라이언트 자격 증명 플로우 및 OAuth 토큰 캐싱에 대한 지원이 추가되었습니다.
PAT:의 경우 매개 변수 인증자에 대해
PROGRAMMATIC_ACCESS_TOKEN
매개 변수를 추가했습니다.OAuth 2.0 승인 코드 플로우의 경우:
oauthClientId
,oauthClientSecret
,oauthAuthorizationUrl
,oauthTokenRequestUrl
및oauthScope
매개 변수를 추가했습니다.매개 변수 인증자에 대한
OAUTH_AUTHORIZATION_CODE
매개 변수를 추가했습니다.
OAuth 2.0 클라이언트 자격 증명 플로우의 경우:
oauthClientId
,oauthClientSecret
,oauthTokenRequestUrl
및oauthScope
매개 변수를 추가했습니다.매개 변수 인증자에 대한
OAUTH_CLIENT_CREDENTIALS
매개 변수를 추가했습니다.
OAuth 토큰 캐싱의 경우: 드라이버 구성에 사용자 이름을 전달해야 하며
clientStoreTemporaryCredential
속성을false
로 설정할 수 없습니다.
joda-time
및google-http-client
라이브러리에 대한 종속성을 제거했습니다.
버그 수정 사항¶
프록시 사용 시 OCSP 캐시 서버 URL 이 수정되었습니다.
TIMESTAMP_LTZ 유형에 대한 바인딩 실행으로 인해 다른 날짜 시간 유형에 대한 바인딩이 잘못되는 문제를 수정했습니다.
BindUploader
로 삽입할 때 04.10.1582(그레고리오 개혁) 이전의 날짜 처리를 수정했습니다.TIME 유형을 벽시계 시간으로 처리하는 것을 수정하여
CLIENT_TREAT_TIME_AS_WALL_CLOCK_TIME
매개 변수를 추가했습니다.
버전 3.23.2(2025년 4월 3일)¶
새로운 기능과 업데이트¶
없음
버그 수정 사항¶
캐시 폴더에 액세스할 수 없을 때 발생하는 null 포인터 예외를 수정했습니다.
버전 3.23.1(2025년 3월 13일)¶
새로운 기능과 업데이트¶
없음
버그 수정 사항¶
Nimbusds 라이브러리에 대한 종속성 버전 선언이 누락된 것을 수정했습니다.
Windows 환경에서 캐시에 사용되는 파일 생성 관련 문제를 수정했습니다.
GET/PUT 명령 실행 중 대상 스테이지의 클라이언트 측 암호화 마스터 키가 로컬에 기록될 때 디버그 수준에서 로깅되는 문제를 수정했습니다. 키 자체로는 민감한 데이터에 대한 액세스 권한을 부여하지 않습니다. 자세한 내용은 CVE -2025-27496 을 참조하십시오.
저장소와 통신하는 동안 GCS 자격 증명을 Snowflake 자격 증명보다 우선시하는 문제를 수정했습니다. 매개 변수
disableGcsDefaultCredentials
의 기본값을true
로 변경했습니다.OKTA 를 사용하여 인증 프로세스에서 사용되는 재시도 메커니즘을 수정했습니다.
버전 3.23.0(2025년 2월 27일)¶
비공개 미리 보기(PrPr) 기능¶
PAT, OAuth 2.0 승인 코드 플로우, OAuth 2.0 클라이언트 자격 증명 플로우 및 OAuth 토큰 캐싱에 대한 지원이 비공개 미리 보기에 추가되었습니다.
PAT:의 경우 매개 변수 인증자에 대해
PROGRAMMATIC_ACCESS_TOKEN
매개 변수를 추가했습니다.OAuth 2.0 승인 코드 플로우의 경우:
oauthClientId
,oauthClientSecret
,oauthAuthorizationUrl
,oauthTokenRequestUrl
및oauthScope
매개 변수를 추가했습니다.매개 변수 인증자에 대한
OAUTH_AUTHORIZATION_CODE
매개 변수를 추가했습니다.
OAuth 2.0 클라이언트 자격 증명 플로우의 경우:
oauthClientId
,oauthClientSecret
,oauthTokenRequestUrl
및oauthScope
매개 변수를 추가했습니다.매개 변수 인증자에 대한
OAUTH_CLIENT_CREDENTIALS
매개 변수를 추가했습니다.
OAuth 토큰 캐싱의 경우: 드라이버 구성에 사용자 이름을 전달해야 하며
clientStoreTemporaryCredential
속성을false
로 설정할 수 없습니다.
면책 조항:
이 기능은
SF_ENABLE_EXPERIMENTAL_AUTHENTICATION
환경 변수를:codenowrap:true
로 설정해야 액세스할 수 있습니다.이러한 기능은 프로덕션이 아닌 데이터에만 사용해야 합니다.
이러한 PrPr 기능은 지원팀에서 담당하지 않습니다. 그러나 제품 및 엔지니어링 팀은 PrPr 단계에서 이용할 수 있습니다.
참여 및 설명서는 계정 팀에 문의하십시오.
새로운 기능과 업데이트¶
쿼리 메타데이터를 가져올 때 예외 메시지가 개선되었습니다.
일부
DatabaseMetaData
메서드에서 정확한 스키마 검색이 가능하도록ENABLE_EXACT_SCHEMA_SEARCH_ENABLED
매개 변수를 추가했습니다.DataSource 에 사용자 이름이나 비밀번호가 누락된 경우 보다 명시적 오류 메시지가 추가되었습니다.
다음 종속성의 버전을 높였습니다.
netty를 .1.118.Final 버전으로
json-smart를 2.5.2 버전으로
asm을 9.7.1 버전으로
CLIENT_REQUEST_MFA_TOKEN
플래그를string
에서boolean
로 변환하는 기능을 추가했습니다.쿼리 시간 제한을 서버 측 또는 클라이언트 측으로 설정할 수 있는 기능을 추가했습니다.
버그 수정 사항¶
글로벌 요청 구성에서 프록시를 설정하는 잘못된 동작을 수정했습니다.
로그 수준이:codenowrap:
OFF
로 설정된 경우 비어 있지 않은 로그가 수정되었습니다.PUT 명령에서 삼중 슬래시 파일 접두사(
file:///
)를 사용할 수 있는 파일 경로를 수정했습니다.uploadFileCallable
에서 throw된 예외는 이제 자동으로 실패하는 대신 메인 스레드로 전파됩니다.
버전 3.22.0(2025년 1월 29일)¶
새로운 기능과 업데이트¶
다음 연결 매개 변수를 추가했습니다.
배치를 성공적으로 실행한 후에만 지우는
CLEAR_BATCH_ONLY_AFTER_SUCCESSFUL_EXECUTION
매개 변수.더 이상 사용되지 않는
insecureMode
매개 변수를 대체하는disableOCSPChecks
매개 변수.IMPLICIT_SERVER_SIDE_QUERY_TIMEOUT
매개 변수를 사용하여 클라이언트와 서버 모두에서 동기 쿼리에 대한 시간 제한을 설정할 수 있습니다.
서버에서 비동기 쿼리의 시간 제한을 설정하는
SnowflakeStatement.setAsyncQueryTimeout
메서드를 추가했습니다.commons-logging`에서의 로그 처리를 구성하는 :codenowrap:`net.snowflake.jdbc.commons_logging_wrapper
java 속성을 추가했습니다.
버그 수정 사항¶
GCS (Google Cloud Storage)에서의 PUT/GET 작업에서 프로토콜이 없는 엔드포인트 처리를 수정했습니다.
정형 유형이 포함된 결과를 가져올 때
toString
을 너무 자주 호출하는 성능 문제를 수정했습니다.createArrayOf
에서 대/소문자를 구분하지 않는 문제를 수정했습니다.downloadStream
이 동일한 접두사를 가진 다른 파일을 다운로드할 수 있는 문제를 수정했습니다.인증이
EXTERNALBROWSER
로 설정되어 Windows 환경에서 사용될 때%PATH%
권한 상승이 발생할 가능성을 수정했습니다. 자세한 내용은 CVE-2025-24789 섹션을 참조하십시오.EXTERNALBROWSER
또는USERNAME_PASSWORD_MFA
로 인증이 설정된 경우 Linux 환경에서 생성되고 토큰 캐싱에 사용되는 파일 권한 및 소유자의 검증을 수정했습니다. 자세한 내용은 CVE-2025-24790 섹션을 참조하십시오.