Installieren und Konfigurieren des ODBC-Treibers für Linux¶

Betriebssystem¶

Eine Liste der von Snowflake-Clients unterstützten Betriebssysteme finden Sie unter Betriebssystemunterstützung.

Ab ODBC-Version 3.0.1 bietet der Treiber keine Unterstützung mehr für CentOS 6-Versionen.

Treiber-Manager: iODBC oder unixODBC¶

Ein Treiber-Manager ist erforderlich, um die Kommunikation zwischen Snowflake und dem ODBC-Treiber zu verwalten. Der Treiber unterstützt die Verwendung von iODBC oder unixODBC als Treibermanager.

1.1: Neuesten öffentlichen Snowflake-Schlüssel herunterladen und importieren¶

Laden Sie vom öffentlichen Keyserver den öffentlichen Snowflake-GPG-Schlüssel in der von Ihnen verwendeten ODBC-Treiberversion herunter, und importieren Sie diesen:

• Für Version 2.25.6 und höher:

  $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 630D9F3CAB551AF3

• Für die Versionen 2.22.1 bis 2.25.5:

  $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 37C7086698CB005C

• Für die Versionen 2.18.2 bis 2.22.0:

  $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys EC218558EABB25A1

• Für Version 2.18.1 und niedriger:

  $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 93DB296A69BE019A

1.2: RPM- oder DEB-Treiberpaket herunterladen¶

Laden Sie das Paket aus dem Snowflake Client Repository herunter. Weitere Details dazu finden Sie unter Herunterladen des ODBC-Treibers.

1.3: Signatur für das RPM- oder DEB-Treiberpaket überprüfen¶

1.4: Alten öffentlichen Snowflake-Schlüssel löschen – Optional¶

Ihre lokale Umgebung kann mehrere GPG-Schlüssel enthalten. Aus Sicherheitsgründen rotiert Snowflake jedoch regelmäßig den öffentlichen GPG-Schlüssel. Als Best Practice empfehlen wir, den vorhandenen öffentlichen Schlüssel zu löschen, nachdem wir bestätigt haben, dass der letzte Schlüssel mit dem zuletzt signierten Paket funktioniert.

So löschen Sie den Schlüssel:

$ gpg --delete-key "Snowflake Computing"

Copy

Verwenden von yum zum Herunterladen und Installieren des Treibers¶

Mit Version 2.21.1 des ODBC-Treibers (und spätere Versionen) können Sie yum verwenden, um den Treiber herunterzuladen und zu installieren.

So laden Sie den Snowflake-ODBC-Treiber für Linux mit yum herunter und installieren ihn:

1. Erstellen Sie eine Datei mit dem Namen /etc/yum.repos.d/snowflake-odbc.repo, und fügen Sie der Datei den folgenden Text hinzu:

   [snowflake-odbc]
   name=snowflake-odbc
   baseurl=https://sfc-repo.snowflakecomputing.com/odbc/linux/<VERSION_NUMBER>/
   gpgkey=https://sfc-repo.snowflakecomputing.com/odbc/Snowkey-<GPG_KEY_ID>-gpg
   

   Copy

   wobei VERSION_NUMBER die spezifische Versionsnummer des Treibers (z. B. 3.2.0) und GPG_KEY_ID eine der folgenden Schlüssel-IDs ist:

   ODBC-Treiberversion	GPG-Schlüssel-ID
   2.22.1 und höher	630D9F3CAB551AF3

   In den obigen Einstellungen zeigen baseurl und gpgkey auf das Snowflake Client Repository auf Amazon S3. Wenn Sie stattdessen den Spiegel auf Azure Blob verwenden möchten, ändern Sie den Hostnamen in https://sfc-repo.azure.snowflakecomputing.com/:

   [snowflake-odbc]
   name=snowflake-odbc
   baseurl=https://sfc-repo.azure.snowflakecomputing.com/odbc/linux/<VERSION_NUMBER>/
   gpgkey=https://sfc-repo.azure.snowflakecomputing.com/odbc/Snowkey-<GPG_KEY_ID>-gpg
   

   Copy

2. Führen Sie den folgenden Befehl aus, um den Treiber zu installieren:

   yum install snowflake-odbc
   

   Copy

Installieren der TGZ-Datei¶

So installieren Sie den Snowflake-ODBC-Treiber für Linux mithilfe der zuvor heruntergeladenen TGZ-Datei:

1. Kopieren Sie die heruntergeladene Datei (snowflake_linux_x8664_odbc-version.tgz) in ein Arbeitsverzeichnis.

2. Entpacken Sie die Datei:

   $ gunzip snowflake_linux_x8664_odbc-<version>.tgz
   

   Copy

3. Extrahieren Sie die Dateien aus der .tar-Datei:

   $ tar -xvf snowflake_linux_x8664_odbc-<version>.tar
   

   Copy

4. Kopieren Sie den resultierenden Ordner snowflake_odbc in das Verzeichnis, in dem Sie den Treiber installieren möchten. Notieren Sie sich dieses Verzeichnis. Sie werden den Speicherort später in der Anleitung benötigen.

Installieren des RPM-Pakets¶

Um den Snowflake-ODBC-Treiber für Linux mit dem zuvor heruntergeladenen RPM-Paket zu installieren, führen Sie nach der optionalen Überprüfung der Paketsignatur den folgenden Befehl aus:

$ yum install snowflake-odbc-<version>.x86_64.rpm

Copy

Installieren des DEB-Pakets¶

Um den Snowflake-ODBC-Treiber für Linux mit dem zuvor heruntergeladenen DEB-Paket zu installieren, führen Sie nach der optionalen Überprüfung der Paketsignatur den folgenden Befehl aus:

$ sudo dpkg -i snowflake-odbc-<version>.x86_64.deb

Copy

Der Befehl kann fehlschlagen, wenn keine erforderlichen Abhängigkeiten für den Paketmanager installiert sind. Wenn das passiert, installieren Sie diese jetzt:

$ sudo apt-get install -f

Copy

Konfigurieren mit iODBC¶

Wechseln Sie in einem Terminalfenster in das Verzeichnis snowflake_odbc, und führen Sie den folgenden Befehl aus, um Snowflake ODBC zu installieren:

$ ./iodbc_setup.sh

Copy

Dieses Skript führt die folgenden Schritte aus:

• Fügt eine Snowflake-Verbindung zu Ihrer Datei /etc/odbc.ini auf Systemebene hinzu.

• Fügt die Snowflake-Treiberinformationen zu Ihrer Datei auf Systemebene /etc/odbcinst.ini hinzu.

• Fügt alle vom Snowflake-ODBC-Treiber benötigten Zertifikate der Zertifizierungsstelle (CA) zu Ihrer Datei simba.snowflake.ini auf Systemebene hinzu.

Wenn Sie iodbc_setup.sh ausführen, müssen Sie keine Umgebungsvariablen festlegen.

Wenn Sie nicht möchten, dass Snowflake Ihre Systemkonfigurationen ändert, fügen Sie der Shell-Konfigurationsdatei die folgenden Umgebungsvariablen hinzu (z. B. .profile, .bash_profile):

• ODBCINI = <Pfad>/conf/odbc.ini

• ODBCINSTINI = <Pfad>/conf/odbcinst.ini

Wobei path der Speicherort des snowflake_odbc-Verzeichnisses ist. Wenn Sie andere ODBC-Treiber in Ihrem System konfiguriert haben und im nächsten Schritt die Snowflake-ODBC-Einträge zu Ihren bestehenden Dateien odbc.ini und odbcinst.ini hinzufügen möchten, dann lassen Sie ODBCINI und ODBCINSTINI auf den Speicherort dieser Dateien verweisen.

Konfigurieren mit unixODBC¶

Wechseln Sie in einem Terminalfenster in das Verzeichnis snowflake_odbc, und führen Sie den folgenden Befehl aus, um Snowflake ODBC zu installieren:

$ ./unixodbc_setup.sh

Copy

Dieses Skript führt die folgenden Schritte aus:

• Fügt eine Snowflake-Verbindung zu Ihrer Datei auf Systemebene /etc/odbc.ini hinzu.

• Fügt die Snowflake-Treiberinformationen zu Ihrer Datei auf Systemebene /etc/odbcinst.ini hinzu.

• Fügt alle vom Snowflake-ODBC-Treiber benötigten Zertifikate der Zertifizierungsstelle (CA) zu Ihrer Datei simba.snowflake.ini auf Systemebene hinzu.

Wenn Sie unixodbc_setup.sh ausführen, müssen Sie keine Umgebungsvariablen festlegen.

Wenn Sie nicht möchten, dass Snowflake Ihre Systemkonfigurationen ändert, fügen Sie der Shell-Konfigurationsdatei die folgenden Umgebungsvariablen hinzu (z. B. .profile, .bash_profile):

• ODBCSYSINI = <Pfad>/conf/

Wobei path der Speicherort des snowflake_odbc-Verzeichnisses ist. Wenn Sie andere ODBC-Treiber in Ihrem System konfiguriert haben und im nächsten Schritt die Snowflake-ODBC-Einträge zu Ihren bestehenden Dateien odbc.ini und odbcinst.ini hinzufügen möchten, dann lassen Sie ODBCSYSINI auf den Speicherort dieser Dateien verweisen.

4.1: simba.snowflake.ini-Datei (Treibermanager und Protokollierung)¶

Fügen Sie die folgenden Einträge zur Datei simba.snowflake.ini hinzu:

ErrorMessagesPath=<path>/ErrorMessages/
LogPath=/tmp/
ODBCInstLib=<driver_manager_path>
CABundleFile=<path>/lib/cacert.pem
ANSIENCODING=UTF-8

Copy

Wobei:

• path ist der Speicherort des snowflake_odbc-Verzeichnisses.

• driver_manager_path ist der Speicherort Ihres Treiber-Manager-Verzeichnisses:

  • iODBC: ODBCInstLib=libiodbcinst.so.2

  • unixODBC: ODBCInstLib=libodbcinst.so

  Bemerkung

  Wenn das Verzeichnis Ihres Treibermanager nicht in der Umgebungsvariablen LD_LIBRARY_PATH enthalten ist, geben Sie hier den vollständigen Pfad zur Treibermanager-Bibliothek an.

Überprüfen Sie, ob Sie über Schreibrechte für den Protokollpfad verfügen.

Der Parameter ANSIENCODING gibt die Zeichencodierung der Anwendung an. Die Voreinstellung ist UTF-8. Der Parameter ist nur zur Verwendung durch Snowflake vorgesehen. Kunden sollten den Wert nicht ändern.

4.2: odbcinst.ini-Datei (Treiberregistrierung)¶

Fügen Sie die folgenden Einträge zur Datei odbcinst.ini hinzu:

[ODBC Drivers]
SnowflakeDSIIDriver=Installed

[SnowflakeDSIIDriver]
APILevel=1
ConnectFunctions=YYY
Description=Snowflake DSII
Driver=/<path>/lib/libSnowflake.so
DriverODBCVer=03.52
SQLLevel=1

Copy

Wobei path der Speicherort des snowflake_odbc-Verzeichnisses ist.

4.3: odbc.ini-Datei (DSN-Einträge)¶

Fügen Sie für jede DSN die folgenden Einträge zur Datei odbc.ini hinzu:

• DSN-Name und Treibername (SnowflakeDSIIDriver) in der Form <DSN-Name> = <Treibername>.

• Parameter:

  • Erforderliche Verbindungsparameter, wie z. B. server.

  • Alle zusätzlichen, optionalen Parameter, wie z. B. Standardrolle (role), Standarddatenbank (database) und Standardwarehouse (warehouse).

  Parameter werden in der Form <Parametername> = <Wert> angegeben. Einzelheiten zu den Parametern, die für jeden DSN festgelegt werden können, finden Sie unter Konfigurations- und Verbindungsparameter für ODBC.

Das folgende Beispiel zeigt eine odbc.ini-Datei, die zwei Datenquellen konfiguriert, die unterschiedliche Formen eines Kontobezeichners in der server-URL verwenden:

• testodbc1 verwendet einen Kontobezeichner, der einen Kontobezeichner (Kontonamen) zur Angabe des Kontos myaccount der Organisation myorganization verwendet.

• testodbc2 verwendet den Konto-Locator xy12345 als Kontobezeichner.

  Beachten Sie, dass testodbc2 ein Konto in der Region AWS US West (Oregon) verwendet. Wenn sich das Konto in einer anderen Region befindet oder wenn das Konto einen anderen Cloudanbieter verwendet, müssen Sie nach dem Konto-Locator zusätzliche Segmente angeben.

  [ODBC Data Sources]
  testodbc1 = SnowflakeDSIIDriver
  testodbc2 = SnowflakeDSIIDriver
  
  
  [testodbc1]
  Driver      = /usr/jsmith/snowflake_odbc/lib/libSnowflake.so
  Description =
  server      = myorganization-myaccount.snowflakecomputing.com
  role        = sysadmin
  
  
  [testodbc2]
  Driver      = /usr/jsmith/snowflake_odbc/lib/libSnowflake.so
  Description =
  server      = xy12345.snowflakecomputing.com
  role        = analyst
  database    = sales
  warehouse   = analysis
  

  Copy

Beachten Sie Folgendes:

• Sowohl testodbc1 als auch testodbc2 haben Standardrollen.

• testodbc2 hat auch eine Standarddatenbank und ein Standardwarehouse.

Testen mit iODBC¶

Testen Sie die von Ihnen erstellten DSNs. Geben Sie in der Befehlszeile den DSN-Namen, den Benutzeranmeldenamen und das Kennwort im folgenden Format an:

iodbctest "DSN=<DSN-Name>;UID=<Benutzername>;PWD=<Kennwort>"

Beispiel:

$ iodbctest "DSN=testodbc2;UID=mary;PWD=password"
iODBC Demonstration program
This program shows an interactive SQL processor
Driver Manager: 03.52.0709.0909
Driver: 2.12.70 (Snowflake)

SQL>

Copy

Testen mit unixODBC¶

Testen Sie die DSNs, die Sie mit dem Befehlszeilen-Dienstprogramm isql erstellt haben, das vom Befehl unixODBC bereitgestellt wurde.

Geben Sie in der Befehlszeile den DSN-Namen, den Benutzeranmeldenamen und das Kennwort an.

Beispiel:

$ isql -v testodbc2 mary <password>

Dec 14 22:57:50 INFO  2022078208 Driver::LogVersions: SDK Version: 09.04.09.1013
Dec 14 22:57:50 INFO  2022078208 Driver::LogVersions: DSII Version: 2.12.36
Dec 14 22:57:50 INFO  2022078208 SFConnection::connect: Tracing level: 4

+---------------------------------------+
| Connected!                            |
|                                       |
| sql-statement                         |
| help [tablename]                      |
| quit                                  |
|                                       |
+---------------------------------------+
SQL>

Copy