17.4.7 DatabaseMetaDataインタフェース
- 〈この項の構成〉
(1) 概要
DatabaseMetaDataインタフェースでは,主に次の機能が提供されます。
-
接続先のDBに関する各種情報の返却
-
表一覧,列一覧などの一覧情報の返却(ResultSet(結果セット)に格納)
DatabaseMetaDataクラスのメソッドには,Stringのパターン文字列を引数とするものがあります。このパターン文字列中に指定できる特殊文字を次に示します。
特殊文字 |
説明 |
---|---|
_(下線) |
任意の1文字です。 |
% |
0文字以上の任意の長さの文字列です。 |
\ |
エスケープ文字です。パターン文字列中に記述したエスケープ文字の直後の特殊文字を通常の文字として扱います。 |
(2) メソッド
DatabaseMetaDataインタフェースのメソッド一覧を次の表に示します。なお,表に記載されていないメソッドはサポートしていません。サポートしていないメソッドを指定すると,SQLExceptionを投入します。
メソッド |
提供ドライバ |
機能 |
||
---|---|---|---|---|
JDBC2.0 |
JDBC4.0 |
JDBC4.3 |
||
○ |
○ |
○ |
getProcedures()メソッドによって返されるすべてのプロシジャが,現在のユーザから呼び出せるかどうかを返します。 |
|
○ |
○ |
○ |
getTables()メソッドによって返されるすべてのテーブルが,現在のユーザによって使用できるかどうかを返します。 |
|
○ |
○ |
○ |
トランザクションのデータ定義文が,トランザクションを強制的にコミットさせるかどうかを返します。 |
|
○ |
○ |
○ |
トランザクションでデータ定義文が無視されるかどうかを返します。 |
|
○ |
○ |
○ |
ResultSet.rowDeleted()メソッドを呼び出すことによって,可視の行が削除されたことを検出できるかどうかを返します。 |
|
○ |
○ |
○ |
getMaxRowSize()メソッドに,SQLデータ型のLONGVARCHAR及びLONGVARBINARYを含んでいるかどうか返します。 |
|
○ |
○ |
○ |
指定されたスキーマ,及びカタログで使用できるユーザ定義の型のための,属性に関する記述を返します。 |
|
getBestRowIdentifier(String catalog, String schema, String table, int scope, boolean nullable) |
○ |
○ |
○ |
行を一意に識別するテーブルの,最適な列セットに関する記述を返します。 |
○ |
○ |
○ |
使用できるカタログ名を返します。 |
|
○ |
○ |
○ |
カタログ名とテーブル名のセパレータを返します。 |
|
○ |
○ |
○ |
"catalog"に対する推奨用語を返します。 |
|
getColumnPrivileges (String catalog,String schema,String table,String columnNamePattern) |
○ |
○ |
○ |
テーブルの列へのアクセス権に関する記述を返します。 |
getColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern) |
○ |
○ |
○ |
指定されたテーブル列の記述を返します。※1 |
○ |
○ |
○ |
このDatabaseMetaDataインスタンスを生成したConnectionインスタンスを返します。 |
|
○ |
○ |
○ |
指定された参照テーブルと指定された被参照テーブルとのクロスリファレンス情報を返します。 |
|
○ |
○ |
○ |
データベースのメジャーバージョンを返します。 |
|
○ |
○ |
○ |
データベースのマイナーバージョンを返します。 |
|
○ |
○ |
○ |
接続データベースの製品名称を返します。 |
|
○ |
○ |
○ |
接続データベースのバージョンを返します。 |
|
○ |
○ |
○ |
デフォルトのトランザクション遮断レベルを返します。 |
|
○ |
○ |
○ |
このJDBCドライバのメジャーバージョンをint型で返します。 |
|
○ |
○ |
○ |
このJDBCドライバのマイナーバージョンをint型で返します。 |
|
○ |
○ |
○ |
JDBCドライバの名前を返します。 |
|
○ |
○ |
○ |
このJDBCドライバのバージョンをStringとして返します。 |
|
○ |
○ |
○ |
指定されたテーブルの外部キーに関する情報を返します。 |
|
○ |
○ |
○ |
引用符で囲まれていないSQL識別名に使用できるすべての特殊文字(a-z,A-Z,0-9,及び_以外)を返します。 |
|
○ |
○ |
○ |
SQL識別子を引用するために使用する文字列を返します。 |
|
○ |
○ |
○ |
指定されたテーブルの主キーに関する情報を返します。 |
|
getIndexInfo(String catalog, String schema, String table, boolean unique, boolean approximate) |
○ |
○ |
○ |
指定されたテーブルのインデクスに関する記述を返します。 |
○ |
○ |
○ |
ドライバのJDBCメジャーバージョンを返します。 |
|
○ |
○ |
○ |
ドライバのJDBCマイナーバージョンを返します。 |
|
○ |
○ |
○ |
バイナリリテラル中に入れられる16進数の最大文字数を返します。 |
|
○ |
○ |
○ |
カタログ名の最大文字数を返します。 |
|
○ |
○ |
○ |
キャラクタリテラルの最大文字数を返します。 |
|
○ |
○ |
○ |
列名の最大文字数を返します。 |
|
○ |
○ |
○ |
GROUP BY節中の列数の最大値を返します。 |
|
○ |
○ |
○ |
インデクス中で許される列数の最大値を返します。 |
|
○ |
○ |
○ |
ORDER BY節中の列数の最大値を返します。 |
|
○ |
○ |
○ |
SELECTリスト中の列数の最大値を返します。 |
|
○ |
○ |
○ |
テーブル中の列数の最大値を返します。 |
|
○ |
○ |
○ |
現在の接続の最大数を返します。 |
|
○ |
○ |
○ |
カーソル名の最大文字数を返します。 |
|
○ |
○ |
○ |
インデクスの全部分を含む,インデクスの最大長を返します。 |
|
○ |
○ |
○ |
プロシジャ名の最大文字数を返します。 |
|
○ |
○ |
○ |
1行の最大バイト数を返します。 |
|
○ |
○ |
○ |
スキーマ名の最大文字数を返します。 |
|
○ |
○ |
○ |
SQL文の最大長を返します。 |
|
○ |
○ |
○ |
アクティブにできるSQL文の最大数を返します。 |
|
○ |
○ |
○ |
テーブル名の最大文字数を返します。 |
|
○ |
○ |
○ |
SELECT文中の最大テーブル数を返します。 |
|
○ |
○ |
○ |
ユーザ名の最大文字数を返します。 |
|
○ |
○ |
○ |
数学関数を,コンマで区切ったリストで返します。 |
|
○ |
○ |
○ |
指定されたテーブルの主キー列の記述を返します。 |
|
○ |
○ |
○ |
ストアドプロシジャパラメタに関する記述を返します。※2 |
|
getProcedures(String catalog,String schemaPattern,String procedureNamePattern) |
○ |
○ |
○ |
ストアドプロシジャに関する記述を返します。※3 |
○ |
○ |
○ |
"procedure"に対する推奨用語を返します。 |
|
○ |
○ |
○ |
ResultSetオブジェクトの保持機能を返します。 |
|
○ |
○ |
○ |
使用できるスキーマ名に関する情報を返します。※4 |
|
○ |
○ |
○ |
"schema"に対する推奨用語を返します。 |
|
○ |
○ |
○ |
ワイルドカード文字をエスケープするために使用する文字列を返します。 |
|
○ |
○ |
○ |
データベース固有のSQLキーワードであり,かつSQL92のキーワードではないすべてのキーワードを,コンマで区切ったリストで返します。 |
|
○ |
○ |
○ |
SQLException.getSQLStateによって返されるSQLSTATEが,X/OpenのSQL CLIであるかSQL99であるかを返します。 |
|
○ |
○ |
○ |
文字列関数を,コンマで区切ったリストで返します。 |
|
getSuperTables(String catalog,String schemaPattern,String tableNamePattern) |
○ |
○ |
○ |
特定のスキーマで定義されているテーブル階層の説明を返します。 |
getSuperTypes(String catalog,String schemaPattern,String typeNamePattern) |
○ |
○ |
○ |
特定のスキーマで定義されているユーザ定義型階層の説明を返します。 |
○ |
○ |
○ |
使用できるシステム関数を返します。 |
|
getTablePrivileges(String catalog,String schemaPattern,String tableNamePattern) |
○ |
○ |
○ |
テーブルのアクセス権に関する記述を返します。 |
getTables(String catalog, String schemaPattern, String tableNamePattern, String[] types) |
○ |
○ |
○ |
テーブルに関する記述を返します。 |
○ |
○ |
○ |
使用できるテーブルの型を返します。 |
|
○ |
○ |
○ |
使用できる時間関数と日付関数をコンマで区切ったリストを返します。 |
|
○ |
○ |
○ |
標準SQLの型に関する記述を返します。 |
|
getUDTs(String catalog,String schemaPattern,String typeNamePattern,int[] types) |
○ |
○ |
○ |
ユーザ定義型に関する情報を返します。 |
○ |
○ |
○ |
HiRDB又はXDM/RD E2に接続したURLを返します。 |
|
○ |
○ |
○ |
HiRDB又はXDM/RD E2に接続する際に使用したユーザ名を返します。 |
|
getVersionColumns(String catalog,String schema,String table) |
○ |
○ |
○ |
テーブル中の行が更新された場合に,自動的に更新されるテーブルの列に関する記述を返します。 |
○ |
○ |
○ |
ResultSet.rowInserted()メソッドを呼び出すことによって,可視の行が挿入されたことを検出できるかどうかを返します。 |
|
○ |
○ |
○ |
完全修飾されたテーブル名の開始部分(又は終了部分)に,カタログが現れるかどうかを返します。 |
|
○ |
○ |
○ |
データベースが読み込み専用モードかどうかを返します。 |
|
○ |
○ |
○ |
LOBへの変更が,コピーに対して行われたのか,LOBに直接行われたのかを示します。 |
|
○ |
○ |
○ |
NULL値と非NULL値の連結を,NULLとするかどうかを返します。 |
|
○ |
○ |
○ |
NULL値が,終了時にソート順に関係なくソートされるかどうかを返します。 |
|
○ |
○ |
○ |
NULL値が,開始時にソート順に関係なくソートされるかどうかを返します。 |
|
○ |
○ |
○ |
NULL値が高位にソートされるかどうかを返します。 |
|
○ |
○ |
○ |
NULL値が下位にソートされるかどうかを返します。 |
|
○ |
○ |
○ |
ほかで行われた削除が可視かどうかを返します。 |
|
○ |
○ |
○ |
ほかで行われた挿入が可視かどうかを返します。 |
|
○ |
○ |
○ |
ほかで行われた削除が可視かどうかを返します。 |
|
○ |
○ |
○ |
結果セット自身の削除が可視かどうかを返します。 |
|
○ |
○ |
○ |
結果セット自身の挿入が可視かどうかを返します。 |
|
○ |
○ |
○ |
結果セット自身の更新が可視かどうかを返します。 |
|
○ |
○ |
○ |
大文字と小文字が混在する引用符なしのSQL識別子を,大文字と小文字を区別しないで処理し,小文字で格納するかどうかを返します。 |
|
○ |
○ |
○ |
大文字と小文字が混在する引用符付きのSQL識別子を,大文字と小文字を区別しないで処理し,小文字で格納するかどうかを返します。 |
|
○ |
○ |
○ |
大文字と小文字が混在する引用符なしのSQL識別子を,大文字と小文字を区別しないで処理し,大文字と小文字を混在して格納するかどうかを返します。 |
|
○ |
○ |
○ |
大文字と小文字が混在する引用符付きのSQL識別子を,大文字と小文字を区別しないで処理し,大文字と小文字を混在して格納するかどうかを返します。 |
|
○ |
○ |
○ |
大文字と小文字が混在する引用符なしのSQL識別子を,大文字と小文字を区別しないで処理し,大文字で格納するかどうかを返します。 |
|
○ |
○ |
○ |
大文字と小文字が混在する引用符付きのSQL識別子を,大文字と小文字を区別しないで処理し,大文字で格納するかどうかを返します。 |
|
○ |
○ |
○ |
追加列のあるALTER TABLEが,サポートされているかどうかを返します。 |
|
○ |
○ |
○ |
ドロップ列のあるALTER TABLEが,サポートされているかどうかを返します。 |
|
○ |
○ |
○ |
ANSI92エントリレベルのSQL文法が,サポートされるかどうかを返します。 |
|
○ |
○ |
○ |
ANSI92完全レベルのSQL文法が,サポートされるかどうかを返します。 |
|
○ |
○ |
○ |
ANSI92中間レベルのSQL文法が,サポートされるかどうかを返します。 |
|
○ |
○ |
○ |
バッチ更新をサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
データ操作文でカタログ名を使用できるかどうかを返します。 |
|
○ |
○ |
○ |
インデクス定義文でカタログ名を使用できるかどうかを返します。 |
|
○ |
○ |
○ |
特権定義文でカタログ名を使用できるかどうかを返します。 |
|
○ |
○ |
○ |
プロシジャ呼び出し文でカタログ名を使用できるかどうかを返します。 |
|
○ |
○ |
○ |
テーブル定義文でカタログ名を使用できるかどうかを返します。 |
|
○ |
○ |
○ |
カラムの別名をサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
SQLタイプ間のCONVERT関数をサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
与えられたSQLタイプ間のCONVERT関数をサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
ODBC Core SQL文法をサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
照合関連サブクエリーをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
トランザクションで,データ定義文とデータ操作文の両方をサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
トランザクションで,データ操作文だけをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
テーブル相互関連名がサポートされている場合,テーブルの名前と異なる名前にするという制限があるかどうかを返します。 |
|
○ |
○ |
○ |
"ORDER BY"リスト中の式をサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
ODBC Extended SQL文法をサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
完全ネストの外部結合をサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
文が実行された後に自動生成キーを取得できるかどうかを返します。 |
|
○ |
○ |
○ |
"GROUP BY"節のフォームをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
SELECT中のすべてのカラムを指定するという条件で,"GROUP BY"節がSELECT中にないカラムを使用できるかどうかを返します。 |
|
○ |
○ |
○ |
"GROUP BY"節が,SELECT中にないカラムを使用できるかどうかを返します。 |
|
○ |
○ |
○ |
SQL Integrity Enhancement Facilityをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
"LIKE"節で,エスケープ文字をサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
外部結合に関し,制限されたサポートがあるかどうかを返します。 |
|
○ |
○ |
○ |
ODBC Minimum SQL文法をサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
大文字と小文字が混在する引用符なしのSQL識別子を,大文字と小文字を区別して処理し,結果として大文字と小文字を混在して格納するかどうかを返します。 |
|
○ |
○ |
○ |
大文字と小文字が混在する引用符付きのSQL識別子を,大文字と小文字を区別して処理し,結果として大文字と小文字を混在して格納するかどうかを返します。 |
|
○ |
○ |
○ |
CallableStatementオブジェクトから同時に返された複数のResultSetオブジェクトを持つことが可能かどうかを返します。 |
|
○ |
○ |
○ |
単一のexecuteメソッド実行からの複数ResultSetをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
一度に複数のトランザクションを(異なった接続に関し)オープンできるかどうかを返します。 |
|
○ |
○ |
○ |
callable文への名前付きパラメータがサポートされるかどうかを返します。 |
|
○ |
○ |
○ |
列を非nullとして定義できるかどうかを返します。 |
|
○ |
○ |
○ |
カーソルをコミット間でオープンされた状態のままにできるかどうかを返します。 |
|
○ |
○ |
○ |
カーソルをロールバック間でオープンされた状態のままにできるかどうかを返します。 |
|
○ |
○ |
○ |
文をコミット間でオープンされた状態のままにできるかどうかを返します。 |
|
○ |
○ |
○ |
文をロールバック間でオープンされた状態のままにできるかどうかを返します。 |
|
○ |
○ |
○ |
"ORDER BY"節が,SELECT中にない列を使用できるかどうかを返します。 |
|
○ |
○ |
○ |
何らかの外部結合のフォームをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
位置決めされたDELETEをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
位置決めされたUPDATEをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
指定されたResultSetタイプと並行処理タイプの組み合わせをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
指定されたResultSetオブジェクトの保持機能を,サポートしているかどうかを返します。 |
|
○ |
○ |
○ |
指定されたResultSetタイプをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
セーブポイントをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
データ操作文でスキーマ名を使用できるかどうかを返します。 |
|
○ |
○ |
○ |
インデクス定義文でスキーマ名を使用できるかどうかを返します。 |
|
○ |
○ |
○ |
特権定義文でスキーマ名を使用できるかどうかを返します。 |
|
○ |
○ |
○ |
プロシジャ呼び出し文でスキーマ名を使用できるかどうかを返します。 |
|
○ |
○ |
○ |
テーブル定義文でスキーマ名を使用できるかどうかを返します。 |
|
○ |
○ |
○ |
UPDATE用のSELECTをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
文のプールをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
ストアドプロシジャコールをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
比較式中でサブクエリーをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
"exists"式中でサブクエリーをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
"in"文中でサブクエリーをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
定量化された式中でサブクエリーをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
テーブル相互関連名をサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
与えられたトランザクションアイソレーションレベルをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
トランザクションをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
SQL UNIONをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
SQL UNION ALLをサポートしているかどうかを返します。 |
|
○ |
○ |
○ |
指定されたResultSetタイプで,ResultSetに行われた更新をResultSet.rowUpdatedメソッドによって検出できるかどうかを返します。 |
|
○ |
○ |
○ |
各テーブルにファイルを使用するかどうかを返します。 |
|
○ |
○ |
○ |
ローカルファイルにテーブルを格納するかどうかを返します。 |
|
× |
○ |
○ |
RowId型をサポートしているかどうかを返します。RowId型をサポートしている場合は,RowIdオブジェクトが有効になっている寿命を返します。 |
|
× |
○ |
○ |
使用できるスキーマ名に関する情報を返します。 |
|
× |
○ |
○ |
プロシジャエスケープ構文を使用した,ユーザ定義関数又はベンダー関数の呼び出しをサポートするかどうかを返します。 |
|
× |
○ |
○ |
オートコミット有効時にSQLExceptionが発生した場合,オープンされたすべてのResultSetがクローズされるかどうかを返します。 |
|
× |
○ |
○ |
JDBCドライバがサポートするクライアント情報プロパティのリスト情報を取得します。 |
|
getFunctions(String catalog, String schemaPattern, String functionNamePattern) |
× |
○ |
○ |
関数に関する情報を返します。 |
× |
○ |
○ |
関数のパラメタと返される型に関する情報を返します。 |
|
× |
× |
○ |
擬似列,隠し列の説明を返します。 |
|
× |
× |
○ |
自動生成キーの列を表す指定された列名又はインデックスが有効であり,SQL文が成功した場合に生成されたキーが常に返されるかどうかを返します。 |
|
× |
× |
○ |
このデータベースでLOBの論理サイズとして許容される最大バイト数を返します。 |
|
× |
× |
○ |
REF CURSORのサポート有無を返します。 |
|
× |
× |
○ |
シャーディングのサポート有無を返します。 |
- (凡例)
-
○:提供されます。
×:提供されません。
- 注※1
-
JDBC2.0とJDBC4.0以降とでは,次のような差異があります。
-
返却されるResultSetの列数がJDBC4.0以降ではJDBC2.0よりも多い
-
- 注※2
-
JDBC2.0とJDBC4.0以降とでは,次のような差異があります。
-
返却されるResultSetの列数がJDBC4.0以降ではJDBC2.0よりも多い
-
返却されるPRECISION及びLENGTH列の値が異なる
-
SQL_ROUTINES表,又はSQL_ROUTINE_PARAMS表が存在しないためディクショナリ検索でエラーになった場合,JDBC2.0ではSQLExceptionが返却されるが,JDBC4.0以降では検索結果行数0のResultSetが返却される
-
JDBC2.0ではプロシジャ及び関数のパラメタ情報が返却されるが,JDBC4.0以降ではプロシジャのパラメタ情報だけが返却される
-
- 注※3
-
JDBC2.0とJDBC4.0以降では,次のような差異があります。
-
返却されるResultSetの列数がJDBC4.0以降ではJDBC2.0よりも多い
-
SQL_ROUTINES表,又はSQL_ROUTINE_PARAMS表が存在しないためディクショナリ検索でエラーになった場合,JDBC2.0ではSQLExceptionが返却されるが,JDBC4.0以降では検索結果行数0のResultSetが返却される
-
JDBC2.0ではプロシジャ及び関数のパラメタ情報が返却されるが,JDBC4.0以降ではプロシジャのパラメタ情報だけが返却される
-
- 注※4
-
JDBC2.0とJDBC4.0以降では,次のような差異があります。
-
JDBC2.0では表を所有するスキーマが返却されるが,JDBC4.0以降ではすべてのスキーマが返却される
-
(a) allProceduresAreCallable()
- 【機能】
-
getProcedures()メソッドによって返されるすべてのプロシジャが,現在のユーザから呼び出せるかどうかを返します。
- 【形式】
public boolean allProceduresAreCallable() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:呼び出せます。
false:呼び出せません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(b) allTablesAreSelectable()
- 【機能】
-
getTables()メソッドによって返されるすべてのテーブルが,現在のユーザによって使用できるかどうかを返します。
- 【形式】
public boolean allTablesAreSelectable() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:使用できます。
false:使用できません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(c) dataDefinitionCausesTransactionCommit()
- 【機能】
-
トランザクションのデータ定義文が,トランザクションを強制的にコミットさせるかどうかを返します。
- 【形式】
public boolean dataDefinitionCausesTransactionCommit() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:コミットさせます。
false:コミットさせません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(d) dataDefinitionIgnoredInTransactions()
- 【機能】
-
トランザクションでデータ定義文が無視されるかどうかを返します。
- 【形式】
public boolean dataDefinitionIgnoredInTransactions() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:無視されます。
false:無視されません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(e) deletesAreDetected(int type)
- 【機能】
-
ResultSet.rowDeleted()メソッドを呼び出すことによって,可視の行が削除されたことを検出できるかどうかを返します。
- 【形式】
public boolean deletesAreDetected(int type) throws SQLException
- 【引数】
-
- int type:
-
ResultSetの型。次のどれかです。
-
ResultSet.TYPE_FORWARD_ONLY
-
ResultSet.TYPE_SCROLL_INSENSITIVE
-
ResultSet.TYPE_SCROLL_SENSITIVE
-
- 【戻り値】
-
- boolean型:
-
true:削除が検出されます。
false:削除が検出されません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(f) doesMaxRowSizeIncludeBlobs()
- 【機能】
-
getMaxRowSize()メソッドに,SQLデータ型のLONGVARCHAR及びLONGVARBINARYを含んでいるかどうか返します。
- 【形式】
public boolean doesMaxRowSizeIncludeBlobs() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:含んでいます。
false:含んでいません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(g) getAttributes(String catalog,String schemaPattern,String typeNamePattern,String attributeNamePattern)
- 【機能】
-
指定されたスキーマ,及びカタログで使用できるユーザ定義の型のための,属性に関する記述を返します。
- 【形式】
public ResultSet getAttributes(String catalog, String schemaPattern, String typeNamePattern, String attributeNamePattern) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名
- String schemaPattern:
-
スキーマ名パターン
- String typeNamePattern:
-
型名パターン
- String attributeNamePattern:
-
属性名パターン
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
Type4 JDBCドライバでは,ユーザ定義の型は未サポートのため,常に検索結果行数0のResultSetを返します。すべての引数について妥当性チェックを行いません。返却するResultSetの形式を次に示します。
列番号
型
SQL型(Types)
列名
列の意味
1
String
CHAR
TYPE_CAT
カタログ名
2
String
VARCHAR
TYPE_SCHEM
認可識別子名
3
String
VARCHAR
TYPE_NAME
型名
4
String
VARCHAR
ATTR_NAME
属性名
5
int
INTEGER
DATA_TYPE
属性の型
6
String
VARCHAR
ATTR_TYPE_NAME
型名
7
int
INTEGER
ATTR_SIZE
列サイズ
8
int
INTEGER
DECIMAL_DIGITS
小数点以下のけた数
9
int
INTEGER
NUM_PREC_RADIX
基数
10
int
INTEGER
NULLABLE
NULL値の可否
11
String
VARCHAR
REMARKS
コメント
12
String
VARCHAR
ATTR_DEF
デフォルト値
13
int
INTEGER
SQL_DATA_TYPE
未使用
14
int
INTEGER
SQL_DATETIME_SUB
未使用
15
int
INTEGER
CHAR_OCTET_LENGTH
char型列の最大バイト数
16
int
INTEGER
ORDINAL_POSITION
テーブル中の列のインデクス
17
String
VARCHAR
IS_NULLABLE
NULL値の可否
18
String
VARCHAR
SCOPE_CATALOG
参照属性のスコープであるテーブルのカタログ
19
String
VARCHAR
SCOPE_SCHEMA
参照属性のスコープであるテーブルのスキーマ
20
String
VARCHAR
SCOPE_TABLE
参照属性のスコープであるテーブル名
21
short
SMALLINT
SOURCE_DATA_TYPE
個別の型又はユーザ生成Ref型,java.sql.TypesのSQL型のソースの型
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(h) getBestRowIdentifier(String catalog, String schema, String table, int scope, boolean nullable)
- 【機能】
-
行を一意に識別するテーブルの,最適な列セットに関する記述を返します。
- 【形式】
public ResultSet getBestRowIdentifier(String catalog, String schema, String table, int scope, boolean nullable) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名
- String schema:
-
スキーマ名
- String table:
-
テーブル名
- int scope:
-
対象のスケール
- boolean nullable:
-
NULL値指定
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
すべての引数について妥当性チェックを行いません。常に検索結果行数0のResultSetを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(i) getCatalogs()
- 【機能】
-
使用できるカタログ名を返します。
- 【形式】
public ResultSet getCatalogs() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
常に検索結果行数0のResultSetを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(j) getCatalogSeparator()
- 【機能】
-
カタログ名とテーブル名のセパレータを返します。
- 【形式】
public String getCatalogSeparator() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【機能詳細】
-
nullを返します。
システムプロパティHiRDB_for_Java_METADATA_BEHAVIORにCAT_SEP_EMPTYが指定されている場合,空文字("")を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(k) getCatalogTerm()
- 【機能】
-
"catalog"に対する推奨用語を返します。
- 【形式】
public String getCatalogTerm() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【機能詳細】
-
常にnullを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(l) getColumnPrivileges (String catalog,String schema,String table,String columnNamePattern)
- 【機能】
-
テーブルの列へのアクセス権に関する記述を返します。
- 【形式】
public ResultSet getColumnPrivileges(String catalog, String schema, String table, String columnNamePattern) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名。このドライバでは無視します。
- String schema:
-
スキーマ名パターン。null又は0長文字列を指定している場合,スキーマ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- String table:
-
テーブル名パターン。null又は0長文字列を指定している場合,テーブル名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- String columnNamePattern:
-
列名パターン。null又は0長文字列を指定している場合,列名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
指定されたテーブル列が属する表のアクセス権に関する記述を返します。返却するResultSetの形式を次に示します。
列番号
型
SQL型(Types)
列名
ソート※
列の意味
1
String
CHAR
TABLE_CAT
−
カタログ名
常にNULL値を返します。
2
String
VARCHAR
TABLE_SCHEM
1(昇順)
認可識別子名
3
String
VARCHAR
TABLE_NAME
2(昇順)
テーブル名
4
String
VARCHAR
COLUMN_NAME
3(昇順)
列名
5
String
VARCHAR
GRANTOR
−
アクセス権の付与者
6
String
VARCHAR
GRANTEE
−
アクセス権の被付与者
7
String
VARCHAR
PRIVILEGE
4(昇順)
許可されているアクセス権限名。複数のアクセス権限を許可されている場合は,コンマ(,)で区切って返します。
SELECT:SELECT権限
INSERT:INSERT権限
UPDATE:UPDATE権限
DELETE:DELETE権限
8
String
VARCHAR
IS_GRANTABLE
−
アクセス権の被付与者が,別のユーザにアクセス権を与えることができるかを表します。
YES:与えることができます。
NO:与えることができません。
null:与えることができるかどうか不明です。
PRIVILEGEに設定されたアクセス権限が複数ある場合,その内の一つ以上のアクセス権限を別のユーザに与えることができれば,YESを設定します。HiRDB,XDM/RD E2共に,nullは返しません。
- (凡例)
-
−:該当しません。
- 注※
-
ソートのキー列の優先順位を示します。
- 【発生する例外】
-
次のどちらかの場合,例外SQLExceptionを投入します。
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行した場合
-
データベースアクセスエラーが発生した場合
-
(m) getColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern)
- 【機能】
-
指定されたテーブル列の記述を返します。
- 【形式】
public ResultSet getColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名(このドライバでは無視します)
- String schemaPattern:
-
スキーマ名パターン(大文字と小文字を区別します)
- String tableNamePattern:
-
テーブル名パターン(大文字と小文字を区別します)
- String columnNamePattern:
-
列名パターン(大文字と小文字を区別します)
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
指定されたテーブル列の記述を返します。返却するResultSetの形式を次の表に示します。
表17‒47 getColumnsで返却するResultSetの形式 列番号
型
SQL型(Types)
列名
列の意味
ドライバが返却する列
JDBC2.0
JDBC4.0以降
1
String
CHAR
TABLE_CAT
常にNULL値を返します。
○
○
2
String
VARCHAR
TABLE_SCHEM
認可識別子名
○
○
3
String
VARCHAR
TABLE_NAME
テーブル名
○
○
4
String
VARCHAR
COLUMN_NAME
列名
○
○
5
int
INTEGER
DATA_TYPE
SQLの型
○
○
6
String
CHAR
TYPE_NAME
型名
○
○
7
int
INTEGER
COLUMN_SIZE
列サイズ
○
○
8
int
INTEGER
BUFFER_LENGTH
常にNULL値を返します。
○
○
9
int
INTEGER
DECIMAL_DIGITS
小数点以下のけた数
○
○
10
int
INTEGER
NUM_PREC_RADIX
基数
-
概数値:2
-
真数値:10
-
数値以外:0
○
○
11
int
INTEGER
NULLABLE
この型にNULL値を使用できるかどうかを返します。
-
columnNoNulls:NULL値を使用できない可能性があります。
-
columnNullable:NULL値を使用できます。
-
columnNullableUnknown:NULL値を使用できるか不明です。
○
○
12
String
VARCHAR
REMARKS
コメント記述列
○
○
13
String
VARCHAR
COLUMN_DEF
デフォルト値
○
○
14
int
INTEGER
SQL_DATA_TYPE
常にNULL値を返します。
○
○
15
int
INTEGER
SQL_DATETIME_SUB
常にNULL値を返します。
○
○
16
int
INTEGER
CHAR_OCTET_LENGTH
charの型についての列の最大バイト数
COLUMN_SIZEと同じです。
○
○
17
int
SMALLINT
ORDINAL_POSITION
列番号
1から始まります。
○
○
18
String
CHAR
IS_NULLABLE
この型にNULL値が使用できるかどうかを返します。
-
"NO":NULL値を使用できません。
-
"YES":NULL値を使用できる可能性があります。
○
○
19
String
CHAR
SCOPE_CATLOG
常にNULL値を返します。
○
○
20
String
CHAR
SCOPE_SCHEMA
常にNULL値を返します。
○
○
21
String
CHAR
SCOPE_TABLE
常にNULL値を返します。
○
○
22
short
SMALLINT
SOURCE_DATA_TYPE
常にNULL値を返します。
○
○
23
String
VARCHAR
IS_AUTOINCREMENT
列が自動インクリメントされるかどうかを示します。
-
"YES":列が自動インクリメントされます。
-
"NO":列が自動インクリメントされません。
-
空白:列が自動インクリメントされるか不明です。
常にNOを返します。
×
○
- (凡例)
-
○:返却されます。
×:返却されません。
-
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(n) getConnection()
- 【機能】
-
このDatabaseMetaDataインスタンスを生成したConnectionインスタンスを返します。
- 【形式】
public Connection getConnection() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Connenctionオブジェクト
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(o) getCrossReference (String primaryCatalog,String primarySchema,String primaryTable,String foreignCatalog,String foreignSchema,String foreignTable)
- 【機能】
-
指定された参照テーブルと指定された被参照テーブルとのクロスリファレンス情報を返します。
- 【形式】
public ResultSet getCrossReference(String primaryCatalog, String primarySchema, String primaryTable, String foreignCatalog, String foreignSchema, String foreignTable) throws SQLException
- 【引数】
-
- String primaryCatalog:
-
被参照テーブルのカタログ名。このドライバでは無視します。
- String primarySchema:
-
被参照テーブルのスキーマ名パターン。null又は0長文字列を指定している場合,スキーマ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- String primaryTable:
-
被参照テーブルのテーブル名パターン。null又は0長文字列を指定している場合,テーブル名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- String foreignCatalog:
-
参照テーブルのカタログ名。このドライバでは無視します。
- String foreignSchema:
-
参照テーブルのスキーマ名パターン。null又は0長文字列を指定している場合,スキーマ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- String foreignTable:
-
参照テーブルのテーブル名パターン。null又は0長文字列を指定している場合,テーブル名を検索の限定に使用しません。引数の値は大文字小文字を区別します。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
指定された参照テーブルと指定された被参照テーブルとのクロスリファレンス情報を返します。返却するResultSetの形式を次に示します。
列番号
型
SQL型(Types)
列名
ソート※
列の意味
1
String
CHAR
PKTABLE_CAT
−
被参照テーブルのカタログ名。
常にNULL値を返します。
2
String
VARCHAR
PKTABLE_SCHEM
−
被参照テーブルの認可識別子名。
3
String
VARCHAR
PKTABLE_NAME
−
被参照テーブルのテーブル名。
4
String
VARCHAR
PKCOLUMN_NAME
−
主キーの列名。
5
String
CHAR
FKTABLE_CAT
−
参照テーブルのカタログ名。
常にNULL値を返します。
6
String
VARCHAR
FKTABLE_SCHEM
1(昇順)
参照テーブルの認可識別子名。
7
String
VARCHAR
FKTABLE_NAME
2(昇順)
参照テーブルのテーブル名。
8
String
VARCHAR
FKCOLUMN_NAME
−
外部キーの列名。
9
short
SMALLINT
KEY_SEQ
3(昇順)
外部キーのシーケンス番号。
10
short
SMALLINT
UPDATE_RULE
−
更新規則。
主キーを参照している外部キーが存在する場合に,主キーを更新すると,それを参照している外部キーがどのような影響を受けるのかを表します。
-
importedKeyNoAction
主キーは更新できません。
-
importedKeyCascade
主キーと同じ値で,外部キーを更新します。
-
importedKeySetNull
外部キーの値がNULLになります。
-
importedKeySetDefault
外部キーの値がデフォルト値になります。
-
importedKeyRestrict
主キーは更新できません。
11
short
SMALLINT
DELETE_RULE
−
削除規則。
主キーを参照している外部キーが存在する場合に,主キーを削除すると,それを参照している外部キーがどのような影響を受けるのかを表します。
-
importedKeyNoAction
主キーを削除できません。
-
importedKeyCascade
外部キーがある行を,削除します。
-
importedKeySetNull
外部キーの値がNULLになります。
-
importedKeySetDefault
外部キーの値がデフォルト値になります。
-
importedKeyRestrict
主キーを削除できません。
12
String
VARCHAR
FK_NAME
−
参照制約の制約名。
13
String
VARCHAR
PK_NAME
−
主キーのインデクス名。
14
short
SMALLINT
DEFERRABILITY
−
外部キーに対する制約の評価を,トランザクションのコミット時まで延期できるかを表します。
-
importedKeyInitiallyDeferred
延期できます。
-
importedKeyInitiallyImmediate
現時点では即時に評価されますが,延期できるように変更できます。
-
importedKeyNotDeferrable
延期できません。
- (凡例)
-
−:該当しません。
- 注※
-
ソートのキー列の優先順位を示します。
-
- 【発生する例外】
-
次のどちらかの場合,例外SQLExceptionを投入します。
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行した場合
-
データベースアクセスエラーが発生した場合
-
(p) getDatabaseMajorVersion()
- 【機能】
-
データベースのメジャーバージョンを返します。
- 【形式】
public int getDatabaseMajorVersion() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
データベースのメジャーバージョン
- 【機能詳細】
-
サーバがHiRDBの場合,HiRDBサーバのメジャーバージョンを返します。例えば,HiRDBサーバのバージョンが08-02の場合,int型の8を返します。
サーバがXDM/RD E2の場合,XDM/RD E2のメジャーバージョンに,20を加算した値を返します。この返却値は,JDBCドライバが出力するSQLトレースの,ヘッダ部に表示されるサーバのメジャーバージョンと同じです。例えば,XDM/RD E2のバージョンが11-03の場合,int型の31を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(q) getDatabaseMinorVersion()
- 【機能】
-
データベースのマイナーバージョンを返します。
- 【形式】
public int getDatabaseMinorVersion() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
データベースのマイナーバージョン
- 【機能詳細】
-
サーバがHiRDBの場合,HiRDBサーバのマイナーバージョンを返します。例えば,HiRDBサーバのバージョンが08-02の場合,int型の2を返します。
サーバがXDM/RD E2の場合,XDM/RD E2のマイナーバージョンを返します。例えば,XDM/RD E2のバージョンが11-03の場合,int型の3を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(r) getDatabaseProductName()
- 【機能】
-
接続データベースの製品名称を返します。
サーバがHiRDBの場合,"HiRDB"を返します。サーバがXDM/RD E2の場合,"XDM/RD E2"を返します。
- 【形式】
public String getDatabaseProductName() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(s) getDatabaseProductVersion()
- 【機能】
-
接続データベースのバージョンを返します。
- 【形式】
public String getDatabaseProductVersion() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【機能詳細】
-
サーバがHiRDBの場合,"vv-rr"(例:"08-00")の形式でHiRDBのバージョンを返します。
サーバがXDM/RD E2の場合,XDM/RD E2のバージョンに20を加算した値を,"vv-rr"の形式で返します。例えば,XDM/RD E2のバージョンが11-03の場合,"31-03"を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(t) getDefaultTransactionIsolation()
- 【機能】
-
デフォルトのトランザクション遮断レベルを返します。
- 【形式】
public int getDefaultTransactionIsolation() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
遮断レベル
- 【機能詳細】
-
常にTRANSACTION_REPEATABLE_READを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(u) getDriverMajorVersion()
- 【機能】
-
このJDBCドライバのメジャーバージョンをint型で返します。例えば,バージョンが08-00の場合,int型の8を返します。
- 【形式】
public int getDriverMajorVersion() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
JDBCドライバのメジャーバージョン
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(v) getDriverMinorVersion()
- 【機能】
-
このJDBCドライバのマイナーバージョンをint型で返します。例えば,バージョンが08-00の場合,int型の0を返します。
- 【形式】
public int getDriverMinorVersion() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
JDBCドライバのマイナーバージョン
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(w) getDriverName()
- 【機能】
-
JDBCドライバの名前を返します。
- 【形式】
public String getDriverName() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【機能詳細】
-
JDBCドライバの名前として,次のどれかを返却します。
-
JDBC2.0:HiRDB_Type4_JDBC_Driver
-
JDBC4.0:HiRDB_Type4_JDBC40_Driver
-
JDBC4.3:HiRDB_Type4_JDBC43_Driver
-
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(x) getDriverVersion()
- 【機能】
-
このJDBCドライバのバージョンをStringとして返します。例えば,バージョンが08-00の場合,String型の08-00を返します。
- 【形式】
public String getDriverVersion() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(y) getExportedKeys (String catalog,String schema,String table)
- 【機能】
-
主キー及び外部キーに関する情報を返します。
- 【形式】
public ResultSet getExportedKeys(String catalog,String schema,String table) throws SQLException
- 【引数】
-
- String catalog:
-
参照テーブルのカタログ名。このドライバでは無視します。
- String schema:
-
参照テーブルのスキーマ名パターン。null又は0長文字列を指定している場合,スキーマ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- String table:
-
参照テーブルのテーブル名パターン。null又は0長文字列を指定している場合,テーブル名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
指定されたテーブルの主キー及び当該主キーを参照する外部キーに関する情報を返します。
システムプロパティHiRDB_for_Java_CompatibleにALLが指定されている場合,指定されたテーブルの外部キー及び当該外部キーが参照する主キーに関する情報を返します。
返却するResultSetの形式を次に示します。
列番号
型
SQL型(Types)
列名
ソート※
列の意味
1
String
CHAR
PKTABLE_CAT
−
被参照テーブルのカタログ名。
常にNULL値を返します。
2
String
VARCHAR
PKTABLE_SCHEM
−
被参照テーブルの認可識別子名。
3
String
VARCHAR
PKTABLE_NAME
−
被参照テーブルのテーブル名。
4
String
VARCHAR
PKCOLUMN_NAME
−
主キーの列名。
5
String
CHAR
FKTABLE_CAT
−
参照テーブルのカタログ名。常にNULL値を返します。
6
String
VARCHAR
FKTABLE_SCHEM
1(昇順)
参照テーブルの認可識別子名。
7
String
VARCHAR
FKTABLE_NAME
2(昇順)
参照テーブルのテーブル名。
8
String
VARCHAR
FKCOLUMN_NAME
−
外部キーの列名。
9
short
SMALLINT
KEY_SEQ
3(昇順)
外部キーのシーケンス番号。
10
short
SMALLINT
UPDATE_RULE
−
更新規則。
主キーを参照している外部キーが存在する場合に,主キーを更新すると,それを参照している外部キーがどのような影響を受けるのかを表します。
-
importedKeyNoAction
主キーは更新できません。
-
importedKeyCascade
主キーと同じ値で,外部キーを更新します。
-
importedKeySetNull
外部キーの値がNULLになります。
-
importedKeySetDefault
外部キーの値がデフォルト値になります。
-
importedKeyRestrict
主キーは更新できません。
11
short
SMALLINT
DELETE_RULE
−
削除規則。
主キーを参照している外部キーが存在する場合に,主キーを削除すると,それを参照している外部キーがどのような影響を受けるのかを表します。
-
importedKeyNoAction
主キーを削除できません。
-
importedKeyCascade
外部キーがある行を削除します。
-
importedKeySetNull
外部キーの値がNULLになります。
-
importedKeySetDefault
外部キーの値がデフォルト値になります。
-
importedKeyRestrict
主キーを削除できません。
12
String
VARCHAR
FK_NAME
−
参照制約の制約名。
13
String
VARCHAR
PK_NAME
−
主キーのインデクス名。
14
short
SMALLINT
DEFERRABILITY
−
外部キーに対する制約の評価を,トランザクションのコミット時まで延期できるかを表します。
-
importedKeyInitiallyDeferred
延期できます。
-
importedKeyInitiallyImmediate
現時点では即時に評価されますが,延期できるように変更できます。
-
importedKeyNotDeferrable
延期できません。
- (凡例)
-
−:該当しません。
- 注※
-
ソートのキー列の優先順位を示します。
-
- 【発生する例外】
-
次のどちらかの場合,例外SQLExceptionを投入します。
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行した場合
-
データベースアクセスエラーが発生した場合
-
(z) getExtraNameCharacters()
- 【機能】
-
引用符で囲まれていないSQL識別名に使用できる特殊文字を返します。ただし,a-z,A-Z,0-9,及び_は除きます。
- 【形式】
public String getExtraNameCharacters() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【機能詳細】
-
常に\,@,及び#を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(aa) getIdentifierQuoteString()
- 【機能】
-
SQL識別子を引用するために使用する文字列を返します。
- 【形式】
public String getIdentifierQuoteString() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【機能詳細】
-
常に二重引用符(")を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ab) getImportedKeys (String catalog,String schema,String table)
- 【機能】
-
主キー及び外部キーに関する情報を返します。
- 【形式】
public ResultSet getImportedKeys(String catalog,String schema,String table) throws SQLException
- 【引数】
-
- String catalog:
-
被参照テーブルのカタログ名。このドライバでは無視します。
- String schema:
-
被参照テーブルのスキーマ名パターン。null又は0長文字列を指定している場合,スキーマ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- String table:
-
被参照テーブルのテーブル名パターン。null又は0長文字列を指定している場合,テーブル名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
指定されたテーブルの外部キー及び当該外部キーが参照する主キーに関する情報を返します。
システムプロパティHiRDB_for_Java_CompatibleにALLが指定されている場合,指定されたテーブルの主キー及び当該主キーを参照する外部キーに関する情報を返します。
返却するResultSetの形式を次に示します。
列番号
型
SQL型(Types)
列名
ソート※
列の意味
1
String
CHAR
PKTABLE_CAT
−
被参照テーブルのカタログ名。
常にNULL値を返します。
2
String
VARCHAR
PKTABLE_SCHEM
1(昇順)
被参照テーブルの認可識別子名。
3
String
VARCHAR
PKTABLE_NAME
2(昇順)
被参照テーブルのテーブル名。
4
String
VARCHAR
PKCOLUMN_NAME
−
主キーの列名。
5
String
CHAR
FKTABLE_CAT
−
参照テーブルのカタログ名。
常にNULL値を返します。
6
String
VARCHAR
FKTABLE_SCHEM
−
参照テーブルの認可識別子名。
7
String
VARCHAR
FKTABLE_NAME
−
参照テーブルのテーブル名。
8
String
VARCHAR
FKCOLUMN_NAME
−
外部キーの列名。
9
short
SMALLINT
KEY_SEQ
3(昇順)
外部キーのシーケンス番号。
10
short
SMALLINT
UPDATE_RULE
−
更新規則。
主キーを参照している外部キーが存在する場合に,主キーを更新すると,それを参照している外部キーがどのような影響を受けるのかを表します。
-
importedKeyNoAction
主キーは更新できません。
-
importedKeyCascade
主キーと同じ値で,外部キーを更新します。
-
importedKeySetNull
外部キーの値がNULLになります。
-
importedKeySetDefault
外部キーの値がデフォルト値になります。
-
importedKeyRestrict
主キーは更新できません。
11
short
SMALLINT
DELETE_RULE
−
削除規則。
主キーを参照している外部キーが存在する場合に,主キーを削除すると,それを参照している外部キーがどのような影響を受けるのかを表します。
-
importedKeyNoAction
主キーを削除できません。
-
importedKeyCascade
外部キーがある行を削除します。
-
importedKeySetNull
外部キーの値がNULLになります。
-
importedKeySetDefault
外部キーの値がデフォルト値になります。
-
importedKeyRestrict
主キーを削除できません。
12
String
VARCHAR
FK_NAME
−
参照制約の制約名。
13
String
VARCHAR
PK_NAME
−
主キーのインデクス名。
14
short
SMALLINT
DEFERRABILITY
−
外部キーに対する制約の評価を,トランザクションのコミット時まで延期できるかを表します。
-
importedKeyInitiallyDeferred
延期できます。
-
importedKeyInitiallyImmediate
現時点では即時に評価されるが,延期できるように変更できます。
-
importedKeyNotDeferrable
延期できません。
- (凡例)
-
−:該当しません。
- 注※
-
ソートのキー列の優先順位を示します。
-
- 【発生する例外】
-
次のどちらかの場合,例外SQLExceptionを投入します。
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行した場合
-
データベースアクセスエラーが発生した場合
-
(ac) getIndexInfo(String catalog, String schema, String table, boolean unique, boolean approximate)
- 【機能】
-
指定されたテーブルのインデクスに関する記述を返します。
- 【形式】
public ResultSet getIndexInfo(String catalog, String schema, String table, boolean unique, boolean approximate) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名。この指定値は未使用です。
- String schema:
-
スキーマ名パターン。引数の値は大文字と小文字を区別します。
- String table:
-
テーブル名パターン。引数の値は大文字と小文字を区別します。
- boolean unique:
-
ユニーク属性。
true:ユニークインデクスだけを返します。
false:ユニークであるかどうかに関係なく,インデクス情報を返します。
- boolean approximate:
-
結果属性。この指定値は未使用です。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
指定されたテーブルのインデクスに関する記述を返します。返却するResultSetの形式を次の表に示します。
表17‒48 getIndexInfoで返却するResultSetの形式 列番号
型
SQL型
列名
列の意味
1
String
CHAR
TABLE_CAT
カタログ名
常にNULL値を返します。
2
String
VARCHAR
TABLE_SCHEM
認可識別子名
3
String
VARCHAR
TABLE_NAME
テーブル名
4
boolean
BIT
NON_UNIQUE
インデクスを定義するキー値(インデクスとして定義する一つ又は複数の列全体の値)が,すべての行で異なっている場合にfalse,そうでない場合にtrueを返します。
5
String
CHAR
INDEX_QUALIFIER
インデクスのカタログ名
常にNULL値を返します。
6
String
VARCHAR
INDEX_NAME
インデクス識別子
7
short
SMALLINT
TYPE
インデクス種別によって次の値を返します。
-
クラスタキーの場合:DatabaseMetaData.tableIndexClustered(1)
-
ハッシュインデクスの場合:DatabaseMetaData.tableIndexHashed(2)
-
その他の場合:DatabaseMetaData.tableIndexOther(3)
8
short
SMALLINT
ORDINAL_POSITION
単一列インデクスの場合,1を返します。複数列インデクスの場合,インデクスを構成する列の順序(インデクスを構成する列名順を識別する番号で,1から始まる整数)を返します。
9
String
VARCHAR
COLUMN_NAME
列名
10
String
VARCHAR
ASC_OR_DESC
インデクスを昇順に定義する場合,"A"を返します。インデクスを降順に定義する場合,"D"を返します。プラグインインデクスの場合,NULL値を返します。
11
int
INTEGER
CARDINALITY
インデクス内のユニークな値の数
常にNULL値を返します。
12
int
INTEGER
PAGES
インデクスで使用しているページ数
常にNULL値を返します。
13
String
CHAR
FILTER_CONDITION
フィルタ条件
常にNULL値を返します。
-
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ad) getJDBCMajorVersion()
- 【機能】
-
ドライバのJDBCメジャーバージョンを返します。
- 【形式】
public int getJDBCMajorVersion() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
JDBCメジャーバージョン
- 【機能詳細】
-
ドライバのJDBCメジャーバージョンを返します。2を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ae) getJDBCMinorVersion()
- 【機能】
-
ドライバのJDBCマイナーバージョンを返します。
- 【形式】
public int getJDBCMinorVersion () throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
JDBCマイナーバージョン
- 【機能詳細】
-
ドライバのJDBCマイナーバージョンを返します。1を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(af) getMaxBinaryLiteralLength()
- 【機能】
-
バイナリリテラル中に入れられる16進数の最大文字数を返します。
- 【形式】
public int getMaxBinaryLiteralLength() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
最大文字数
- 【機能詳細】
-
常に64000を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ag) getMaxCatalogNameLength()
- 【機能】
-
カタログ名の最大文字数を返します。
- 【形式】
public int getMaxCatalogNameLength() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
カタログ名に許可される最大文字数。0は制限がないか,制限が不明であることを示します。
- 【機能詳細】
-
常に0を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ah) getMaxCharLiteralLength()
- 【機能】
-
キャラクタリテラルの最大文字数を返します。
- 【形式】
public int getMaxCharLiteralLength() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
キャラクタリテラルに許可される最大文字数。0は制限がないか,制限が不明であることを示します。
- 【機能詳細】
-
常に32000を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ai) getMaxColumnNameLength()
- 【機能】
-
列名の最大文字数を返します。
- 【形式】
public int getMaxColumnNameLength() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
列名に許可される最大文字数
- 【機能詳細】
-
常に30を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(aj) getMaxColumnsInGroupBy()
- 【機能】
-
GROUP BY節中の列数の最大値を返します。
- 【形式】
public int getMaxColumnsInGroupBy() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
許可される列の最大数
- 【機能詳細】
-
常に255を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ak) getMaxColumnsInIndex()
- 【機能】
-
インデクス中で許される列数の最大値を返します。
- 【形式】
public int getMaxColumnsInIndex() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
許可される列の最大数
- 【機能詳細】
-
インデクス中で許される列数の最大値を返します。返す値はクライアント及び接続先サーバの組み合わせによって異なります。クライアント及び接続先サーバの組み合わせによる返却値を次の表に示します。
表17‒49 クライアント及び接続先サーバの組み合わせによる返却値 クライアント
接続先サーバ
HiRDB
XDM/RD E2
バージョン09-50より前
バージョン09-50以降
バージョン09-50より前
16
16
16
バージョン09-50以降
16
64
16
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(al) getMaxColumnsInOrderBy()
- 【機能】
-
ORDER BY節中の列数の最大値を返します。
- 【形式】
public int getMaxColumnsInOrderBy() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
許可される列の最大数
- 【機能詳細】
-
常に255を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(am) getMaxColumnsInSelect()
- 【機能】
-
SELECTリスト中の列数の最大値を返します。
- 【形式】
public int getMaxColumnsInSelect() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
許可される列の最大数
- 【機能詳細】
-
常に30000を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(an) getMaxColumnsInTable()
- 【機能】
-
テーブル中の列数の最大値を返します。
- 【形式】
public int getMaxColumnsInTable() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
許可される列の最大数
- 【機能詳細】
-
常に30000を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ao) getMaxConnections()
- 【機能】
-
現在の接続の最大数を返します。
- 【形式】
public int getMaxConnections() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
一度に接続できるアクティブな接続の最大数。0は制限がないか,制限が不明を示します。
- 【機能詳細】
-
常に0を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ap) getMaxCursorNameLength()
- 【機能】
-
カーソル名の最大文字数を返します。
- 【形式】
public int getMaxCursorNameLength() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
カーソル名に許可される最大文字数
- 【機能詳細】
-
常に30を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(aq) getMaxIndexLength()
- 【機能】
-
インデクスの全部分を含む,インデクスの最大長を返します。
- 【形式】
public int getMaxIndexLength() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
許可されるインデクスの最大長
- 【機能詳細】
-
常に4036を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ar) getMaxProcedureNameLength()
- 【機能】
-
プロシジャ名の最大文字数を返します。
- 【形式】
public int getMaxProcedureNameLength() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
プロシジャ名の最大長
- 【機能詳細】
-
常に30を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(as) getMaxRowSize()
- 【機能】
-
1行の最大バイト数を返します。
- 【形式】
public int getMaxRowSize() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
許可される1行の最大バイト数。0は制限がないか,制限が不明であることを示します。
- 【機能詳細】
-
常に0を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(at) getMaxSchemaNameLength()
- 【機能】
-
スキーマ名の最大文字数を返します。
- 【形式】
public int getMaxSchemaNameLength() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
スキーマ名の最大長
- 【機能詳細】
-
スキーマ名の最大文字数を返します。返す値はクライアント及び接続先サーバの組み合わせによって異なります。クライアント及び接続先サーバの組み合わせによる返却値を次に示します。
表17‒50 クライアント及び接続先サーバの組み合わせによる返却値 クライアント
接続先サーバ
HiRDB
XDM/RD E2
バージョン09-50より前
バージョン09-50以降
バージョン09-50より前
8
8
30
バージョン09-50以降
8
30
30
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(au) getMaxStatementLength()
- 【機能】
-
SQL文の最大長を返します。
- 【形式】
public int getMaxStatementLength() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
SQL文の最大長
- 【機能詳細】
-
サーバがHiRDBの場合2,000,000を返します。
サーバがXDM/RD E2の場合30,000を返します。
- 注意:
-
サーバがXDM/RD E2の場合,Database Connection Serverのサーバ空間の起動制御文のRDB句でMAX SQL LENGTHを指定すると,SQL文の最大長を2,000,000まで拡張できます。しかし,JDBCドライバは,MAX SQL LENGTH指定の情報をサーバから取得していないので,このメソッドは,MAX SQL LENGTHが指定されていない場合のデフォルト値(30,000)を返します。JDBCドライバ自身は最大2,000,000バイトのSQL文を処理できます。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(av) getMaxStatements()
- 【機能】
-
アクティブにできるSQL文の最大数を返します。
- 【形式】
public int getMaxStatements() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
SQL文の最大数
- 【機能詳細】
-
常に4095を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(aw) getMaxTableNameLength()
- 【機能】
-
テーブル名の最大文字数を返します。
- 【形式】
public int getMaxTableNameLength() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
テーブル名の最大長
- 【機能詳細】
-
常に30を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ax) getMaxTablesInSelect()
- 【機能】
-
SELECT文中の最大テーブル数を返します。
- 【形式】
public int getMaxTablesInSelect() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
SELECT文で許可されるテーブルの最大数
- 【機能詳細】
-
クライアント及び接続先サーバの組み合わせによって,次の値を返します。
クライアント
接続先サーバ
HiRDB
XDM/RD E2
バージョン09-65-02より前
バージョン09-65-02以降
バージョン09-65-02より前
64
64
256
バージョン09-65-02以降
64
128
256
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ay) getMaxUserNameLength()
- 【機能】
-
ユーザ名の最大文字数を返します。
- 【形式】
public int getMaxUserNameLength() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
ユーザ名に許可される最大長
- 【機能詳細】
-
ユーザ名の最大文字数を返します。返す値はクライアント及び接続先サーバの組み合わせによって異なります。クライアント及び接続先サーバの組み合わせによる返却値を次に示します。
表17‒51 クライアント及び接続先サーバの組み合わせによる返却値 クライアント
接続先サーバ
HiRDB
XDM/RD E2
バージョン09-50より前
バージョン09-50以降
バージョン09-50より前
8
8
7
バージョン09-50以降
8
30
7
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(az) getNumericFunctions()
- 【機能】
-
数学関数を,コンマで区切ったリストで返します。
- 【形式】
public String getNumericFunctions() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【機能詳細】
-
サーバがHiRDBの場合,次のリストを返します。
ABS,ACOS,ASIN,ATAN,ATAN2,CEILING,COS,DEGREES,EXP,FLOOR,LOG,LOG10,MOD,PI,POWER,RADIANS,ROUND,SIGN,SIN,SQRT,TAN,TRUNCATE
サーバがXDM/RD E2の場合,次のリストを返します。
ABS,CEILING,EXP,FLOOR,LOG,MOD,POWER,SQRT
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ba) getPrimaryKeys(String catalog, String schema, String table)
- 【機能】
-
指定されたテーブルの主キー列の記述を返します。
- 【形式】
public ResultSet getPrimaryKeys(String catalog, String schema, String table) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名。この指定値は未使用です。
- String schema:
-
スキーマ名パターン。引数の値は大文字と小文字を区別します。
- String table:
-
テーブル名パターン。引数の値は大文字と小文字を区別します。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
指定されたテーブルの主キー列の記述を返します。返却するResultSetの形式を次の表に示します。
表17‒52 getPrimaryKeysで返却するResultSetの形式 列番号
型
SQL型
列名
列の意味
1
String
CHAR
TABLE_CAT
カタログ名
常にNULL値を返します。
2
String
VARCHAR
TABLE_SCHEM
認可識別子名
3
String
VARCHAR
TABLE_NAME
テーブル名
4
String
VARCHAR
COLUMN_NAME
列名
5
short
SMALLINT
KEY_SEQ
インデクスを構成する列の順序(インデクスを構成する列名順を識別する番号で,1から始まる整数)を返します。
6
String
VARCHAR
PK_NAME
プライマリインデクス識別子
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bb) getProcedureColumns(String catalog,String schemaPattern,String procedureNamePattern, String columnNamePattern)
- 【機能】
-
ストアドプロシジャパラメタに関する記述を返します。
- 【形式】
public ResultSet getProcedureColumns(String catalog, String schemaPattern, String procedureNamePattern, String columnNamePattern) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名。このドライバでは無視します。
- String schemaPattern:
-
スキーマ名パターン。null又は0長文字列を指定している場合,スキーマ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- String procedureNamePattern:
-
プロシジャ名パターン。null又は0長文字列を指定している場合,プロシジャ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- String columnNamePattern:
-
パラメタ名パターン。null又は0長文字列を指定している場合,パラメタ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
- JDBC2.0の場合
-
指定したストアドプロシジャ及び関数のパラメタに関する記述を返します。HiRDBサーバにSQL_ROUTINE_PARAMS表が定義されていない場合,SQLExceptionを返します。
- JDBC4.0以降の場合
-
指定したストアドプロシジャのパラメタに関する記述を返します。HiRDBサーバにSQL_ROUTINE_PARAMS表が定義されていない場合,検索結果行数0のResultSetを返却します。
返却するResultSetの形式を次に示します。
列番号
型
SQL型(Types)
列名
ソート※
列の意味
ドライバが返却する列
JDBC2.0
JDBC4.0以降
1
String
CHAR
PROCEDURE_CAT
−
カタログ名
常にNULL値を返します。
○
○
2
String
VARCHAR
PROCEDURE_SCHEM
1(昇順)
認可識別子名
○
○
3
String
VARCHAR
PROCEDURE_NAME
2(昇順)
プロシジャ名
○
○
4
String
VARCHAR
COLUMN_NAME
−
パラメタ名
○
○
5
short
SMALLINT
COLUMN_TYPE
−
パラメタの種類
-
procedureColumnUnknown
不明
-
procedureColumnIn
INパラメタ
-
procedureColumnInOut
INOUTパラメタ
-
procedureColumnOut
OUTパラメタ
-
procedureColumnReturn
プロシジャ戻り値
-
procedureColumnResult
ResultSetの結果列
HiRDB,XDM/RD E2共に,procedureColumnReturn,procedureColumnResultは設定しません。
○
○
6
int
INTEGER
DATA_TYPE
−
パラメタのSQL型
(java.sql.Typesで定義されている値)
○
○
7
String
VARCHAR
TYPE_NAME
−
パラメタのSQL型名
(型名を文字列で表現したもの)
○
○
8
int
INTEGER
PRECISION
−
パラメタの精度
- JDBC2.0:
-
パラメタのSQL型名がDECIMAL以外の場合,0を返します。
- JDBC4.0以降:
-
-
数値データの場合:最大精度
-
文字データの場合:文字数
-
日時データ型の場合:String表現の文字数
-
バイナリデータの場合:バイト数
-
○
○
9
int
INTEGER
LENGTH
−
パラメタのサイズ
- JDBC2.0:
-
NCHAR及びNVARCHAR:文字数
DECIMAL型:精度
INTERVAL型:DATA_LENGTH_CODEの値
上記以外:バイト数
- JDBC4.0以降:
-
バイト数を返します。
DECIMAL型は精度に符号とピリオドを加えるため,位取りなしの場合は精度+1,位取りありの場合は精度+2となります。
○
○
10
short
SMALLINT
SCALE
−
パラメタの位取り(小数部分のけた数)
パラメタのSQL型名がDECIMAL,TIMESTAMP以外の場合は,0を返します。
○
○
11
short
SMALLINT
RADIX
−
パラメタの基数
-
概数値:2
-
真数値:10
-
数値以外:0
○
○
12
short
SMALLINT
NULLABLE
−
NULL値の可否
-
procedureNoNulls
NULL値を許しません。
-
procedureNullable
NULL値を許します。
-
procedureNullableUnknown
NULL値を許すかどうかは不明です。
常に,procedureNullableを返します。
○
○
13
String
VARCHAR
REMARKS
−
パラメタに関するコメント
常にNULL値を返します。
○
○
14
String
VARCHAR
COLUMN_DEF
−
列のデフォルト値
常にNULL値を返します。
×
○
15
int
INTEGER
SQL_DATA_TYPE
−
将来予約用
0を返します。
×
○
16
int
INTEGER
SQL_DATE_TIME
−
将来予約用
0を返します。
×
○
17
int
INTEGER
CHAR_OCTET_LENGTH
−
バイナリと文字ベースのパラメタ又は列の最大長
×
○
18
int
INTEGER
ORDINAL_POSITION
4(昇順)
入力及び出力パラメタの1から始まる順番
×
○
19
String
CHAR
IS_NULLABLE
−
パラメタ又は列でNULL値を許可するかどうか
-
YES
NULL値を許します。
-
NO
NULL値を許しません。
-
空白
NULL値を許すかどうか不明です。
常にYESを返します。
×
○
20
String
VARCHAR
SPECIFIC_NAME
3(昇順)
このプロシジャを一意に識別する名前
×
○
- (凡例)
-
−:該当しません。
○:返却されます。
×:返却されません。
- 注※
-
ソートのキー列の優先順位を示します。
- 【発生する例外】
-
次のどちらかの場合,例外SQLExceptionを投入します。
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行した場合
-
データベースアクセスエラーが発生した場合
-
(bc) getProcedures(String catalog,String schemaPattern,String procedureNamePattern)
- 【機能】
-
ストアドプロシジャに関する記述を返します。
- 【形式】
public ResultSet getProcedures(String catalog, String schemaPattern, String procedureNamePattern) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名。このドライバでは無視します。
- String schemaPattern:
-
スキーマ名パターン。null又は0長文字列を指定している場合,スキーマ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- String procedureNamePattern:
-
プロシジャ名パターン。null又は0長文字列を指定している場合,プロシジャ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
- JDBC2.0の場合:
-
指定されたストアドプロシジャ及び関数に関する記述を返します。HiRDBサーバにSQL_ROUTINES表が定義されていない場合,SQLExceptionを返します。
- JDBC4.0以降の場合:
-
指定されたストアドプロシジャに関する記述を返します。HiRDBサーバにSQL_ROUTINES表が定義されていない場合,検索結果行数0のResultSetを返却します。
- 返却するResultSetの形式を次に示します。
-
列番号
型
SQL型(Types)
列名
ソート※
列の意味
ドライバが返却する列
JDBC2.0
JDBC4.0以降
1
String
CHAR
PROCEDURE_CAT
−
カタログ名
常にNULL値を返します。
○
○
2
String
VARCHAR
PROCEDURE_SCHEM
1(昇順)
認可識別子名
○
○
3
String
VARCHAR
PROCEDURE_NAME
2(昇順)
プロシジャ名
○
○
4
String
VARCHAR
RESERVE1
−
予約
常にNULL値を返します。
○
○
5
String
VARCHAR
RESERVE2
−
予約
常にNULL値を返します。
○
○
6
String
VARCHAR
RESERVE3
−
予約
常にNULL値を返します。
○
○
7
String
VARCHAR
REMARKS
−
プロシジャの説明文
○
○
8
short
SMALLINT
PROCEDURE_TYPE
−
プロシジャの種類
-
procedureResultUnknown
結果を返す可能性があります。
-
procedureNoResult
結果を返しません。
-
procedureReturnsResult
結果を返します。
○
○
9
String
VARCHAR
SPECIFIC_NAME
3(昇順)
このプロシジャを一意に識別する名前
×
○
- (凡例)
-
−:該当しません。
○:返却されます。
×:返却されません。
- 注※
-
ソートのキー列の優先順位を示します。
-
- 【発生する例外】
-
次のどちらかの場合,例外SQLExceptionを投入します。
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行した場合
-
データベースアクセスエラーが発生した場合
-
(bd) getProcedureTerm()
- 【機能】
-
"procedure"に対する推奨用語を返します。
- 【形式】
public String getProcedureTerm() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【機能詳細】
-
常に"procedure"を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(be) getResultSetHoldability()
- 【機能】
-
ResultSetオブジェクトの保持機能を返します。
- 【形式】
public int getResultSetHoldability() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
ResultSetオブジェクトの保持機能。Connection.commit メソッドが呼び出されたときにResultSetオブジェクトがクローズされるかどうかを示します。
ResultSet.HOLD_CURSORS_OVER_COMMIT:クローズされません。
ResultSet.CLOSE_CURSORS_AT_COMMIT:クローズされます。
- 【機能詳細】
-
有効なResultSetオブジェクトの保持機能を返します。
Connectionインスタンス生成時のカーソル動作モード(HIRDB_CURSOR)で,ホールダブルカーソルを有効とした場合はResultSet.HOLD_CURSORS_OVER_COMMIT,無効とした場合はResultSet.CLOSE_CURSORS_AT_COMMITを返します。
カーソル動作モードの指定方法については,「ユーザプロパティ」を参照してください。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bf) getSchemas()
- 【機能】
-
使用できるスキーマ名に関する情報を返します。
- 【形式】
public ResultSet getSchemas() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
- JDBC2.0の場合:
-
表を所有するスキーマ名だけを返します。
- JDBC4.0以降の場合:
-
HiRDBサーバに存在するすべてのスキーマ名に関する情報を返します。
システム共通定義にpd_security_host_groupを指定し,指定値にUAPが動作するクライアントマシンのホストが含まれていない場合,SQLExceptionを投入します。
返却するResultSetの形式を次の表に示します。
表17‒53 getSchemasで返却するResultSetの形式 列番号
型
SQL型
列名
列の意味
1
String
VARCHAR
TABLE_SCHEM
認可識別子名
2
String
CHAR
TABLE_CATALOG
常にNULL値を返します。
- 【発生する例外】
-
次の場合,SQLExceptionを投入します。
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している
-
データベースアクセスエラーが発生した
-
システム共通定義にpd_security_host_groupを指定し,指定値にUAPが動作するクライアントマシンのホストが含まれていない(JDBC4.0以降の場合だけ)
-
(bg) getSchemaTerm()
- 【機能】
-
"schema"に対する推奨用語を返します。
- 【形式】
public String getSchemaTerm() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【機能詳細】
-
常に"schema"を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bh) getSearchStringEscape()
- 【機能】
-
ワイルドカード文字をエスケープするために使用する文字列を返します。
- 【形式】
public String getSearchStringEscape() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【機能詳細】
-
常に"\"を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bi) getSQLKeywords()
- 【機能】
-
データベース固有のSQLキーワードであり,かつSQL92のキーワードではないすべてのキーワードを,コンマで区切ったリストで返します。
- 【形式】
public String getSQLKeywords() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【機能詳細】
-
サーバの種類によって,返却するリストに違いがあります。
- サーバがHiRDBの場合
-
ABS,ACCESS,AFTER,ALIAS,AMOUNT,ANDNOT,ANSI,ARRAY,ASSIGN,
ASYNC,AUTO,BASE,BEFORE,BINARY,BIT_AND_TEST,BLOB,
BOOLEAN,BREADTH,BTREE,BUFFER,BYTE,CALL,CHANGE,CLUSTER,
COLUMNS,COMMENT,COMPLETION,COMPRESSED,CONDITION,
CONFIGURATION,CONST,CONSTRUCTOR,CONTIGUOUS,
COUNT_FLOAT,CURAID,CYCLE,DATA,DATABASE,DAYS,DBA,DEFER,
DEMOTING,DEPTH,DEVICE,DICTIONARY,DIGITS,DIRECT,DO,
DOUBLE_PRECISION,EACH,EDIT,ELSEIF,ENCRYPT,EQUALS,
ESTIMATED,EXCLUSIVE,EXIT,EXTERN,FILE,FIX,FIXED,FLAT,FORCE,
FREE,FUNCTION,GENERAL,GET_JAVA_STORED_ROUTINE_SOURCE,
HANDLER,HASH,HELP,HEX,HiRDB,HOURS,HUGE,IDENTIFIED,IF,
IGNORE,INDEX,INOUT,IS_USER_CONTAINED_IN_HDS_GROUP,LARGE,
LEAVE,LENGTH,LESS,LIMIT,LINES,LINK,LIST,LOCATOR,LOCK,
LOCKS,LOGID,LOGNAME,LONG,LOOP,MASTER,MAXUSAGES,MCHAR,
MINUTES,MOD,MODE,MODIFY,MONTHS,MOVE,MVARCHAR,NEW,
NONE,NOWAIT,NULLABLE,NVARCHAR,OBJECT,OFF,OFFSET,OID,
OLD,OPERATION,OPERATORS,OPTIMIZE,OTHERS,OUT,OVER,
OVERFLOW,OWN,PAGE,PARAMETERS,PARTITIONED,PCTFREE,
PENDANT,PIC,PICTURE,PREALLOCATED,PREFERRED,PREORDER,
PRIVATE,PROGRAM,PROTECTED,PURGE,RANDOM,RD,RDAREA,
RECOMPILE,RECOVERABLE,RECOVERY,RECURSIVE,REF,
REFERENCING,REGLIKE,RELEASE,RELEASING,RENAME,
RESIGNAL,RESTART,RETURN,RETURNS,ROLE,ROOT,ROUTINE,ROW,
ROWID,SAVEPOINT,SCALE,SCAN,SCHEMAS,SCOPE,SD,SEARCH,
SECONDS,SEGMENT,SENSITIVE,SEPARATE,SEPARATOR,SEQUENCE,
SFLIKE,SHARE,SHORT,SIGNAL,SIMILAR,SLOCK,SMALLFLT,SPLIT,
SQLCODE_OF_LAST_CONDITION,SQLCODE_TYPE,SQLCOUNT,SQLDA,
SQLERRM,SQLERRM_OF_LAST_CONDITION,SQLERRMC,SQLERRML,
SQLEXCEPTION,SQLNAME,SQL_STANDARD,SQLWARN,
SQLWARNING,START,STATIC,STOP,STOPPING,STRUCTURE,SUBSTR,
SUPPRESS,SYNONYM,TEST,TEXT,THERE,TIMESTAMP_FORMAT,
TREAT,TRIGGER,TYPE,UAMT,UBINBUF,UCHAR,UDATE,UHANT,
UHDATE,UNDER,UNIFY_2000,UNIONALL,UNLIMITED,UNLOCK,UNTIL,
USE,UTIME,UTXTBUF,VARCHAR_FORMAT,VARIABLE,VIRTUAL,
VISIBLE,VOLATILE,VOLUME,VOLUMES,WAIT,WHILE,WITHOUT,
XLIKE,XLOCK,XML,XMLAGG,XMLEXISTS,XMLPARSE,XMLQUERY,
XMLSERIALIZE,YEARS
- サーバがXDM/RD E2の場合
-
ABS,ANDNOT,ARRAY,ASSIGN,AUDIT,BINARY,BLOB,BOOLEAN,CALL,
CARDINALITY,CHANGE,CLOB,CLUSTER,COMMENT,COMPRESSED,
CORR,COUNT,COVAR_POP,COVAR_SAMP,CUBE,CUME_DIST,
CURRENT_ROLE,DATA,DAYS,DBA,DENSE_RANK,DIGITS,DO,EACH,
ELSEIF,EVERY,EXCLUSIVE,FALSE,FILTER,FIX,FLAT,FORCE,
FUNCTION,GROUPING,HEX,HOURS,IDENTIFIED,IF,INDEX,INOUT,
ITERATE,LABEL,LARGE,LEAVE,LENGTH,LIMIT,LIST,LOCK,LONG,
LOOP,MCHAR,MICROSECOND,MICROSECONDS,MINUTES,MOD,
MODE,MONTHS,MVARCHAR,NEW,NONLOCAL,NOWAIT,NVARCHAR,
OLD,OPTIMIZE,OUT,OVER,OVERLAY,OWN,PARTITION,PCTFREE,
PERCENT_RANK,PERCENTILE_CONT,PERCENTILE_DISC,PRIVATE,
PROGRAM,PROTECTED,PURGE,RANGE,RANK,RDAREA,RDNODE,
RECURSIVE,REFERENCING,REGR_AVGX,REGR_AVGY,REGR_COUNT,
REGR_INTERCEPT,REGR_R2,REGR_SLOPE,REGR_SXX,REGR_SXY,
REGR_SYY,RELEASE,REPEAT,RESERVED,RETURN,RETURNS,ROLLUP,
ROUTINE,ROW,ROW_NUMBER,ROWID,SECONDS,SHARE,SIGNAL,
SMALLFLT,SPECIFIC,SQLCOUNT,SQLDA,SQLERRM,SQLERRMC,
SQLERRML,SQLNAME,SQLWARN,STDDEV_POP,STDDEV_SAMP,
STOPPING,SUBSTR,TIMESTAMP_FORMAT,TRIGGER,TYPE,
UNBOUNDED,UNDER,UNTIL,USER_AUDIT,USER_GROUP,
USER_LEVEL,VAR_POP,VAR_SAMP,VARCHAR_FORMAT,WAIT,WHILE,
WINDOW,WITHIN,WITHOUT,YEARS
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bj) getSQLStateType()
- 【機能】
-
SQLException.getSQLStateによって返されるSQLSTATEが,X/OpenのSQL CLIであるかSQL99であるかを返します。
- 【形式】
public int getSQLStateType() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- int型:
-
SQLSTATEの型。sqlStateXOpen又はsqlStateSQL99。
- 【機能詳細】
-
-
サーバがHiRDBの場合
クライアント環境変数PDSTANDARDSQLSTATEにYESを設定している場合,又はクライアント環境変数PDSTANDARDSQLSTATEを省略してシステム共通定義pd_standard_sqlstateがYの場合,SQLSTATEにはSQL2003の値を設定するため,戻り値にはsqlStateSQL99を設定します。
上記以外の場合,SQLSTATEにはHiRDB独自の値を設定するため,戻り値には0を設定します。
-
サーバがXDM/RD E2の場合
戻り値にsqlStateSQL99を設定します。
-
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bk) getStringFunctions()
- 【機能】
-
文字列関数を,コンマで区切ったリストで返します。
- 【形式】
public String getStringFunctions() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【機能詳細】
-
サーバがHiRDBの場合,次のリストを返します。
ASCII,CHAR,INSERT,LCASE,LEFT,LENGTH,LOCATE,LTRIM,REPLACE,RIGHT,RTRIM,SUBSTRING,UCASE
サーバがXDM/RD E2の場合,次のリストを返します。
LCASE,LENGTH,LOCATE,LTRIM,POSITION,REPLACE,RTRIM,SUBSTRING,UCASE
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bl) getSuperTables(String catalog,String schemaPattern,String tableNamePattern)
- 【機能】
-
特定のスキーマで定義されているテーブル階層の説明を返します。
- 【形式】
public ResultSet getSuperTables(String catalog,String schemaPattern,String tableNamePattern) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名
- String schemaPattern:
-
スキーマ名パターン
- String tableNamePattern:
-
テーブル名パターン
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
HiRDB,XDM/RD E2では,テーブル階層は未サポートのため,常に検索結果行数0のResultSetを返します。すべての引数について妥当性チェックを行いません。返却するResultSetの形式を次に示します。
列番号
型
SQL型(Types)
列名
列の意味
1
String
CHAR
TABLE_CAT
カタログ名
2
String
VARCHAR
TABLE_SCHEM
認可識別子
3
String
VARCHAR
TABLE_NAME
型名
4
String
VARCHAR
SUPERTABLE_NAME
スーパタイプ名
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bm) getSuperTypes(String catalog,String schemaPattern,String typeNamePattern)
- 【機能】
-
特定のスキーマで定義されているユーザ定義型階層の説明を返します。
- 【形式】
public ResultSet getSuperTypes(String catalog,String schemaPattern,String typeNamePattern) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名
- String schemaPattern:
-
スキーマ名パターン
- String typeNamePattern:
-
ユーザ定義型名パターン
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
TYPE4 JDBCドライバでは,ユーザ定義型は未サポートのため,常に検索結果行数0のResultSetを返します。すべての引数について妥当性チェックを行いません。返却するResultSetの形式を次に示します。
列番号
型
SQL型(Types)
列名
列の意味
1
String
CHAR
TYPE_CAT
ユーザ定義型のカタログ名
2
String
VARCHAR
TYPE_SCHEM
ユーザ定義型のスキーマ名
3
String
VARCHAR
TYPE_NAME
ユーザ定義型の型名
4
String
CHAR
SUPERTYPE_CAT
直接のスーパタイプのカタログ名
5
String
VARCHAR
SUPERTYPE_SCHEM
直接のスーパタイプのスキーマ名
6
String
VARCHAR
SUPERTYPE_NAME
直接のスーパタイプ名
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bn) getSystemFunctions()
- 【機能】
-
使用できるシステム関数を返します。
- 【形式】
public String getSystemFunctions() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【機能詳細】
-
常に"USER"を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bo) getTablePrivileges(String catalog,String schemaPattern,String tableNamePattern)
- 【機能】
-
テーブルのアクセス権に関する記述を返します。
- 【形式】
public ResultSet getTablePrivileges(String catalog, String schemaPattern, String tableNamePattern)throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名。このドライバでは無視します。
- String schemaPattern:
-
スキーマ名パターン。null又は0長文字列を指定している場合,スキーマ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- String tableNamePattern:
-
テーブル名パターン。null又は0長文字列を指定している場合,テーブル名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
指定されたテーブルに対するアクセス権に関する記述を返します。返却するResultSetの形式を次に示します。
列番号
型
SQL型(Types)
列名
ソート※
列の意味
1
String
CHAR
TABLE_CAT
−
カタログ名
常にNULL値を返します。
2
String
VARCHAR
TABLE_SCHEM
1(昇順)
認可識別子名
3
String
VARCHAR
TABLE_NAME
2(昇順)
テーブル名
4
String
VARCHAR
GRANTOR
−
アクセス権の付与者
5
String
VARCHAR
GRANTEE
−
アクセス権の被付与者
6
String
VARCHAR
PRIVILEGE
3(昇順)
許可されているアクセス権限名。複数のアクセス権限を許可されている場合は,コンマ(,)で区切って返します。
SELECT:SELECT権限
INSERT:INSERT権限
UPDATE:UPDATE権限
DELETE:DELETE権限
7
String
VARCHAR
IS_GRANTABLE
−
アクセス権の被付与者が,別のユーザにアクセス権を与えることができるかを表します。
YES:与えることができます。
NO:与えることができません。
null:与えることができるかどうか不明です。
HiRDB,XDM/RD E2共に,nullは返しません。PRIVILEGEに設定されたアクセス権限が複数ある場合,その内の一つ以上のアクセス権限を別のユーザに与えることができれば,YESを設定します。
- (凡例)
-
−:該当しません。
- 注※
-
ソートのキー列の優先順位を示します。
- 【発生する例外】
-
次のどちらかの場合,例外SQLExceptionを投入します。
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行した場合
-
データベースアクセスエラーが発生した場合
-
(bp) getTables(String catalog, String schemaPattern, String tableNamePattern, String[] types)
- 【機能】
-
テーブルに関する記述を返します。
- 【形式】
public ResultSet getTables(String catalog, String schemaPattern, String tableNamePattern, String[] types) throws SQLException
- 【引数】
-
- String catalog:
-
未使用。
- String schemaPattern:
-
スキーマ名パターン。引数の値は大文字と小文字を区別します。
- String tableNamePattern:
-
テーブル名パターン。引数の値は大文字と小文字を区別します。
- String[] types:
-
テーブルの型のリスト。getTableTypes()メソッドによって返されるテーブルの型を指定できます。引数の値は大文字と小文字を区別します。nullの場合,"TABLE","VIEW","SYSTEM TABLE",及び"GLOBAL TEMPORARY"のすべてが指定されたものとします。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
テーブルに関する記述を返します。返却するResultSetの形式を次の表に示します。
表17‒54 getTablesで返却するResultSetの形式 列番号
型
SQL型
列名
列の意味
1
String
CHAR
TABLE_CAT
常にNULL値を返します。
2
String
VARCHAR
TABLE_SCHEM
認可識別子名
3
String
VARCHAR
TABLE_NAME
テーブル名
4
String
VARCHAR
TABLE_TYPE
表の種別
-
TABLE:永続実表(DABroker for Java互換で"BASE TABLE"と指定されても"TABLE"と同様の動作をします)
-
VIEW:ビュー表
-
SYSTEM TABLE:ディクショナリ表
-
GLOBAL TEMPORARY:一時表
5
String
VARCHAR
REMARKS
コメント
6
String
CHAR
TYPE_CAT
常にNULL値を返します。
7
String
CHAR
TYPE_SCHEM
常にNULL値を返します。
8
String
CHAR
TYPE_NAME
常にNULL値を返します。
9
String
CHAR
SELF_REFERENCING_COL_NAME
常にNULL値を返します。
10
String
CHAR
REF_GENERATION
常にNULL値を返します。
-
- 【発生する例外】
-
次の場合,SQLExceptionを投入します。
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合
-
引数String[] typeの一つ以上の要素がnullである場合
-
引数String[] typeの一つ以上の要素が,次のすべての文字列に該当しない場合
"TABLE","VIEW","SYSTEM TABLE","BASE TABLE","GLOBAL TEMPORARY"
-
(bq) getTableTypes()
- 【機能】
-
使用できるテーブルの型を返します。
- 【形式】
public ResultSet getTableTypes()throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
使用できるテーブルの型を返します。返却するResultSetの形式を次に示します。
列番号
型
SQL型
列名
列の意味
1
String
VARCHAR
TABLE_TYPE
表の種別
-
TABLE:永続実表
-
VIEW:ビュー表
-
SYSTEM TABLE:ディクショナリ表
-
GLOBAL TEMPORARY:一時表
-
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(br) getTimeDateFunctions()
- 【機能】
-
使用できる時間関数と日付関数をコンマで区切ったリストを返します。
- 【形式】
public String getTimeDateFunctions() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【機能詳細】
-
サーバがHiRDBの場合,次のリストを返します。
ADD_INTERVAL,CENTURY,CHARACTER,CURRENT_DATE,CURRENT_TIME,CURRENT_TIMESTAMP,
DATE,DATE_TIME,DAYNAME,DAYOFWEEK,DAYOFYEAR,DAY,DAYS,INTERVAL_DATETIMES,
HALF,HOUR,LAST_DAY,MIDNIGHTSECONDS,MINUTE,MONTH,MONTHNAME,MONTHS_BETWEEN,
NEXT_DAY,QUARTER,ROUNDMONTH,SECOND,TIME,TIMESTAMP,TIMESTAMP_FORMAT,TRUNCYEAR,
VARCHAR_FORMAT,WEEK,WEEKOFMONTH,YEAR,YEARS_BETWEEN
サーバがXDM/RD E2の場合,次のリストを返します。
CURDATE,CURRENT_DATE,CURTIME,CURRENT_TIME,CURRENT_TIMESTAMP,HOUR,MINUTE,MONTH,NOW,SECOND,YEAR
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bs) getTypeInfo()
- 【機能】
-
標準SQLの型に関する記述を返します。
- 【形式】
public ResultSet getTypeInfo() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
標準SQLの型に関する記述を返します。返却するResultSetの形式を次の表に示します。
表17‒55 getTypeInfoで返却するResultSetの形式 列番号
型
SQL型
列名
列の意味
1
String
VARCHAR
TYPE_NAME
型名
2
short
SMALLINT
DATA_TYPE
java.sql.TypesのSQLデータ型
3
int
INTEGER
PRECISION
最大の精度
4
String
VARCHAR
LITERAL_PREFIX
リテラルを引用するのに使用する接頭辞
5
String
VARCHAR
LITERAL_SUFFIX
リテラルを引用するのに使用する接尾辞
6
String
VARCHAR
CREATE_PARAMS
型の作成に使用するパラメタ
7
short
SMALLINT
NULLABLE
この型にNULLを使用できるかどうかを返します。
-
typeNoNulls:NULL値を使用できません。
-
typeNullable:NULL値を使用できます。
-
typeNullableUnknown:NULL値を使用できるか不明です。
常にtypeNullableUnknownを返します。
8
boolean
BIT
CASE_SENSITIVE
大文字と小文字を区別するかどうかを返します。
-
true:文字列系データ型
-
false:その他のデータ型
9
short
SMALLINT
SEARCHABLE
この型に"WHERE"を使用できるかどうかを返します。
-
typePredNone:使用できません。
-
typePredChar:WHERE..LIKEだけ使用できます。
-
typePredBasic:WHERE..LIKE以外を使用できます。
-
typeSearchable:すべてのWHERE..を使用できます。
常にtypeSearchableを返します。
10
boolean
BIT
UNSIGNED_ATTRIBUTE
符号無し属性かどうかを返します。
数値データは符号有りのためfalse,その他のデータ型は符号の有無に関係ないためfalseを返します。
11
boolean
BIT
FIXED_PREC_SCALE
通貨の値になれるかどうかを返します。
常にfalseを返します。
12
boolean
BIT
AUTO_INCREMENT
自動インクリメントの値に使用できるかどうかを返します。
常にfalseを返します。
13
String
VARCHAR
LOCAL_TYPE_NAME
型名の地域対応されたバージョン
型名と同じものを返します。
14
short
SMALLINT
MINIMUM_SCALE
サポートされる最小スケール
15
short
SMALLINT
MAXIMUM_SCALE
サポートされる最大スケール
16
int
INTEGER
SQL_DATA_TYPE
常にNULL値を返します。
17
int
INTEGER
SQL_DATETIME_SUB
常にNULL値を返します。
18
int
INTEGER
NUM_PREC_RADIX
数値データは2又は10,
それ以外は0
-
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bt) getUDTs(String catalog,String schemaPattern,String typeNamePattern,int[] types)
- 【機能】
-
ユーザ定義型に関する情報を返します。
- 【形式】
public ResultSet getUDTs(String catalog, String schemaPattern, String typeNamePattern, int[] types) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名
- String schemaPattern:
-
スキーマ名パターン
- String typeNamePattern:
-
型名パターン
- int[] types:
-
ユーザ定義型のリスト
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
Type4 JDBCドライバでは,ユーザ定義型は未サポートのため,常に検索結果行数0のResultSetを返します。すべての引数について妥当性チェックを行いません。返却するResultSetの形式を次に示します。
列番号
型
SQL型(Types)
列名
列の意味
1
String
CHAR
TYPE_CAT
ユーザ定義型のカタログ名
2
String
VARCHAR
TYPE_SCHEM
ユーザ定義型のスキーマ名
3
String
VARCHAR
TYPE_NAME
ユーザ定義型の型名
4
String
VARCHAR
CLASS_NAME
Javaクラス名
5
int
INTEGER
DATA_TYPE
java.sql.Typesで定義されている型値
6
String
VARCHAR
REMARKS
型に関する説明
7
short
SMALLINT
BASE_TYPE
DISTINCT型のソースの型の型コード,又はjava.sql.Typesで定義される構造型のSELF_REFERENCING_COLUMNのユーザ生成参照型を実装する型の型コード
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bu) getURL()
- 【機能】
-
HiRDB又はXDM/RD E2に接続したURLを返します。URLがない場合はNULLを返します。
- 【形式】
public String getURL() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bv) getUserName()
- 【機能】
-
HiRDB又はXDM/RD E2に接続する際に使用したユーザ名を返します。
OSログインユーザの簡易認証機能を使用している場合は,簡易認証キーワードを返します。
- 【形式】
public String getUserName() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
Stringオブジェクト
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bw) getVersionColumns(String catalog,String schema,String table)
- 【機能】
-
テーブル中の行が更新された場合に,自動的に更新されるテーブルの列に関する記述を返します。
- 【形式】
public ResultSet getVersionColumns(String catalog,String schema,String table) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名
- String schema:
-
スキーマ名
- String table:
-
テーブル名
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
HiRDB,XDM/RD E2では,自動的に列を更新する機能は未サポートのため,常に検索結果行数0のResultSetを返します。すべての引数について妥当性チェックを行いません。返却するResultSetの形式を次に示します。
列番号
型
SQL型(Types)
列名
列の意味
1
short
SMALLINT
SCOPE
未使用
2
String
VARCHAR
COLUMN_NAME
列名
3
int
INTEGER
DATA_TYPE
SQL型
4
String
VARCHAR
TYPE_NAME
データソース依存の型名
5
int
INTEGER
COLUMN_SIZE
データの精度
6
int
INTEGER
BUFFER_LENGTH
データのバイト数
7
short
SMALLINT
DECIMAL_DIGITS
スケール
8
short
SMALLINT
PSEUDO_COLUMN
列が擬似列かどうかを表します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bx) insertsAreDetected(int type)
- 【機能】
-
ResultSet.rowInserted()メソッドを呼び出すことによって,可視の行が挿入されたことを検出できるかどうかを返します。
- 【形式】
public boolean insertsAreDetected(int type) throws SQLException
- 【引数】
-
- int type:
-
ResultSetの型。次のどれかです。
-
ResultSet.TYPE_FORWARD_ONLY
-
ResultSet.TYPE_SCROLL_INSENSITIVE
-
ResultSet.TYPE_SCROLL_SENSITIVE
-
- 【戻り値】
-
- boolean型:
-
true:指定された結果セットの型によって変更が検出されます。
false:指定された結果セットの型によって変更が検出されません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(by) isCatalogAtStart()
- 【機能】
-
完全修飾されたテーブル名の開始部分(又は終了部分)に,カタログが現れるかどうかを返します。
- 【形式】
public boolean isCatalogAtStart() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:完全修飾されたテーブル名の開始部分にカタログ名が現れます。
false:完全修飾されたテーブル名の開始部分にカタログ名が現れません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(bz) isReadOnly()
- 【機能】
-
データベースが読み込み専用モードかどうかを返します。
- 【形式】
public boolean isReadOnly() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:読み込み専用モードです。
false:読み込み専用モードではありません。
- 【機能詳細】
-
常にfalseを返します。
- 注意:
-
サーバがXDM/RD E2の場合,Database Connection Serverの起動制御文,又は運用コマンドで,データベースのアクセスモードをREADに設定すると読み込み専用となりますが,JDBCドライバはアクセスモードの情報をサーバから取得していないので,アクセスモードがUPDATEであると仮定して処理します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ca) locatorsUpdateCopy()
- 【機能】
-
LOBへの変更が,コピーに対して行われたのか,LOBに直接行われたのかを示します。
- 【形式】
public boolean locatorsUpdateCopy() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true :変更がLOBのコピーに対して行われました。
false:変更がLOBに直接行われました。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cb) nullPlusNonNullIsNull()
- 【機能】
-
NULL値と非NULL値の連結を,NULLとするかどうかを返します。
- 【形式】
public boolean nullPlusNonNullIsNull() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:NULL値と非NULL値の連結をNULLとします。
false:NULL値と非NULL値の連結をNULLとしません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cc) nullsAreSortedAtEnd()
- 【機能】
-
NULL値が,終了時にソート順に関係なくソートされるかどうかを返します。
- 【形式】
public boolean nullsAreSortedAtEnd() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:ソートされます。
false:ソートされません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cd) nullsAreSortedAtStart()
- 【機能】
-
NULL値が,開始時にソート順に関係なくソートされるかどうかを返します。
- 【形式】
public boolean nullsAreSortedAtStart() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:ソートされます。
false:ソートされません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ce) nullsAreSortedHigh()
- 【機能】
-
NULL値が高位にソートされるかどうかを返します。
- 【形式】
public boolean nullsAreSortedHigh() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:ソートされます。
false:ソートされません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cf) nullsAreSortedLow()
- 【機能】
-
NULL値が下位にソートされるかどうかを返します。
- 【形式】
public boolean nullsAreSortedLow() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:ソートされます。
false:ソートされません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cg) othersDeletesAreVisible(int type)
- 【機能】
-
ほかで行われた削除が可視かどうかを返します。
- 【形式】
public boolean othersDeletesAreVisible(int type) throws SQLException
- 【引数】
-
- int type:
-
ResultSetの型。次のどれかです。
-
ResultSet.TYPE_FORWARD_ONLY
-
ResultSet.TYPE_SCROLL_INSENSITIVE
-
ResultSet.TYPE_SCROLL_SENSITIVE
-
- 【戻り値】
-
- boolean型:
-
true:可視です。
false:可視ではありません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ch) othersInsertsAreVisible(int type)
- 【機能】
-
ほかで行われた挿入が可視かどうかを返します。
- 【形式】
public boolean othersInsertsAreVisible(int type) throws SQLException
- 【引数】
-
- int type:
-
ResultSetの型。次のどれかです。
-
ResultSet.TYPE_FORWARD_ONLY
-
ResultSet.TYPE_SCROLL_INSENSITIVE
-
ResultSet.TYPE_SCROLL_SENSITIVE
-
- 【戻り値】
-
- boolean型:
-
true:可視です。
false:可視ではありません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ci) othersUpdatesAreVisible(int type)
- 【機能】
-
ほかで行われた削除が可視かどうかを返します。
- 【形式】
public boolean othersUpdatesAreVisible(int type) throws SQLException
- 【引数】
-
- int type:
-
ResultSetの型。次のどれかです。
-
ResultSet.TYPE_FORWARD_ONLY
-
ResultSet.TYPE_SCROLL_INSENSITIVE
-
ResultSet.TYPE_SCROLL_SENSITIVE
-
- 【戻り値】
-
- boolean型:
-
true:可視です。
false:可視ではありません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cj) ownDeletesAreVisible(int type)
- 【機能】
-
結果セット自身の削除が可視かどうかを返します。
- 【形式】
public boolean ownDeletesAreVisible(int type) throws SQLException
- 【引数】
-
- int type:
-
ResultSetの型。次のどれかです。
-
ResultSet.TYPE_FORWARD_ONLY
-
ResultSet.TYPE_SCROLL_INSENSITIVE
-
ResultSet.TYPE_SCROLL_SENSITIVE
-
- 【戻り値】
-
- boolean型:
-
true:可視です。
false:可視ではありません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ck) ownInsertsAreVisible(int type)
- 【機能】
-
結果セット自身の挿入が可視かどうかを返します。
- 【形式】
public boolean ownInsertsAreVisible(int type) throws SQLException
- 【引数】
-
- int type:
-
ResultSetの型。次のどれかです。
-
ResultSet.TYPE_FORWARD_ONLY
-
ResultSet.TYPE_SCROLL_INSENSITIVE
-
ResultSet.TYPE_SCROLL_SENSITIVE
-
- 【戻り値】
-
- boolean型:
-
true:可視です。
false:可視ではありません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cl) ownUpdatesAreVisible(int type)
- 【機能】
-
結果セット自身の更新が可視かどうかを返します。
- 【形式】
public boolean ownUpdatesAreVisible(int type) throws SQLException
- 【引数】
-
- int type:
-
ResultSetの型。次のどれかです。
-
ResultSet.TYPE_FORWARD_ONLY
-
ResultSet.TYPE_SCROLL_INSENSITIVE
-
ResultSet.TYPE_SCROLL_SENSITIVE
-
- 【戻り値】
-
- boolean型:
-
true:可視です。
false:可視ではありません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cm) storesLowerCaseIdentifiers()
- 【機能】
-
大文字と小文字が混在する引用符なしのSQL識別子を,大文字と小文字を区別しないで処理し,小文字で格納するかどうかを返します。
- 【形式】
public boolean storesLowerCaseIdentifiers() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:大文字と小文字を区別しないで,小文字で格納します。
false:大文字と小文字を区別して格納します。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cn) storesLowerCaseQuotedIdentifiers()
- 【機能】
-
大文字と小文字が混在する引用符付きのSQL識別子を,大文字と小文字を区別しないで処理し,小文字で格納するかどうかを返します。
- 【形式】
public boolean storesLowerCaseQuotedIdentifiers() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:大文字と小文字を区別しないで,小文字で格納します。
false:上記ではありません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(co) storesMixedCaseIdentifiers()
- 【機能】
-
大文字と小文字が混在する引用符なしのSQL識別子を,大文字と小文字を区別しないで処理し,大文字と小文字を混在して格納するかどうかを返します。
- 【形式】
public boolean storesMixedCaseIdentifiers() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:大文字と小文字を区別しないで処理し,大文字と小文字を混在して格納します。
false:上記ではありません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cp) storesMixedCaseQuotedIdentifiers()
- 【機能】
-
大文字と小文字が混在する引用符付きのSQL識別子を,大文字と小文字を区別しないで処理し,大文字と小文字を混在して格納するかどうかを返します。
- 【形式】
public boolean storesMixedCaseQuotedIdentifiers() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:大文字と小文字を区別しないで処理し,大文字と小文字を混在して格納します。
false:上記ではありません。
- 【機能詳細】
-
常にtrueを返します。
- 注意:
-
-
実際には大文字と小文字を区別して処理しますが,結果として大文字と小文字を混在して格納するので,trueを返します。大文字と小文字を区別して処理するかどうかは,supportsMixedCaseQuotedIdentifiersメソッドで判定できます。
-
サーバがXDM/RD E2の場合,XDM/RD E2のRD環境定義で,DELIMITED ID UPPERオペランドにYES(デフォルトはNO)を指定しているときは大文字で格納しますが,JDBCドライバはDELIMITED ID UPPERオペランドの情報をサーバから取得していないので,デフォルトのNOであると仮定して処理します。
-
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cq) storesUpperCaseIdentifiers()
- 【機能】
-
大文字と小文字が混在する引用符なしのSQL識別子を,大文字と小文字を区別しないで処理し,大文字で格納するかどうかを返します。
- 【形式】
public boolean storesUpperCaseIdentifiers() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:大文字と小文字を区別しないで処理し,大文字で格納します。
false:上記ではありません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cr) storesUpperCaseQuotedIdentifiers()
- 【機能】
-
大文字と小文字が混在する引用符付きのSQL識別子を,大文字と小文字を区別しないで処理し,大文字で格納するかどうかを返します。
- 【形式】
public boolean storesUpperCaseQuotedIdentifiers() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:大文字と小文字を区別しないで処理し,大文字で格納します。
false:上記ではありません。
- 【機能詳細】
-
常にfalseを返します。
- 注意:
-
サーバがXDM/RD E2の場合,XDM/RD E2のRD環境定義で,DELIMITED ID UPPERオペランドにYES(デフォルトはNO)を指定しているときは大文字で格納しますが,JDBCドライバからはDELIMITED ID UPPERオペランドの情報を取得できないので,JDBCドライバはデフォルトのNOであると仮定して処理します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cs) supportsAlterTableWithAddColumn()
- 【機能】
-
追加列のあるALTER TABLEが,サポートされているかどうかを返します。
- 【形式】
public boolean supportsAlterTableWithAddColumn() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ct) supportsAlterTableWithDropColumn()
- 【機能】
-
ドロップ列のあるALTER TABLEが,サポートされているかどうかを返します。
- 【形式】
public boolean supportsAlterTableWithDropColumn() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cu) supportsANSI92EntryLevelSQL()
- 【機能】
-
ANSI92エントリレベルのSQL文法が,サポートされるかどうかを返します。
- 【形式】
public boolean supportsANSI92EntryLevelSQL() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cv) supportsANSI92FullSQL()
- 【機能】
-
ANSI92完全レベルのSQL文法が,サポートされるかどうかを返します。
- 【形式】
public boolean supportsANSI92FullSQL() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cw) supportsANSI92IntermediateSQL()
- 【機能】
-
ANSI92中間レベルのSQL文法が,サポートされるかどうかを返します。
- 【形式】
public boolean supportsANSI92IntermediateSQL() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cx) supportsBatchUpdates()
- 【機能】
-
バッチ更新をサポートしているかどうかを返します。
- 【形式】
public boolean supportsBatchUpdates() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cy) supportsCatalogsInDataManipulation()
- 【機能】
-
データ操作文でカタログ名を使用できるかどうかを返します。
- 【形式】
public boolean supportsCatalogsInDataManipulation() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:カタログ名を使用できます。
false:カタログ名を使用できません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(cz) supportsCatalogsInIndexDefinitions()
- 【機能】
-
インデクス定義文でカタログ名を使用できるかどうかを返します。
- 【形式】
public boolean supportsCatalogsInIndexDefinitions() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:カタログ名を使用できます。
false:カタログ名を使用できません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(da) supportsCatalogsInPrivilegeDefinitions()
- 【機能】
-
特権定義文でカタログ名を使用できるかどうかを返します。
- 【形式】
public boolean supportsCatalogsInPrivilegeDefinitions() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:カタログ名を使用できます。
false:カタログ名を使用できません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(db) supportsCatalogsInProcedureCalls()
- 【機能】
-
プロシジャ呼び出し文でカタログ名を使用できるかどうかを返します。
- 【形式】
public boolean supportsCatalogsInProcedureCalls() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:カタログ名を使用できます。
false:カタログ名を使用できません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dc) supportsCatalogsInTableDefinitions()
- 【機能】
-
テーブル定義文でカタログ名を使用できるかどうかを返します。
- 【形式】
public boolean supportsCatalogsInTableDefinitions() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:カタログ名を使用できます。
false:カタログ名を使用できません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dd) supportsColumnAliasing()
- 【機能】
-
カラムの別名をサポートしているかどうかを返します。
- 【形式】
public boolean supportsColumnAliasing() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(de) supportsConvert()
- 【機能】
-
SQLタイプ間のCONVERT関数をサポートしているかどうかを返します。
- 【形式】
public boolean supportsConvert() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(df) supportsConvert(int fromType, int toType)
- 【機能】
-
与えられたSQLタイプ間のCONVERT関数をサポートしているかどうかを返します。
- 【形式】
public boolean supportsConvert(int fromType, int toType) throws SQLException
- 【引数】
-
- int fromType:
-
変換元の型。java.sql.Typesクラスの型コードです。
- int toType:
-
変換先の型。java.sql.Typesクラスの型コードです。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
変換元の型と変換先の型の組み合わせによって値を返します。変換元の型と変換先の型の組み合わせでの戻り値を次の表に示します。
表17‒56 変換元の型と変換先の型での組み合わせでの戻り値(その1) 変換元の型
java.sql.Typesの型
変換先の型
java.sql.Typesの型
BIT
TINYINT
SMALLINT
INTEGER
BIGINT
FLOAT
REAL
DOUBLE
NUMERIC
DECIMAL
CHAR
VARCHAR
LONGVARCHAR
BIT
1
1
1
1
1
1
1
1
1
1
1
1
1
TINYINT
1
1
1
1
1
1
1
1
1
1
1
1
1
SMALLINT
1
1
1
1
1
1
1
1
1
1
1
1
1
INTEGER
1
1
1
1
1
1
1
1
1
1
1
1
1
BIGINT
1
1
1
1
1
1
1
1
1
1
1
1
1
FLOAT
1
1
1
1
1
1
1
1
1
1
1
1
1
REAL
1
1
1
1
1
1
1
1
1
1
1
1
1
DOUBLE
1
1
1
1
1
1
1
1
1
1
1
1
1
NUMERIC
1
1
1
1
1
1
1
1
1
1
1
1
1
DECIMAL
1
1
1
1
1
1
1
1
1
1
1
1
1
CHAR
1
1
1
1
1
1
1
1
1
1
1
1
1
VARCHAR
1
1
1
1
1
1
1
1
1
1
1
1
1
LONGVARCHAR
1
1
1
1
1
1
1
1
1
1
1
1
1
DATE
0
0
0
0
0
0
0
0
0
0
1
1
1
TIME
0
0
0
0
0
0
0
0
0
0
1
1
1
TIMESTAMP
0
0
0
0
0
0
0
0
0
0
1
1
1
BINARY
0
0
0
0
0
0
0
0
0
0
0
0
0
VARBINARY
0
0
0
0
0
0
0
0
0
0
0
0
0
LONGVARBINARY
0
0
0
0
0
0
0
0
0
0
0
0
0
JAVA_OBJECT
0
0
0
0
0
0
0
0
0
0
0
0
0
STRUCT
0
0
0
0
0
0
0
0
0
0
0
0
0
ARRAY
0
0
0
0
0
0
0
0
0
0
0
0
0
BLOB
0
0
0
0
0
0
0
0
0
0
0
0
0
CLOB
0
0
0
0
0
0
0
0
0
0
0
0
0
REF
0
0
0
0
0
0
0
0
0
0
0
0
0
- (凡例)
-
0:false 1:true
表17‒57 変換元の型と変換先の型での組み合わせでの戻り値(その2) 変換元の型
java.sql.Typesの型
変換先の型
java.sql.Typesの型
DATE
TIME
TIMESTAMP
BINARY
VARBINARY
LONGVARBINARY
JAVA_OBJECT
STRUCT
ARRAY
BLOB
CLOB
REF
BIT
0
0
0
0
0
0
0
0
0
0
0
0
TINYINT
0
0
0
0
0
0
0
0
0
0
0
0
SMALLINT
0
0
0
0
0
0
0
0
0
0
0
0
INTEGER
0
0
0
0
0
0
0
0
0
0
0
0
BIGINT
0
0
0
0
0
0
0
0
0
0
0
0
FLOAT
0
0
0
0
0
0
0
0
0
0
0
0
REAL
0
0
0
0
0
0
0
0
0
0
0
0
DOUBLE
0
0
0
0
0
0
0
0
0
0
0
0
NUMERIC
0
0
0
0
0
0
0
0
0
0
0
0
DECIMAL
0
0
0
0
0
0
0
0
0
0
0
0
CHAR
1
1
1
0
0
0
0
0
0
0
0
0
VARCHAR
1
1
1
0
0
0
0
0
0
0
0
0
LONGVARCHAR
1
1
1
0
0
0
0
0
0
0
0
0
DATE
1
0
1
0
0
0
0
0
0
0
0
0
TIME
0
1
0
0
0
0
0
0
0
0
0
0
TIMESTAMP
1
0
1
0
0
0
0
0
0
0
0
0
BINARY
0
0
0
1
1
1
0
0
0
0
0
0
VARBINARY
0
0
0
1
1
1
0
0
0
0
0
0
LONGVARBINARY
0
0
0
1
1
1
0
0
0
0
0
0
JAVA_OBJECT
0
0
0
0
0
0
0
0
0
0
0
0
STRUCT
0
0
0
0
0
0
0
0
0
0
0
0
ARRAY
0
0
0
0
0
0
0
0
0
0
0
0
BLOB
0
0
0
0
0
0
0
0
0
0
0
0
CLOB
0
0
0
0
0
0
0
0
0
0
0
0
REF
0
0
0
0
0
0
0
0
0
0
0
0
- (凡例)
-
0:false 1:true
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dg) supportsCoreSQLGrammar()
- 【機能】
-
ODBC Core SQL文法をサポートしているかどうかを返します。
- 【形式】
public boolean supportsCoreSQLGrammar() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(di) supportsDataDefinitionAndDataManipulationTransactions()
- 【機能】
-
トランザクションで,データ定義文とデータ操作文の両方をサポートしているかどうかを返します。
- 【形式】
public boolean supportsDataDefinitionAndDataManipulationTransactions() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
サーバがHiRDBの場合,falseを返します。
サーバがXDM/RD E2の場合,trueを返します。
- 注意:
-
サーバがXDM/RD E2の場合,データ操作文を実行したトランザクションが決着していない状態で,データ定義文を実行できます。ただし,データ定義文がトランザクションを強制的にコミットさせます。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dj) supportsDataManipulationTransactionsOnly()
- 【機能】
-
トランザクションで,データ操作文だけをサポートしているかどうかを返します。
- 【形式】
public boolean supportsDataManipulationTransactionsOnly() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dk) supportsDifferentTableCorrelationNames()
- 【機能】
-
テーブル相互関連名がサポートされている場合,テーブルの名前と異なる名前にするという制限があるかどうかを返します。
- 【形式】
public boolean supportsDifferentTableCorrelationNames() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:制限があります。
false:制限がありません。
- 【機能詳細】
-
サーバがHiRDBの場合,falseを返します。
サーバがXDM/RD E2の場合,trueを返します。
- 注意:
-
サーバがXDM/RD E2の場合,XDM/RD E2のRD環境定義で,RANGE VARIABLEオペランドにUSE(デフォルトはNOUSE)を指定しているときは,テーブルの名前と同じ相関名を使用できます。しかし,JDBCドライバは,RANGE VARIABLEオペランドの情報をサーバから取得していないので,このメソッドは,デフォルトのNOUSEであると仮定してtrueを返します。JDBCドライバ自身は,テーブルの名前と同じ相関名の使用を制限していません。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dl) supportsExpressionsInOrderBy()
- 【機能】
-
"ORDER BY"リスト中の式をサポートしているかどうかを返します。
- 【形式】
public boolean supportsExpressionsInOrderBy() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
サーバがHiRDBの場合,falseを返します。
サーバがXDM/RD E2の場合,trueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dm) supportsExtendedSQLGrammar()
- 【機能】
-
ODBC Extended SQL文法をサポートしているかどうかを返します。
- 【形式】
public boolean supportsExtendedSQLGrammar() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dn) supportsFullOuterJoins()
- 【機能】
-
完全ネストの外部結合をサポートしているかどうかを返します。
- 【形式】
public boolean supportsFullOuterJoins() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(do) supportsGetGeneratedKeys()
- 【機能】
-
文が実行された後に自動生成キーを取得できるかどうかを返します。
- 【形式】
public boolean supportsGetGeneratedKeys() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:自動生成キーを取得できます。
false:自動生成キーを取得できません。
- 【機能詳細】
-
Type4 JDBCドライバでは,自動生成キーは未サポートのため,常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dp) supportsGroupBy()
- 【機能】
-
"GROUP BY"節のフォームをサポートしているかどうかを返します。
- 【形式】
public boolean supportsGroupBy() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dq) supportsGroupByBeyondSelect()
- 【機能】
-
SELECT中のすべてのカラムを指定するという条件で,"GROUP BY"節がSELECT中にないカラムを使用できるかどうかを返します。
- 【形式】
public boolean supportsGroupByBeyondSelect() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:使用できます。
false:使用できません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ds) supportsIntegrityEnhancementFacility()
- 【機能】
-
SQL Integrity Enhancement Facilityをサポートしているかどうかを返します。
- 【形式】
public boolean supportsIntegrityEnhancementFacility() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dt) supportsLikeEscapeClause()
- 【機能】
-
"LIKE"節で,エスケープ文字をサポートしているかどうかを返します。
- 【形式】
public boolean supportsLikeEscapeClause() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(du) supportsLimitedOuterJoins()
- 【機能】
-
外部結合に関し,制限されたサポートがあるかどうかを返します。
- 【形式】
public boolean supportsLimitedOuterJoins() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dv) supportsMinimumSQLGrammar()
- 【機能】
-
ODBC Minimum SQL文法をサポートしているかどうかを返します。
- 【形式】
public boolean supportsMinimumSQLGrammar() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dw) supportsMixedCaseIdentifiers()
- 【機能】
-
大文字と小文字が混在する引用符なしのSQL識別子を,大文字と小文字を区別して処理し,結果として大文字と小文字を混在して格納するかどうかを返します。
- 【形式】
public boolean supportsMixedCaseIdentifiers() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:結果として大文字と小文字を混在して格納します。
false:結果として大文字と小文字を混在して格納しません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dx) supportsMixedCaseQuotedIdentifiers()
- 【機能】
-
大文字と小文字が混在する引用符付きのSQL識別子を,大文字と小文字を区別して処理し,結果として大文字と小文字を混在して格納するかどうかを返します。
- 【形式】
public boolean supportsMixedCaseQuotedIdentifiers() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:結果として大文字と小文字を混在して格納します。
false:結果として大文字と小文字を混在して格納しません。
- 【機能詳細】
-
常にtrueを返します。
- 注意:
-
サーバがXDM/RD E2の場合,XDM/RD E2のRD環境定義で,DELIMITED ID UPPERオペランドにYES(デフォルトはNO)を指定しているときは大文字で格納しますが,JDBCドライバは,DELIMITED ID UPPERオペランドの情報をサーバから取得していないので,デフォルトのNOであると仮定して処理します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dy) supportsMultipleOpenResults()
- 【機能】
-
CallableStatementオブジェクトから同時に返された複数のResultSetオブジェクトを持つことが可能かどうかを返します。
- 【形式】
public boolean supportsMultipleOpenResults() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:CallableStatementオブジェクトが複数のResultSetオブジェクトを同時に返すことができます。
false:CallableStatementオブジェクトが複数のResultSetオブジェクトを同時に返すことができません。
- 【機能詳細】
-
サーバがHiRDBの場合,trueを返します。
サーバがXDM/RD E2の場合,falseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(dz) supportsMultipleResultSets()
- 【機能】
-
単一のexecuteメソッド実行からの複数ResultSetをサポートしているかどうかを返します。
- 【形式】
public boolean supportsMultipleResultSets() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ea) supportsMultipleTransactions()
- 【機能】
-
一度に複数のトランザクションを(異なった接続に関し)オープンできるかどうかを返します。
- 【形式】
public boolean supportsMultipleTransactions() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:オープンできます。
false:オープンできません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(eb) supportsNamedParameters()
- 【機能】
-
callable文への名前付きパラメータがサポートされるかどうかを返します。
- 【形式】
public boolean supportsNamedParameters() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ec) supportsNonNullableColumns()
- 【機能】
-
列を非nullとして定義できるかどうかを返します。
- 【形式】
public boolean supportsNonNullableColumns() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:定義できます。
false:定義できません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ed) supportsOpenCursorsAcrossCommit()
- 【機能】
-
カーソルをコミット間でオープンされた状態のままにできるかどうかを返します。
- 【形式】
public boolean supportsOpenCursorsAcrossCommit() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:カーソルをコミット間でオープンされた状態のままにできます。
false:カーソルをコミット間でオープンされた状態のままにできません。
- 【機能詳細】
-
Connectionインスタンス生成時のカーソル動作モード(HIRDB_CURSOR)で,ホールダブルカーソルを有効とした場合はtrue,無効とした場合はfalseを返します。カーソル動作モードの指定方法については,「ユーザプロパティ」を参照してください。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ee) supportsOpenCursorsAcrossRollback()
- 【機能】
-
カーソルをロールバック間でオープンされた状態のままにできるかどうかを返します。
- 【形式】
public boolean supportsOpenCursorsAcrossRollback() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:カーソルをロールバック間でオープンされた状態のままにできます。
false:カーソルをロールバック間でオープンされた状態のままにできません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ef) supportsOpenStatementsAcrossCommit()
- 【機能】
-
文をコミット間でオープンされた状態のままにできるかどうかを返します。
- 【形式】
public boolean supportsOpenStatementsAcrossCommit() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:文をコミット間でオープンされた状態のままにできます。
false:文をコミット間でオープンされた状態のままにできません。
- 【機能詳細】
-
Connectionインスタンス生成時のURL指定項目STATEMENT_COMMIT_BEHAVIORで,TRUEを指定するか同指定項目を省略した場合はtrue,同指定項目でFALSEを指定した場合はfalseを返します。URL指定項目STATEMENT_COMMIT_BEHAVIORの指定方法については,「ユーザプロパティ」を参照してください。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(eg) supportsOpenStatementsAcrossRollback()
- 【機能】
-
文をロールバック間でオープンされた状態のままにできるかどうかを返します。
- 【形式】
public boolean supportsOpenStatementsAcrossRollback() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:文をロールバック間でオープンされた状態のままにできます。
false:文をロールバック間でオープンされた状態のままにできません。
- 【機能詳細】
-
Connectionインスタンス生成時のURL指定項目STATEMENT_COMMIT_BEHAVIORで,TRUEを指定するか同指定項目を省略した場合はtrue,同指定項目でFALSEを指定した場合はfalseを返します。URL指定項目STATEMENT_COMMIT_BEHAVIORの指定方法については,「ユーザプロパティ」を参照してください。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ei) supportsOuterJoins()
- 【機能】
-
何らかの外部結合のフォームをサポートしているかどうかを返します。
- 【形式】
public boolean supportsOuterJoins() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ej) supportsPositionedDelete()
- 【機能】
-
位置決めされたDELETEをサポートしているかどうかを返します。
- 【形式】
public boolean supportsPositionedDelete() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ek) supportsPositionedUpdate()
- 【機能】
-
位置決めされたUPDATEをサポートしているかどうかを返します。
- 【形式】
public boolean supportsPositionedUpdate() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(el) supportsResultSetConcurrency(int type, int concurrency)
- 【機能】
-
指定されたResultSetタイプと並行処理タイプの組み合わせをサポートしているかどうかを返します。
- 【形式】
public boolean supportsResultSetConcurrency(int type, int concurrency) throws SQLException
- 【引数】
-
- int type:
-
結果セットタイプjava.sql.ResultSetで定義されている型
- int concurrency:
-
並行処理タイプjava.sql.ResultSetで定義されている型
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
typeがTYPE_FORWARD_ONLY又はTYPE_SCROLL_INSENSITIVE,かつconcurrencyがCONCUR_READ_ONLYの場合,trueを返します。
上記以外はfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(em) supportsResultSetHoldability(int holdability)
- 【機能】
-
指定されたResultSetオブジェクトの保持機能を,サポートしているかどうかを返します。
- 【形式】
public boolean supportsResultSetHoldability(int holdability) throws SQLException
- 【引数】
-
- int holdability:
-
定数。
ResultSet.HOLD_CURSORS_OVER_COMMIT:Connection.commitメソッドが呼び出されたときにResultSetオブジェクトがクローズされません。
ResultSet.CLOSE_CURSORS_AT_COMMIT:Connection.commitメソッドが呼び出されたときにResultSetオブジェクトがクローズされます。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
指定されたResultSetオブジェクトの保持機能を,サポートしているかどうかを返します。次の値を返します。
引数holdability
HIRDB_CURSOR※
有効
無効
HOLD_CURSORS_OVER_COMMIT
trueを返します。
falseを返します。
CLOSE_CURSORS_AT_COMMIT
falseを返します。
trueを返します。
- 注※
-
Connectionインスタンス生成時のカーソル動作モード(HIRDB_CURSOR)
カーソル動作モードの指定方法については,「ユーザプロパティ」を参照してください。
- 【発生する例外】
-
次のどちらかの場合,例外SQLExceptionを投入します。
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行した場合
-
引数holdabilityの指定値が不正な場合
-
(en) supportsResultSetType(int type)
- 【機能】
-
指定されたResultSetタイプをサポートしているかどうかを返します。
- 【形式】
public boolean supportsResultSetType(int type) throws SQLException
- 【引数】
-
- int type:
-
結果セットタイプjava.sql.ResultSetで定義されている型結果セットタイプ
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
typeがTYPE_FORWARD_ONLY又はTYPE_SCROLL_INSENSITIVEの場合,trueを返します。
上記以外はfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(eo) supportsSavepoints()
- 【機能】
-
セーブポイントをサポートしているかどうかを返します。
- 【形式】
public boolean supportsSavepoints() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
HiRDB,XDM/RD E2ではセーブポイントは未サポートのため,常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ep) supportsSchemasInDataManipulation()
- 【機能】
-
データ操作文でスキーマ名を使用できるかどうかを返します。
- 【形式】
public boolean supportsSchemasInDataManipulation() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:スキーマ名を使用できます。
false:スキーマ名を使用できません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(eq) supportsSchemasInIndexDefinitions()
- 【機能】
-
インデクス定義文でスキーマ名を使用できるかどうかを返します。
- 【形式】
public boolean supportsSchemasInIndexDefinitions() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:スキーマ名を使用できます。
false:スキーマ名を使用できません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(er) supportsSchemasInPrivilegeDefinitions()
- 【機能】
-
特権定義文でスキーマ名を使用できるかどうかを返します。
- 【形式】
public boolean supportsSchemasInPrivilegeDefinitions() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:スキーマ名を使用できます。
false:スキーマ名を使用できません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(es) supportsSchemasInProcedureCalls()
- 【機能】
-
プロシジャ呼び出し文でスキーマ名を使用できるかどうかを返します。
- 【形式】
public boolean supportsSchemasInProcedureCalls() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:スキーマ名を使用できます。
false:スキーマ名を使用できません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(et) supportsSchemasInTableDefinitions()
- 【機能】
-
テーブル定義文でスキーマ名を使用できるかどうかを返します。
- 【形式】
public boolean supportsSchemasInTableDefinitions() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:スキーマ名を使用できます。
false:スキーマ名を使用できません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(eu) supportsSelectForUpdate()
- 【機能】
-
UPDATE用のSELECTをサポートしているかどうかを返します。
- 【形式】
public boolean supportsSelectForUpdate() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ev) supportsStatementPooling()
- 【機能】
-
文のプールをサポートしているかどうかを返します。
- 【形式】
public boolean supportsStatementPooling() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
Type4 JDBCドライバでは未サポートのため,常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ew) supportsStoredProcedures()
- 【機能】
-
ストアドプロシジャコールをサポートしているかどうかを返します。
- 【形式】
public boolean supportsStoredProcedures() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ex) supportsSubqueriesInComparisons()
- 【機能】
-
比較式中でサブクエリーをサポートしているかどうかを返します。
- 【形式】
public boolean supportsSubqueriesInComparisons() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:スキーマ名を使用できます。
false:スキーマ名を使用できません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ey) supportsSubqueriesInExists()
- 【機能】
-
"exists"式中でサブクエリーをサポートしているかどうかを返します。
- 【形式】
public boolean supportsSubqueriesInExists() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ez) supportsSubqueriesInIns()
- 【機能】
-
"in"文中でサブクエリーをサポートしているかどうかを返します。
- 【形式】
public boolean supportsSubqueriesInIns() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:スキーマ名を使用できます。
false:スキーマ名を使用できません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(fa) supportsSubqueriesInQuantifieds()
- 【機能】
-
定量化された式中でサブクエリーをサポートしているかどうかを返します。
- 【形式】
public boolean supportsSubqueriesInQuantifieds() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(fb) supportsTableCorrelationNames()
- 【機能】
-
テーブル相互関連名をサポートしているかどうかを返します。
- 【形式】
public boolean supportsTableCorrelationNames() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:スキーマ名を使用できます。
false:スキーマ名を使用できません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(fc) supportsTransactionIsolationLevel(int level)
- 【機能】
-
与えられたトランザクションアイソレーションレベルをサポートしているかどうかを返します。
- 【形式】
public boolean supportsTransactionIsolationLevel(int level) throws SQLException
- 【引数】
-
- int level:
-
java.sql.Connectionで定義されているトランザクション遮断レベル
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
levelがTRANSACTION_REPEATABLE_READ,TRANSACTION_READ_COMMITTED,TRANSACTION_READ_UNCOMMITTEDの場合にtrueを返します。
上記以外の場合はfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(fd) supportsTransactions()
- 【機能】
-
トランザクションをサポートしているかどうかを返します。
- 【形式】
public boolean supportsTransactions() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:スキーマ名を使用できます。
false:スキーマ名を使用できません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(fe) supportsUnion()
- 【機能】
-
SQL UNIONをサポートしているかどうかを返します。
- 【形式】
public boolean supportsUnion() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(ff) supportsUnionAll()
- 【機能】
-
SQL UNION ALLをサポートしているかどうかを返します。
- 【形式】
public boolean supportsUnionAll() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートしています。
false:サポートしていません。
- 【機能詳細】
-
常にtrueを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(fg) updatesAreDetected(int type)
- 【機能】
-
指定されたResultSetタイプで,ResultSetに行われた更新をResultSet.rowUpdatedメソッドによって検出できるかどうかを返します。
- 【形式】
public boolean updatesAreDetected(int type) throws SQLException
- 【引数】
-
- int type:
-
ResultSetの型。次のどれかです。
-
ResultSet.TYPE_FORWARD_ONLY
-
ResultSet.TYPE_SCROLL_INSENSITIVE
-
ResultSet.TYPE_SCROLL_SENSITIVE
-
- 【戻り値】
-
- boolean型:
-
true:検出できます。
false:検出できません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(fh) usesLocalFilePerTable()
- 【機能】
-
各テーブルにファイルを使用するかどうかを返します。
- 【形式】
public boolean usesLocalFilePerTable() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:使用します。
false:使用しません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(fi) usesLocalFiles()
- 【機能】
-
ローカルファイルにテーブルを格納するかどうかを返します。
- 【形式】
public boolean usesLocalFiles() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:格納します。
false:格納しません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(fj) getRowIdLifetime()
- 【機能】
-
RowId型をサポートしているかどうかを返します。RowId型をサポートしている場合は,RowIdオブジェクトが有効になっている寿命を返します。
- 【形式】
public RowIdLifetime getRowIdLifetime() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- RowIdLifeTime型:
-
ROWID_UNSUPPORTED:ROWID型をサポートしていません。
ROWID_VALID_OTHER:ROWIDの寿命が不確定です。
ROWID_VALID_SESSION:ROWIDの寿命がセッション中です。
ROWID_VALID_TRANSACTION:ROWIDの寿命がトランザクション中です。
ROWID_VALID_FOREVER:ROWIDの寿命が無期限です。
- 【機能詳細】
-
常にROWID_UNSUPPORTEDを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(fk) getSchemas(String catalog, String schemaPattern)
- 【機能】
-
使用できるスキーマ名に関する情報を返します。
- 【形式】
public ResultSet getSchemas(String catalog,String schemaPattern) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名。このドライバでは無視します。
- String schemaPattern:
-
スキーマ名パターン。null又は0長文字を指定している場合,スキーマ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
HiRDBサーバに存在するすべてのスキーマ名に関する情報を返します。システム共通定義にpd_security_host_groupを指定し,指定値にUAPが動作するクライアントマシンのホストが含まれていない場合,SQLExceptionを投入します。
返却するResultSetの形式を次の表に示します。
表17‒58 返却するResultSetの形式(getSchemasメソッド) 型
SQL型
列名
列の意味
String
VARCHAR
TABLE_SCHEM
認可識別子名。
String
CHAR
TABLE_CATALOG
常にNULL値を返します。
- 【発生する例外】
-
次の場合,SQLExceptionを投入します。
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している
-
データベースアクセスエラーが発生した
-
システム共通定義にpd_security_host_groupを指定し,指定値にUAPが動作するクライアントマシンのホストが含まれていない
-
(fl) supportsStoredFunctionsUsingCallSyntax()
- 【機能】
-
プロシジャエスケープ構文を使用した,ユーザ定義関数又はベンダー関数の呼び出しをサポートするかどうかを返します。
- 【形式】
public boolean supportsStoredFunctionsUsingCallSyntax() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:サポートします。
false:サポートしません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(fm) autoCommitFailureClosesAllResultSets()
- 【機能】
-
オートコミット有効時にSQLExceptionが発生した場合,オープンされたすべてのResultSetがクローズされるかどうかを返します。
- 【形式】
public boolean autoCommitFailureClosesAllResultSets() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:クローズします。
false:クローズしません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(fn) getClientInfoProperties()
- 【機能】
-
JDBCドライバがサポートするクライアント情報プロパティのリスト情報を取得します。
- 【形式】
public ResultSet getClientInfoProperties() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
JDBCドライバがサポートするクライアント情報プロパティのリスト情報を返します。常に検索結果行数0のResultSetを返します。返却するResultSetの形式を次の表に示します。
表17‒59 返却するResultSetの形式(getClientInfoPropertiesメソッド) 列番号
型
SQL型
列名
列の意味
1
String
CHAR
NAME
クライアント情報プロパティの名前
2
int
INTEGER
MAX_LEN
プロパティの値の最大長
3
String
CHAR
DEFAULT_VALUE
プロパティのデフォルト値
4
String
CHAR
DESCRIPTION
プロパティの記述
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(fo) getFunctions(String catalog, String schemaPattern, String functionNamePattern)
- 【機能】
-
関数に関する情報を返します。
- 【形式】
public ResultSet getFunctions(String catalog, String schemaPattern, String functionNamePattern) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名。このドライバでは無視します。
- String schemaPattern:
-
スキーマ名パターン。null又は0長文字を指定している場合,スキーマ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- String functionNamePattern:
-
関数名パターン。関数名と一致しなければなりません。引数の値は大文字と小文字を区別します。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
指定されたユーザ定義関数に関する情報を返します。HiRDBサーバにSQL_ROUTINES表が定義されていない場合,検索結果行数0のResultSetを返します。返却するResultSetの形式を次の表に示します。
表17‒60 返却するResultSetの形式(getFunctionsメソッド) 列番号
型
SQL型(Types)
列名
ソート※
列の意味
1
String
CHAR
FUNCTION_CAT
−
カタログ名
常にnull値を返します。
2
String
VARCHAR
FUNCTION_SCHEM
1(昇順)
認可識別子名
3
String
VARCHAR
FUNCTION_NAME
2(昇順)
関数名
4
String
VARCHAR
REMARKS
−
関数に関する説明
常にnull値を返します。
5
Short
SMALLINT
FUNCTION_TYPE
−
関数の種類
-
functionResultUnknown
戻り値又はテーブルが返されるかどうか判断できません。
-
functionNoTable
テーブルが返されません。
-
functionReturnsTable
テーブルが返されます。
常にfunctionNoTableを返します。
6
String
VARCHAR
SPECIFIC_NAME
3(昇順)
この関数をそのスキーマ内で一意に識別する名前
- (凡例)
-
−:該当しません。
- 注※
-
ソートのキー列の優先順位を示します。
-
- 【発生する例外】
-
次の場合,SQLExceptionを投入します。
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合
-
データベースアクセスエラーが発生した場合
-
(fp) getFunctionColumns(String catalog,String schemaPattern,String functionNamePattern,String columnNamePattern)
- 【機能】
-
関数のパラメタと返される型に関する情報を返します。
- 【形式】
public ResultSet getFunctionColumns(String catalog, String schemaPattern, String functionNamePattern, String columnNamePattern) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名。このドライバでは無視します。
- String schemaPattern:
-
スキーマ名パターン。null又は0長文字を指定している場合,スキーマ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- String functionNamePattern:
-
関数名パターン。null又は0長文字を指定している場合,関数名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- String columnNamePattern:
-
パラメタ名パターン。null又は0長文字を指定している場合,パラメタ名を検索の限定に使用しません。引数の値は大文字と小文字を区別します。
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
指定されたユーザ定義関数のパラメタと返される型に関する情報を返します。HiRDBサーバにSQL_ROUTINE_PARAMS表が定義されていない場合,検索結果行数0のResultSetを返します。返却するResultSetの形式を次の表に示します。
表17‒61 返却するResultSetの形式(getFunctionColumnsメソッド) 列番号
型
SQL型(Types)
列名
ソート※
列の意味
1
String
CHAR
FUNCTION_CAT
−
カタログ名
常にnull値を返します。
2
String
VARCHAR
FUNCTION_SCHEM
1(昇順)
認可識別子名
3
String
VARCHAR
FUNCTION_NAME
2(昇順)
関数名
4
String
VARCHAR
COLUMN_NAME
−
列/パラメタ名
5
short
SMALLINT
COLUMN_TYPE
−
列の種類/パラメタ
-
functionColumnUnknown
不明
-
functionColumnIn
INパラメタ
-
functionColumnInOut
INOUTパラメタ
-
functionColumnOut
OUTパラメタ
-
functionReturn
関数の戻り値
-
functionColumnResult
パラメタ又は列がResultSetの列
functionColumnIn,functionColumnInOut,functionColumnOut,及び
functionColumnResultについては設定しません。
6
int
INTEGER
DATA_TYPE
−
パラメタのSQL型(java.sql.Typesで定義されている値)
7
String
CHAR
TYPE_NAME
−
パラメタのSQL型名(型名を文字列で表現したもの)
8
int
INTEGER
PRECISION
−
パラメタの精度
-
数値データの場合
最大精度
-
文字データの場合
文字数
-
日時データ型の場合
String表現の文字数
-
バイナリデータの場合
バイト数
9
int
INTEGER
LENGTH
−
パラメタのサイズ
バイト数を返します。
DECIMAL型は精度に符号とピリオドを加えるため,位取りなしの場合は精度+1,位取りありの場合は精度+2となります。
10
short
SMALLINT
SCALE
−
パラメタの位取り(小数部分のけた数)
パラメタのSQL型名がDECIMAL又はTIMESTAMP以外の場合は,0を返します。
11
short
SMALLINT
RADIX
−
パラメタの基数
-
概数値:2
-
真数値:10
-
数値以外:0
12
short
SMALLINT
NULLABLE
−
null値可否
-
functionNoNulls
null値を許しません。
-
functionNullable
null値を許します。
-
functionNullableUnknown
null値を許すかどうかは不明です。
常に,functionNullableを返します。
13
String
VARCHAR
REMARKS
−
パラメタに関するコメント
常にnull値を返します。
14
int
INTEGER
CHAR_OCTET_LENGTH
−
バイナリと文字ベースのパラメタ又は列の最大長
15
int
INTEGER
ORDINAL_POSITION
4(昇順)
入力及び出力パラメタの1から始まる順番
関数の戻り値の場合は0を返します。
16
String
CHAR
IS_NULLABLE
−
パラメタ又は列でnull値を許可するかどうか
-
YES
null値を許します。
-
NO
null値を許しません。
-
空白
null値を許すかどうかは不明です。
常にYESを返します。
17
String
VARCHAR
SPECIFIC_NAME
3(昇順)
この関数をスキーマ内で一意に識別する名前
- (凡例)
-
−:該当しません。
- 注※
-
ソートのキー列の優先順位を示します。
-
- 【発生する例外】
-
次の場合,SQLExceptionを投入します。
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合
-
データベースアクセスエラーが発生した場合
-
(fq) getPseudoColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern)
- 【機能】
-
擬似列,隠し列の説明を返します。
- 【形式】
public ResultSet getPseudoColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern) throws SQLException
- 【引数】
-
- String catalog:
-
カタログ名
- String schemaPattern:
-
スキーマ名パターン
- String tableNamePattern:
-
表名パターン
- String columnNamePattern:
-
パラメタ名パターン
- 【戻り値】
-
ResultSetオブジェクト
- 【機能詳細】
-
常に検索結果行数0のResultSetを返します。返却するResultSetの形式を次の表に示します。
表17‒62 返却するResultSetの形式(getPseudoColumnsメソッド) 列番号
型
SQL型(Types)
列名
列の意味
1
String
CHAR
TABLE_CAT
カタログ名
2
String
VARCHAR
TABLE_SCHEM
認可識別子名
3
String
VARCHAR
TABLE_NAME
表名
4
String
VARCHAR
COLUMN_NAME
列名
5
int
INTEGER
DATA_TYPE
パラメタのSQL型
6
int
INTEGER
COLUMN_SIZE
列の定義長
7
int
INTEGER
DECIMAL_DIGITS
小数点以下の桁数
8
int
INTEGER
NUM_PREC_RADIX
パラメタの基数
9
String
VARCHAR
COLUMN_USAGE
列の許可された使用法
10
String
VARCHAR
REMARKS
列を記述するコメント
11
int
INTEGER
CHAR_OCTET_LENGTH
バイナリと文字ベースのパラメタ又は列の最大長(バイト数)
12
String
CHAR
IS_NULLABLE
パラメタ又は列でnull値を許可するかどうか
- 【発生する例外】
-
次の場合,SQLExceptionを投入します。
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合
-
データベースアクセスエラーが発生した場合
-
(fr) generatedKeyAlwaysReturned()
- 【機能】
-
自動生成キーの列を表す指定された列名又はインデックスが有効であり,SQL文が成功した場合に生成されたキーが常に返されるかどうかを返します。
- 【形式】
public boolean generatedKeyAlwaysReturned() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
- boolean型:
-
true:キーを返します。
false:キーを返しません。
- 【機能詳細】
-
常にfalseを返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(fs) getMaxLogicalLobSize()
- 【機能】
-
このデータベースでLOBの論理サイズとして許容される最大バイト数を返します。
- 【形式】
public boolean getMaxLogicalLobSize() throws SQLException
- 【引数】
-
なし。
- 【戻り値】
-
最大バイト数
- 【機能詳細】
-
常に2147483647を返します。
- 【発生する例外】
-
このメソッド実行前にConnectionオブジェクトに対してclose()を実行している場合,SQLExceptionを投入します。
(3) パッケージ名称及びクラス名称
このインタフェースを実装するパッケージ名称とクラス名称を次に示します。
パッケージ名称:JP.co.Hitachi.soft.HiRDB.JDBC
クラス名称:PrdbDatabaseMetaData
(4) 注意事項
(a) 1コネクション当たりのステートメントオブジェクト数の上限
ResultSetを返却するDatabaseMetaDataのメソッドでは,内部的にステートメントオブジェクトを使用しているため,ステートメントオブジェクト数が4096以上となった場合,SQLExceptionを投入します。詳細は「Statementインタフェース」の「注意事項」を参照してください。