2026년 Node.js Driver 릴리스 정보¶

EXTERNALBROWSER 인증을 수신하는 로컬 서버의 포트를 사용자 지정하는 browserRedirectPort 연결 옵션을 추가했습니다.

fast-xml-parser 취약성을 해결하기 위해 @aws-sdk/* 종속성을 업데이트했습니다.

서버가 연결을 닫기 전에 부실 연결을 사전에 삭제하여 소켓 중단 및 ECONNRESET 오류를 방지하는 30초 유휴 소켓 시간 제한으로 연결 유지 HTTP를 개선했습니다.

EXTERNALBROWSER 또는 OAUTH_AUTHORIZATION_CODE 인증자를 사용할 때 풀링된 모든 연결에 대해 브라우저 인증을 다시 표시하는 연결 풀을 수정했습니다. 이제 첫 번째 연결은 인증을 완료하고 후속 풀 연결이 시작되기 전에 토큰을 캐시합니다.

잘못된 형식의 요청으로 인해 세션 토큰 갱신이 실패하여 만료된 세션 토큰을 새로 고치는 대신 장시간 실행 중인 연결이 해제되는 문제를 수정했습니다.

실패한 쿼리에서 쿼리 컨텍스트 캐시가 업데이트되지 않아 후속 쿼리가 다른 GS 노드에 배치될 때 부실 캐시가 발생할 수 있는 문제를 수정했습니다.

:codenowrap:`connect()`에서 모든 인증자 유형(외부 브라우저 및 Okta 포함)에 대한 지원을 추가했으며, 이는 :codenowrap:`connectAsync()`와 일치합니다.

@google-cloud/storage 종속성을 제거했습니다. 이제 GCS 전송에 JSON API를 직접 사용합니다. forceGCPUseDownscopedCredential 연결 옵션은 더 이상 필요하지 않아 제거되었습니다.

기본 jsonColumnVariantParser`를 업데이트하여 JSON을 준수하지 않는 베리언트 값(예:codenowrap:`undefined, NaN, Infinity)에 대해 평가 기반 구문 분석으로 대체하고, :codenowrap:`JSON.parse`를 기본 구문 분석기로 유지하면서 2.3.5 이전 동작을 복원했습니다.

OAUTH_AUTHORIZATION_CODE 인증자가 openExternalBrowserCallback 연결 옵션을 준수하지 않는 문제를 수정했습니다.

createConnection() 및 :codenowrap:`createPool()`이 인자를 허용하지 않도록 수정하여 :file:`connections.toml`에서 구성을 로드하는 런타임 동작과 일치시켰습니다.

ConnectionOptions 유형의 account 필드는 accessUrl 또는 :codenowrap:`host`에서 파생될 수 있으므로 선택 사항으로 수정했습니다.

SSO URL 요청이 서버 측 오류를 반환할 때 외부 브라우저 SSO 인증이 충돌하는 문제를 수정했습니다.

SF_SKIP_TOKEN_FILE_PERMISSIONS_VERIFICATION 환경 변수를 사용하여 토큰 파일 권한 검사를 건너뛰는 기능을 추가했습니다.

2.x 릴리스 이후 공식적으로 지원되는 최소 버전인 Node 18+를 엔진에 추가했습니다.

login-request 원격 분석에 PLATFORM 필드를 추가했습니다.

이전에 발견되지 않은 쿼리 실행 경로에 요청 재시도를 추가했습니다.

statement.streamRows()`를 통해 쿼리 결과를 스트리밍할 때 버퍼링되는 행 수를 제어하기 위해 :codenowrap:`rowStreamHighWaterMark 연결 옵션을 추가했습니다.

쿼리 결과를 전체 자릿수 손실이 있는 JavaScript 숫자로 변환할 때 경고를 추가했습니다.

인자가 없는 :codenowrap:`createConnection()`을 통해 :file:`connections.toml`을 로드할 때 snake_case 키 지원을 추가했습니다.

키 별칭과 약어 재정의를 사용하여 snake_case 연결 키를 카멜 케이스로 변환하기 위해 normalizeConnectionOptions() 유틸리티를 내보냈습니다.

login-request 원격 분석에 LIBC_FAMILY 및 LIBC_VERSION 필드를 추가했습니다.

CRL 파일 다운로드 시 최대 응답 크기 제한을 적용하기 위해 crlDownloadMaxSize 구성을 추가했습니다.

CRL 유효성 검사를 위해 RSASSA-PSS 서명 확인 지원을 추가했습니다.

OAuth가 실패한 경우의 오류 세부 정보를 개선했습니다.

기본 :codenowrap:`jsonColumnVariantParser`를 :codenowrap:`JSON.parse`로 변경했습니다.

이전 Linux 배포판과의 광범위한 호환성을 위해 glibc 2.18을 대상으로 하는 Linux GNU Minicore 바이너리를 업데이트했습니다.

번들러를 사용하는 경우의 OAuth 충돌을 수정했습니다.

읽기 전용 배열을 허용하도록 Binds 입력을 수정했습니다.

연결이 완료되기 전에 connectAsync() 메서드를 확인하는 문제를 수정했습니다.

connect() and :codenowrap:`connectAsync()`에서 선택 사항이어야 하는 콜백 인자의 잘못된 처리를 수정했습니다.

사용자가 구성에서 계정과 호스트를 모두 실수로 설정한 경우 유효하지 않은 JWT가 생성되는 버그를 수정했습니다.

Microsoft Identity Platform v2.0 토큰의 선택적 매개 변수를 포함할 때 JSON 미디어 유형 구문 분석이 실패하여 OAuth 클라이언트 자격 증명 흐름이 실패하는 버그를 수정했습니다.

disableSamlURLCheck`가 올바른 대소문자를 사용하도록 :codenowrap:`disableSamlUrlCheck 입력을 수정했습니다.

사용자 홈 디렉터리가 구성되지 않은 환경에서 :codenowrap:`getDefaultCacheDir()`이 충돌하는 문제를 :codenowrap:`os.tmpdir()`로 대체하여 수정했습니다.

:codenowrap:`SF_OCSP_RESPONSE_CACHE_DIR`이 OCSP 캐시 디렉터리로 직접 사용되지 않는 문제를 수정했습니다.

noProxy 및 NO_PROXY 처리에서 다음 버그를 수정했습니다.

• .domain.com 와일드카드 형식이 대상 호스트와 올바르게 일치하지 않았습니다.

• :codenowrap:`.`이 리터럴 점 대신 임의의 문자로 잘못 일치했습니다.

• 전체 대상 일치를 요구하는 대신 부분 문자열이 잘못 일치했습니다.

디버그 대신 경고 수준에서 실패를 기록하도록 CRL ADVISORY 모드를 수정했습니다.

캐시된 액세스 토큰이 만료될 때 OAuth 인증 코드 재인증 시 새로 고친 액세스 토큰을 사용하지 않는 문제를 수정했습니다.

IDP에서 새 토큰을 반환하지 않을 때 OAuth 인증 코드 새로 고침 토큰이 캐시에서 제거되는 문제를 수정했습니다.

서버가 잘못된 형식의 쿼리 응답을 반환할 때 처리되지 않은 약속 거부 문제를 수정했습니다.

PUT 작업 중 메모리 사용량이 감소했습니다.

login-request 원격 분석에 :codenowrap:`APPLICATION_PATH`를 추가했습니다.

/etc/os-release`에서 구문 분석된 Linux 배포 세부 정보를 :codenowrap:`login-request 원격 분석에 추가했습니다.

axios 인터셉터의 버그를 해결하기 위해 axios를 버전 1.13.4로 업데이트했습니다.

다른 종속성을 최신 부 버전으로 업데이트했습니다.

HTTP 요청에서 일관되지 않은 재시도 동작을 수정하고 복구 가능한 모든 오류가 올바르게 재시도되도록 했습니다.

role 및 `oauthScope`가 연결 구성에서 누락된 경우 유효하지 않은 oauth 범위를 수정했습니다.

연결 구성에서 APPLICATION 필드가 login-request 원격 분석으로 전달되지 않는 문제를 수정했습니다.

minicore 모듈로 인해 발생하는 번들러의 빌드 오류를 수정했습니다.