パッケージ java.sql

Java^TM プログラミング言語を使用してデータソース (通常はリレーショナルデータベース) に格納されたデータにアクセスして処理する API を提供します。

参照: 説明

インタフェースのサマリー

インタフェース	説明
Array	SQL 型 ARRAY の Java プログラミング言語でのマッピングです。
Blob	SQL BLOB 値の JavaTM プログラミング言語での表現 (マッピング) です。
CallableStatement	SQL ストアドプロシージャーを実行するのに使用されるインタフェースです。
Clob	SQL 型 CLOB の JavaTM プログラミング言語でのマッピングです。
Connection	特定のデータベースとの接続 (セッション) を表現します。
DatabaseMetaData	データベースに関する包括的な情報です。
Driver	すべてのドライバクラスが実装しなければならないインタフェースです。
NClob	SQL 型 NCLOB の JavaTM プログラミング言語でのマッピングです。
ParameterMetaData	PreparedStatement オブジェクト内の各パラメータマーカーの型とプロパティーに関する情報を取得するのに使用できるオブジェクトです。
PreparedStatement	プリコンパイルされた SQL 文を表すオブジェクトです。
Ref	Java プログラミング言語での SQL REF 値のマッピングで、データベースの SQL 構造化型の値への参照となります。
ResultSet	データベースの結果セットを表すデータのテーブルで、通常、データベースに照会する文を実行することによって生成されます。
ResultSetMetaData	ResultSet オブジェクトの列の型とプロパティーに関する情報を取得するのに使用できるオブジェクトです。
RowId	SQL ROWID 値の Java プログラミング言語での表現 (マッピング) です。
Savepoint	Connection.rollback メソッドから参照される現在のトランザクション内のポイントであるセーブポイントの表現です。
SQLData	SQL ユーザー定義型 (UDT) を Java プログラミング言語のクラスにカスタムマッピングするのに使用されるインタフェースです。
SQLInput	SQL 構造化型または SQL の個別の型のインスタンスを表す値のストリームを格納する入力ストリームです。
SQLOutput	ユーザー定義型の属性をデータベースに書き戻すための出力ストリームです。
SQLXML	SQL XML 型の JavaTM プログラミング言語でのマッピングです。
Statement	静的 SQL 文を実行し、作成された結果を返すために使用されるオブジェクトです。
Struct	SQL 構造化型の Java プログラミング言語の標準のマッピングです。
Wrapper	委譲インスタンスが実際はプロキシクラスであるときにそのインスタンスを取得できる、JDBC クラスのインタフェースです。

クラスのサマリー

クラス	説明
Date	ミリ秒の値をラップする薄いラッパーであり、これによって JDBC がミリ秒の値を SQL DATE 値として扱うことができるようになります。
DriverManager	一連の JDBC ドライバを管理するための基本的なサービスです。 注: JDBC 2.0 API で新しく追加された DataSource インタフェースを使用してデータソースに接続することも可能です。
DriverPropertyInfo	接続用のドライバプロパティーです。
SQLPermission	アプレットで実行されているコードまたは SecurityManager が有効になっているアプリケーションが DriverManager.setLogWriter メソッド、DriverManager.setLogStream (非推奨) メソッド、SyncFactory.setJNDIContext メソッド、SyncFactory.setLogger メソッド、Connection.setNetworktimeout メソッド、または Connection.abort メソッドを呼び出すときに、SecurityManager がチェックするアクセス権です。
Time	java.util.Date クラスの薄いラッパーで、このラッパーによって JDBC API はこれを SQL TIME 値として識別できます。
Timestamp	このクラスは、java.util.Date の薄いラッパーで、このラッパーによって JDBC API はこれを SQL TIMESTAMP 値として識別できます。
Types	JDBC 型と呼ばれる、汎用 SQL 型を識別するために使用する定数を定義するクラスです。

列挙型のサマリー

列挙型	説明
ClientInfoStatus	Connection.setClientInfo の呼び出しによってプロパティーを設定できない理由の状態の列挙です。
PseudoColumnUsage	擬似/隠し列の使用の列挙を表す列挙です。
RowIdLifetime	RowId の寿命の値の列挙です。

例外のサマリー

例外	説明
BatchUpdateException	バッチ更新操作中にエラーが発生したときにスローされる SQLException のサブクラスです。
DataTruncation	MaxFieldSize を超過した以外の理由でデータ値が予期せず切り詰められたときに、DataTruncation 例外としてスローされる例外 (書き込み時)、または DataTruncation 警告として報告される例外 (読み込み時) です。
SQLClientInfoException	1 つ以上のクライアント情報プロパティーを Connection で設定できなかったときに、SQLException のサブクラスがスローされます。
SQLDataException	SQLState クラス値が「22」であるか、またはベンダー指定の条件下にあるときにスローされる SQLException のサブクラスです。
SQLException	データベースアクセスエラーまたはその他のエラーに関する情報を提供する例外です。
SQLFeatureNotSupportedException	SQLState クラス値が「0A」(ゼロ A) のときにスローされる SQLException のサブクラスです。
SQLIntegrityConstraintViolationException	SQLState クラス値が「23」であるか、またはベンダー指定の条件下にあるときにスローされる SQLException のサブクラスです。
SQLInvalidAuthorizationSpecException	SQLState クラス値が「28」であるか、またはベンダー指定の条件下にあるときにスローされる SQLException のサブクラスです。
SQLNonTransientConnectionException	SQLState クラス値が「08」であるか、またはベンダー指定の条件下にあるときにスローされる SQLException のサブクラスです。
SQLNonTransientException	SQLException の原因が修正されないかぎり、同じ操作を再試行してもインスタンスが失敗するときにスローされる SQLException のサブクラスです。
SQLRecoverableException	アプリケーションが回復手順を実行してトランザクション全体 (分散トランザクションの場合はトランザクションブランチ) を再試行すれば前回失敗した操作が成功する可能性があるときにスローされる SQLException のサブクラスです。
SQLSyntaxErrorException	SQLState クラス値が「42」であるか、またはベンダー指定の条件下にあるときにスローされる SQLException のサブクラスです。
SQLTimeoutException	Statement で指定されたタイムアウトの期限が切れたときにスローされる、SQLException のサブクラスです。
SQLTransactionRollbackException	SQLState クラス値が「40」であるか、またはベンダー指定の条件下にあるときにスローされる SQLException のサブクラスです。
SQLTransientConnectionException	SQLState クラス値が「08」であるか、またはベンダー指定の条件下にあるときのための、SQLException のサブクラスです。
SQLTransientException	前回失敗した操作が、アプリケーションレベルの機能による介入がなくても再試行時に成功する可能性がある状況では、SQLException のサブクラスがスローされます。
SQLWarning	データベースアクセスの警告に関する情報を提供する例外です。

パッケージ java.sql の説明

Java^TM プログラミング言語を使用してデータソース (通常はリレーショナルデータベース) に格納されたデータにアクセスして処理する API を提供します。この API に含まれているフレームワークで、複数のドライバをインストールして複数のデータソースに動的にアクセスできます。JDBC^TM API は主に SQL 文をデータベースに渡すために作られていますが、表形式の任意のデータソースのデータの読み込みおよび書き込みを提供します。javax.sql.RowSet インタフェースグループを介して使用可能な読み込み/書き込み機能は、スプレッドシート、フラットファイル、またはほかの表形式のデータソースのデータを使用および更新するためにカスタマイズできます。

JDBC^TM 4.1 API に含まれる API

JDBC^TM 4.1 API には、JDBC コア API と呼ばれる java.sql パッケージと、JDBC オプションパッケージ API と呼ばれる javax.sql パッケージの両方が含まれます。この完全な JDBC API は、Java^TM Standard Edition (Java SE^TM) の Version 7 に含まれます。javax.sql パッケージは JDBC API の機能をクライアント側 API からサーバー側 API へ拡張するもので、Java^TM Enterprise Edition (Java EE^TM) テクノロジの必須部分です。

バージョン

JDBC 4.1 API には以前のバージョンの JDBC API がすべて組み込まれています。

• JDBC 4.0 API
• JDBC 3.0 API
• JDBC 2.1 コア API
• JDBC 2.0 オプションパッケージ API
  (JDBC 2.1 コア API と JDBC 2.0 オプションパッケージ API を合わせて JDBC 2.0 API と呼ぶ)
• JDBC 1.2 API
• JDBC 1.0 API

クラス、インタフェース、メソッド、フィールド、コンストラクタ、および例外には、これらがいつ Java プラットフォームに導入されたのかを示す次の since タグがあります。since タグが JDBC API の Javadoc^TM のコメントで使用されている場合、その意味は次のとおりです。

• since 1.7 -- JDBC 4.1 API に新しく追加。Java SE プラットフォーム, Version 7 の一部
• since 1.6 -- JDBC 4.0 API に新しく追加。Java SE プラットフォーム, Version 6 の一部
• since 1.4 -- JDBC 3.0 API に新しく追加。J2SE プラットフォーム, Version 1.4 の一部
• since 1.2 -- JDBC 2.0 API に新しく追加。J2SE プラットフォーム, Version 1.2 の一部
• since 1.1 または since タグなし -- 元の JDBC 1.0 API に存在。JDK^TM, Version 1.1 の一部

注: 新機能の多くはオプションです。したがって、ドライバおよびドライバがサポートする機能にはいくつかのバリエーションがあります。機能を使用する前に、その機能がサポートされているかどうかをドライバのドキュメントで必ず確認してください。

注: SQLPermission クラスが Java^TM 2 SDK, Standard Edition, Version 1.3 リリースで追加されました。このクラスを使用すると、テーブル名、列データなどの情報を格納する DriverManager に関連したログストリームへの無権限でのアクセスを防止できます。

java.sql パッケージに含まれるもの

java.sql パッケージは、次の用途の API を含んでいます。

• DriverManager 機能を介したデータソースとの接続
  • DriverManager クラス -- ドライバとの接続
  • SQLPermission クラス -- アプレットなどのセキュリティーマネージャー内で実行されるコードが DriverManager を介してログストリームを設定しようとするときにアクセス権を許可する
  • Driver インタフェース -- JDBC テクノロジに基づくドライバ (JDBC ドライバ) の登録および接続を API に提供する。通常は DriverManager クラスだけが使用する
  • DriverPropertyInfo クラス -- JDBC ドライバのプロパティーを提供する。一般ユーザーは使用しない
• データベースへの SQL 文の送信
  • Statement -- 基本 SQL 文を送信する
  • PreparedStatement -- 準備済み文または基本 SQL 文を送信する (Statement から派生)
  • CallableStatement -- データベースストアドプロシージャーを呼び出す (PreparedStatement から派生)
  • Connection インタフェース -- 文を作成し、接続とそのプロパティーを管理するメソッドを提供する
  • Savepoint -- トランザクションでセーブポイントを提供する
• クエリー結果の取得と更新
  • ResultSet インタフェース
• SQL 型を Java プログラミング言語のクラスおよびインタフェースへ標準マッピング
  • Array インタフェース -- SQL の次をマッピングする: ARRAY
  • Blob インタフェース -- SQL の次をマッピングする: BLOB
  • Clob インタフェース -- SQL の次をマッピングする: CLOB
  • Date クラス -- SQL の次をマッピングする: DATE
  • NClob インタフェース -- SQL の次をマッピングする: NCLOB
  • Ref インタフェース -- SQL の次をマッピングする: REF
  • RowId インタフェース -- SQL の次をマッピングする: ROWID
  • Struct インタフェース -- SQL の次をマッピングする: STRUCT
  • SQLXML インタフェース -- SQL の次をマッピングする: XML
  • Time クラス -- SQL の次をマッピングする: TIME
  • Timestamp クラス -- SQL の次をマッピングする: TIMESTAMP
  • Types クラス -- SQL 型の定数を提供する
• SQL ユーザー定義型 (UDT) を Java プログラミング言語のクラスへカスタムマッピング
  • SQLData インタフェース -- このクラスのインスタンスへの UDT のマッピングを指定する
  • SQLInput インタフェース -- ストリームから UDT 属性を読み込むメソッドを提供する
  • SQLOutput インタフェース -- ストリームへ UDT 属性を書き込むメソッドを提供する
• メタデータ
  • DatabaseMetaData インタフェース -- データベースに関する情報を提供する
  • ResultSetMetaData インタフェース -- ResultSet オブジェクトの列に関する情報を提供する
  • ParameterMetaData インタフェース -- PreparedStatement コマンドのパラメータに関する情報を提供する
• 例外
  • SQLException -- データアクセスの障害が発生したときにほとんどのメソッドによってスローされ、その他の理由により一部のメソッドによってスローされる
  • SQLWarning -- 警告を示すためにスローされる
  • DataTruncation -- データが切り詰められた可能性があることを示すためにスローされる
  • BatchUpdateException -- バッチ更新のコマンドがすべては正常に実行されなかったことを示すためにスローされる

JDBC 4.1 API で導入された java.sql と javax.sql の機能

• Connection、ResultSet、および Statement オブジェクトを try-with-resources 文で使用できる
• CallableStatement および ResultSet に getObject メソッドを使用して変換先の Java 型を指定するサポートを追加
• DatabaseMetaData の擬似列を返すメソッドおよび生成されたキーが常に返されるかどうかを返すメソッド
• データベーススキーマを指定し、物理接続を中止およびタイムアウトさせるためのサポートの Connection への追加。
• 依存するオブジェクトがクローズされた場合に、Statement オブジェクトをクローズするサポートの追加
• Driver、DataSource、ConnectionPoolDataSource および XADataSource の親ロガーの取得のサポート

JDBC 4.0 API で導入された java.sql と javax.sql の機能

• 自動 java.sql.Driver 検出 -- Class.forName を使用した java.sql.Driver クラスのロードは不要
• 各国の文字セットサポートの追加
• SQL:2003 XML データ型に対するサポートの追加
• SQLException の拡張機能 -- 原因チェーンのサポートの追加。共通の SQLState クラスの値コード用の新しい SQLException の追加
• Blob/Clob 機能の拡張 -- Blob/Clob インスタンスを作成および解放するためのサポートの提供、およびアクセス可能性を向上させるためのメソッドの追加
• SQL ROWID にアクセスするためのサポートの追加
• JDBC アプリケーションで、通常はアプリケーションサーバーまたは接続プール環境にある、ベンダーによってラップされた JDBC リソースのインスタンスにアクセスするためのサポートの追加
• PooledConnection に関連付けられた PreparedStatement がクローズされたか、無効であるとドライバが判断したときに通知される機能

JDBC 3.0 API で導入された java.sql と javax.sql の機能

• プール文 -- プール接続に関連した文を再利用する
• セーブポイント -- 指定されたセーブポイントまでトランザクションをロールバックする
• ConnectionPoolDataSource に定義されたプロパティー -- 接続のプール方法を指定する
• PreparedStatement オブジェクトのパラメータのメタデータ
• 自動生成された列から値を取得する
• 同時にオープンされている CallableStatement オブジェクトから複数の ResultSet オブジェクトを返す
• CallableStatement オブジェクトへのパラメータを名前とインデックスによって識別する
• ResultSet 保持機能 -- トランザクションの終了時にカーソルをオープンの状態に保持するべきかクローズの状態に保持するべきかを指定する
• Ref オブジェクトが参照する SQL 構造化型インスタンスを取得および更新する
• BLOB、CLOB、ARRAY、および REF の各値をプログラムによって更新する。
• java.sql.Types.DATALINK データ型の追加 -- JDBC ドライバがデータソースの外部に格納されたオブジェクトにアクセスできるようにする
• SQL 型階層を取得するメタデータの追加

JDBC 2.1 コア API で導入された java.sql 機能

• スクロール可能な結果セット -- 現在位置から特定の行または位置へのカーソルの相対的な移動を可能にする、ResultSet インタフェースの新しいメソッドを使用
• バッチ更新
• プログラムによる更新 -- ResultSet 更新用メソッドを使用
• 新しいデータ型 -- SQL3 データ型をマッピングするインタフェース
• ユーザー定義型 (UDT) のカスタムマッピング
• その他の機能として、パフォーマンスのヒント、文字ストリームの使用、java.math.BigDecimal 値の全精度、追加セキュリティー、日、時間、およびタイムスタンプの各値でのタイムゾーンのサポートなど。

JDBC 2.0 オプションパッケージ API で導入された javax.sql 機能

• 接続を確立するための手段としての DataSource インタフェース。Java Naming and Directory Interface^TM (JNDI) は DataSource オブジェクトをネームサービスに登録し、それを取得するのに使用する。
• プール接続 -- 接続の使用と再利用を可能にする
• 分散トランザクション -- 多様な DBMS サーバーに及ぶトランザクションを可能にする
• RowSet テクノロジ -- データを処理して渡す便利な手段を提供する

UDT のカスタムマッピング

SQL で定義したユーザー定義型 (UDT) を Java プログラミング言語のクラスにマッピングできます。SQL 構造化型または SQL DISTINCT 型が、カスタムマッピングできる UDT です。次の 3 つのステップで、カスタムマッピングを設定します。

1. SQL 構造化型または SQL DISTINCT 型を SQL で定義します
2. SQL UDT をマッピングする Java プログラミング言語のクラスを定義します。このクラスは SQLData インタフェースを実装している必要があります。
3. 次の 2 項目を含む Connection オブジェクトの型マップにエントリを作成します。
   • UDT の完全指定された SQL 名
   • SQLData インタフェースを実装するクラスの Class オブジェクト

これらが UDT の該当位置にあると、ResultSet.getObject または CallableStatement.getObject メソッドを呼び出した場合に UDT は自動的に UDT へのカスタムマッピングを取得します。また、PreparedStatement.setObject は、オブジェクトをその SQL 型へ自動的にマッピングしてデータソースにオブジェクトを格納します。

パッケージの仕様

• 「JDBC 4.0 API の仕様」

関連項目

• 「JDBC API 入門」 -- 主なインタフェースの概要

• JDBC API の章 -- 「The Java Tutorial Continued」のオンラインバージョンより

• 「JDBC^TM API Tutorial and Reference, Third Edition」 -- JDBC 3.0 API の完全なリファレンスとチュートリアル

導入されたバージョン:

1.1