Connector/ODBC ソース配布物には、nmake または他の make ユーティリティを必要とする Makefiles が含まれています。配布物のうち、Makefile はリリース バージョンの構築、Makefile_debug はドライバ ライブラリと DLL のデバッグ バージョンの構築に使われます。

ドライバを構築は、次の手順で行って下さい :

注意 :

ドライバ ライブラリがシステム ディレクトリにコピー、もしくはインストールされたら、samples サブディレクトリにあるサンプルを使用して、ライブラリが適切に構築されているかテストすることができます :

C:\> cd samples
C:\> nmake -f Makefile all

MyODBC 2.50 ソース配布物には、VC workspace ファイルが含まれています。そのファイル ( .dsp および .dsw ) を Microsoft Visual Studio 6.0 以降からロードし、それらを使ってドライバを構築することができます。

configure スクリプトは、Connector/ODBC 構成をどのようにコンフィグするかにおいて、多大な制御力を提供します。通常は、configure コマンド ラインのオプションを使用してこれを行います。また、特定の環境変数を使って、configure に影響を与えることもできます。configure がサポートするオプションと環境変数のリストを見るには、次のコマンドを実行してください :

shell> ./configure --help

よく使われる configure オプションのいくつかを以下で説明します :

最終構成コマンドは次のようのものです :

shell> ./configure --prefix=/usr/local \
         --with-iodbc=/usr/local \
         --with-mysql-path=/usr/local/mysql

Connector/ODBC を作成する前の構成での設定に、必要または望ましいオプションは他にも多数あります。

ドライバ ライブラリを構築するには、make を実行してください。

shell> make

なんらかのエラーが発生すれば、修正して構築を続けてください。構築が行えない場合は、詳細を明記のうえ、<myodbc@lists.mysql.com>までメールでお問い合わせ下さい。

ほとんどのプラットフォームでは、MySQL が .so ( 共有 ) を建築、またはサポートするデフォルト設定にはなっていません。これは共用ライブラリ構築の経験に基づいた情報です。

そのような場合は、MySQL 配布物をダウンロードし、次のオプションで構成してください :

--without-server --enable-shared

共用ドライバ ライブラリを構築するには、--enable-shared オプションを configure で指定する必要があります。configure が、デフォルト設定でこのオプションを有効にすることはありません。

--disable-shared オプションを使用して構成した場合、次のコマンドで、スタティック ライブラリから .so ファイルを作成することができます :

shell> cd mysql-connector-odbc-3.51.01
shell> make
shell> cd driver
shell> CC=/usr/bin/gcc \
          $CC -bundle -flat_namespace -undefined error \
          -o .libs/libmyodbc3-3.51.01.so \
          catalog.o connect.o cursor.o dll.o error.o execute.o \
          handle.o info.o misc.o myodbc3.o options.o prepare.o \
          results.o transact.o utility.o \
          -L/usr/local/mysql/lib/mysql/ \
          -L/usr/local/iodbc/lib/ \
          -lz -lc -lmysqlclient -liodbcinst

iODBC でなく、unixODBC を使用している場合は、-liodbcinst を必ず -lodbcinst に変更し、ライブラリ パスを適切に構成してください。

これで libmyodbc3-3.51.01.so ファイルが構築され、.libs ディレクトリに収容されます。このファイルを Connector/ODBC ライブラリ インストール ディレクトリ ( /usr/local/lib 、もしくは --prefix と共に供給したインストレーション ディレクトリ下の lib ディレクトリ ) にコピーしてください。

shell> cd .libs
shell> cp libmyodbc3-3.51.01.so /usr/local/lib
shell> cd /usr/local/lib
shell> ln -s libmyodbc3-3.51.01.so libmyodbc3.so

スレッドセーフ ドライバ ライブラリを構築するには :

shell> CC=/usr/bin/gcc \
          $CC -bundle -flat_namespace -undefined error
          -o .libs/libmyodbc3_r-3.51.01.so
          catalog.o connect.o cursor.o dll.o error.o execute.o
          handle.o info.o misc.o myodbc3.o options.o prepare.o
          results.o transact.o utility.o
          -L/usr/local/mysql/lib/mysql/
          -L/usr/local/iodbc/lib/
          -lz -lc -lmysqlclient_r -liodbcinst

ドライバ ライブラリをインストールするには、次のコマンドを実行してください :

shell> make install

このコマンドは、次のライブラリ セットのうちのどれかをインストールします :

Connector/ODBC 3.51 の場合 :

スレッドセーフ Connector/ODBC 3.51 の場合 :

MyODBC 2.5.0 の場合 :

構築手順の詳しい情報は、ソース配布物に添付されている INSTALL ファイルを参照してください。Sun から make を使用すると、エラーが発生する恐れがありますので注意してください。一方、GNU gmake は、すべてのプラットフォームで問題なく使用できるでしょう。

配布物に含まれている簡単なサンプルを、自作のライブラリで実行するには、次のコマンドを使用してください :

shell> make test

テストを実行する前に、odbc.ini 内に DSN 'myodbc3' を作成し、環境変数 ODBCINI を、適切な odbc.ini ファイルに設定してください。また、MySQL サーバは作動しています。サンプル odbc.ini は、ドライバ配布物に添付されています。

samples/run-samples スクリプトを改変し、各サンプルへのコマンドライン引数として、所望の DSN、UID、PASSWORD 値に受け渡すことも可能です。

Mac OS X (Darwin) でドライバを構築するには、次の configure 例を利用してください :

shell> ./configure --prefix=/usr/local
          --with-unixODBC=/usr/local
          --with-mysql-path=/usr/local/mysql
          --disable-shared
          --enable-gui=no
          --host=powerpc-apple

このコマンドでは、unixODBC と MySQL がデフォルト ロケーションにインストールされたものと仮定します。そうでない場合は、適切に構成してください。

Mac OS X では、デフォルト設定により --enable-shared が .dylib ファイルを構築するようになっています。.so を以下のように構築することができます :

shell> make
shell> cd driver
shell> CC=/usr/bin/gcc \
          $CC -bundle -flat_namespace -undefined error
          -o .libs/libmyodbc3-3.51.01.so *.o
          -L/usr/local/mysql/lib/
          -L/usr/local/iodbc/lib
          -liodbcinst -lmysqlclient -lz -lc

スレッドセーフ ドライバ ライブラリを構築するには :

shell> CC=/usr/bin/gcc \
          $CC -bundle -flat_namespace -undefined error
          -o .libs/libmyodbc3-3.51.01.so *.o
          -L/usr/local/mysql/lib/
          -L/usr/local/iodbc/lib
          -liodbcinst -lmysqlclienti_r -lz -lc -lpthread

iODBC でなく、unixODBC を使用する場合は、-liodbcinst を必ず -lodbcinst に変更し、ライブラリ パスを適切に構成してください。

Apple 版の GCC では、cc と gcc の双方が gcc3 へのシンボリック リンクになっています。

このライブラリを $prefix/lib ディレクトリにコピーし、libmyodbc3.so へ symlink してください。

このコマンドを使用して、アウトプット共用ライブラリのプロパティをクロスチェックすることができます :

shell> otool -LD .libs/libmyodbc3-3.51.01.so

HP-UX 10.x もしくは 11.x でドライバを構築するには、次の configure 例を利用してください :

cc を使用する場合 :

shell> CC="cc" \
          CFLAGS="+z" \
          LDFLAGS="-Wl,+b:-Wl,+s" \
          ./configure --prefix=/usr/local
          --with-unixodbc=/usr/local
          --with-mysql-path=/usr/local/mysql/lib/mysql
          --enable-shared
          --enable-thread-safe

gcc を使用する場合 :

shell> CC="gcc" \
          LDFLAGS="-Wl,+b:-Wl,+s" \
          ./configure --prefix=/usr/local
          --with-unixodbc=/usr/local
          --with-mysql-path=/usr/local/mysql
          --enable-shared
          --enable-thread-safe

ドライバが構築されたら、chatr .libs/libmyodbc3.sl を使ってその属性をクロスチェックし、SHLIB_PATH 環境変数を使用して MySQL クライアント ライブラリ パスを設定する必要があるか確認してください。スタティック バージョンでは、すべての共用ライブラリ オプションを無視し、--disable-shared オプションで configure を実行してください。

AIX でドライバを構築するには、次の configure 例を利用してください :

shell> ./configure --prefix=/usr/local
          --with-unixodbc=/usr/local
          --with-mysql-path=/usr/local/mysql
          --disable-shared
          --enable-thread-safe

注意 :異なるプラットフォームに跨るスタティックおよび共用ライブラリの構築と設定に関しては、「Using static and shared libraries across platforms」で詳細をご覧ください。