7.28 CREATE_COLLECTIONプロシージャ

このプロシージャを使用して、まだ存在していない空のコレクションを作成します。同じ名前のコレクションが、カレント・アプリケーションIDの同じセッション内にカレント・ユーザー用として存在すると、アプリケーション・エラーが発生します。

構文

APEX_COLLECTION.CREATE_COLLECTION(
    p_collection_name    IN VARCHAR2,
    p_truncate_if_exists IN VARCHAR2 default 'NO');

パラメータ

表7-7 CREATE_COLLECTIONプロシージャのパラメータ

パラメータ 説明

p_collection_name

コレクションの名前。最大長は255文字です。このコレクションが、カレント・ユーザーの指定された名前で、同じセッションに存在すると、エラーが戻されます。

p_truncate_if_exists

YESの場合、コレクションが存在していればコレクションのメンバーがまず切り捨てられ、エラーは発生しません。NOの場合(YESでない場合)、コレクションが存在していれば、エラーが発生します。

この例は、CREATE_COLLECTIONプロシージャを使用して、EMPLOYEESという空のコレクションを作成する方法を示しています。

Begin
    APEX_COLLECTION.CREATE_COLLECTION(
        p_collection_name => 'EMPLOYEES');
End;