Datenquellen-Dienstprogramm (dbdsn)

dbdsn [ modifier-options ]
   { -l[ s | u ]
   | -d[ s | u ] dsn
   | -g[ s | u ] dsn
   | -w[ s | u ] dsn [details-options;...]
   | -cl }

Hauptoption	Beschreibung
@data	Liest Optionen aus der angegebenen Umgebungsvariablen oder Konfigurationsdatei ein. Siehe Konfigurationsdateien. Wenn Sie Kennwörter oder andere Informationen in einer Konfigurationsdatei schützen möchten, können Sie das Dienstprogramm zum Verschleiern von Dateien (dbfhide) verwenden. Siehe Dienstprogramm zum Verschleiern von Dateien (dbfhide).
-l[ s \| u ]	Listet die verfügbaren SQL Anywhere ODBC-Datenquellen auf. Sie können das Listenformat ändern, indem Sie die Optionen -b oder -v verwenden. Unter Windows können Sie die Option mit den Systembezeichnern u (Benutzer) oder s (System) ändern. Standardwert ist u.
-d[ s \| u ] dsn	Löscht die benannte SQL Anywhere-Datenquelle. Wenn Sie die Option -y angeben, werden bestehende Datenquellen ohne Bestätigungsaufforderung gelöscht. Unter Windows können Sie die Option mit den Systembezeichnern u (Benutzer) oder s (System) ändern. Standardwert ist u.
-g[ s \| u ] dsn	Listet die Definition der benannten SQL Anywhere-Datenquelle auf. Sie können das Format der Ausgabe ändern, indem Sie die Optionen -b oder -v verwenden. Unter Windows können Sie die Option mit den Systembezeichnern u (Benutzer) oder s (System) ändern. Standardwert ist u.
-w[ s \| u ] dsn [ details-options ]	Erstellt eine neue Datenquelle oder überschreibt eine Datenquelle, wenn eine Datenquelle mit demselben Namen vorhanden ist. Sie müssen die Option -c mit der Option -w angeben. Wenn Sie -y angeben, werden bestehende Datenquellen ohne Bestätigungsaufforderung überschrieben. Unter Windows können Sie die Option mit den Systembezeichnern u (Benutzer) oder s (System) ändern. Standardwert ist u.
-cl	Listet die Verbindungsparameter auf, die vom dbdsn-Dienstprogramm unterstützt werden. Siehe Verbindungsparameter. Hinweise zu unterstützten ODBC-Verbindungsparametern finden Sie unter ODBC-Verbindungsparameter.

Änderungsoptionen Beschreibung

-b Formatiert die Ausgabe der Liste in eine einzeilige Verbindungszeichenfolge.

-cm

Zeigt den Befehl an, der zum Erstellen der Datenquelle verwendet wurde. Mit dieser Option kann der Erstellungsbefehl in eine Datei ausgegeben werden, die verwendet werden kann, um die Datenquelle auf einem anderen Computer zu installieren oder den ursprünglichen Zustand einer Datenquelle wiederherzustellen, wenn sie geändert wurde. Sie müssen die Optionen -g oder -l zusammen mit der Option -cm verwenden, andernfalls schlägt der Befehl fehl. Die Angabe von "-g" zeigt den Erstellungsbefehl für die angegebene Datenquelle an, während die Angabe von "-l" den Erstellungsbefehl für alle Datenquellen anzeigt.

Wenn die angegebene Datenquelle nicht existiert, wird der Befehl zum Löschen der Datenquelle generiert. Beispiel: Wenn die mydsn-Datenquelle auf dem Computer nicht existiert, würde dbdsn -cm -g mydsn den folgenden Befehl zum Löschen der mydsn-Datenquelle zurückgeben:

dbdsn -y -du "mydsn"

-dr

Nimmt den Driver-Parameter auf, wenn Datenquellen angezeigt werden. Wenn Sie die Option -cm zur Neuerstellung von Datenquellen verwenden, kann die aktuelle Version von dbdsn Datenquellen erstellen, die eine andere Version des ODCB-Treibers referenzieren.

Führen Sie beispielsweise den folgenden Befehl aus, um eine Datenquelle der Version 11 zu erstellen:

dbdsn -y -wu "11.0 Student Sample" -c "UID=DBA;PWD=sql;...;Driver=
SQL Anywhere 11"

Wenn Sie dbdsn -cm -l ausführen, listet dbdsn denselben Befehl ohne den Parameter "Driver=" auf, wodurch die ODBC-Datenquelle unter Verwendung des SQL Anywhere ODBC-Treibers der Version 12 neu erstellt wird.

Wenn Sie allerdings dbdsn -dr -cm -l ausführen, wird der Parameter "Driver=" einbezogen und die Datenbank genauso neu erstellt, wie sie ursprünglich erstellt wurde: unter Verwendung des ODBC-Treibers der Version 11.

-f Zeigt den Namen der Systemdatei, die benutzt wird. Diese Option ist nur unter Unix verfügbar.

-ns

Gibt an, dass die Einstellungen der Umgebungsvariablen benutzt werden, um den Speicherort der Systeminformationsdatei (standardmäßig .odbc.ini) zu ermitteln. Diese Option ist auch nützlich um zu bestimmen, welche Datei von dbdsn verwendet wird, wenn es in der Umgebung mehrere Kandidaten für die Systeminformationsdatei gibt. Diese Option ist nur unter Unix verfügbar.

Wenn Sie bei der Erstellung einer Datenquelle nicht die Option -ns angeben, sucht dbdsn im Stammverzeichnis und Pfad des Benutzers nach der Systeminformationsdatei.

Weitere Hinweise darüber, wie nach der Systeminformationsdatei gesucht wird, finden Sie unter ODBC-Datenquellen unter Unix.

-o filename Schreibt Meldungen in die angegebene Datei.

-or

Erstellt bei der Angabe der Option -c eine Datenquelle für den iAnywhere Solutions Oracle-Treiber. Zum Beispiel:

dbdsn -w MyOracleDSN -or -c Userid=DBA;Password=sql;
ServiceName=abcd;ArraySize=500;ProcResults=y

Sie können die Option -cl mit der Option -or angeben, um eine Liste der Verbindungsparameter für den iAnywhere Solutions Oracle-Treiber zu erhalten.

Siehe iAnywhere Solutions 12 - Oracle ODBC-Treiber.

-pe Verschlüsselt das Kennwort, das im Verbindungsparameter angegeben wurde, und speichert das verschlüsselte Kennwort in der Datenquelle mit dem ENP-Verbindungsparameter.

-q Unterdrückt die Ausgabe in das Meldungsfenster des Datenbankservers. Wenn Sie beim Löschen oder Ändern einer Datenquelle die Option -q angeben, müssen Sie auch -y angeben.

-v Formatiert die Ausgabe der Liste über mehrere Zeilen, wie bei einer Tabelle.

-y Löscht oder überschreibt alle Datenquellen automatisch, ohne eine Bestätigung anzufordern. Wenn Sie beim Löschen oder Ändern einer Datenquelle die Option -q angeben, müssen Sie auch -y angeben.

Detailoptionen	Beschreibung
-c "keyword=value;..."	Legt Verbindungsparameter als Verbindungszeichenfolge fest. Siehe Verbindungsparameter.
-cw	Stellt sicher, dass der DBF-Parameter (Angabe mit -c) ein absoluter Dateiname ist. Wenn der Wert von DBF kein absoluter Dateiname ist, zieht das Datenquellen-Dienstprogramm das aktuelle Arbeitsverzeichnis heran (CWD). Diese Option ist sinnvoll, da einige Betriebssysteme keine CWD-Informationen in Batchdateien verfügbar halten.

Die Änderungsoptionen können vor oder nach der Angabe der Hauptoptionen definiert werden.

Das Datenquellen-Dienstprogramm ist eine plattformübergreifende Alternative zum ODBC-Datenquellen-Administrator für das Erstellen, Löschen, Beschreiben und Auflisten von SQL Anywhere ODBC-Datenquellen. Das Dienstprogramm ist für Batch-Vorgänge nützlich.

Achtung

Das Speichern von Benutzer-IDs, Kennwörtern (verschlüsselt oder nicht-verschlüsselt) und/oder Datenbankschlüsseln in einer Datenquelle ist nicht sicher. Es wird empfohlen, dass Sie diese Informationen nicht in einer Datenquelle speichern, wenn die Datenbank sensible Daten enthält.

Unter Windows werden die Datenquellen in der Registrierung eingetragen.

Hinweise zur Erstellung einer Datenquelle mit dem ODBC-Datenquellen-Administrator unter Windows finden Sie unter ODBC-Datenquellen.

Unter Unix-Betriebssystemen werden Datenquellen in der Systeminformationsdatei (standardmäßig .odbc.ini genannt) gespeichert. Wenn Sie unter Unix mit dem Datenquellen-Dienstprogramm SQL Anywhere ODBC-Datenquellen erstellen oder löschen, aktualisiert das Dienstprogramm automatisch den Abschnitt [ODBC Data Sources] in der Systeminformationsdatei. Wenn Sie unter Unix den Treiberverbindungsparameter mit der Option -c nicht angeben, fügt das Datenquellen-Dienstprogramm automatisch einen Treibereintrag mit dem vollen Pfad des SQL Anywhere ODBC-Treibers hinzu, basierend auf der Einstellung der SQLANY12-Umgebungsvariablen.

Weitere Hinweise zur Systeminformationsdatei finden Sie unter ODBC-Datenquellen unter Unix.

Hinweise zu unterstützten ODBC-Verbindungsparametern finden Sie unter ODBC-Verbindungsparameter.

Achtung

Unter Unix dürfen Sie die Systeminformationsdatei (.odbc.ini) nicht mit dem Dienstprogramm zum Verschleiern von Dateien (dbfhide) verschleiern, außer Sie verwenden ausschließlich SQL Anywhere-Datenquellen. Wenn Sie vorhaben, andere Datenquellen (wie z.B. für die MobiLink-Synchronisation) zu verwenden, kann das Verbergen des Inhalts der Systeminformationsdatei möglicherweise dazu führen, dass andere Treiber nicht richtig funktionieren.

Beendigungscodes sind 0 (Erfolg) oder eine von 0 verschiedene Zahl (Fehlschlag). Siehe Beendigungscodes der Softwarekomponenten.

Eine Version der Datenquelle "newdsn" schreiben. Keine Bestätigung anfordern, wenn die Datenquelle bereits vorhanden ist:

dbdsn -y -w newdsn -c "UID=DBA;PWD=sql;Host=myhost"

Oder, in einer anderen Reihenfolge der Optionen:

dbdsn -w newdsn -c "UID=DBA;PWD=sql;Host=myhost" -y

Alle bekannten benutzerdefinierten Datenquellen mit einem Datenquellennamen pro Ausgabezeile auflisten.:

dbdsn -l

Alle bekannten Systemdatenquellen mit einem Datenquellenamen pro Ausgabezeile auflisten:

dbdsn -ls

Alle Datenquellen mit der ihnen zugeordneten Verbindungszeichenfolge auflisten:

dbdsn -l -b

Die Verbindungszeichenfolge für die benutzerdefinierte Datenquelle MyDSN anzeigen:

dbdsn -g MyDSN

Die Verbindungszeichenfolge für die System-Datenquelle MyDSN anzeigen:

dbdsn -gs MyDSN

Die Datenquelle BadDSN löschen, aber zuerst die Verbindungsparameter für BadDSN auflisten und eine Bestätigung anfordern:

dbdsn -d BadDSN -v

Die Datenquelle BadDSN löschen, ohne zur Bestätigung aufzufordern:

dbdsn -d BadDSN -y

Eine Datenquelle namens NewDSN für den Datenbankserver MyServer erstellen:

dbdsn -w NewDSN -c "UID=DBA;PWD=sql;Server=MyServer"

Wenn NewDSN bereits besteht, werden Sie aufgefordert, das Überschreiben der Datenquelle zu bestätigen.

Alle Verbindungsparameter-Namen und ihre Aliase auflisten:

dbdsn -cl

Listet alle Benutzerdatenquellen auf:

dbdsn -l -o dsninfo.txt

Listet alle Verbindungsparameter auf:

dbdsn -cl -o dsninfo.txt

Absoluten Dateinamen angeben. Wenn die ODBC-Datenquelle erstellt wird, enthält sie DBF=c:\SQLAnywhere12\my.db.

c:\SQLAnywhere12> dbdsn -w testdsn -cw -c UID=DBA;PWD=sql;Server=SQLAny;DBF=my.db

Führen Sie den folgenden Befehl aus, um die SQL Anywhere 12 Demo-Datenquelle zu erstellen und sie in eine Datei namens restoredsn.bat auszugeben:

dbdsn -cm -gs "SQL Anywhere 12 Demo" > restoredsn.bat

Die Datei restoredsn.bat enthält z. B. Folgendes:

dbdsn -y -ws "SQL Anywhere 12 Demo" -c "UID=DBA;PWD=sql;
DBF='C:\Dokumente und Einstellungen\All Users\Dokumente\SQL Anywhere 12\Samples\demo.db';
Server=demo12;START='C:\Programme\SQL Anywhere 12\Bin32\dbeng12.exe';
ASTOP=yes;Description='SQL Anywhere 12 Sample Database'"

Führen Sie den folgenden Befehl aus, um den Speicherort der Systeminformationsdatei unter Unix zurückzugeben:

dbdsn -f

Der Befehl gibt diese Ausgabe zurück:

dbdsn using /home/user/.odbc.ini

Den Standort der Systeminformationsdatei ändern:

export ODBCINI=./myodbc.ini

Den neuen Standort der Systeminformationsdatei mithilfe von dbdsn -f überprüfen:

dbdsn using ./myodbc.ini

Die Option -ns bei der Erstellung der Datenquelle verwenden:

dbdsn -w NewDSN -c "UID=DBA" -ns

Dies ergibt die folgende Ausgabe:

Configuration "newdsn" written to file ./myodbc.ini