GET_ORDERBY_NULLS_SUPPORTファンクション

このファンクションは、現在のデータ・ソースでソートにNULLS句を指定できるようになっているかどうかを確認します。これはローカルおよびREST対応SQLの場合は必ずtrueですが、一部のREST APIではそれがサポートされていない場合があります。

プラグイン開発者は、このファンクションを使用して、このデータ・ソースに対してNULLS句を指定できるかどうかを特定し、これらのオプションをUIで表示または非表示にできます。

次のいずれかの条件がtrueの場合は、NULLS FIRSTまたはNULLS LAST句を指定できます:

ローカル・データベースまたはREST対応SQLサービスがこの操作の対象となっています。
このREST APIにより、ページ区切りを無効にします。必ずすべての行をフェッチし、ローカルでソートします。
このREST APIにより、サーバー側の順序付けを無効にします。すべての行をフェッチし、ローカルでソートする必要があります。
このREST APIにより、ページ区切りを有効にし、サーバー側の順序付けをサポートし、ORDER BY NULLS句を含めます。

構文

APEX_PLUGIN_UTIL.GET_ORDERBY_NULLS_SUPPORT
    RETURN apex_exec.t_supports_orderby_nulls_as;

戻り値

このファンクションは、ORDER BY NULLS句がサポートされているかどうか、または順序付け時にREST APIでNULLSがどのように扱われるかを示す、APEX_EXEC.T_SUPPORTS_ORDERBY_NULLS_ASのインスタンスを戻します。

戻り値	説明
`wwv_flow_exec_api.c_orderby_nulls_flexible`	そのデータ・ソースではORDER BY NULL句がサポートされています。
`wwv_flow_exec_api.c_orderby_nulls_are_lowest`	そのデータ・ソースではソート時にNULLが最低値として扱われます。
`wwv_flow_exec_api.c_orderby_nulls_are_highest`	そのデータ・ソースではソート時にNULLが最高値として扱われます。
`wwv_flow_exec_api.c_orderby_nulls_always_last`	そのデータ・ソースでは順序付けで必ずNULLが最後になります。
`wwv_flow_exec_api.c_orderby_nulls_always_first`	そのデータ・ソースでは順序付けで必ずNULLが最初になります。

例

DECLARE
    l_supports_orderby_nulls apex_exec.t_supports_orderby_nulls_as;
BEGIN
    l_supports_orderby_nulls := apex_plugin_util.get_orderby_nulls_support;

    IF l_supports_orderby_nulls = wwv_flow_exec_api.c_orderby_nulls_flexible THEN
        ...
    END IF;
END;