MAX_CARDINALITY スカラー関数

MAX_CARDINALITY 関数は、配列に入れることができるエレメントの最大数を示すタイプ BIGINT の値を戻します。 これは、CREATE TYPE ステートメントで指定した、通常配列タイプに関するカーディナリティーです。

構文図を読む構文図をスキップする MAX_CARDINALITY ( array-expression )

スキーマは SYSIBM です。

array-expression
配列タイプの SQL 変数、SQL パラメーター、またはグローバル変数か、配列タイプへのパラメーター・マーカーの CAST 指定。

結果

結果は NULL になる可能性があります。引数が連想配列である場合、その結果は NULL 値になります。

例

  1. 配列タイプ PHONENUMBERS の RECENT_CALLS 配列変数の最大カーディナリティーを戻します。
       SET LIST_SIZE = MAX_CARDINALITY(RECENT_CALLS)
    SQL 変数 LIST_SIZE は 50 に設定されます。この値は、配列タイプ PHONENUMBERS の定義に使用された最大カーディナリティーです。