接続情報の配備

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

プログラムを使用 データソースの記述をエンドユーザのレジストリまたは ODBC 初期化ファイルに追加します。
手動エンドユーザに手順を示して、各自のコンピュータに適切なデータソースを作成できるようにします。
Windows では、ODBC データソースアドミニストレータを使用して [ユーザ DSN] タブまたは [システム DSN] タブでデータソースを手動で作成します。SQL Anywhere ODBC ドライバは、設定を入力するための設定ウィンドウを表示します。データソースの設定には、データベースファイルのロケーション、データベースサーバの名前、起動パラメータとその他のオプションが含まれます。コンテキスト別のヘルプは、[ヘルプ] ボタンを押すことでアクセスできます。ヘルプテキストは、sacshelp16.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 レジストリに格納されます。データソース定義の正しいレジストリエントリを確実に作成する最も簡単な方法は、dbdsn ユーティリティを使用して作成することです。このユーティリティを使用しない場合は、一連のレジストリ値を特定のレジストリキーに作成する必要があります。

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

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

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

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

64 ビットの Windows でのシステムデータソースの場合、2 つのレジストリキーがあります。1 つは 64 ビットのアプリケーション用で、もう 1 つは 32 ビットのアプリケーション用です。64 ビットのレジストリキーは次のとおりです。

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

64 ビット Windows では、dbdsn の 64 ビットバージョンを使用して 64 ビットレジストリキーを作成します。

32 ビットのレジストリキーは次のとおりです。

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

64 ビット Windows では、dbdsn の 32 ビットバージョンを使用して 32 ビットレジストリキーを作成します。

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

値の名前	値のタイプ	値データ
Autostop	文字列	YES
DatabaseFile	文字列	C:\Users\Public\Documents\SQL Anywhere 16\Samples\demo.db
Description	文字列	SQL Anywhere 16 サンプルデータベース
Driver	文字列	C:\Program Files\SQL Anywhere 16\bin32\dbodbc16.dll
PWD	文字列	sql
ServerName	文字列	demo16
StartLine	文字列	C:\Program Files\SQL Anywhere 16\bin32\dbeng16.exe
UID	文字列	DBA

注意

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

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

64 ビットの Windows では、64 ビットアプリケーションと 32 ビットアプリケーションの両方で共有されるユーザデータソースのレジストリエントリは 1 つしかありません。

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

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 16 Demo という名前で、次のような値を持ちます。

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

警告

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

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

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

DSN=ADataSourceName

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 で意見交換できます