Paramètres de configuration et de connexion ODBC¶

Paramètres de connexion requis¶

<nom> (source de données)

Spécifie le nom de votre DSN.

port (Port)

Spécifie le port sur lequel le pilote écoute la communication Snowflake.

Note

Vous n’avez pas besoin de changer la valeur par défaut Port de 443.

pwd (mot de passe)

Un mot de passe est requis pour se connecter à Snowflake. Cependant, pour des raisons de sécurité et d’authentification, Snowflake déconseille fortement le stockage des identifiants de mot de passe directement dans toute définition DSN.

Généralement, les informations d’identification sont transmises au pilote par programmation par l’application client qui tente de se connecter à Snowflake.

Note

Sous Windows, le pilote ODBC affiche un champ Password dans l’outil Data Source Administration. Cependant, le pilote ne stocke pas les valeurs saisies dans le champ. À la place, le pilote nécessite que les informations d’identification soient fournies au moment de la connexion.

server (serveur)

Spécifie le nom d’hôte de votre compte au format suivant :

account_identifier.snowflakecomputing.com

Pour plus d’informations sur les identificateurs de compte, voir Identificateurs de compte.

uid (utilisateur)

Indique le nom de connexion de l’utilisateur Snowflake à authentifier.

Paramètres de connexion facultatifs¶

BROWSER_RESPONSE_TIMEOUT

Spécifie le nombre de secondes à attendre pour une réponse d’authentification dans un navigateur externe.

La valeur par défaut est 120.

CLIENT_OUT_OF_BAND_TELEMETRY_ENABLED=<Booléen>

Indique si la télémétrie hors bande doit être activée.

La valeur par défaut est true

CLIENT_SESSION_KEEP_ALIVE=<Booléen>

Indique si la session en cours doit rester active après une période d’inactivité ou si l’utilisateur doit se reconnecter. Si la valeur est true, Snowflake garde la session active indéfiniment, même s’il n’y a aucune activité de l’utilisateur. Si la valeur est false, l’utilisateur doit se reconnecter après quatre heures d’inactivité.

La valeur par défaut est false.

database (base de données)

Indique la base de données par défaut à utiliser pour les sessions lancées par le pilote.

maxHttpRetries (base de données)

Indique le nombre maximal de nouvelles tentatives HTTP pour les requêtes dont les demandes HTTP ont échoué avant de renvoyer une erreur. La configuration de maxHttpRetries=0 supprime la limite de tentatives, mais cela fait courir le risque que le pilote relance indéfiniment les appels HTTP qui ont échoué.

La valeur par défaut est 7.

role (rôle)

Indique le rôle par défaut à utiliser pour les sessions lancées par le pilote. Le rôle indiqué doit être un rôle qui a été affecté à l’utilisateur spécifié pour le pilote. Si le rôle spécifié ne correspond à aucun des rôles affectés à l’utilisateur, les sessions lancées par le pilote n’ont pas de rôle au départ. Toutefois, un rôle peut toujours être spécifié depuis la session.

schema (schéma)

Indique le schéma par défaut à utiliser pour les sessions lancées par le pilote.

La valeur par défaut est public.

SecondaryRoles (rôle)

Indique les rôles secondaires à utiliser pour les sessions lancées par le pilote. Les rôles doivent déjà être accordés à l’utilisateur spécifié pour le pilote. Les rôles secondaires peuvent également être activés depuis une session utilisateur à l’aide de la commande USE SECONDARY ROLES.

Les valeurs possibles sont les suivantes :

• Tous : tous les rôles accordés à l’utilisateur.

• Aucun : aucun rôle n’est autorisé (désactive les rôles secondaires).

tracing (traçage)

Le niveau de détail à enregistrer dans les fichiers de trace de pilote :

• 0 = Désactiver le traçage

• 1 = Uniquement traçage des erreurs fatales

• 2 = Traçage des erreurs

• 3 = Traçage des avertissements

• 4 = Traçage des informations

• 5 = Traçage des débogages

• 6 = Traçage détaillé

warehouse (entrepôt)

Indique l’entrepôt par défaut à utiliser pour les sessions lancées par le pilote.

Paramètres de connexion supplémentaires¶

allowEmptyProxy

Spécifie s’il faut autoriser des valeurs vides pour les paramètres de connexion proxy et no_proxy comme décrit dans les sections suivantes :

• Utilisation des paramètres de connexion

• Utilisation des paramètres de configuration

• Utilisation de variables d’environnement

La définition de cette valeur produit les effets suivants :

• true : le pilote traite les valeurs de proxy vides comme des paramètres de proxy valides et remplace toute variable ou tout paramètre d’environnement existant.

• false : le pilote ignore les valeurs de proxy vides et utilise la variable d’environnement ou les paramètres de configuration spécifiés.

La valeur par défaut est true.

application

Pour partenaire Snowflake uniquement : spécifie le nom d’une application partenaire à connecter via ODBC.

Ce paramètre peut également être défini en appelant la fonction SQLSetConnectAttr(). Pour plus d’informations, reportez-vous à la section relative au comportement de la fonction SQLSetConnectAttr, spécifique à Snowflake.

authenticator

Spécifie l’authentifiant à utiliser pour vérifier les informations d’identification d’utilisateur :

• snowflake (par défaut) pour utiliser l’authentificateur interne Snowflake.

• externalbrowser pour utiliser 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.

  Note

  Le pilote Snowflake ODBC ne prend pas en charge l’authentification externalbrowser en utilisant Microsoft Excel avec MacOS.

• https://<nom_compte_okta>.okta.com (c.-à-d. le point de terminaison d’URL pour votre compte Okta) pour vous authentifier via Okta natif (uniquement pris en charge si votre IdP est Okta).

• oauth pour vous authentifier à l’aide de OAuth. Lorsque OAuth est spécifié comme authentificateur, vous devez également définir le paramètre token pour spécifier le jeton OAuth (voir ci-dessous).

• username_password_mfa pour s’authentifier avec la mise en cache du jeton MFA. Pour plus de détails, voir Utilisation de l’authentification multifactorielle (dans cette rubrique).

La valeur par défaut est snowflake.

Sous Windows, vous pouvez utiliser l’outil d’administration de sources de données ODBC pour définir ce paramètre.

Pour plus d’informations sur l’authentification, voir Gestion/Utilisation de l’authentification fédérée et Clients, pilotes et connecteurs.

default_binary_size, . default_varchar_size

Spécifie la taille par défaut que le pilote utilise lors de la récupération et de la conversion de valeurs provenant de colonnes BINARY ou VARCHAR de taille indéterminée. Définissez cette option lorsque vous récupérez des valeurs de ces types de colonnes.

Par défaut, le pilote utilise 8388608 (pour les colonnes BINARY) et 16777216 (pour les colonnes VARCHAR) comme tailles par défaut lors de l’allocation de mémoire pour la récupération de la valeur d’une colonne de taille indéterminée.

Pour réduire la quantité de mémoire allouée à ces valeurs, vous pouvez définir default_binary_size et default_varchar_size à la taille maximale des valeurs dans ces types de colonnes.

Note

La définition de ces valeurs ne modifie que le champ SQL_DESC_LENGTH du descripteur de ligne d’implémentation (IRD) et les valeurs correspondantes renvoyées par SQLDescribeCol/SQLColAttribute/SQLColAttributes. Le pilote renvoie toujours l’intégralité des données, même si leur longueur dépasse le paramètre défini.

D’autre part, une application pourrait allouer un tampon de données en fonction de la longueur spécifiée dans ces paramètres, ce qui pourrait tronquer les données en raison d’un manque d’espace dans le tampon. En tant que meilleure pratique, Snowflake recommande de définir une taille par défaut plus grande que la taille maximale des données typiques (par exemple 4 000 ou 8 000 octets) afin de réduire considérablement l’utilisation de la mémoire par rapport aux valeurs par défaut d’origine de 16 777 216/8 388 608 octets et de réduire le risque de troncation des données.

Notez que vous pouvez également utiliser ces paramètres pour éviter l’erreur suivante, qui peut se produire lors de l’utilisation du fournisseur OLE DB de Microsoft (MSDASQL) avec une base de données Snowflake :

Requested conversion is not supported
Cannot get the current row value of column

Copy

Vous pouvez spécifier ces paramètres en tant que paramètres de configuration de connexion (par exemple, dans le fichier simba.snowflake.ini sur macOS et Linux). Si ce paramètre est défini à la fois comme un paramètre de connexion et comme un paramètre de configuration, le paramètre de connexion dans le DSN (ou chaîne de connexion) a la priorité.

Ces paramètres ont été introduits dans la version 2.23.2 du pilote ODBC.

get_size_threshold

Spécifie la taille minimale du fichier, en mégaoctets (MB), pour diviser les fichiers en parties plus petites lors du téléchargement de fichiers avec la commande GET. Les fichiers dont la taille est inférieure à ce seuil n’utiliseront pas le téléchargement en plusieurs parties.

La valeur par défaut est 5 (MB).

Note

La définition de cette valeur en tant que paramètre de connexion remplace la valeur du paramètre de configuration obtenir_taille_seuil correspondant.

login_timeout

Indique le temps d’attente, en secondes, pour l’obtention d’une réponse lors de la connexion au service Snowflake avant de renvoyer une erreur d’échec de connexion.

La valeur par défaut est 300 (secondes).

network_timeout

Indique le temps d’attente, en secondes, pour l’obtention d’une réponse lors d’une interaction avec le service Snowflake avant de renvoyer une erreur. Zéro (0) indique qu’aucun délai d’attente réseau n’est défini.

La valeur par défaut est 0 (secondes).

retryTimeout

Spécifie combien de temps, en secondes, il faut attendre avant de renvoyer une erreur pour les nouvelles tentatives HTTP de requêtes HTTP ayant échoué. Zéro (0) indique qu’aucun délai d’expiration de nouvelle tentative n’est défini.

La valeur par défaut est 300 (secondes).

no_proxy

Spécifie les terminaisons de nom d’hôte qui doivent être autorisées à ignorer le serveur proxy. Par exemple, no_proxy=.amazonaws.com signifie que l’accès d’Amazon S3 n’a pas besoin de passer par le proxy.

Ce paramètre ne prend pas en charge les caractères génériques. Chaque valeur spécifiée doit être l’une des suivantes :

• La fin d’un nom d’hôte (ou d’un nom d’hôte complet), par exemple :

  • .amazonaws.com

  • myorganization-myaccount.snowflakecomputing.com

• Une adresse IP, par exemple :

  • 192.196.1.15

Si plusieurs valeurs sont spécifiées, elles doivent être séparées par des virgules, par exemple :

no_proxy=localhost,.my_company.com,myorganization-myaccount.snowflakecomputing.com,192.168.1.15,192.168.1.16

Copy

Note

Ce paramètre est appliqué au processus. Si une autre connexion partage le même processus, le paramètre de proxy doit être identique ou le comportement n’est pas prévisible.

odbc_use_standard_timestamp_columnsize

Ce paramètre booléen a une incidence sur la largeur de colonne (en caractères) renvoyée pour SQL_TYPE_TIMESTAMP. Lorsque ce paramètre est défini sur True, le pilote renvoie 29, en suivant la norme ODBC. Lorsque ce paramètre est défini sur false, le pilote renvoie 35, ce qui laisse de la place pour le décalage de fuseau horaire (par exemple, « -08:00 »).

Cette valeur peut être définie via non seulement le fichier odbc.ini (linux ou macOS) ou le registre Windows, mais également la chaîne de connexion.

La valeur par défaut est false.

passcode

Spécifie le code à utiliser pour l’authentification multifactorielle.

Pour plus d’informations sur l’authentification multifactorielle, voir Authentification multifactorielle (MFA).

passcodeInPassword

Indique si le code pour l’authentification multifactorielle est ajouté au mot de passe :

• on (ou true) spécifie que le code est ajouté.

• off (ou false) ou toute autre valeur spécifie que le code n’est pas ajouté.

La valeur par défaut est off.

proxy

Indique l’URL de serveur de proxy au format http://<nom_hôte>:<port>/ ou <nom_hôte>:<numéro_port> pour que toutes les communications depuis ODBC utilisent le serveur de proxy.

Note

Ce paramètre est appliqué au processus. Si une autre connexion partage le même processus, le paramètre de proxy doit être identique ou le comportement n’est pas prévisible.

put_compresslv

Spécifie le taux de compression que le pilote ODBC utilise lors du transfert des données avec la commande PUT. Ce paramètre remplace le niveau de compression gzip par défaut. Si vous ne spécifiez pas put_compresslv, le pilote ODBC utilise le niveau de compression par défaut.

Les valeurs valides vont de -1 à 9. La valeur par défaut est -1 et spécifie la valeur par défaut Z_DEFAULT_COMPRESSION.

Les valeurs 0 à 9 spécifient un taux de compression personnalisé. 0 fait en sorte que le pilote ODBC utilise un taux de compression inférieur et 9 un taux de compression supérieur. L’utilisation d’un taux de compression plus élevé entraîne des vitesses de transfert de données plus lentes.

Vous pouvez également spécifier ce paramètre en tant que paramètre de configuration (par exemple, dans le simba.snowflake.ini sur macOS et Linux). Si ce paramètre est défini à la fois comme un paramètre de connexion et comme un paramètre de configuration, le paramètre de connexion dans le DSN (ou chaîne de connexion) a la priorité.

Ce paramètre a été introduit dans la version 2.23.3 du pilote ODBC.

put_fastfail

Si vous utilisez des caractères génériques avec la commande PUT pour charger plusieurs fichiers à la fois et que vous souhaitez que le pilote arrête le chargement des fichiers lorsqu’une erreur se produit, réglez ce paramètre sur true.

La valeur par défaut est false , ce qui signifie que si une erreur se produit avec un fichier, le pilote continue de charger le reste des fichiers.

Ce paramètre a été introduit dans la version 2.22.3 du pilote ODBC.

À partir de la version 2.22.5 du pilote ODBC, vous pouvez également spécifier ce paramètre en tant que paramètre de configuration (par exemple, dans le simba.snowflake.ini sur macOS et Linux). Si ce paramètre est défini à la fois comme un paramètre de connexion et comme un paramètre de configuration, le paramètre de connexion dans le DSN (ou chaîne de connexion) a la priorité.

put_maxretries

Spécifie le nombre de fois que le pilote doit réessayer la commande PUT si la commande échoue.

La valeur par défaut est 5.

La plage de valeurs valable pour ce paramètre est de 0 à 100. Si vous spécifiez une valeur en dehors de cette plage, le pilote utilise la valeur par défaut de 5.

Ce paramètre a été introduit dans la version 2.22.3 du pilote ODBC.

À partir de la version 2.22.5 du pilote ODBC, vous pouvez également spécifier ce paramètre en tant que paramètre de configuration (par exemple, dans le simba.snowflake.ini sur macOS et Linux). Si ce paramètre est défini à la fois comme un paramètre de connexion et comme un paramètre de configuration, le paramètre de connexion dans le DSN (ou chaîne de connexion) a la priorité.

put_tempdir

Spécifie le répertoire temporaire à utiliser pour les demandes de commandes PUT. Le pilote utilise ce répertoire temporaire pour créer des fichiers compressés temporaires avant de télécharger ces fichiers vers Snowflake.

Si ce paramètre n’est pas défini, le pilote crée et utilise le répertoire temporaire /tmp/snowflakeTmp_username, où username est le nom d’utilisateur de l’utilisateur actuel dans le système d’exploitation.

Vous pouvez également spécifier ce paramètre en tant que paramètre de configuration (par exemple, dans le simba.snowflake.ini sur macOS et Linux). Si ce paramètre est défini à la fois comme un paramètre de connexion et comme un paramètre de configuration, le paramètre de connexion dans le DSN (ou chaîne de connexion) a la priorité.

Ce paramètre a été introduit dans la version 2.23.1 du pilote ODBC.

query_timeout

Indique le temps d’attente, en secondes, pour qu’une requête se termine avant de renvoyer une erreur. Zéro (0) indique une attente indéfinie.

La valeur par défaut est 0 (secondes).

token=<chaîne>

Spécifie le jeton OAuth à utiliser pour l’authentification, où <chaîne> est le jeton. Ce paramètre est requis uniquement lorsque le paramètre authenticator=oauth est défini.

La valeur par défaut est aucun.

validateSessionParam

Spécifie comment répondre lorsque l’un des paramètres de connexion de session suivants n’est pas valide :

• database
• schema
• warehouse

Les valeurs possibles sont les suivantes :

• false (par défaut) : se connecte avec succès, mais définit les valeurs des paramètres database et schema comme des chaînes vides et définit le paramètre warehouse comme sa valeur par défaut. Pour plus d’informations sur les entrepôts, voir Utilisation d’entrepôts dans les sessions.

• true : rejette la connexion et génère une erreur.

Utilisation des paramètres de connexion¶

Pour se connecter via un serveur de proxy, ajoutez les paramètres de connexion suivants au DSN :

• proxy

• no_proxy

Par exemple :

[connection]
Description = SnowflakeDB
Driver      = SnowflakeDSIIDriver
Locale      = en-US
server      = myorganization-myaccount.snowflakecomputing.com
proxy       = http://proxyserver.company:80
no_proxy    = .amazonaws.com

Copy

Voir Paramètres de connexion pour la description des paramètres.

Utilisation des paramètres de configuration¶

Pour vous connecter via un serveur de proxy, ajoutez les paramètres de configuration suivants :

• Proxy

• NoProxy

Voir Paramètres de configuration pour la description des paramètres.

Utilisation de variables d’environnement¶

Pour vous connecter via un serveur de proxy, configurez les variables d’environnement suivantes :

• http_proxy

• https_proxy

• no_proxy

Par exemple :

• Linux ou macOS :

  export http_proxy=http://proxyserver.company.com:80
  export https_proxy=http://proxyserver.company.com:80
  

  Copy

  Si le serveur proxy nécessite un nom d’utilisateur et un mot de passe, indiquez les informations d’identification, par exemple :

  export https_proxy=http://username:password@proxyserver.company.com:80
  

  Copy

• Windows :

  set http_proxy=http://proxyserver.company.com:80
  set https_proxy=http://proxyserver.company.com:80
  

  Copy

  Si le serveur proxy nécessite un nom d’utilisateur et un mot de passe, indiquez les informations d’identification, par exemple :

  set https_proxy=http://username:password@proxyserver.company.com:80
  

  Copy

En option, vous pouvez définir no_proxy pour contourner le proxy pour des communications spécifiques (par exemple no_proxy=.amazonaws.com pour contourner l’accès Amazon S3).