2025년 JDBC Driver 릴리스 정보¶

새로운 기능과 업데이트¶

• 다음 매개 변수를 포함한 TLS 버전 1.3에 대한 지원을 추가했습니다.

  • :codenowrap:`MIN_TLS_VERSION`은 TLS 핸드셰이크를 시작할 때 사용할 최소 SSL/TLS 버전을 지정합니다.

  • :codenowrap:`MAX_TLS_VERSION`은 TLS 핸드셰이크를 시작할 때 사용할 최대 SSL/TLS 버전을 지정합니다.

버그 수정 사항¶

• Okta에서 MFA가 활성화되어 있고 기본 Okta 인증이 사용되는 경우의 NullPointerException 관련 문제가 해결되었습니다.

• :codenowrap:`CloseableHttpClient`가 무기한 캐시되는 문제를 해결했습니다.

• `CVE-2025-3823<https://github.com/netty/netty/security/advisories/GHSA-4v5m-5c5m-5c5m>`_을 해결하기 위해 Netty 버전을 4.1.124.Final로 높였습니다.

새로운 기능과 업데이트¶

• AWS, Azure, Google Cloud, Kubernetes 플랫폼에서 워크로드 ID 페더레이션에 대한 지원을 추가했습니다.

  • workloadIdentityProvider 연결 매개 변수를 추가했습니다.

  • WORKLOAD_IDENTITY 을 authenticator 연결 매개 변수 값에 추가했습니다.

버그 수정 사항¶

• RFC 6749 섹션 3.1.2와 호환되도록 후행 /(슬래시)를 제거하여 리디렉션 URI에 대한 OAuth 인증 코드 값을 수정했습니다.

• 연결 풀링에 SnowflakeChunkDownloader 를 사용할 때 NullPointerException 를 발생시키는 버그를 수정했습니다.

• 연결 풀링에 auto-config 를 사용하지 못하게 하는 버그를 수정했습니다.

• 원격 분석 스레드로 인해 애플리케이션이 즉시 종료되지 못하는 버그를 수정했습니다.

• S3 클라이언트에 대해 프록시 기본 인증을 적용했습니다.

• 워크로드 ID 페더레이션을 사용하기 위해 SF_ENABLE_EXPERIMENTAL_AUTHENTICATION 환경 변수에 대한 요구 사항을 제거했습니다.

• Date 데이터 타입에 대한 배열 바인딩을 수정했습니다.

새로운 기능과 업데이트¶

• DatabaseMetaData SHOW … IN … 명령에서 패턴 사용을 활성화하기 위해 ENABLE_WILDCARDS_IN_SHOW_METADATA_COMMANDS 매개 변수를 추가했습니다.

• 스테이지 파일이 포함된 디렉터리가 소유자 전용 권한(0600)을 갖도록 강제하는 OWNER_ONLY_STAGE_FILE_PERMISSIONS_ENABLED 매개 변수를 추가했습니다.

버그 수정 사항¶

• 네트워크 재시도 중 불필요한 예외 래핑을 수정했습니다.

• TLS 협상 중에 발생하는 protocol_version 오류에 대해 재시도하는 기능을 추가했습니다.

• 기본 신뢰 관리자가 X509ExtendedTrustManager 를 확장하지 않는 문제를 수정했습니다.

• 세션 로그에 누락된 로그 매개 변수를 추가했습니다.

새로운 기능과 업데이트¶

• 소버린 클라우드에 대한 지원을 추가하고 워크로드 ID 페더레이션에 대해 사용되지 않는 발급자 검사를 제거했습니다.

버그 수정 사항¶

• TelemetryThreadPool 이 워크로드를 따라 확장되지 못하도록 하는 버그를 수정했습니다.

• 레거시 OAuth 흐름에 대한 액세스 토큰 만료 처리를 수정했습니다.

• HTTP 응답 확인에서 사용되지 않는 오류 로그를 제거했습니다.

새로운 기능과 업데이트¶

• 없습니다.

버그 수정 사항¶

• 기본값 JVM 알고리즘으로 신뢰 관리자를 초기화할 때 발생하는 신뢰 관리자 초기화 문제를 수정했습니다.

새로운 기능과 업데이트¶

• 없습니다.

버그 수정 사항¶

• 기본값 JVM 알고리즘으로 신뢰 관리자를 초기화할 때 발생하는 신뢰 관리자 초기화 문제를 수정했습니다.

새로운 기능과 업데이트¶

• 없습니다.

버그 수정 사항¶

• 기본값 JVM 알고리즘으로 신뢰 관리자를 초기화할 때 발생하는 신뢰 관리자 초기화 문제를 수정했습니다.

새로운 기능과 업데이트¶

• 없습니다.

버그 수정 사항¶

• 기본값 JVM 알고리즘으로 신뢰 관리자를 초기화할 때 발생하는 신뢰 관리자 초기화 문제를 수정했습니다.

새로운 기능과 업데이트¶

• 없습니다.

버그 수정 사항¶

• 기본값 JVM 알고리즘으로 신뢰 관리자를 초기화할 때 발생하는 신뢰 관리자 초기화 문제를 수정했습니다.

새로운 기능과 업데이트¶

• 없습니다.

버그 수정 사항¶

• 기본값 JVM 알고리즘으로 신뢰 관리자를 초기화할 때 발생하는 신뢰 관리자 초기화 문제를 수정했습니다.

새로운 기능과 업데이트¶

• Snowflake JDBC 드라이버가 시작하는 다양한 요청에 사용자 정의 HTTP 헤더를 삽입하는 유연한 방법을 제공하기 위해 HttpHeadersCustomizer 인터페이스를 추가했습니다

• LOCAL_APPLICATION default for the clientId 및 clientSecret OAUTH 매개 변수에 추가했습니다.

버그 수정 사항¶

• BindUploader 로 삽입할 때 04.10.1582(그레고리오 개혁) 이전의 타임스탬프 처리를 수정했습니다.

• 파일에 액세스할 수 없을 때 캐시 파일에 쓰는 NPE 처리를 수정했습니다.

• AWS에 대한 워크로드 ID 페레더레이션 요청 서명을 수정했습니다.

비공개 미리 보기(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 매개 변수를 추가했습니다.

새로운 기능과 업데이트¶

• 없음

버그 수정 사항¶

• 캐시 폴더에 액세스할 수 없을 때 발생하는 null 포인터 예외를 수정했습니다.

새로운 기능과 업데이트¶

• 없음

버그 수정 사항¶

• Nimbusds 라이브러리에 대한 종속성 버전 선언이 누락된 것을 수정했습니다.

• Windows 환경에서 캐시에 사용되는 파일 생성 관련 문제를 수정했습니다.

• GET/PUT 명령 실행 중 대상 스테이지의 클라이언트 측 암호화 마스터 키가 로컬에 기록될 때 디버그 수준에서 로깅되는 문제를 수정했습니다. 키 자체로는 민감한 데이터에 대한 액세스 권한을 부여하지 않습니다. 자세한 내용은 CVE -2025-27496 을 참조하십시오.

• 저장소와 통신하는 동안 GCS 자격 증명을 Snowflake 자격 증명보다 우선시하는 문제를 수정했습니다. 매개 변수 disableGcsDefaultCredentials 의 기본값을 true 로 변경했습니다.

• OKTA 를 사용하여 인증 프로세스에서 사용되는 재시도 메커니즘을 수정했습니다.

비공개 미리 보기(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 로 변환하는 기능을 추가했습니다.

• 쿼리 시간 제한을 서버 측 또는 클라이언트 측으로 설정할 수 있는 기능을 추가했습니다.

• 토큰 캐싱 개선을 포함하여 Linux용 파일 기반 자격 증명 캐시를 구현하고 개선했습니다.

버그 수정 사항¶

• 글로벌 요청 구성에서 프록시를 설정하는 잘못된 동작을 수정했습니다.

• 로그 수준이:codenowrap:OFF 로 설정된 경우 비어 있지 않은 로그가 수정되었습니다.

• PUT 명령에서 삼중 슬래시 파일 접두사(file:///)를 사용할 수 있는 파일 경로를 수정했습니다.

• uploadFileCallable 에서 throw된 예외는 이제 자동으로 실패하는 대신 메인 스레드로 전파됩니다.

새로운 기능과 업데이트¶

• 다음 연결 매개 변수를 추가했습니다.

  • 배치를 성공적으로 실행한 후에만 지우는 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 섹션을 참조하십시오.