このセクションでは、SQL Server 用 Microsoft JDBC ドライバー を使用して SQL Server データベースへのシンプルな接続を作成する方法について簡単に説明します。 SQL Server データベースに接続する前に、まず SQL Server をローカル コンピューターまたはサーバーのどちらかにインストールし、JDBC ドライバーをローカル コンピューターにインストールする必要があります。
適切な JAR ファイルを選択する
Microsoft JDBC Driver には、好みの Java Runtime Environment (JRE) 設定に対応して使用できる複数のジャーが用意されています。
Microsoft JDBC Driver 12.10 for SQL Server には、 mssql-jdbc-12.10.0.jre8.jar および mssql-jdbc-12.10.0.jre11.jar クラス ライブラリ ファイルが用意されています。
SQL Server 用 Microsoft JDBC Driver 12.8 では、mssql-jdbc-12.8.0.jre8.jar および mssql-jdbc-12.8.0.jre11.jar クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 12.6 for SQL Server では、mssql-jdbc-12.6.0.jre8.jar および mssql-jdbc-12.6.0.jre11.jar クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 12.4 for SQL Server では、mssql-jdbc-12.4.0.jre8.jar および mssql-jdbc-12.4.0.jre11.jar クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 12.2 for SQL Server では、mssql-jdbc-12.2.0.jre8.jar および mssql-jdbc-12.2.0.jre11.jar クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 11.2 for SQL Server には、mssql-jdbc-11.2.0.jre8.jar、mssql-jdbc-11.2.0.jre11.jar、mssql-jdbc-11.2.0.jre17.jar、mssql-jdbc-11.2.0.jre18.jar のクラス ライブラリ ファイルが用意されています。
Microsoft JDBC Driver 10.2 for SQL Server では、mssql-jdbc-10.2.0.jre8.jar、mssql-jdbc-10.2.0.jre11.jar、mssql-jdbc-10.2.0.jre17.jar の各クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 9.4 for SQL Server では、mssql-jdbc-9.4.1.jre8.jar、mssql-jdbc-9.4.1.jre11.jar、mssql-jdbc-9.4.1.jre16.jar の各クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 9.2 for SQL Server では、mssql-jdbc-9.2.1.jre8.jar、mssql-jdbc-9.2.1.jre11.jar、mssql-jdbc-9.2.1.jre15.jar の各クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 8.4 for SQL Server では、mssql-jdbc-8.4.1.jre8.jar、mssql-jdbc-8.4.1.jre11.jar、mssql-jdbc-8.4.1.jre14.jar の各クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 8.2 for SQL Server では、mssql-jdbc-8.2.2.jre8.jar、mssql-jdbc-8.2.2.jre11.jar、mssql-jdbc-8.2.2.jre13.jar の各クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 7.4 for SQL Server では、mssql-jdbc-7.4.1.jre8.jar、mssql-jdbc-7.4.1.jre11.jar、mssql-jdbc-7.4.1.jre12.jar の各クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 7.2 for SQL Server には、mssql-jdbc-7.2.2.jre8.jar および mssql-jdbc-7.2.2.jre11.jar クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 7.0 for SQL Server には、mssql-jdbc-7.0.0.jre8.jar および mssql-jdbc-7.0.0.jre10.jar クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 6.4 for SQL Server には、mssql-jdbc-6.4.0.jre7.jar、mssql-jdbc-6.4.0.jre8.jar、および mssql-jdbc-6.4.0.jre9.jar クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 6.2 for SQL Server には、mssql-jdbc-6.2.2.jre7.jarおよび mssql-jdbc-6.2.2.jre8.jar クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 6.0 および 4.2 SQL Server には、sqljdbc41.jar、および sqljdbc42.jar クラス ライブラリ ファイルが提供されます。
Microsoft JDBC Driver 4.1 SQL Server には、sqljdbc41.jar クラス ライブラリ ファイルが提供されます。
何を選択したかによって、使用可能な機能が決まります。 選択する JAR ファイルの詳細については、「JDBC Driver のシステム要件」を参照してください。
クラスパスの設定
Microsoft JDBC Driver の jar は Java SDK の一部ではないため、ユーザー アプリケーションのクラスパスに含める必要があります。
JDBC Driver 12.10 を使用している場合は、mssql-jdbc-12.10.0.jre8.jarまたはmssql-jdbc-12.10.0.jre11.jarを含むようにクラスパスを設定します。
JDBC Driver 12.8 を使用する場合は、mssql-jdbc-12.8.0.jre8.jar または mssql-jdbc-12.8.0.jre11.jar を含むようにクラスパスを設定します。
JDBC Driver 12.6 を使用する場合は、mssql-jdbc-12.6.0.jre8.jar または mssql-jdbc-12.6.0.jre11.jar を含むようにクラスパスを設定します。
JDBC Driver 12.4 を使用する場合は、mssql-jdbc-12.4.0.jre8.jar または mssql-jdbc-12.4.0.jre11.jar を含むようにクラスパスを設定します。
JDBC Driver 12.2 を使用する場合は、mssql-jdbc-12.2.0.jre8.jar または mssql-jdbc-12.2.0.jre11.jar を含むようにクラスパスを設定します。
JDBC Driver 11.2 を使用する場合は、mssql-jdbc-11.2.0.jre8.jar、mssql-jdbc-11.2.0.jre11.jar、mssql-jdbc-11.2.0.jre17.jar、または mssql-jdbc-11.2.0.jre18.jar が含まれるようにクラスパスを設定します。
JDBC Driver 10.2 を使用する場合は、mssql-jdbc-10.2.0.jre8.jar、mssql-jdbc-10.2.0.jre11.jar、または mssql-jdbc-10.2.0.jre17.jar が含まれるようにクラスパスを設定します。
JDBC Driver 9.4 を使用する場合は、mssql-jdbc-9.4.1.jre8.jar、mssql-jdbc-9.4.1.jre11.jar、または mssql-jdbc-9.4.1.jre16.jar が含まれるようにクラスパスを設定します。
JDBC Driver 9.2 を使用する場合は、mssql-jdbc-9.2.1.jre8.jar、mssql-jdbc-9.2.1.jre11.jar、または mssql-jdbc-9.2.1.jre15.jar が含まれるようにクラスパスを設定します。
JDBC Driver 8.4 を使用する場合は、mssql-jdbc-8.4.1.jre8.jar、mssql-jdbc-8.4.1.jre11.jar、または mssql-jdbc-8.4.1.jre14.jar が含まれるようにクラスパスを設定します。
JDBC Driver 8.2 を使用する場合は、mssql-jdbc-8.2.2.jre8.jar、mssql-jdbc-8.2.2.jre11.jar、または mssql-jdbc-8.2.2.jre13.jar が含まれるようにクラスパスを設定します。
JDBC Driver 7.4 を使用する場合は、mssql-jdbc-7.4.1.jre8.jar、mssql-jdbc-7.4.1.jre11.jar、または mssql-jdbc-7.4.1.jre12.jar が含まれるようにクラスパスを設定します。
JDBC Driver 7.2 を使用する場合は、mssql-jdbc-7.2.2.jre8.jar または mssql-jdbc-7.2.2.jre11.jarを含むようにクラスパスを設定します。
JDBC Driver 7.0 を使用する場合は、mssql-jdbc-7.0.0.jre8.jar または mssql-jdbc-7.0.0.jre10.jar を含むようにクラスパスを設定します。
JDBC Driver 6.4 を使用する場合は、mssql-jdbc-6.4.0.jre7.jar、mssql-jdbc-6.4.0.jre8.jar、または mssql-jdbc-6.4.0.jre9.jar が含まれるようにクラスパスを設定します。
JDBC Driver 6.2 を使用する場合は、mssql-jdbc-6.2.2.jre7.jar または mssql-jdbc-6.2.2.jre8.jar を含むようにクラスパスを設定します。
JDBC Driver 4.1 または 4.2 を使用する場合は、該当するドライバーのダウンロードから sqljdbc41.jar または sqljdbc42.jar ファイルが含まれるようにクラスパスを設定します。
クラスパスに適切な Jar ファイルのエントリがない場合、アプリケーションでは Class not found という一般的な例外がスローされます。
Microsoft JDBC Driver 12.10 の場合
mssql-jdbc-12.10.0.jre8.jarまたはmssql-jdbc-12.10.0.jre11.jarファイルは、次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.10.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.10.0.jre11.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.10 for SQL Server\sqljdbc_12.10\enu\mssql-jdbc-12.10.0.jre11.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.10/enu/mssql-jdbc-12.10.0.jre11.jar
CLASSPATH ステートメントに含まれる Microsoft JDBC Driver for SQL Server ( mssql-jdbc-12.10.0.jre8.jar、 mssql-jdbc-12.10.0.jre11.jar など) が 1 つだけであることを確認します。
Microsoft JDBC Driver 12.8 の場合
mssql-jdbc-12.8.0.jre8.jar または mssql-jdbc-12.8.0.jre11.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.8.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.8.0.jre11.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.8 for SQL Server\sqljdbc_12.8\enu\mssql-jdbc-12.8.0.jre11.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.8/enu/mssql-jdbc-12.8.0.jre11.jar
CLASSPATH ステートメントには 1 つの SQL Server 用 Microsoft JDBC ドライバー (mssql-jdbc-12.8.0.jre8.jar または mssql-jdbc-12.8.0.jre11.jar のいずれか) のみが含まれていることを確認してください。
Microsoft JDBC Driver 12.6 の場合
mssql-jdbc-12.6.0.jre8.jar または mssql-jdbc-12.6.0.jre11.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.6.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.6.0.jre11.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.6 for SQL Server\sqljdbc_12.6\enu\mssql-jdbc-12.6.0.jre11.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.6/enu/mssql-jdbc-12.6.0.jre11.jar
CLASSPATH ステートメントには 1 つの SQL Server 用 Microsoft JDBC ドライバー (mssql-jdbc-12.6.0.jre8.jar または mssql-jdbc-12.6.0.jre11.jar のいずれか) のみが含まれていることを確認してください。
Microsoft JDBC Driver 12.4 の場合
mssql-jdbc-12.4.0.jre8.jar または mssql-jdbc-12.4.0.jre11.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.4.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.4.0.jre11.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.4 for SQL Server\sqljdbc_12.4\enu\mssql-jdbc-12.4.0.jre11.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.4/enu/mssql-jdbc-12.4.0.jre11.jar
CLASSPATH ステートメントには 1 つの SQL Server 用 Microsoft JDBC ドライバー (mssql-jdbc-12.4.0.jre8.jar または mssql-jdbc-12.4.0.jre11.jar のいずれか) のみが含まれていることを確認してください。
Microsoft JDBC Driver 12.2 の場合
mssql-jdbc-12.2.0.jre8.jar または mssql-jdbc-12.2.0.jre11.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.2.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.2.0.jre11.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.2 for SQL Server\sqljdbc_12.2\enu\mssql-jdbc-12.2.0.jre11.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.2/enu/mssql-jdbc-12.2.0.jre11.jar
CLASSPATH ステートメントには 1 つの SQL Server 用 Microsoft JDBC ドライバー (mssql-jdbc-12.2.0.jre8.jar または mssql-jdbc-12.2.0.jre11.jar のいずれか) のみが含まれていることを確認してください。
Microsoft JDBC Driver 11.2 の場合
mssql-jdbc-11.2.0.jre8.jar、mssql-jdbc-11.2.0.jre11.jar、mssql-jdbc-11.2.0.jre17.jar、または mssql-jdbc-11.2.0.jre18.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre17.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre18.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 11.2 for SQL Server\sqljdbc_11.2\enu\mssql-jdbc-11.2.0.jre11.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_11.2/enu/mssql-jdbc-11.2.0.jre11.jar
CLASSPATH ステートメントには 1 つの Microsoft JDBC Driver for SQL Server (mssql-jdbc-11.2.0.jre8.jar、mssql-jdbc-11.2.0.jre11.jar、mssql-jdbc-11.2.0.jre17.jar、mssql-jdbc-11.2.0.jre18.jar のいずれか) のみが含まれていることを確認してください。
Microsoft JDBC Driver 10.2 の場合
mssql-jdbc-10.2.0.jre8.jar、mssql-jdbc-10.2.0.jre11.jar、または mssql-jdbc-10.2.0.jre17.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-10.2.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-10.2.0.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-10.2.0.jre17.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 10.2 for SQL Server\sqljdbc_10.2\enu\mssql-jdbc-10.2.0.jre11.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_10.2/enu/mssql-jdbc-10.2.0.jre11.jar
CLASSPATH ステートメントに SQL Server 用 Microsoft JDBC ドライバー が 1 つだけ含まれていることを確認します (mssql-jdbc-10.2.0.jre8.jar、mssql-jdbc-10.2.0.jre11.jar、または mssql-jdbc-10.2.0.jre17.jar など)。
Microsoft JDBC Driver 9.4 の場合
mssql-jdbc-9.4.1.jre8.jar、mssql-jdbc-9.4.1.jre11.jar、または mssql-jdbc-9.4.1.jre16.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.4.1.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.4.1.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.4.1.jre16.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 9.4 for SQL Server\sqljdbc_9.4\enu\mssql-jdbc-9.4.1.jre11.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_9.4/enu/mssql-jdbc-9.4.1.jre11.jar
CLASSPATH ステートメントに SQL Server 用 Microsoft JDBC ドライバー が 1 つだけ含まれていることを確認します (mssql-jdbc-9.4.1.jre8.jar、mssql-jdbc-9.4.1.jre11.jar、または mssql-jdbc-9.4.1.jre16.jar など)。
Microsoft JDBC Driver 9.2 の場合
mssql-jdbc-9.2.1.jre8.jar、mssql-jdbc-9.2.1.jre11.jar、または mssql-jdbc-9.2.1.jre15.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.2.1.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.2.1.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.2.1.jre15.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 9.2 for SQL Server\sqljdbc_9.2\enu\mssql-jdbc-9.2.1.jre11.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_9.2/enu/mssql-jdbc-9.2.1.jre11.jar
CLASSPATH ステートメントに SQL Server 用 Microsoft JDBC ドライバー が 1 つだけ含まれていることを確認します (mssql-jdbc-9.2.1.jre8.jar、mssql-jdbc-9.2.1.jre11.jar、または mssql-jdbc-9.2.1.jre15.jar など)。
Microsoft JDBC Driver 8.4 の場合
mssql-jdbc-8.4.1.jre8.jar、mssql-jdbc-8.4.1.jre11.jar、または mssql-jdbc-8.4.1.jre14.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.4.1.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.4.1.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.4.1.jre14.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 8.4 for SQL Server\sqljdbc_8.4\enu\mssql-jdbc-8.4.1.jre11.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_8.4/enu/mssql-jdbc-8.4.1.jre11.jar
CLASSPATH ステートメントに SQL Server 用 Microsoft JDBC ドライバー が 1 つだけ含まれていることを確認します (mssql-jdbc-8.4.1.jre8.jar、mssql-jdbc-8.4.1.jre11.jar、または mssql-jdbc-8.4.1.jre14.jar など)。
Microsoft JDBC Driver 8.2 の場合
mssql-jdbc-8.2.2.jre8.jar、mssql-jdbc-8.2.2.jre11.jar、または mssql-jdbc-8.2.2.jre13.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.2.2.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.2.2.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.2.2.jre13.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 8.2 for SQL Server\sqljdbc_8.2\enu\mssql-jdbc-8.2.2.jre11.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_8.2/enu/mssql-jdbc-8.2.2.jre11.jar
CLASSPATH ステートメントに SQL Server 用 Microsoft JDBC ドライバー が 1 つだけ含まれていることを確認します (mssql-jdbc-8.2.2.jre8.jar、mssql-jdbc-8.2.2.jre11.jar、または mssql-jdbc-8.2.2.jre13.jar など)。
Microsoft JDBC Driver 7.4 の場合
mssql-jdbc-7.4.1.jre8.jar、mssql-jdbc-7.4.1.jre11.jar、または mssql-jdbc-7.4.1.jre12.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.4.1.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.4.1.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.4.1.jre12.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.4 for SQL Server\sqljdbc_7.4\enu\mssql-jdbc-7.4.1.jre11.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.4/enu/mssql-jdbc-7.4.1.jre11.jar
CLASSPATH ステートメントに SQL Server 用 Microsoft JDBC ドライバー が 1 つだけ含まれていることを確認します (mssql-jdbc-7.4.1.jre8.jar、mssql-jdbc-7.4.1.jre11.jar、mssql-jdbc-7.4.1.jre12.jar など)。
Microsoft JDBC driver 7.2 の場合
Mssql-jdbc-7.2.2.jre8.jar または mssql-jdbc-7.2.2.jre11.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.2.2.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.2.2.jre11.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.2 for SQL Server\sqljdbc_7.2\enu\mssql-jdbc-7.2.2.jre11.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.2/enu/mssql-jdbc-7.2.2.jre11.jar
CLASSPATH ステートメントには 1 つの SQL Server 用 Microsoft JDBC ドライバー (mssql-jdbc-7.2.2.jre8.jar または mssql-jdbc-7.2.2.jre11.jar のいずれか) のみが含まれていることを確認してください。
Microsoft JDBC Driver 7.0 の場合
mssql-jdbc-7.0.0.jre8.jar または mssql-jdbc-7.0.0.jre10.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.0.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.0.0.jre10.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.0 for SQL Server\sqljdbc_7.0\enu\mssql-jdbc-7.0.0.jre10.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.0/enu/mssql-jdbc-7.0.0.jre10.jar
CLASSPATH ステートメントには 1 つの SQL Server 用 Microsoft JDBC ドライバー (mssql-jdbc-7.0.0.jre8.jar または mssql-jdbc-7.0.0.jre10.jar のいずれか) のみが含まれていることを確認してください。
Microsoft JDBC Driver 6.4 の場合
mssql-jdbc-6.4.0.jre7.jar、mssql-jdbc-6.4.0.jre8.jar、または mssql-jdbc-6.4.0.jre9.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.4.0.jre7.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.4.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.4.0.jre9.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.4 for SQL Server\sqljdbc_6.4\enu\mssql-jdbc-6.4.0.jre9.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.4/enu/mssql-jdbc-6.4.0.jre9.jar
CLASSPATH ステートメントには 1 つの SQL Server 用 Microsoft JDBC ドライバー (mssql-jdbc-6.4.0.jre7.jar、mssql-jdbc-6.4.0.jre8.jar、mssql-jdbc-6.4.0.jre9.jar のいずれか) のみが含まれていることを確認してください。
Microsoft JDBC Driver 6.2 の場合
mssql-jdbc-6.2.2.jre7.jar または mssql-jdbc-6.2.2.jre8.jar ファイルが次の場所にインストールされます。
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.2.2.jre7.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.2.2.jre8.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.2 for SQL Server\sqljdbc_6.2\enu\mssql-jdbc-6.2.2.jre8.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.2/enu/mssql-jdbc-6.2.2.jre8.jar
CLASSPATH ステートメントには 1 つの SQL Server 用 Microsoft JDBC ドライバー (mssql-jdbc-6.2.2.jre7.jar または mssql-jdbc-6.2.2.jre8.jar のいずれか) のみが含まれていることを確認してください。
Microsoft JDBC Driver 4.1、4.2、および 6.0 の場合
sqljdbc.jar ファイル、sqljdbc4.jar ファイル、sqljdbc41.jar ファイル、または sqljdbc42.jar ファイルは次の場所にインストールします。
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc.jar
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc4.jar
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc41.jar
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc42.jar
次のスニペットは、Windows アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.0 for SQL Server\sqljdbc_4.2\enu\sqljdbc42.jar
次のスニペットは、Unix または Linux アプリケーションで使用される CLASSPATH ステートメントの例です。
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_4.2/enu/sqljdbc42.jar
CLASSPATH ステートメントに含まれている SQL Server 用 Microsoft JDBC ドライバー が、sqljdbc.jar、sqljdbc4.jar、sqljdbc41.jar、または sqljdbc42.jar のいずれか 1 つであることを確認してください。
注記
Windows システムでは、ディレクトリ名が 8.3 ファイル名規則より長い場合、またはフォルダー名にスペースが含まれている場合、クラスパスに問題が生じることがあります。 このような種類の問題が疑われる場合は、sqljdbc.jar ファイル、sqljdbc4.jar ファイル、またはsqljdbc41.jar ファイルを C:\Tempなどの単純なディレクトリ名に一時的に移動し、クラスパスを変更して、問題に対処するかどうかを判断します。
コマンド プロンプトで直接実行されるアプリケーション
クラスパスは、オペレーティング システムにおいて構成されます。 sqljdbc.jar、sqljdbc4.jar、または sqljdbc41.jar をシステムのクラスパスに追加します。 または、java -classpath オプションを使用して、アプリケーションを実行するクラスパスを Java コマンド ラインで指定できます。
IDE で実行されるアプリケーション
各 IDE ベンダーには、自身の IDE 内でクラスパスを設定するための方法が別に用意されています。 オペレーティング システム内でクラスパスを設定するだけでは上手くいきません。 sqljdbc.jar、sqljdbc4.jar、または sqljdbc41.jar を IDE クラスパスに追加する必要があります。
サーブレットおよび JSP
サーブレットや JSP は、Tomcat のようなサーブレット/JSP エンジンで実行されます。 クラスパスは、サーブレット/JSP エンジンのドキュメントに従って設定する必要があります。 オペレーティング システム内でクラスパスを設定するだけでは上手くいきません。 一部のサーブレット/JSP エンジンでは、エンジンのクラスパスを設定するために使用できるセットアップ画面が用意されています。 この場合、正しい JDBC ドライバー用 JAR ファイルを既存のエンジン クラスパスに追加し、エンジンを再起動する必要があります。 この他の場合は、エンジンをインストールするときに lib のような特定のディレクトリに sqljdbc.jar、sqljdbc4.jar、または sqljdbc41.jar をコピーしてドライバーを配置することができます。 エンジン ドライバーのクラスパスは、エンジン固有の構成ファイルで指定することもできます。
エンタープライズJavaBeans
Enterprise Java Beans (EJB) は、EJB コンテナーで実行されます。 EJB コンテナーは、さまざまなベンダーから供給されています。 Java アプレットはブラウザー上で動作しますが、Web サーバーからダウンロードされます。 sqljdbc.jar、sqljdbc4.jar、または sqljdbc41.jar を Web サーバーのルートにコピーし、アプレットの [HTML archive] タブで JAR ファイル名を指定します。たとえば、<applet ... archive=mssql-jdbc-***.jar> のようになります。
データベースへの単純な接続を行う
sqljdbc.jar クラス ライブラリを使用するには、まず、次のようにして、アプリケーションでドライバーを登録する必要があります。
Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
ドライバーが読み込まれたら、接続 URL と、DriverManager クラスの getConnection メソッドを使用して接続を確立できます。
String connectionUrl = "jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;user=MyUserName;password=<password>;encrypt=false;";
Connection con = DriverManager.getConnection(connectionUrl);
警告
上記の接続文字列では encrypt=falseが使用されています。運用環境では推奨されません。 JDBC を使ったデータベース接続の暗号化については、「暗号化を使用した接続」を参照してください。
JDBC API 4.0 以降、JDBC ドライバーが自動的に読み込まれるように、DriverManager.getConnection() メソッドが改良されました。 したがって、ドライバーの Jar ライブラリを使用する場合は、アプリケーションから Class.forName メソッドを呼び出してドライバーの登録や読み込みを行う必要はありません。
DriverManager クラスの getConnection メソッドを呼び出すと、登録されている JDBC ドライバーのセットから適切なドライバーが検索されます。 sqljdbc4.jar、sqljdbc41.jar、または sqljdbc42.jar ファイルには "META-INF/services/java.sql.Driver" ファイルが含まれています。これには、com.microsoft.sqlserver.jdbc.SQLServerDriver が登録済みのドライバーとして含まれています。 現在、Class.forName メソッドを使用してドライバーを読み込んでいる既存のアプリケーションは、変更なしで引き続き動作します。
注記
sqljdbc4.jar、sqljdbc41.jar、または sqljdbc42.jar クラス ライブラリは、古いバージョンの Java ランタイム環境 (JRE) では使用できません。 SQL Server 用 Microsoft JDBC ドライバー によってサポートされている JRE バージョンの一覧については、「JDBC Driver のシステム要件」を参照してください。
データ ソースの接続方法と接続 URL の使用方法の詳細については、「接続 URL の構築」と「接続プロパティの設定」を参照してください。
ヒント
前の例では、わかりやすくするために DriverManager を使用しています。 運用アプリケーションの場合は、代わりに SQLServerDataSource クラスを使用することを検討してください。このクラスは、接続プールと追加の構成性を提供します。 詳細と例については、「 データの接続と取得」および「データソースのサンプル」を参照してください。