接続情報の配備

ODBC のクライアント接続情報は、通常は ODBC データソースとして配備されます。ODBC データソースは、次のいずれかの方法で配備できます。

プログラムを使用 データソースの記述をエンドユーザーのレジストリまたは ODBC 初期化ファイルに追加します。
手動エンドユーザーに手順を示して、各自のコンピューターに適切なデータソースを作成できるようにします。
Windows では、ODBC データソースアドミニストレーターを使用して [ユーザー DSN] タブまたは [システム DSN] タブでデータソースを手動で作成します。SQL Anywhere ODBC ドライバーは、設定を入力するための設定ウィンドウを表示します。データソースの設定には、データベースファイルのロケーション、データベースサーバーの名前、起動パラメーターとその他のオプションが含まれます。コンテキスト別のヘルプは、[ヘルプ] ボタンを押すことでアクセスできます。ヘルプテキストは、sacshelp12.chm を使ってローカルに提供されます。このファイルが見つからない場合は、システムのデフォルトインターネットブラウザーを使用して DocCommentXchange からインターネット経由でヘルプが提供されます。

UNIX プラットフォームでは、SQL Anywhere の dbdsn ユーティリティを使用して手動でデータソースを作成できます。データソースの設定には、データベースファイルのロケーション、データベースサーバーの名前、起動パラメーターとその他のオプションが含まれます。

この項では、どちらの方法であっても知る必要がある情報について説明します。

データソースのタイプ (Windows)

データソースには 3 種類あります。ユーザーデータソース、システムデータソース、ファイルデータソースです。

ユーザーデータソース定義は、レジストリの一部として保存され、システムに現在ログインしている特定のユーザー用の設定を含んでいます。
これに対し、システムデータソースは、すべてのユーザーと Windows のサービスで使用でき、ユーザーがシステムにログインしているかどうかに関係なく稼働します。MyApp というシステムデータソースが正しく設定されている場合、ODBC 接続文字列に DSN=MyApp と指定することでどのユーザーでもその ODBC 設定ソースを使用することができます。
ファイルデータソースはレジストリには保存されず、ディスクに格納されます。ファイルデータソースを使用するには、接続文字列に FileDSN 接続パラメーターを指定する必要があります。ファイルデータソースのデフォルトのロケーションは、HKEY_CURRENT_USER\Software\ODBC\odbc.ini\ODBC File DSN\DefaultDSNDir レジストリエントリまたは HKEY_LOCAL_MACHINE\Software\ODBC\odbc.ini\ODBC File DSN\DefaultDSNDir レジストリエントリ (フォーマットが定義されていない場合) で指定されます。ファイルデータソースが他の場所にある場合は、FileDSN 接続パラメーターにパスを含めて、検索に役立てることができます。

データソースのレジストリエントリ (Windows)

ユーザーデータソースとシステムデータソースの定義は、Windows レジストリに格納されます。データソース定義の正しいレジストリエントリを確実に作成する最も簡単な方法は、SQL Anywhere dbdsn ユーティリティを使用して作成することです。

このユーティリティを使用しない場合は、一連のレジストリ値を特定のレジストリキーに作成する必要があります。

ユーザーデータソースの場合のレジストリキーを次に示します。

HKEY_CURRENT_USER\
   SOFTWARE\
      ODBC\
         ODBC.INI\
            user-data-source-name

システムデータソースの場合のレジストリキーを次に示します。

HKEY_LOCAL_MACHINE\
   SOFTWARE\
      ODBC\
         ODBC.INI\
            system-data-source-name

キーには一連のレジストリ値が含まれ、それぞれが 1 つの接続パラメーターに対応します (Driver 文字列を除く)。Microsoft ODBC データソースアドミニストレーターまたは dbdsn ユーティリティを使用してデータソースが作成されるときに、Driver 文字列は Microsoft ODBC ドライバーマネージャーによって自動的にレジストリに追加されます。たとえば、32 ビットの Windows では、SQL Anywhere 12 Demo システムのデータソース名 (DSN) に対応する SQL Anywhere 12 Demo キーには次の設定が含まれます。

値の名前	値のタイプ	値データ
Autostop	文字列	YES
DatabaseFile	文字列	C:\Users\Public\Documents\SQL Anywhere 12\Samples\demo.db
Description	文字列	SQL Anywhere 12 サンプルデータベース
Driver	文字列	C:\Program Files\SQL Anywhere 12\bin32\dbodbc12.dll
Password	文字列	sql
ServerName	文字列	demo12
StartLine	文字列	C:\Program Files\SQL Anywhere 12\bin32\dbeng12.exe
UserID	文字列	DBA

注意

配備されたアプリケーションの接続文字列には、ServerName パラメーターを含めることをおすすめします。これにより、コンピューターで複数の SQL Anywhere データベースサーバーが実行されている場合に、アプリケーションが確実に正しいサーバーに接続できるため、タイミングに依存する接続エラーを防ぐことができます。

これらのエントリにおいて、64 ビットの Windows の場合は、bin32 が bin64 になります。

64 ビットの Windows では、64 ビットアプリケーションと 32 ビットアプリケーションの両方で共有されるユーザーデータソースのレジストリエントリは 1 つしかありません。これらのタイプのデータソースでは、Driver 文字列のパスを削除することをおすすめします。パスが 64 ビットの ODBC ドライバーを指定している場合、接続または切断する 32 ビットのアプリケーションでは、Microsoft ODBC ドライバーマネージャーの使用時に、多くの場合、パフォーマンスの低下 (およびメモリのリーク) が発生します。同様に、パスが 32 ビットの ODBC ドライバーを指定している場合、接続または切断する 64 ビットのアプリケーションでは、多くの場合、同じようなパフォーマンスの低下が発生します。書き込み時に、これは Microsoft ODBC ドライバーマネージャーの弱点となります。このため、64 ビットの Windows システムの場合は、システムデータソースを使用することをおすすめします。

さらに、データソース名をレジストリ内のデータソースのリストにも追加する必要があります。ユーザーデータソースの場合は、次のキーを使用します。

HKEY_CURRENT_USER\
   SOFTWARE\
      ODBC\
         ODBC.INI\
            ODBC Data Sources

システムデータソースの場合は、次のキーを使用します。

HKEY_LOCAL_MACHINE\
   SOFTWARE\
      ODBC\
         ODBC.INI\
            ODBC Data Sources

この値によって、各データソースは ODBC ドライバーと対応させられます。値の名前はデータソース名で、値データは ODBC ドライバー名です。たとえば、SQL Anywhere によってインストールされたシステムデータソースは、SQL Anywhere 12 Demo という名前で、次のような値を持ちます。

値の名前	値のタイプ	値データ
SQL Anywhere 12 Demo	文字列	SQL Anywhere 12

警告

ODBC データソース名の設定は簡単に表示されてしまいます。ユーザーデータソースの設定には、ユーザー ID とパスワードのように機密性のあるデータベース設定を含めることもできます。これらの設定は、レジストリにプレーンテキストとして保存され、Windows レジストリエディター regedit.exe または regedt32.exe を使用して表示できます。これらのエディターは、Microsoft からオペレーティングシステムとともに提供されています。パスワードを暗号化したり、ユーザーが接続するときにパスワードの入力を要求するように選択することもできます。

必須およびオプションの接続パラメーター

ODBC 接続文字列内のデータソース名は次のようにして調べることができます。

DSN=UserDataSourceName

Windows では、DSN パラメーターを接続文字列に指定すると、Windows レジストリ内のユーザーデータソース定義が検索された後にシステムデータソースが検索されます。ファイルデータソースは、FileDSN が ODBC 接続文字列に指定された場合にだけ検索されます。

次の表は、データソースが存在し、そのデータソースが DSN パラメーターや FileDSN パラメーターとしてアプリケーションの接続文字列に含まれている場合の、ユーザーと開発者に対する影響を示します。

データソースの状態	接続文字列に指定する追加情報	ユーザーが指定する情報
ODBC ドライバーの名前とロケーション、データベースファイルまたはデータベースサーバーの名前、起動パラメーター、ユーザー ID とパスワードを含む	追加情報なし	追加情報なし
ODBC ドライバーの名前とロケーション、データベースファイルまたはデータベースサーバーの名前、起動パラメーターを含む	追加情報なし	ユーザー ID とパスワード (ODBC データソースに指定がない場合)
ODBC ドライバーの名前とロケーションのみを含む	データベースファイル名 (DBF=) とデータベースサーバー名 (SERVER=) またはそのいずれか。オプションで、Userid (UID=) や PASSWORD (PWD=) などのその他の接続パラメーターを含む場合もあります。	ユーザー ID とパスワード (ODBC データソースまたは ODBC 接続文字列に指定がない場合)
存在しない	使用する ODBC ドライバー名 (Driver=)、データベース名 (DBN=)、データベースファイル名 (DBF=) とデータベースサーバー名 (SERVER=) またはそのいずれか。オプションで、Userid (UID=) や PASSWORD (PWD=) などのその他の接続パラメーターを含む場合もあります。	ユーザー ID とパスワード (ODBC 接続文字列に指定がない場合)

参照

DocCommentXchange で意見交換できます