Returns a result set listing the foreign keys for a table.
Parameters
connection
A valid connection to an IBM DB2, Cloudscape, or Apache Derby database.
qualifier
A qualifier for DB2 databases running on OS/390 or z/OS servers. For
other databases, pass NULL or an empty string.
schema
The schema which contains the tables. If schema
is NULL, db2_foreign_keys() matches the schema for
the current connection.
table-name
The name of the table.
Return Values
Returns a statement resource with a result set containing rows describing
the foreign keys for the specified table. The result set is composed of the
following columns:
Column name
Description
PKTABLE_CAT
Name of the catalog for the table containing the primary key. The
value is NULL if this table does not have catalogs.
PKTABLE_SCHEM
Name of the schema for the table containing the primary key.
PKTABLE_NAME
Name of the table containing the primary key.
PKCOLUMN_NAME
Name of the column containing the primary key.
FKTABLE_CAT
Name of the catalog for the table containing the foreign key. The
value is NULL if this table does not have catalogs.
FKTABLE_SCHEM
Name of the schema for the table containing the foreign key.
FKTABLE_NAME
Name of the table containing the foreign key.
FKCOLUMN_NAME
Name of the column containing the foreign key.
KEY_SEQ
1-indexed position of the column in the key.
UPDATE_RULE
Integer value representing the action applied to the foreign key
when the SQL operation is UPDATE.
DELETE_RULE
Integer value representing the action applied to the foreign key
when the SQL operation is DELETE.
FK_NAME
The name of the foreign key.
PK_NAME
The name of the primary key.
DEFERRABILITY
An integer value representing whether the foreign key deferrability is
SQL_INITIALLY_DEFERRED, SQL_INITIALLY_IMMEDIATE, or
SQL_NOT_DEFERRABLE.