2025년 Node.js Driver 릴리스 정보¶
이 문서에는 Node.js Driver 에 대한 릴리스 정보가 있는데, 해당되는 경우 다음을 포함합니다.
동작 변경 사항
새로운 기능
고객이 직면한 버그 수정
Snowflake는 Node.js Driver 업데이트에 의미 체계 버전 관리를 사용합니다.
설명서는 Node.js 드라이버 섹션을 참조하십시오.
버전 2.2.0(2025년 8월 13일)¶
새로운 기능과 업데이트¶
AWS, Azure, Google Cloud, Kubernetes 플랫폼에서 워크로드 ID 페더레이션에 대한 지원을 추가했습니다.
workloadIdentityProvider
연결 매개 변수를 추가했습니다.WORKLOAD_IDENTITY
을authenticator
연결 매개 변수 값에 추가했습니다.
QUERY_TAG
세션 매개 변수를 설정하기 위해queryTag
연결 매개 변수를 추가했습니다.
버그 수정 사항¶
만료된 OAuth 액세스 토큰에 연결할 때 발생하는 네트워크 오류를 수정했습니다.
RFC 6749 섹션 3.1.2와 호환되도록 후행 /(슬래시)를 제거하여 리디렉션 URI에 대한 OAuth 인증 코드 값을 수정했습니다.
GET 명령의 오류를 개선했습니다.
버전 2.1.3(2025년 7월 21일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
useVirtualUrl=true
일 때 Google Cloud Platform(GCP) XML API 사용 시 발생하는 문제를 수정했습니다..toml
구성 파일에 대한 권한 확인을 수정했습니다.외부 브라우저 인증을 사용할 때 프로세스가 종료되지 않도록 연결을 생성한 후 처리되지 않는 리소스를 수정했습니다.
인증 코드 흐름에서
oauthEnableSingleUseRefreshTokens
의 문제를 수정했습니다.
버전 2.1.2(2025년 7월 10일)¶
새로운 기능과 업데이트¶
없습니다.
버그 수정 사항¶
버전 2.1.1에 도입된 TypeScript 오류를 수정했습니다.
버전 2.1.1(2025년 7월 3일)¶
비공개 미리 보기(PrPr) 기능¶
AWS, Azure, GCP 및 Kubernetes 플랫폼에서 워크로드 ID 페더레이션에 대한 지원을 추가했습니다.
면책 조항:
이 기능은
SF_ENABLE_EXPERIMENTAL_AUTHENTICATION
환경 변수를true
로 설정해야만 액세스할 수 있습니다.이 기능은 프로덕션이 아닌 데이터에만 사용해야 합니다.
이 PrPr 기능은 지원 대상에서 제외됩니다. 그러나 제품 및 엔지니어링 팀이 PrPr 단계에서 지원할 수 있습니다.
참여 및 설명서는 계정 팀에 문의하십시오.
새로운 기능과 업데이트¶
클라이언트 자격 증명 인증을 위한 토큰 캐싱을 제거했습니다.
버그 수정 사항¶
Util.getProxyFromEnv
가 HTTPS를 잘못 가정하여 HTTP 트래픽(포트 80)에 대해HTTP_PROXY
값이 무시되는 문제를 수정했습니다.getQueryResponse
가 null 응답을 반환하는 사례를 처리하여 가끔 발생하는 중단을 방지하도록extractQueryStatus
를 개선했습니다.코어 인스턴스에
ErrorCode
를 추가했습니다.
추가 참고 사항¶
이 릴리스에는 개발을 위한 TypeScript가 도입되었습니다. npm 패키지에는 드라이버 사용자에게 예상되는 호환성 문제가 없는 컴파일된 JavaScript 코드가 포함되어 있습니다.
버전 2.1.0(2025년 5월 11일)¶
새로운 기능과 업데이트¶
OAuth 2.0 승인 코드 플로우 및 OAuth 2.0 클라이언트 자격 증명 플로우에 대한 지원이 추가되었습니다.
OAuth 2.0 승인 코드 플로우의 경우:
oauthClientId
,oauthClientSecret
,oauthAuthorizationUrl
,oauthTokenRequestUrl
및oauthScope
매개 변수를 추가했습니다.매개 변수 인증자에 대한
OAUTH_AUTHORIZATION_CODE
매개 변수를 추가했습니다.
OAuth 2.0 클라이언트 자격 증명 플로우의 경우:
oauthClientId
,oauthClientSecret
,oauthTokenRequestUrl
및oauthScope
매개 변수를 추가했습니다.매개 변수 인증자에 대한
OAUTH_CLIENT_CREDENTIALS
매개 변수를 추가했습니다.
가상 스타일 도메인에 대한 지원이 추가되었습니다.
토큰 캐싱 개선을 포함하여 Linux용 파일 기반 자격 증명 캐시를 구현하고 개선했습니다.
버그 수정 사항¶
없음
버전 2.0.4(2025년 4월 28일)¶
비공개 미리 보기(PrPr) 기능¶
프로그래밍 방식 액세스 토큰 인증에 대한 지원을 구현했습니다.
면책 조항:
이 기능은
SF_ENABLE_EXPERIMENTAL_AUTHENTICATION
환경 변수를:codenowrap:true
로 설정해야 액세스할 수 있습니다.이러한 기능은 프로덕션이 아닌 데이터에만 사용해야 합니다.
이러한 PrPr 기능은 지원팀에서 담당하지 않습니다. 그러나 제품 및 엔지니어링 팀은 PrPr 단계에서 이용할 수 있습니다.
참여 및 설명서는 계정 팀에 문의하십시오.
새로운 기능과 업데이트¶
Axios를 버전 1.8.2+로 업그레이드했습니다.
버그 수정 사항¶
간편 로깅 구성 파일에 대한 액세스를 확인할 때 사용 시간 확인(TOCTOU) 경쟁 조건을 수정했습니다. 자세한 내용은 CVE-2025-46328 섹션을 참조하십시오.
OCSP 응답 캐시 항목이 올바르게 새로 고쳐지지 않는 문제를 수정했습니다.
버전 2.0.3(2025년 3월 13일)¶
새로운 기능과 업데이트¶
없음
버그 수정 사항¶
파일 업로드 오류에 대한 약속 거부 문제를 수정했습니다.
버전 2.0.2(2025년 1월 29일)¶
새로운 기능과 업데이트¶
리전별 Google Cloud Storage 엔드포인트에 대한 지원을 추가했습니다.
GCS 에 대한 프로토콜이 없는 엔드포인트를 위한 지원을 추가했습니다.
다음 종속성을 업데이트했습니다.
azure/storage-blob을 버전 12.26.x로 업데이트
aws-sdk/client-s3에서 버전 3.726.0으로 업데이트
smithy/node-http-handler를 버전 4.0.1로 업데이트
버그 수정 사항¶
인증이
EXTERNALBROWSER
또는USERNAME_PASSWORD_MFA
로 설정된 경우 토큰 캐싱 파일 권한 및 소유자 확인을 수정했습니다. 자세한 내용은 CVE-2025-24791 섹션을 참조하십시오.타입 정의 파일에서
FileAndStageBindStatement
유형을 수정했습니다.HttpClient
에서 요청 중단 및 일관되지 않은 요청 메서드와 관련된 문제를 수정했습니다.GCS 버킷으로 요청을 보내는 데 사용되는 프록시 구성 설정 관련 문제를 수정했습니다.