Node.js Driver-Versionshinweise 2026¶
Dieser Artikel enthält die Versionshinweise für Node.js Driver, einschließlich der folgenden, sofern zutreffend:
Verhaltensänderungen
Neue Features
Fehlerkorrekturen für Kunden
Snowflake verwendet semantische Versionierung für Node.js Driver-Aktualisierungen.
Siehe Node.js-Treiber für die Dokumentation.
Version 2.4.0 (07. April 2026)¶
Neue Features und Aktualisierungen¶
Die Verbindungsoption :codenowrap:
browserRedirectPortwurde hinzugefügt, um den Port des lokalen Servers anzupassen, der den EXTERNALBROWSER-Authentifizierungs-Callback empfängt.Die :codenowrap:-Abhängigkeiten
@aws-sdk/*wurden aktualisiert, um eine Sicherheitslücke im :codenowrap:-Paketfast-xml-parserzu beheben.Die Keep-Alive-HTTP-Agenten wurden verbessert, indem ein Leerlauf-Timeout für Sockets von 30 Sekunden eingeführt wurde. Dadurch werden veraltete Verbindungen proaktiv verworfen, bevor der Server sie schließt, wodurch Socket-Hang-Up- und ECONNRESET-Fehler verhindert werden.
Fehlerkorrekturen¶
Es wurde ein Fehler behoben, durch den Verbindungspools bei Verwendung von EXTERNALBROWSER- oder OAUTH_AUTHORIZATION_CODE-Authentifikatoren für jede gepoolte Verbindung erneut zur Browser-Authentifizierung aufgefordert haben. Die erste Verbindung vervollständigt nun die Authentifizierung und speichert die Token, bevor die nachfolgenden Pool-Verbindungen gestartet werden.
Die Erneuerung von Sitzungstoken schlug aufgrund einer fehlerhaften -Anforderung fehl, die dazu führte, dass lang laufende Verbindungen getrennt wurden, anstatt deren abgelaufenes Token zu aktualisieren.
Es wurde ein Fehler behoben, durch den der Query-Context-Cache bei fehlgeschlagenen Abfragen nicht aktualisiert wurde, was dazu führen konnte, dass ein veralteter Cache verwendet wird, wenn nachfolgende Abfragen auf einem anderen GS-Knoten ausgeführt werden.
Version 2.3.6 (25. März 2026)¶
Neue Features und Aktualisierungen¶
Unterstützung für jeden Authentifikatortyp (einschließlich externer Browser und Okta) in
connect(), übereinstimmend mitconnectAsync().Abhängigkeit
@google-cloud/storagewurde entfernt. GCS-Übertragungen verwenden jetzt direkt die JSON API. DieforceGCPUseDownscopedCredential-Verbindungsoption wurde entfernt, da sie nicht mehr benötigt wird.Der Standardwert
jsonColumnVariantParserwurde aktualisiert, sodass für nicht konforme JSON-Variantwerte (wieundefined,NaNundInfinity) auf ein bewertungsbasiertes Parsing zurückgegriffen wird. Damit wird das Verhalten vor Version 2.3.5 wiederhergestellt, währendJSON.parseweiterhin als primärer Parser verwendet wird.
Fehlerkorrekturen¶
Ein Problem wurde behoben, bei dem der
OAUTH_AUTHORIZATION_CODE-Authentifikator dieopenExternalBrowserCallback-Verbindungsoption nicht beachtet hat.Ein Problem wurde behoben, sodass die :codenowrap:` createConnection()`- und :codenowrap:` createPool()`-Typen nun keine Argumente mehr akzeptieren und damit dem Laufzeitverhalten entsprechen, bei dem die Konfiguration aus
connections.tomlgeladen wird.Es wurde ein Problem behoben, sodass das
account-Feld imConnectionOptions-Typ jetzt optional ist, da es vonaccessUrloderhostabgeleitet werden kann.Ein Problem wurde behoben, bei dem die SSO-Authentifizierung auf einem externen Browser abstürzte, wenn eine SSO URL-Anforderung einen serverseitigen Fehler zurückgab.
Version 2.3.5 (17. März 2026)¶
Neue Features und Aktualisierungen¶
Es wurde eine Möglichkeit hinzugefügt, mit der sich die Prüfung der Token-Dateiberechtigungen über die Umgebungsvariable
SF_SKIP_TOKEN_FILE_PERMISSIONS_VERIFICATIONüberspringen lässt.Node 18+ wurde zu Engines hinzugefügt. Dies ist die offiziell unterstützte Mindestversion seit 2.x.
Das Feld
PLATFORMwurde zurlogin-requestTelemetrie hinzugefügt.Anforderungswiederholungen wurden zu zuvor nicht erfassten Abfrageausführungspfaden hinzugefügt.
Die Verbindungsoption
rowStreamHighWaterMarkwurde hinzugefügt, um zu steuern, wie viele Zeilen gepuffert werden, wenn Abfrageergebnisse über codenowrap:statement.streamRows()gestreamt werden.Warnung hinzugefügt bei der Umwandlung von Abfrageergebnissen in JavaScript-Zahlen mit möglichem Präzisionsverlust.
Unterstützung von snake_case-Schlüsseln beim Laden von
connections.tomlübercreateConnection()ohne Argumente hinzugefügt.Dienstprogramm
normalizeConnectionOptions()zur Umwandlung von snake_case-Verbindungsschlüsseln in camelCase exportiert, mit Schlüssel-Aliassen und Akronym-Überschreibungen.Die Felder
LIBC_FAMILYundLIBC_VERSIONwurden zurlogin-request-Telemetrie hinzugefügt.Die Konfigurationsoption
crlDownloadMaxSizewurde hinzugefügt, um beim Herunterladen von CRL-Dateien eine maximale Antwortgröße zu erzwingen.Unterstützung für die RSASSA-PSS-Signaturüberprüfung zur CRL-Validierung hinzugefügt.
Verbesserte Fehlerdetails, wenn OAuth fehlschlägt.
Der Standardwert für
jsonColumnVariantParserwurde inJSON.parsegeändert.Die Linux-GNU-Minicore-Binaries wurden auf glibc 2.18 als Zielversion aktualisiert, um die Kompatibilität mit älteren Linux-Distributionen zu erweitern.
Fehlerkorrekturen¶
Problem mit OAuth-Absturz bei Verwendung von Bundles behoben.
Die Typisierung von
Bindswurde korrigiert, um schreibgeschützte Arrays zuzulassen.Das Problem wurde behoben, bei dem die Methode
connectAsync()vor dem Herstellen der Verbindung aufgelöst wurde.Falsche Behandlung eines Callback-Arguments, das in
connect()undconnectAsync()optional sein sollte.Korrektur eines Fehlers, bei dem ein ungültiges JWT generiert wurde, wenn ein Benutzender in der Konfiguration versehentlich sowohl das Konto als auch den Host festgelegt hat.
Ein Fehler wurde behoben, bei dem das Parsen des JSON-Medientyps fehlschlug, wenn ein optionaler Parameter von Microsoft Identity Platform v2.0-Token enthalten war, was den Fehler beim OAuth-Client-Anmeldeinformationsablauf verursachte.
Die Typisierung von
disableSamlUrlCheckwurde so korrigiert, dass sie die korrekte Groß-/Kleinschreibung verwendet:disableSamlURLCheck.Es wurde ein Fehler behoben, bei dem
getDefaultCacheDir()in Umgebungen ohne konfiguriertes Benutzerverzeichnis abstürzte, indem nun ein Fallback aufos.tmpdir()durchgeführt wird.Es wurde ein Fehler behoben, bei dem codenowrap:
SF_OCSP_RESPONSE_CACHE_DIRnicht direkt als OCSP-Cache-Verzeichnis verwendet wurde.Fehler bei der Handhabung von
noProxyundNO_PROXYbehoben:Das Platzhalterformat :codenowrap:` .domain.com` stimmte nicht korrekt mit dem Zielhost überein.
.wurde falsch als beliebiges Zeichen interpretiert, statt als literaler Punkt.Teilzeichenfolgen wurden falsch abgeglichen, anstatt eine vollständige Zielübereinstimmung zu verlangen.
Der CRLADVISORY-Modus wurde so korrigiert, das Fehler jetzt auf der Warnstufe anstatt auf der Debug-Stufe protokolliert werden.
Es wurde ein Problem behoben, bei dem bei der Neuauthentifizierung des OAuth-Autorisierungscodes nicht das aktualisierte Zugriffstoken verwendet wird, wenn das zwischengespeicherte Zugriffstoken abgelaufen ist.
Es wurde ein Problem behoben, bei dem das Aktualisierungstoken für den OAuth-Autorisierungscode aus dem Cache entfernt wird, wenn durch den IDP-Befehl kein neues Token zurückgegeben wird.
Es wurde Problem mit unbehandelter Promise-Ablehnung behoben, wenn der Server fehlerhafte Abfrageantworten zurückgibt.
Version 2.3.4 (09. Februar 2026)¶
Neue Features und Aktualisierungen¶
Reduzierte Speichernutzung während PUT-Operationen
APPLICATION_PATHzurlogin-request-Telemetrie hinzugefügt.Details zur Linux-Distribution hinzugefügt, die von
/etc/os-releasezurlogin-request-Telemetrie geparst werden.Axios auf Version 1.13.4 aktualisiert, um einen Fehler in Axios-Interceptors zu beheben.
Andere Abhängigkeiten wurden auf die neuesten Nebenversionen aktualisiert.
Fehlerkorrekturen¶
Inkonsistentes Verhalten bei Wiederholungen in allen HTTP-Anforderungen behoben und sichergestellt, dass alle behebbaren Fehler ordnungsgemäß wiederholt werden.
Problem mit ungültigem OAuth-Bereich behoben, wenn
roleundoauthScopein der Verbindungskonfiguration fehlen.Fehler behoben, bei dem das
APPLICATION-Feld nicht von der Verbindungskonfiguration an dielogin-request-Telemetrie übergeben wurde.Build-Fehler in Bundles behoben, die vom
minicore-Modul verursacht wurden.