Options de connexion Node.js¶
Lors de la construction d’un nouvel objet Connection
vous transmettez un objet JavaScript qui spécifie les options de la connexion (par exemple votre identificateur de compte, votre nom d’utilisateur, etc.). Les sections suivantes décrivent les options que vous pouvez définir. Pour définir une option, spécifiez le nom de l’option comme nom de propriété dans l’objet JavaScript.
Options de connexion requises¶
account
Votre identificateur de compte.
username
Le nom de connexion de votre utilisateur Snowflake ou de votre fournisseur d’identité (par exemple, votre nom de connexion pour Okta).
region
(Obsolète)Spécifie l’ID de la région où se trouve votre compte.
Note
Cette option est obsolète et n’est incluse ici que pour des raisons de rétrocompatibilité. Snowflake recommande de passer à l’intégration de la région dans l’identificateur du compte, comme décrit dans Utilisation d’un localisateur de compte comme identificateur, de la manière suivante.
var connection = snowflake.createConnection({ account: "myaccount.us-east-2", username: "myusername", password: "mypassword" });
En outre, vous devez spécifier les options d’authentification au serveur.
Options d’authentification¶
application
Spécifie le nom de l’application client qui se connecte à Snowflake.
authenticator
Spécifie l’authentificateur à utiliser pour vérifier les identifiants de connexion utilisateur. Vous pouvez définir cette option sur l’une des valeurs suivantes :
Valeur
Description
SNOWFLAKE
Utilisez l’authentificateur interne Snowflake. Vous devez également définir l’option
password
.EXTERNALBROWSER
Utilisez votre navigateur Web pour vous authentifier avec Okta, des ADFS ou tout autre fournisseur d’identification conforme à SAML 2.0 (IdP) qui a été défini pour votre compte.
https://<nom_compte_okta>.okta.com
OAUTH
Utilisez OAuth pour l’authentification. Vous devez également définir l’option
token
sur le jeton OAuth (voir ci-dessous).SNOWFLAKE_JWT
Utilisez l’authentification par paire de clés. Voir Utilisation de l’authentification par paires de clés et rotation des paires de clés.
La valeur par défaut est
SNOWFLAKE
.Pour plus d’informations sur l’authentification, voir Gestion/utilisation de l’authentification fédérée et Clients, pilotes et connecteurs.
password
Mot de passe de l’utilisateur. Définissez cette option si vous définissez l’option
authenticator
surSNOWFLAKE
ou le point de terminaison de l” URL Okta pour votre compte Okta (par ex.https://<nom_compte_okta>.okta.com
) ou si vous avez laissé l’optionauthenticator
non définie.
token
Spécifie le jeton OAuth à utiliser pour l’authentification. Définissez cette option si vous avez défini l’option
authenticator
surOAUTH
.privateKey
Spécifie la clé privée (au format PEM) pour l’authentification par paire de clés. Pour plus de détails, voir Utilisation de l’authentification par paires de clés et rotation des paires de clés.
privateKeyPath
Spécifie le chemin local au fichier de clé privée (par exemple,
rsa_key.p8
). Pour plus de détails, voir Utilisation de l’authentification par paires de clés et rotation des paires de clés.privateKeyPass
Spécifie le code d’accès pour déchiffrer le fichier de la clé privée, si le fichier est chiffré. Pour plus de détails, voir Utilisation de l’authentification par paires de clés et rotation des paires de clés.
Options de connexion supplémentaires¶
accessUrl
Spécifie un point de terminaison entièrement qualifié pour se connecter à Snowflake. L”
accessUrl
comprend le schéma complet et l’hôte, ainsi qu’un numéro de port facultatif, similaire àhttps://myaccount.us-east-1.snowflakecomputing.com
.Note
Lors de l’utilisation de l’option
accessUrl
, la valeur spécifiée dans l’optionaccount
n’est pas utilisée.arrayBindingThreshold
Définit le nombre maximum de liens que le pilote utilise dans une opération d’insertion en masse. La valeur par défaut est de 100 000.
clientSessionKeepAlive
Par défaut, les connexions client expirent généralement environ 3 à 4 heures après l’exécution de la requête la plus récente.
Si l’option
clientSessionKeepAlive
est définie surtrue
, la connexion du client au serveur sera maintenue indéfiniment, même si aucune requête n’est exécutée.Le paramètre par défaut de cette option est false.
Si vous définissez cette option sur
true
, assurez-vous que votre programme se déconnecte explicitement du serveur à la fin du programme. Ne quittez pas sans vous déconnecter.clientSessionKeepAliveHeartbeatFrequency
(Cette option ne s’applique que lorsque
clientSessionKeepAlive
est true)Définit la fréquence (l’intervalle en secondes) entre les messages de pulsation.
Vous pouvez vaguement penser qu’un message de pulsation de connexion se substitue à une requête et redémarre le compte à rebours du délai d’attente pour la connexion. En d’autres termes, si la connexion expire après au moins 4 heures d’inactivité, la pulsation réinitialise le chronomètre afin que l’expiration ne se produise pas au moins 4 heures après la dernière pulsation (ou requête).
La valeur par défaut est de 3 600 secondes (une heure). La plage de valeurs valide est 900 - 3600. Comme les expirations surviennent généralement après au moins 4 heures, une pulsation toutes les heures est normalement suffisante pour maintenir la connexion en vie. Des intervalles de pulsation inférieurs à 3 600 secondes sont rarement nécessaires ou utiles.
database
La base de données par défaut à utiliser pour la session après la connexion.
noProxy
Spécifie les listes des hôtes auxquels le pilote doit se connecter directement, sans passer par le serveur proxy (par ex.
*.amazonaws.com
pour contourner l’accès à Amazon S3). Pour plusieurs hôtes, séparez les noms d’hôtes par un symbole de barre verticale (|
). Vous pouvez également utiliser un astérisque comme caractère générique. Par exemple :noProxy: "*.amazonaws.com|*.my_company.com"
proxyHost
Spécifie le nom d’hôte d’un serveur proxy authentifié.
proxyPassword
Indique le mot de passe de l’utilisateur spécifié par
proxyUser
.proxyPort
Spécifie le port d’un serveur proxy authentifié.
proxyProtocol
Spécifie le protocole utilisé pour se connecter au serveur proxy authentifié. Utilisez cette propriété pour spécifier le protocole HTTP :
http
ouhttps
.proxyUser
Spécifie le nom d’utilisateur utilisé pour se connecter à un serveur proxy authentifié.
resultPrefetch
Nombre de threads à utiliser par les clients pour la préextraction de grands jeux de résultats. Valeurs valides : 1-10.
role
Le rôle de sécurité par défaut à utiliser pour la session après la connexion.
schema
Le schéma par défaut à utiliser pour la session après la connexion.
timeout
Nombre de millisecondes pour maintenir la connexion en vie sans réponse. Valeur par défaut : 60 000 (1 minute).
warehouse
L’entrepôt virtuel par défaut à utiliser pour la session après la connexion. Utilisé pour effectuer des requêtes, charger des données, etc.
Certaines options de connexion supposent que l’objet de base de données spécifié (base de données, schéma, entrepôt ou rôle) existe déjà dans le système. Si l’objet spécifié n’existe pas, un réglage par défaut n’est pas défini lors de la connexion.
Après la connexion, toutes les options de connexion optionnelles peuvent également être réglées ou remplacées par la commande USE <objet>.