Java EE のサポートについて
以下のセクションでは、Microsoft JDBC Driver for SQL Server が Java Platform, Enterprise Edition (Java EE) および JDBC 3.0 のオプションの API 機能をサポートするしくみについて説明します。 このヘルプ システムで提供されるソース コード例は、これらの機能を使用するための優れた参考資料となります。
まず、使用している Java 環境 (JDK、JRE) に javax.sql パッケージが含まれていることを確認してください。 このパッケージは、オプションの API を使用するすべての JDBC アプリケーションに必須です。 JDK 1.5 以降のバージョンには、このパッケージが既に含まれているので、別途インストールする必要はありません。
ドライバー名
このドライバーのクラス名は、com.microsoft.sqlserver.jdbc.SQLServerDriver です。
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、6.0 の場合、このドライバーは sqljdbc.jar、sqljdbc4.jar、sqljdbc41.jar、または sqljdbc42.jar ファイルに含まれています。
JDBC DriverManager クラスを使用してドライバーを読み込む場合、および任意のドライバー構成でドライバーのクラス名を指定する場合は常に、このクラス名が使用されます。 たとえば、Java EE アプリケーション サーバー内でデータ ソースを構成するには、ドライバーのクラス名を入力する必要が生じる場合があります。
データ ソース
この JDBC ドライバーは、Java EE または JDBC 3.0 データ ソースをサポートします。 JDBC ドライバー SQLServerXADataSource クラスは com.microsoft.sqlserver.jdbc.SQLServerXADataSource によって実装されます。
データソース名
データ ソースを使用して、データベース接続を確立できます。 次の表は、JDBC ドライバーで使用できるデータ ソースを示しています。
| データ ソースの種類 | クラスの名前と説明 |
|---|---|
| DataSource | com.microsoft.sqlserver.jdbc.SQLServerDataSource 非プーリング データ ソース。 |
| ConnectionPoolDataSource | com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource JAVA EE アプリケーション サーバー接続プールを構成するデータ ソース。 通常は、アプリケーションが JAVA EE アプリケーション サーバー内で実行される場合に使用されます。 |
| XADataSource | com.microsoft.sqlserver.jdbc.SQLServerXADataSource JAVA EE XA データ ソースを構成するデータ ソース。 通常は、アプリケーションが JAVA EE アプリケーション サーバーおよび XA トランザクション マネージャー内で実行される場合に使用されます。 |
[データ ソースのプロパティ]
すべてのデータ ソースは、基になるドライバーのプロパティ セットに関連付けられているプロパティを設定または取得する機能をサポートします。
次に例を示します。
setServerName("localhost");
setDatabaseName("AdventureWorks");
以下は、アプリケーションがデータ ソースを使用して接続するしくみを示しています。
//initialize JNDI ..
Context ctx = new InitialContext(System.getProperties());
...
DataSource ds = (DataSource) ctx.lookup("MyDataSource");
Connection c = ds.getConnection("user", "pwd");
データ ソースのプロパティの詳細については、「データ ソースのプロパティの設定」を参照してください。