8.7.78 getTables(String catalog, String schemaPattern, String tableNamePattern, String[] types)
- 〈この項の構成〉
(1) 機能
表に関する情報を取得します。
このメソッドを実行したHADBユーザが持っている権限によって,取得できる表の情報が変わります。権限と取得できる表の情報については,マニュアルHADB システム構築・運用ガイドのHADBユーザが参照できるディクショナリ表とシステム表の範囲を参照してください。
(2) 形式
public synchronized ResultSet getTables(String catalog, String schemaPattern, String tableNamePattern, String[] types) throws SQLException
(3) 引数
- String catalog:
-
カタログ名を指定します。ただし,指定しても無視されます。
- String schemaPattern:
-
スキーマ名パターン※を指定します。大文字と小文字は区別されます。
- String tableNamePattern:
-
表名パターン※を指定します。大文字と小文字は区別されます。
- String[] types:
-
表の型のリストを指定します。getTableTypesメソッドによって返却される表の型を指定します。大文字と小文字は区別されます。
nullを指定した場合,すべての表の種類が指定されたと仮定されます。
- 注※
-
各パターンに指定できる特殊文字については,「8.7.1 DatabaseMetaDataインタフェースのメソッド一覧」の「(4) パターン文字列中に指定できる特殊文字」を参照してください。
(4) 戻り値
ResultSetオブジェクトが返却されます。返却されるResultSetオブジェクトの形式を次の表に示します。
列番号 |
型 |
列名 |
列の意味 |
---|---|---|---|
1 |
String |
TABLE_CAT |
常に空の文字列を返します。 |
2 |
String |
TABLE_SCHEM |
スキーマ名 |
3 |
String |
TABLE_NAME |
表名 |
4 |
String |
TABLE_TYPE |
表の種類
|
5 |
String |
REMARKS |
常に空の文字列を返します。 |
6 |
String |
TYPE_CAT |
常に空の文字列を返します。 |
7 |
String |
TYPE_SCHEM |
常に空の文字列を返します。 |
8 |
String |
TYPE_NAME |
常に空の文字列を返します。 |
9 |
String |
SELF_REFERENCING_COL_NAME |
常に空の文字列を返します。 |
10 |
String |
REF_GENERATION |
常に空の文字列を返します。 |
(5) 発生する例外
次に示す場合にSQLExceptionが投入されます。
-
このメソッドを実行する前に,Connectionオブジェクトがクローズされている場合
-
引数String[] typesの1つ以上の要素がnullである場合
-
引数String[] typesの1つ以上の要素が,次のすべての文字列に該当しない場合
"TABLE","VIEW","SYSTEM TABLE"