db2_columns

(PECL ibm_db2 >= 1.0.0)

db2_columns — テーブルのカラムおよび関連するメタデータを含む結果セットを返す

説明

resource db2_columns ( resource $connection [, string $qualifier [, string $schema [, string $table-name [, string $column-name ]]]] )

テーブルのカラムおよび関連するメタデータを含む結果セットを返します。

パラメータ

connection: IBM DB2、Cloudscape あるいは Apache Derby データベースへの有効な接続。
qualifier: OS/390 あるいは z/OS サーバ上で稼動している DB2 データベースの修飾子。その他のデータベースの場合には NULL あるいは空の文字列を渡します。
schema: テーブルを含むスキーマ。すべてのスキーマに一致させるには、 '%' を渡します。
table-name: テーブルあるいはビューの名前。データベース内のすべてのテーブルに一致させるには、 NULL あるいは空の文字列を渡します。
column-name: カラムの名前。テーブル内のすべてのカラムに一致させるには、 NULL あるいは空の文字列を渡します。

返り値

指定したパラメータに一致するカラムの情報を含む結果セットのステートメントリソースを返します。行の内容は、以下のカラムで構成されています。

カラム名説明

TABLE_CAT カタログの名前。テーブルがカタログを保持していない場合は NULL。

TABLE_SCHEM スキーマの名前。

TABLE_NAME テーブルあるいはビューの名前。

COLUMN_NAME カラムの名前。

DATA_TYPE カラムの SQL データ型を整数値で表したもの。

TYPE_NAME カラムのデータ型を文字列で表したもの。

COLUMN_SIZE カラムのサイズを表す整数値。

BUFFER_LENGTH このカラムのデータを保存するために必要な最大のバイト数。

DECIMAL_DIGITS カラムの位取り。位取りが適用できない場合は NULL。

NUM_PREC_RADIX 10 (正確な数値データ型を表す)、 2 (概数データ型を表す)、あるいは NULL (基数が適用できないデータ型を表す) のいずれか。

NULLABLE カラムが null 値をとることができるかどうかを表す整数値。

REMARKS カラムの説明。

COLUMN_DEF カラムのデフォルト値。

SQL_DATA_TYPE カラムのサイズを表す整数値。

SQL_DATETIME_SUB datetime 型のコードを表す整数値、あるいはこれが適用できない SQL データ型である場合に NULL。

CHAR_OCTET_LENGTH 文字型のカラムにおける最大のオクテット数。シングルバイト文字セットのデータの場合、これは COLUMN_SIZE に一致します。文字型でないカラムの場合は NULL となります。

ORDINAL_POSITION テーブル内でのカラムの位置を表す、1 から始まるインデックス。

IS_NULLABLE カラムが null 値をとることができるかどうかを表す文字列。 'YES' の場合は null 値をとることができ、 'NO' の場合はできません。

カラム名	説明
TABLE_CAT	カタログの名前。テーブルがカタログを保持していない場合は NULL。
TABLE_SCHEM	スキーマの名前。
TABLE_NAME	テーブルあるいはビューの名前。
COLUMN_NAME	カラムの名前。
DATA_TYPE	カラムの SQL データ型を整数値で表したもの。
TYPE_NAME	カラムのデータ型を文字列で表したもの。
COLUMN_SIZE	カラムのサイズを表す整数値。
BUFFER_LENGTH	このカラムのデータを保存するために必要な最大のバイト数。
DECIMAL_DIGITS	カラムの位取り。位取りが適用できない場合は `NULL`。
NUM_PREC_RADIX	10 (正確な数値データ型を表す)、 2 (概数データ型を表す)、あるいは `NULL` (基数が適用できないデータ型を表す) のいずれか。
NULLABLE	カラムが null 値をとることができるかどうかを表す整数値。
REMARKS	カラムの説明。
COLUMN_DEF	カラムのデフォルト値。
SQL_DATA_TYPE	カラムのサイズを表す整数値。
SQL_DATETIME_SUB	datetime 型のコードを表す整数値、あるいはこれが適用できない SQL データ型である場合に `NULL`。
CHAR_OCTET_LENGTH	文字型のカラムにおける最大のオクテット数。シングルバイト文字セットのデータの場合、これは COLUMN_SIZE に一致します。文字型でないカラムの場合は `NULL` となります。
ORDINAL_POSITION	テーブル内でのカラムの位置を表す、1 から始まるインデックス。
IS_NULLABLE	カラムが null 値をとることができるかどうかを表す文字列。 'YES' の場合は null 値をとることができ、 'NO' の場合はできません。

参考

db2_column_privileges() - テーブルのカラムおよび関連する権限情報を含む結果セットを返す
db2_foreign_keys() - テーブルの外部キーを含む結果セットを返す
db2_primary_keys() - テーブルの主キーを含む結果セットを返す
db2_procedure_columns() - ストアドプロシージャのパラメータを含む結果セットを返す
db2_procedures() - データベース内に登録されているストアドプロシージャの一覧を含む結果セットを返す
db2_special_columns() - テーブルのユニーク行 ID カラムを含む結果セットを返す
db2_statistics() - インデックスの情報およびテーブルの統計情報を含む結果セットを返す
db2_table_privileges() - データベース内のテーブルおよび関連する権限情報を含む結果セットを返す
db2_tables() - データベース内のテーブルおよび関連するメタデータを含む結果セットを返す

add a note User Contributed Notes db2_columns

david dot rekowski at gmx dot de 06-Aug-2008 02:21


must be


db2_columns($conn, '', '%', $table, '%');





Don't forget that table names are UPPERCASE. That gave me quite some headache.

lada(at)hoidekr.net 05-Sep-2006 06:48


This is not true!

column-name

    The name of the column. To match all columns in the table, pass NULL or an empty string. 



You should pass '%' to match all columns

add a note