2026년 JDBC Driver 릴리스 정보

이 문서에는 JDBC Driver 에 대한 릴리스 정보가 있는데, 해당되는 경우 다음을 포함합니다.

  • 동작 변경 사항

  • 새로운 기능

  • 고객이 직면한 버그 수정

Snowflake는 JDBC Driver 업데이트에 의미 체계 버전 관리를 사용합니다.

설명서는 JDBC 드라이버 섹션을 참조하십시오.

버전 4.0.2(2026년 3월 12일)

새로운 기능과 업데이트

  • CVE-2024-25710 및 CVE-2024-26308 <https://nvd.nist.gov/vuln/detail/CVE-2024-26308>`_을 해결하기 위해 :codenowrap:`commons-compress 종속성을 버전 1.28.0으로 업데이트했습니다.

버그 수정 사항

  • 결과를 폴링할 때 만료된 세션 토큰 갱신을 수정했습니다.

  • v4.0.0의 공개 API 재구성 중에 삭제되었던 누락된 미니코어 비동기 초기화를 수정했습니다.

  • 드라이버 초기화 중 로깅 수준을 조정했습니다.

  • nonProxyHosts 정규식 패턴에 대한 삭제를 추가했습니다.

  • S3 업로드 중에 형식이 잘못된 파일의 버그를 수정했습니다.

  • 원격 측에 의해 닫힌 소켓의 주기적 닫기를 추가했습니다.

  • S3 클라이언트의 멀티파트 임계값을 16MB로 복원했습니다.

  • fat jar에서 software.amazon.awssdk.transfer.s3.internal.ApplyUserAgentInterceptor 클래스를 찾을 수 없는 문제를 S3 반복으로 수정했습니다.

  • failed to find class org/conscrypt/CryptoUpcalls 네이티브 오류를 방지하기 위해 음영 처리에서 Conscrypt를 제거했습니다.

  • HOME 디렉터리 캐시를 사용할 수 없는 경우의 :codenowrap:`NullPointerException`을 수정했습니다.

  • GCP에 연결하는 경우의 프록시 인증을 수정했습니다.

  • :codenowrap:`getStreams()`에서 호출자가 제공한 스키마가 무시되는 버그를 수정했습니다.

  • :codenowrap:`NullPointerException`으로 매니페스트된 S3 오류 처리를 수정했습니다.

버전 4.0.1(2026년 2월 9일)

새로운 기능과 업데이트

  • 없습니다.

버그 수정 사항

  • client_encryption_key_size 계정 매개 변수가 256으로 설정된 S3에 파일을 업로드할 때 암호화 알고리즘이 잘못 선택되는 문제를 수정했습니다.

  • software.amazon.awssdk.transfer.s3.internal.ApplyUserAgentInterceptor 클래스가 fat jar에서 문제를 찾을 수 없는 문제를 수정했습니다.

  • org/conscrypt/CryptoUpcalls 클래스를 찾을 수 없는 경우 네이티브 오류를 방지하기 위해 음영 처리에서 Conscrypt를 제거했습니다.

  • 열거형 이름 변경 후 “잘못된 연결 URL”: 유효하지 않은 SSOUrl을 찾음” 오류가 발생하는 외부 브라우저 인증을 수정했습니다.

  • 외부 브라우저 인증자 이름을 :codenowrap:`externalbrowser`로 롤백했습니다.

  • CVE-2025-8916 및 `CVE-2025-8885 <https://nvd.nist.gov/vuln/detail/CVE-2025-8885>`_를 해결하기 위해 BouncyCastle 종속성을 업데이트했습니다.

버전 4.0.0(2026년 1월 27일)

중요

몇 가지 기본적인 문제로 인해 Snowflake는 AWS 및 Azure 고객이 PUT 또는 GET 쿼리를 사용하는 경우 이 버전으로 업그레이드하지 않는 것을 권장합니다. 대신 버전 4.0.1로 직접 업그레이드하는 것이 좋습니다. 이미 이 버전으로 업그레이드한 경우 가능한 한 빨리 버전 4.0.1로 업그레이드하세요.

BCR(동작 변경 릴리스) 변경 사항

  • 공개 API가 재구성되었으며 모든 공개 APIs가 net.snowflake.client.api.* 패키지 계층 구조로 이동되었습니다.

    • :codenowrap:`net.snowflake.client.jdbc.SnowflakeDriver`가 사용 중단되었습니다. 이제 :codenowrap:`net.snowflake.client.api.driver.SnowflakeDriver`를 대신 사용해야 합니다.

    • 사용 중단된 QueryStatus 열거형 및 QueryStatusV2 클래스를 대체하는 통합 QueryStatus 클래스가 공개 API에 추가되었습니다.

    • 스트림 업로드/다운로드 구성을 위한 새로운 DownloadStreamConfig 및 UploadStreamConfig 공개 API 인터페이스가 추가되었습니다.

    • 데이터베이스 메타데이터 작업을 위해 공개 API에 SnowflakeDatabaseMetaData 인터페이스가 추가되었습니다.

    • 비동기 쿼리 작업을 위해 공개 API에 SnowflakeAsyncResultSet 인터페이스가 추가되었습니다.

    • 공개 API에 SnowflakeResultSetSerializable 인터페이스가 추가되었습니다.

    • 내부 클래스가 net.snowflake.client.internal.* 패키지 계층 구조로 이동되었습니다.

    자세한 내용은 JDBC 드라이버 3.x에서 JDBC 드라이버 4.x로 마이그레이션하기 섹션을 참조하십시오.

  • BouncyCastle JVM 속성의 이름이 :codenowrap:`net.snowflake.jdbc.enableBouncyCastle`에서 :codenowrap:`net.snowflake.jdbc.useBundledBouncyCastleForPrivateKeyDecryption`로 변경되었습니다.

  • 이전에 사용 중단된 클래스와 메서드가 제거되었습니다.

    • 사용 중단된 com.snowflake.client.jdbc.SnowflakeDriver 클래스가 제거되었습니다.

    • 사용 중단된:codenowrap:QueryStatus 열거형이 net.snowflake.client.core 패키지에서 제거되었습니다.

    • 사용 중단된 QueryStatusV2 클래스가 net.snowflake.client.jdbc 패키지에서 제거되었습니다.

    • 사용 중단된 SnowflakeType 열거형이 net.snowflake.client.jdbc 패키지에서 제거되었습니다.

새로운 기능과 업데이트

  • 성능 향상 및 최신 API 지원을 위해 AWS SDK v1에서 AWS SDK v2로 마이그레이션되었습니다.

  • Azure 저장소가 SDK 버전 5에서 버전 12로 업그레이드되었습니다.

  • nimbus-jose-jwt OAuth2 종속성이 버전 11.30.1로 업그레이드되었습니다.

  • `CVE-2025-67735<https://nvd.nist.gov/vuln/detail/CVE-2025-67735>`_를 해결하기 위해 netty 버전이 4.1.130.Final로 업데이트되었습니다.

버그 수정 사항

  • 데이터베이스 메타데이터 명령의 column_size 값이 JDBC 사양과 일치하도록 수정되었습니다.

  • 대역 내 원격 분석이 HTTP 응답 없이 전송될 때 발생하는 :codenowrap:`NullPointerException`가 수정되었습니다.