top
====================================================================================================

개요
----------------------------------------------------------------------------------------------------

이 명령어는 검색 결과를 지정된 필드를 기준으로 정렬 후 상위 값을 출력합니다.

타입
----------------------------------------------------------------------------------------------------


설명
----------------------------------------------------------------------------------------------------

이 명령어는 검색 결과를 지정된 필드를 기준으로 정렬 후 상위 값을 출력합니다. 만약 지정된 필드의 값이 공백이거나 없다면, 가장 작은 값으로 간주합니다. ``-`` 는 내림차순 정렬을 의미하고, ``+``\ 는 오름차순 정렬을 의미합니다.

**내부 알고리즘은 ``sort`` 명령어와 동일합니다.**

Examples
----------------------------------------------------------------------------------------------------


* ``YEARID``\ 을 오름차순 정렬하고, 100개의 상위 결과를 보여줍니다.

.. code-block:: none

   ..| top 100 +YEARID


* ``YEARID``\ 을 내림차순 정렬하고, 100개의 상위 결과를 보여줍니다.

.. code-block:: none

   ..| top 100 -YEARID

Parameters
----------------------------------------------------------------------------------------------------

.. code-block:: none

   ... | top (N)? ([+|-])?FIELD_NAME

.. list-table::
   :header-rows: 1

   * - 이름
     - 설명
     - 필수/옵션
   * - ``N``
     - sort 후 출력 할 검색 결과의 갯수를 의미합니다.
     - 옵션
   * - ``([+/-])?FIELD_NAME``
     - ``-`` 는 내림차순 정렬을 의미하고, ``+``\ 는 오름차순 정렬을 의미합니다. ``FIELD_NAME``\ 은 정렬 할 field의 이름을 의미합니다.
     - 필수


Parameters BNF
----------------------------------------------------------------------------------------------------

.. code-block:: none

   fields : top_expr
          | NUMBER top_expr

   top_expr : TOKEN
            | PLUS TOKEN
            | MINUS TOKEN

   PLUS : +
   MINUS : -
   TOKEN : [^ |^,|^+|^-]+