トップページ 　→関数リファレンス　→データベース関連　→抽象化レイヤー　→ODBC　→ODBC 関数
１つ上のカテゴリへ

関数・クラス解説

odbc_tables

version:PHP 4, PHP 5, PHP 7 (公式)

指定したデータソースに保存されたテーブルの名前のリストを取得する

公式リファレンス

書式

odbc_tables ( resource $connection_id [, string $catalog [, string $schema [, string $name [, string $types ]]]] ) : resource|false

説明

指定した範囲の全てのテーブルリストを得ます。

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

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

パラメータ

connection_id
ODBC 接続 ID。詳細はodbc_connect() を参照ください。
catalog
カタログ(ODBC 2 の用語では '修飾子')。
schema
スキーマ (ODBC 2 の用語では '所有者')。 このパラメータには以下の検索パターンを使用できます。% はゼロ個以上の文字にマッチし、_ はひとつの文字にマッチします。
name
名前。 このパラメータには以下の検索パターンを使用できます。% はゼロ個以上の文字にマッチし、_ はひとつの文字にマッチします。
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 でソートされます。

サンプル

例1 カタログのテーブル一覧を表示する
 

$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] =>
)

参考

  • odbc_tableprivileges() - 各テーブルのリストおよび関連する権限のリストを取得する
  • odbc_columns() - 指定したテーブルにあるカラム名のリストを取得する
  • odbc_specialcolumns() - 特殊カラムを取得する
  • odbc_statistics() - テーブルに関する統計情報を取得する
  • odbc_procedures() - 指定したデータソースに保存されているプロシージャのリストを取得する

    • ワード検索


    ※入力キーワードが、関数名・説明文・タグに含まれるものを検索

    関数名アルファベット別

    A B C D E F G H I J
    K L M N O P Q R S T
    U V W X Y Z _

    最終更新一覧

    ●stristr
    　大文字小文字を区別せず文字列を検索し、ヒット箇所以降（あるいは以前）の文字列を返却

    ●stripslashes
    　バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

    ●stripos
    　大文字小文字を区別せずに文字列が最初に現れる位置を取得する

    ●stripcslashes
    　addcslashes() でクォートされた文字列をアンクォートする

    ●strip_tags
    　文字列から HTML と PHP のタグを除去して返却

    ●strcspn
    　指定した文字が最初に現れる位置を調べる

    ●strcoll
    　ロケールに基づいて2つの文字列を比較し同じか（あるいは大小）を判定する

    ●strcmp
    　2つの文字列を比較し同じか（あるいは大小）を判定する

    ●strchr
    　strstr() のエイリアス

    ●strcasecmp
    　2つの文字列を比較（大文字小文字を区別せず同じとみなす）

    カテゴリー一覧

    PHP の振る舞いの変更
    音声フォーマットの操作
    認証サービス
    コマンドライン関連
    圧縮およびアーカイブ
    暗号
    データベース関連
    日付および時刻関連
    ファイルシステム
    自然言語および文字エンコーディング
    画像処理および作成
    メール関連
    数学
    テキスト以外の MIME 型
    プロセス制御
    その他の基本モジュール
    その他のサービス
    検索エンジン用の拡張モジュール
    サーバー固有のモジュール
    セッション関連
    テキスト処理
    変数・データ型関連
    ウェブサービス
    Windows 用のモジュール
    XML 操作
    GUI用の拡張モジュール