Installation et configuration du pilote ODBC pour macOS¶

Système d’exploitation¶

Pour obtenir la liste des systèmes d’exploitation pris en charge par les clients Snowflake, voir Prise en charge par les systèmes d’exploitation.

iODBC¶

Le pilote Snowflake ODBC pour Mac nécessite iODBC qui peut être téléchargé sur :

http://www.iodbc.org/dataspace/doc/iodbc/wiki/iodbcWiki/Downloads

Pour installer iODBC :

1. Après avoir téléchargé iODBC, double-cliquez sur le fichier.dmg téléchargé.

2. Double-cliquez sur le fichier d’installation, iODBC-SDK.pkg, et suivez les invites.

   Par défaut, le paquet installe le logiciel dans le répertoire /Library/Application Support/iODBC/bin. Vous pouvez ajouter ce répertoire à la variable d’environnement $PATH pour éviter d’avoir à spécifier le nom de chemin complet pour exécuter l’une des commandes iODBC.

Gestionnaire ODBC — En option/recommandé¶

ODBC Manager est un outil GUI servant à configurer des pilotes et créer/gérer des DSNs. L’outil est optionnel car vous pouvez aussi créer des DSNs manuellement en éditant le fichier odbc.ini correspondant. ODBC Manager via le lien suivant :

http://www.odbcmanager.net/

Pour installer ODBC Manager :

1. Après avoir téléchargé ODBC Manager, double-cliquez sur le fichier.dmg téléchargé.

2. Double-cliquez sur le fichier d’installation, ODBC Manager.pkg, et suivez les invites.

Le programme d’installation installe ODBC Manager dans le répertoire ~/Applications/Utilities.

Création d’un DSN via ODBC Manager :¶

Pour créer un DSN dans ODBC Manager :

1. Démarrez ODBC Manager.

2. Cliquez sur User DSN ou System DSN.

3. Cliquez sur le bouton Add.

4. Sélectionnez le pilote à utiliser (Snowflake) et cliquez sur OK.

5. Saisissez le nom du DSN et éventuellement une description.

6. Créez une paire mot-clé/valeur pour chaque paramètre DSN :

   1. Cliquez sur Add pour créer une paire mot-clé/valeur.

   2. Sélectionnez Keyword et remplacez-le par le nom du paramètre.

   3. Sélectionnez Value et remplacez-le par la valeur du paramètre.

   Répétez ce processus pour chaque paramètre. Pour plus de détails sur les paramètres qui peuvent être définis pour chaque DSN, voir Paramètres de configuration et de connexion ODBC.

7. Cliquez sur OK pour créer le DSN.

Si vous créez le premier utilisateur ou système DSN pour le pilote ODBC, ODBC Manager crée le fichier odbc.ini dans le répertoire correspondant au type de DSN que vous créez. Si vous créez des DSNs supplémentaires, ODBC Manager ajoute des entrées pour chaque DSN au fichier odbc.ini existant.

Création d’un DSN en ajoutant une entrée dans le fichier odbc.ini.¶

Si un utilisateur ou un système DSN a déjà été créé pour le pilote, ajoutez la nouvelle entrée au fichier odbc.ini qui existe déjà dans le répertoire correspondant au type de DSN que vous créez. Si vous créez le premier DSN pour le pilote, vous devez créer manuellement le fichier odbc.ini et ajouter l’entrée au fichier.

Pour chaque DSN, indiquez les éléments suivants :

• Nom du DSN et du pilote (Snowflake) sous la forme <nom_dsn> = <nom_pilote>.

• Chemin d’accès au répertoire et nom du fichier de pilote au format Driver = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib.

• Paramètres de connexion, tels que server et uid (nom d’utilisateur). Tous les paramètres de connexion que vous ajoutez au DSN n’ont pas besoin d’être indiqués dans la chaîne de connexion ODBC.

• Tout paramètre supplémentaire, par exemple role database et warehouse par défaut.

Les paramètres sont spécifiés sous forme de <nom_paramètre> = <valeur>. Pour plus de détails sur les paramètres qui peuvent être définis pour chaque DSN, voir Paramètres de configuration et de connexion ODBC.

L’exemple suivant illustre un fichier odbc.ini qui configure deux sources de données qui utilisent différentes formes d’un identificateur de compte dans l”server URL :

• testodbc1 utilise un identificateur de compte qui utilise un identificateur de compte qui spécifie le compte myaccount dans l’organisation myorganization.

• testodbc2 utilise le localisateur de compte xy12345 comme identificateur de compte.

  Notez que testodbc2 utilise un compte dans la région AWS US Ouest (Oregon). Si le compte se trouve dans une autre région ou s’il utilise un autre fournisseur Cloud, vous devez spécifier des segments supplémentaires après le localisateur de compte.

  [ODBC Data Sources]
  testodbc1 = Snowflake
  testodbc2 = Snowflake
  
  
  [testodbc1]
  Driver      = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib
  Description =
  uid         = peter
  server      = myorganization-myaccount.snowflakecomputing.com
  role        = sysadmin
  
  
  [testodbc2]
  Driver      = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib
  Description =
  uid         = mary
  server      = xy12345.snowflakecomputing.com
  role        = analyst
  database    = sales
  warehouse   = analysis
  

  Copy

Remarques :

• testodbc1 et testodbc2 ont des rôles par défaut.

• testodbc2 possède également une base de données et un entrepôt par défaut.