odbc_tables

説明

指定した範囲の全てのテーブルリストを得ます。ODBC結果IDまたは失敗 した際にFALSEを返します。

結果は以下のカラムを有します。

• TABLE_QUALIFIER

• TABLE_OWNER

• TABLE_NAME

• TABLE_TYPE

• REMARKS

結果は、TABLE_TYPE、TABLE_QUALIFIER、TABLE_OWNER、TABLE_NAMEの順 番になります。

引数ownerおよびname には、検索パターン(ゼロ以上の文字にマッチする'%'や単一の文字にマッ チする'_')を指定可能です。

限定子、所有者、テーブル名を数えるために、 qualifier、owner、 name、table_typeに ついて以下のような特別な記号が使用可能です。

• qualifierがパーセント記号(%)のみで、 ownerおよびname が空文字列であった場合、結果にはそのデータソースに関する 有効な限定子のリスト(NULLを有するTABLE_QUALIFIERカラム以外の全てのカ ラム)が含まれます。

• ownerがパーセント記号(%)のみで、 qualifierおよび nameが空文字列の場合、結果にはそのデータソー スに関する有効な所有者のリスト(NULLを有するTABLE_OWNERカラム以外 の全てのカラム)が含まれます。

• table_typeがパーセント記号(%)のみで、 qualifier、owner、 nameが空文字列の場合、結果にはそのデータソー スに関する有効なテーブル型のリスト(NULLを有するTABLE_TYPEカラ ム以外の全てのカラム)が含まれます。

table_typeが空の文字列ではない場合、検索す る型についてカンマで区切った値のリストを指定する必要があります。 各値は、シングルクオート(')で括るかまたは括らない形で指定可能です。 例えば、"'TABLE','VIEW'"または"TABLE, VIEW"となります。データソー スが指定したテーブル型をサポートしていない場合、 odbc_tables()はその型についていかなる結果も返 しません。

関連する権限の取得については、 odbc_tableprivileges()を参照下さい。