TABLE_NAME スカラー関数

TABLE_NAME 関数は、別名チェーンが解決された後で検出されたオブジェクトの非修飾名を戻します。

スキーマは SYSIBM です。

指定された object-name (および object-schema) が、解決の開始点として使用されます。開始点が別名を参照していない場合は、開始点の非修飾名が戻されます。結果の名前は、表、ビュー、または未定義オブジェクトのいずれかになります。Unicode データベースでは、指定した引数が GRAPHIC ストリングであると、まず文字ストリングに変換されてから、関数が実行されます。

object-name: 解決しようとする非修飾名 (通常は既存の別名) を表す文字式。 object-name は、CHAR または VARCHAR のデータ・タイプ、1 バイト以上 129 バイト未満の長さでなければなりません。
object-schema: 指定された object-name の解決前の値を修飾するのに使うスキーマを表す文字式。object-schema は、CHAR または VARCHAR のデータ・タイプ、1 バイト以上 129 バイト未満の長さでなければなりません。
object-schema を指定しない場合は、修飾子にデフォルトのスキーマが使用されます。

この関数の結果のデータ・タイプは VARCHAR(128 OCTETS) です。object-name が NULL になる可能性がある場合は、結果も NULL になる可能性があります。object-name が NULL であれば、結果も NULL 値になります。object-schema が NULL 値の場合は、デフォルトのスキーマ名が使用されます。結果は、非修飾名を表す文字ストリングになります。結果の名前は、次のオブジェクトのいずれかを表す可能性があります。

table: object-name の値が、表名 (入力値が戻される) であったか、あるいは解決結果が表となり、その表名が戻されることになる別名であった。
view: object-name の値が、ビュー名 (入力値が戻される) であったか、あるいは解決結果がビューとなり、そのビュー名が戻されることになる別名であった。
未定義オブジェクト: object-name の値が、未定義オブジェクト (入力値が戻される) であったか、あるいは解決結果が未定義オブジェクトとなり、その名前が戻されることになる別名であった。

したがって、NULL 以外の値がこの関数に指定された場合、結果名のオブジェクトが存在していなくても、常にその値が戻されます。

注

パーティション・データベース構成において、TABLE_SCHEMA および TABLE_NAME スカラー関数を使用するときにコーディネーター・パーティションとカタログ・パーティションの間で生じる不必要な通信を避けることによって、パフォーマンスを改善するには、代わりに BASE_TABLE 表関数を使用することができます。