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 the clientIdclientSecret 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, oauthTokenRequestUrloauthScope 매개 변수를 추가했습니다.

      • 매개 변수 인증자에 대한 OAUTH_AUTHORIZATION_CODE 매개 변수를 추가했습니다.

    • OAuth 2.0 클라이언트 자격 증명 플로우의 경우:

      • oauthClientId, oauthClientSecret, oauthTokenRequestUrloauthScope 매개 변수를 추가했습니다.

      • 매개 변수 인증자에 대한 OAUTH_CLIENT_CREDENTIALS 매개 변수를 추가했습니다.

    • OAuth 토큰 캐싱의 경우: 드라이버 구성에 사용자 이름을 전달해야 하며 clientStoreTemporaryCredential 속성을 false 로 설정할 수 없습니다.

  • joda-timegoogle-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, oauthTokenRequestUrloauthScope 매개 변수를 추가했습니다.

    • 매개 변수 인증자에 대한 OAUTH_AUTHORIZATION_CODE 매개 변수를 추가했습니다.

  • OAuth 2.0 클라이언트 자격 증명 플로우의 경우:

    • oauthClientId, oauthClientSecret, oauthTokenRequestUrloauthScope 매개 변수를 추가했습니다.

    • 매개 변수 인증자에 대한 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 섹션을 참조하십시오.