array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.odbc-tables.php', 1 => 'odbc_tables', ), 'up' => array ( 0 => 'ref.uodbc.php', 1 => 'ODBC 関数', ), 'prev' => array ( 0 => 'function.odbc-tableprivileges.php', 1 => 'odbc_tableprivileges', ), 'next' => array ( 0 => 'book.pdo.php', 1 => 'PDO', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/uodbc/functions/odbc-tables.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
odbc_tables — 指定したデータソースに保存されたテーブルの名前のリストを取得する
$odbc
,$catalog
= null
,$schema
= null
,$table
= null
,$types
= null
指定した範囲の全てのテーブルリストを得ます。
限定子、所有者、テーブル名を数えるために、
catalog
、schema
、
table
、table_type
について以下のような特別な記号が使用可能です。
catalog
がパーセント記号 (%) のみで、
schema
および table
が空文字列であった場合、結果にはそのデータソースに関する
有効な限定子のリスト (null
を有する TABLE_QUALIFIER カラム以外の
全てのカラム)が含まれます。
schema
がパーセント記号 (%) のみで、
catalog
および
table
が空文字列の場合、結果にはその
データソースに関する有効な所有者のリスト (null
を有する
TABLE_OWNER カラム以外の全てのカラム) が含まれます。
table_type
がパーセント記号 (%) のみで、
catalog
、schema
、
table
が空文字列の場合、結果にはそのデータソースに
関する有効なテーブル型のリスト (null
を有する TABLE_TYPE
カラム以外の全てのカラム) が含まれます。
odbc
ODBC 接続 ID。詳細は odbc_connect() を参照ください。
catalog
カタログ(ODBC 2 の用語では '修飾子')。
schema
スキーマ (ODBC 2 の用語では '所有者')。
このパラメータには以下の検索パターンを使用できます。
%
はゼロ個以上の文字にマッチし、
_
はひとつの文字にマッチします。
table
名前。
このパラメータには以下の検索パターンを使用できます。
%
はゼロ個以上の文字にマッチし、
_
はひとつの文字にマッチします。
types
table_type
が空の文字列ではない場合、検索する型に
ついてカンマで区切った値のリストを指定する必要があります。
各値は、シングルクオート('
)で括るかまたは括らない形で指定可能です。
例えば、'TABLE','VIEW'
または TABLE, VIEW
となります。
データソースが指定したテーブル型をサポートしていない場合、
odbc_tables() はその型についていかなる結果も
返しません。
情報を含んでいる ODBC 結果 ID を返します。
失敗した場合に false
を返します。
結果セットのカラムは次のようになります。
TABLE_CAT
TABLE_SCHEM
TABLE_NAME
TABLE_TYPE
REMARKS
結果セットは TABLE_TYPE
, TABLE_CAT
,
TABLE_SCHEM
, TABLE_NAME
でソートされます。
バージョン | 説明 |
---|---|
8.0.0 |
schema , table ,
types は、nullable になりました。
|
例1 カタログのテーブル一覧を表示する
<?php
$conn = odbc_connect($dsn, $user, $pass);
$tables = odbc_tables($conn, 'SalesOrders', 'dbo', '%', 'TABLE');
while (($row = odbc_fetch_array($tables))) {
print_r($row);
break; // further rows omitted for brevity
}
?>
上の例の出力は、 たとえば以下のようになります。
Array ( [TABLE_CAT] => SalesOrders [TABLE_SCHEM] => dbo [TABLE_NAME] => Orders [TABLE_TYPE] => TABLE [REMARKS] => )