データソースユーティリティ (dbdsn)

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

主要オプション	説明
@data	指定した環境変数または設定ファイルからオプションを読み込みます。設定ファイル内のパスワードなどの情報を保護する場合は、ファイル難読化ユーティリティを使用して、設定ファイルの内容を難読化します。
-l[ s \| u ]	利用できる ODBC データソースをリストします。リストの形式は -b オプションまたは -v オプションを使用して変更できます。Windows では、u (ユーザ) または s (システム) 指定子を使用して、オプションを変更できます。デフォルトの指定子は u です。
-d[ s \| u ] dsn	指定したデータソースを削除します。-y を指定すると、確認メッセージを表示せずに既存のデータソースが削除されます。Windows では、u (ユーザ) または s (システム) 指定子を使用して、オプションを変更できます。デフォルトの指定子は u です。
-g[ s \| u ] dsn	指定したデータソースの定義をリストします。出力のフォーマットは、-b オプションまたは -v オプションを使用して変更できます。Windows では、u (ユーザ) または s (システム) 指定子を使用して、オプションを変更できます。デフォルトの指定子は u です。
-w[ s \| u ] dsn [ details-options ]	新しいデータソースを作成します。同じ名前のデータソースが存在する場合は上書きします。-w オプションと一緒に -c オプションを指定する必要があります。-y を指定すると、確認メッセージを表示せずに既存のデータソースを上書きします。Windows では、u (ユーザ) または s (システム) 指定子を使用して、オプションを変更できます。デフォルトの指定子は u です。
-cl	dbdsn ユーティリティがサポートしている接続パラメータをリストします。

変更オプション説明

-b リストの出力を 1 行の接続文字列にフォーマットします。

-cm

データソースの作成に使用するコマンドを表示します。このオプションを使用すると、作成コマンドをファイルに出力できます。作成コマンドは別のコンピュータにデータソースを追加したり、変更が加えられたデータソースを元の状態にリストアするために使用できます。-cm とともに -g オプションまたは -l オプションを指定しないとコマンドは失敗します。-g を指定すると、指定のデータソースの作成コマンドが表示されるのに対し、-l を指定するとすべてのデータソースの作成コマンドが表示されます。

指定のデータソースが存在しない場合は、データソースを削除するコマンドが生成されます。たとえば、コンピュータに mydsn データソースが存在しない場合、dbdsn -cm -g mydsn は mydsn データソースを削除する次のコマンドを返します。

dbdsn -y -du "mydsn"

-dr

データソースを表示するときに Driver パラメータを含めます。これにより、-cm オプションを使用してデータソースを再作成するときに、dbdsn の現バージョンで異なるバージョンの ODBC ドライバを参照するデータソースを作成することができます。

たとえば、次のようなコマンドを使用してバージョン 11 のデータソースを作成します。

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

dbdsn -cm -l を実行すると、同じコマンドが Driver= パラメータなしで表示されます。これによって、SQL Anywhere バージョン 16 の ODBC ドライバを使用して ODBC データソースが再作成されます。

それに対し、dbdsn -dr -cm -l を実行すると、コマンドに「Driver=parameter」が含まれるため、バージョン 11 の ODBC ドライバを使用した場合とまったく同じデータソースを再作成できます。

-f 使用されているシステムファイルの名前を表示します。このオプションは UNIX でのみ使用できます。

-ns

環境変数の設定を使用してシステム情報ファイル (デフォルトのファイル名は .odbc.ini) のロケーションを特定するように指定します。このオプションは、使用される可能性のあるシステム情報ファイルが複数ある場合に、dbdsn が使用するファイルを特定する目的にも利用できます。このオプションは UNIX でのみ使用できます。

データソースを作成するときに -ns オプションを指定しなかった場合、システム情報ファイルはユーザのホームフォルダとそのパス内で検索されます。

-o filename 指定したファイルに、出力メッセージを書き込みます。

-or

-c オプションとともに指定すると、SQL Anywhere 16 - Oracle ドライバのデータソースが作成されます。次に例を示します。

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

-cl オプションを -or オプションとともに指定すると、SQL Anywhere 16 - Oracle ドライバの接続パラメータのリストを取得できます。

-pe Password 接続パラメータで指定されたパスワードを暗号化し、ENP 接続パラメータを使用して、暗号化されたパスワードをデータソースに格納します。

-q データベースサーバメッセージウィンドウに出力を表示しないようにします。データソースの削除時または変更時に -q を指定する場合は、-y も指定してください。

-v 数行のリスト出力を表としてフォーマットします。

-y 確認を要求するプロンプトを表示しないで、各データソースを削除または上書きします。データソースの削除時または変更時に -q を指定する場合は、-y も指定してください。

詳細オプション	説明
-c "keyword=value;..."	接続パラメータを接続文字列として指定します。
-cw	(-c で指定された) DBF パラメータが確実に絶対ファイル名になるようにします。DBF の値が絶対ファイル名でない場合、dbdsn は現在の作業ディレクトリ (CWD) を付加します。オペレーティングシステムの中には、バッチファイルですぐに利用できる CWD 情報がないものもあるので、このオプションは便利です。

詳細オプション

説明

-c "keyword=value;..."

接続パラメータを接続文字列として指定します。

-cw

(-c で指定された) DBF パラメータが確実に絶対ファイル名になるようにします。DBF の値が絶対ファイル名でない場合、dbdsn は現在の作業ディレクトリ (CWD) を付加します。オペレーティングシステムの中には、バッチファイルですぐに利用できる CWD 情報がないものもあるので、このオプションは便利です。

なし。

変更オプションは、主要オプションの前または後に指定できます。

データソースユーティリティは、プラットフォームを問わないユーティリティで、ODBC データソースアドミニストレータに代わり ODBC データソースの作成、削除、記述、リストを実行します。このユーティリティは、バッチ処理に役立ちます。

警告

ユーザ ID、パスワード (暗号化の有無は不問)、データベースキーをデータソースに保存するのは安全な方法ではありません。データベースに機密データが含まれている場合は、このような情報をデータソースに保存しないでください。

Windows オペレーティングシステムでは、データソースはレジストリに保存されます。

ODBC データソースアドミニストレータを使用した Windows でのデータソース作成の詳細については、ODBC データソースを参照してください。

UNIX オペレーティングシステムでは、データソースはシステム情報ファイル (デフォルトのファイル名は .odbc.ini) に保持されます。データソースユーティリティを使用して ODBC データソースを UNIX 上で作成または削除すると、システム情報ファイルの [ODBC Data Sources] セクションが自動的に更新されます。UNIX で -c オプションを使用して Driver 接続パラメータを指定しない場合、データソースユーティリティによって SQLANY16 環境変数の設定に基づき SQL Anywhere ODBC ドライバのフルパスを使って Driver エントリが自動的に追加されます。

警告

SQL Anywhere データソースのみを使用する場合以外は、UNIX でファイル非表示ユーティリティ (dbfhide) を使って .odbc.ini システム情報ファイルを難読化しないでください。他のデータソース (Mobile Link 同期など) を使用する予定の場合、システム情報ファイルを難読化すると、他のドライバが正しく機能しなくなることがあります。

終了コードは、0 (成功) または 0 以外の値 (失敗) です。

データソース newdsn の定義を書き込みます。データソースがすでに存在する場合でも、確認メッセージは表示しません。

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

または、以下に示す別のオプションを指定できます。

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

既知のすべてのユーザデータソースをリストします (1 行に 1 つのデータソース名)。

dbdsn -l

既知のすべてのシステムデータソースをリストします (1 行に 1 つのデータソース名)。

dbdsn -ls

すべてのデータソースを関連する接続文字列とともにリストします。

dbdsn -l -b

ユーザデータソース MyDSN 用の接続文字列をレポートします。

dbdsn -g MyDSN

システムデータソース MyDSN 用の接続文字列をレポートします。

dbdsn -gs MyDSN

最初に BadDSN の接続パラメータをリストし、確認メッセージを表示してから、データソース BadDSN を削除します。

dbdsn -d BadDSN -v

確認メッセージを表示せずに、データソース BadDSN を削除します。

dbdsn -d BadDSN -y

データベースサーバ MyServer のデータソース NewDSN を作成します。

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

NewDSN がすでに存在する場合は、データソースを上書きするかどうか確認を求められます。

すべての接続パラメータ名とそのエイリアスをリストします。

dbdsn -cl

すべてのユーザデータソースをリストします。

dbdsn -l -o dsninfo.txt

すべての接続パラメータ名をリストします。

dbdsn -cl -o dsninfo.txt

絶対ファイル名を指定します。ODBC データソースは、DBF=c:\SQLAnywhere16\my.db という名前で作成されます。

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

次のコマンドを実行して、SQL Anywhere 16 Demo データソースを作成し、それを restoredsn.bat というファイルに出力します。

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

restoredsn.bat ファイルには以下が含まれます。

dbdsn -y -ws "SQL Anywhere 16 Demo" -c "UID=DBA;PWD=sql;
DBF='C:\Documents and Settings\All Users\Documents\SQL Anywhere 16\Samples\demo.db';
Server=demo16;START='C:\Program Files\SQL Anywhere 16\Bin32\dbeng16.exe';
ASTOP=yes;Description='SQL Anywhere 16 Sample Database'"

次のコマンドは、UNIX のシステム情報ファイルのロケーションを返します。

dbdsn -f

このコマンドは次の出力を返します。

dbdsn using /home/user/.odbc.ini

システム情報ファイルのロケーションを変更します。

export ODBCINI=./myodbc.ini

dbdsn -f を使用してシステム情報ファイルの新しいロケーションを確認します。

dbdsn using ./myodbc.ini

-ns オプションを使用してデータソースを作成します。

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

このコマンドは次の出力を返します。

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

データソースユーティリティ (dbdsn)

構文

権限

備考

警告

警告

参照

例