odbc_foreignkeys

(PHP 4, PHP 5, PHP 7, PHP 8)

odbc_foreignkeys — 外部キーのリストを取得する

説明

odbc_foreignkeys(
    Odbc\Connection $odbc,
    ?string $pk_catalog,
    string $pk_schema,
    string $pk_table,
    string $fk_catalog,
    string $fk_schema,
    string $fk_table
): Odbc\Result|false

指定したテーブルの外部キーのリスト、または指定したテーブルの主キーを参照する他のテーブルの外部キーのリストを取得します。

パラメータ

odbc: ODBC 接続オブジェクト。詳細は odbc_connect() を参照ください。
pk_catalog: 主キーテーブルのカタログ (ODBC 2 の用語では '修飾子')
pk_schema: 主キーテーブルのスキーマ(ODBC 2 の用語では '所有者')
pk_table: 主キーのテーブル。
fk_catalog: 外部キーテーブルのカタログ (ODBC 2 の用語では '修飾子')
fk_schema: 外部キーテーブルのスキーマ(ODBC 2 の用語では '所有者')
fk_table: 外部キーのテーブル。

戻り値

ODBC 結果オブジェクトを返します。失敗した場合に false を返します。

結果は、以下のようなカラムを持つものとなります。

PKTABLE_CAT
PKTABLE_SCHEM
PKTABLE_NAME
PKCOLUMN_NAME
FKTABLE_CAT
FKTABLE_SCHEM
FKTABLE_NAME
FKCOLUMN_NAME
KEY_SEQ
UPDATE_RULE
DELETE_RULE
FK_NAME
PK_NAME
DEFERRABILITY

ドライバは追加のカラムを返すことが出来ます。

プライマリーキーと関連がある外部キーが指定された場合、結果セットは FKTABLE_CAT, FKTABLE_SCHEM, FKTABLE_NAME, KEY_SEQ でソートされます。外部キーと関連がある主キーが指定された場合、結果セットは PKTABLE_CAT, PKTABLE_SCHEM, PKTABLE_NAME, KEY_SEQ でソートされます。

pk_table がテーブル名を有している場合、 odbc_foreignkeys() は指定したテーブルの主キーおよびそのキーを参照する全ての外部キーのリストを結果として返します。

fk_table がテーブル名を有している場合、 odbc_foreignkeys() は指定したテーブルにある全ての外部キーおよびそのキーが参照する(他のテーブルの)主キーのリストを結果として返します。

pk_table および fk_table が共にテーブル名を有している場合、 odbc_foreignkeys() は pk_table で指定されたテーブルの主キーを参照する fk_table で指定されたテーブルの外部キーを返します。返されるキーは最大でも一つだけです。

変更履歴

バージョン	説明
8.4.0	引数 `odbc` は、Odbc\Connection クラスのインスタンスを期待するようになりました。これより前のバージョンでは、resource を期待していました。
8.4.0	この関数は Odbc\Result クラスのインスタンスを返すようになりました。これより前のバージョンでは、resource を返していました。

参考

odbc_tables() - 指定したデータソースに保存されたテーブルの名前のリストを取得する
odbc_primarykeys() - テーブルの主キーを取得する

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.