Installieren und Konfigurieren des ODBC-Treibers für macOS¶
Ähnlich wie Windows, verwendet macOS benannte Datenquellen (DSNs), um ODBC-basierte Clientanwendungen mit Snowflake zu verbinden.
Unter diesem Thema:
Voraussetzungen¶
Betriebssystem¶
Eine Liste der von Snowflake-Clients unterstützten Betriebssysteme finden Sie unter Betriebssystemunterstützung.
iODBC¶
Der Snowflake-ODBC-Treiber für Mac benötigt iODBC. Die Software steht zum Herunterladen zur Verfügung unter:
So installieren Sie iODBC:
Doppelklicken Sie nach dem Herunterladen von iODBC auf die heruntergeladene .dmg-Datei.
Doppelklicken Sie auf die Installationsdatei
iODBC-SDK.pkg
, und folgen Sie den Anweisungen.Standardmäßig installiert das Paket die Software im Verzeichnis
/Library/Application Support/iODBC/bin
. Sie können dieses Verzeichnis zur Umgebungsvariablen$PATH
hinzufügen, um zu vermeiden, dass Sie beim Ausführen von iODBC-Befehlen den vollständigen Pfadnamen angeben müssen.
Bemerkung
iODBC bietet ein GUI-Verwaltungstool zum Konfigurieren von Treibern und DSNs. Das Tool wurde jedoch nicht für die Verwendung mit Snowflake getestet und sollte daher nicht zum Erstellen oder Verwalten von DSNs verwendet werden. Verwenden Sie stattdessen ODBC Manager.
ODBC Manager – Optional/Empfohlen¶
ODBC Manager ist ein GUI-Tool zum Konfigurieren von Treibern und zum Erstellen/Verwalten von DSNs. Das Tool ist optional, da Sie DSNs auch manuell erstellen können, indem Sie die entsprechende odbc.ini
-Datei bearbeiten. ODBC Manager ist verfügbar unter:
So installieren Sie ODBC Manager:
Doppelklicken Sie nach dem Herunterladen von ODBC Manager auf die heruntergeladene .dmg-Datei.
Doppelklicken Sie auf die Installationsdatei
ODBC Manager.pkg
, und folgen Sie den Anweisungen.
Das Installationsprogramm installiert ODBC Manager im Verzeichnis ~/Applications/Utilities
.
Schritt 1: ODBC-Treiber installieren¶
So installieren Sie den Snowflake-ODBC-Treiber für macOS:
Wenn Sie den Treiber noch nicht heruntergeladen haben, laden Sie ihn jetzt herunter. Weitere Details dazu finden Sie unter Herunterladen des ODBC-Treibers.
Doppelklicken Sie auf die heruntergeladene .dmg-Datei
snowflake_odbc_mac-<Version>.dmg
.Doppelklicken Sie auf die Installationsdatei
snowflakeODBC_<Version>.pkg
, und folgen Sie den Anweisungen.Sie werden wahrscheinlich nach dem Administrator/sudo-Kennwort für den Computer gefragt, auf dem Sie den Treiber installieren.
Wenn Sie bei Aufforderung das Standardverzeichnis wählen, installiert das Installationsprogramm die ODBC-Treiberdateien in den folgenden Verzeichnissen:
/opt/snowflake/snowflakeodbc
/Library/ODBC
Schritt 2: ODBC-Treiber konfigurieren¶
Um den ODBC-Treiber für macOS zu konfigurieren, erstellen Sie eine oder mehrere Datenquellen (DSNs), die in den folgenden Dateien gespeichert werden, je nach Typ des von Ihnen erstellten DSN:
Benutzer-DSNs:
~/Library/ODBC/odbc.ini
System-DSNs:
/Library/ODBC/odbc.ini
Um einen DSN zu erstellen, verwenden Sie entweder ODBC Manager, oder Sie bearbeiten die entsprechende odbc.ini
-Datei.
Erstellen eines DSN mit ODBC Manager¶
So erstellen Sie einen DSN in ODBC Manager:
Starten Sie ODBC Manager.
Klicken Sie auf User DSN oder System DSN.
Klicken Sie auf die Schaltfläche Add.
Wählen Sie den zu verwendenden Treiber aus (Snowflake), und klicken Sie auf OK.
Geben Sie den Namen des DSN und optional eine Beschreibung ein.
Erstellen Sie für jeden DSN-Parameter ein Schlüsselwort/Wert-Paar:
Klicken Sie auf Add, um ein Schlüsselwort/Wert-Paar zu erstellen.
Wählen Sie Keyword aus, und ersetzen Sie den Wert durch den Parameternamen.
Wählen Sie Value aus, und ersetzen Sie den Wert durch den Parameterwert.
Wiederholen Sie diesen Vorgang für jeden Parameter. Einzelheiten zu den Parametern, die für jeden DSN festgelegt werden können, finden Sie unter ODBC-Konfigurations- und Verbindungsparameter.
Klicken Sie auf OK, um den DSN zu erstellen.
Wenn Sie erstmals einen Benutzer- oder System-DSN für den ODBC-Treiber erstellen, erstellt ODBC Manager in dem Verzeichnis des von Ihnen erstellten DSN-Typs die Datei odbc.ini
. Wenn Sie zusätzliche DSNs erstellen, fügt ODBC Manager für jeden DSN Einträge zur vorhandenen odbc.ini
-Datei hinzu.
Erstellen eines DSN durch Hinzufügen eines Eintrags zur odbc.ini
-Datei¶
Wenn bereits ein Benutzer- oder System-DSN für den Treiber erstellt wurde, fügen Sie den neuen Eintrag zu der odbc.ini
-Datei hinzu, die bereits im entsprechenden Verzeichnis des von Ihnen erstellten DSN-Typs vorhanden ist. Wenn Sie den ersten DSN für den Treiber erstellen, müssen Sie die odbc.ini
-Datei manuell erstellen und den Eintrag zur Datei hinzufügen.
Geben Sie für jeden DSN Folgendes an:
DSN-Name und Treibername (Snowflake) in der Form
<DSN-Name> = <Treibername>
.Verzeichnispfad und Name der Treiberdatei in der Form
Driver = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib
.Verbindungsparameter wie
server
unduid
(Benutzeranmeldename). Keiner der Verbindungsparameter, den Sie dem DSN hinzufügen, muss in der ODBC-Verbindungszeichenfolge angegeben werden.Alle zusätzlichen Parameter wie 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 ODBC-Konfigurations- und Verbindungsparameter.
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 Kontosmyaccount
der Organisationmyorganization
verwendet.testodbc2
verwendet den Konto-Locatorxy12345
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 = 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
Beachten Sie Folgendes:
Sowohl
testodbc1
als auchtestodbc2
haben Standardrollen.testodbc2
hat auch eine Standarddatenbank und ein Standardwarehouse.
Schritt 3: ODBC-Treiber testen¶
Sie können zum Testen der DSNs das Befehlszeilen-Dienstprogramm iodbctest
verwenden, das mit iODBC bereitgestellt wurde.
Wenn Sie zur Eingabe der ODBC-Verbindungszeichenfolge aufgefordert werden, geben Sie die erforderlichen Verbindungsparameter (DSN-Name, Server, Benutzeranmeldename und Kennwort) sowie alle anderen Parameter ein, die Sie als Teil der Verbindungszeichenfolge eingeben möchten. Die Verbindungszeichenfolge übernimmt Parameter der Form <Parametername>=<Wert>
, z. B. dsn=testodbc2
, wobei jeder Parameter durch ein Semikolon (;
) ohne Leerzeichen getrennt ist. Die Liste der unterstützten Parameter finden Sie unter ODBC-Konfigurations- und Verbindungsparameter.
Bemerkung
Wenn Sie den Server- und Benutzeranmeldenamen im DSN einstellen, sind die einzigen erforderlichen Parameter in der Verbindungszeichenfolge der DSN-Name und das Benutzerkennwort.
Beispiel:
$ "/Library/Application Support/iODBC/bin/iodbctest"
iODBC Demonstration program
This program shows an interactive SQL processor
Driver Manager: 03.52.0607.1008
Enter ODBC connect string (? shows list): dsn=testodbc2;pwd=<password>
Dec 14 20:16:08 INFO 1299 SFConnection::connect: Tracing level: 4
Driver: 2.12.36 (Snowflake - Latest version supported by Snowflake: 2.12.38)
SQL>