1.2.1 - en to ja translation catalogue (32 entries)

en: Summary
ja: 概要

en: ``request_cancel`` command cancels a running request.
ja: ``request_cancel`` コマンドは実行中のリクエストをキャンセルします。

en: There are some limitations:
ja: いくつか制限があります。

en: Request ID must be managed by user. (You need to assign unique key for each request.)
ja: リクエストIDはユーザーが管理する必要があります。（各リクエストに一意のキーを割り当てる必要があります。）

en: Cancel request may be ignored. (You can send ``request_cancel`` command multiple times for the same request ID.)
ja: キャンセルリクエストは無視されることもあります。（同じリクエストIDに対して何度も ``request_cancel`` コマンドを送信することができます。）

en: Only multithreading type Groonga server is supported. (You can use with :doc:`/reference/executables/groonga` based server but can't use with :doc:`/reference/executables/groonga-httpd`.)
ja: マルチスレッド型のGroongaサーバーのみサポートしています。（ :doc:`/reference/executables/groonga` ベースのサーバーでは使えますが、 :doc:`/reference/executables/groonga-httpd` では使えません。）

en: See :doc:`/reference/command/request_id` about request ID.
ja: リクエストIDについては :doc:`/reference/command/request_id` を参照してください。

en: If the request is canceled, a :doc:`/reference/command/return_code` of the canceled request as below.
ja: リクエストがキャンセルされたら、キャンセルされたリクエストの :doc:`/reference/command/return_code` は、以下のようになります。

en: ``-5`` (``GRN_INTERRUPTED_FUNCTION_CALL``) (Groonga version 6.0.1 before)
ja: ``-5`` (``GRN_INTERRUPTED_FUNCTION_CALL``) (Groonga version 6.0.1 より前)

en: ``-77`` (``GRN_CANCEL``) (Groonga version 6.0.1 or later)
ja: ``-77`` (``GRN_CANCEL``) (Groonga version 6.0.1 以降)

en: Syntax
ja: 構文

en: This command takes only one required parameter::
ja: このコマンドの引数は1つで必須です::

en: Usage
ja: 使い方

en: Here is an example of ``request_cancel`` command::
ja: 以下は ``request_cancel`` コマンドの使用例です::

en: Assume that the first ``select`` command takes a long time. ``unique-id-1`` request ID is assigned to the ``select`` command by ``request_id=unique-id-1`` parameter.
ja: 最初の ``select`` コマンドが長時間かかると仮定します。 ``request_id=unique-id-1`` パラメーターを指定することで ``unique-id-1`` というリクエストIDをこの ``select`` コマンドに割り当てます。

en: The second ``request_cancel`` command passes ``id=unique-id-1`` parameter. ``unique-id-1`` is the same request ID passed in ``select`` command.
ja: 2つめの ``request_cancel`` コマンドで ``id=unique-id-1`` パラメーターを指定しています。 ``unique-id-1`` は ``select`` コマンドに渡したリクエストIDと同じリクエストIDです。

en: The ``select`` command may not be canceled immediately. And the cancel request may be ignored.
ja: この ``select`` コマンドはすぐにはキャンセルされないかもしれません。また、このキャンセルリクエストは無視されることもあります。

en: You can send cancel request for the same request ID multiple times. If the target request is canceled or finished, ``"canceled"`` value is changed to ``false`` from ``true`` in return value::
ja: 同じリクエストIDに対するキャンセルリクエストを複数回送ることができます。もし、対象のリクエストがキャンセルされたか終了した場合は戻り値の中の ``"canceled"`` の値が ``true`` から ``false`` に変わります。

en: If the ``select`` command is canceled, response of the ``select`` command has ``-5`` (``GRN_INTERRUPTED_FUNCTION_CALL``) as :doc:`/reference/command/return_code`::
ja: もし、この ``select`` コマンドがキャンセルされたら、 ``select`` コマンドの :doc:`/reference/command/return_code` は ``-5`` （ ``GRN_INTERRUPTED_FUNCTION_CALL`` ）になります。::

en: Parameters
ja: 引数

en: This section describes parameters of ``request_cancel``.
ja: このセクションでは ``request_cancel`` の引数について説明します。

en: Required parameters
ja: 必須引数

en: There is required parameter, ``id``.
ja: ``id`` だけが必須の引数です。

en: Specifies the ID for the target request.
ja: 対象リクエストのIDを指定します。

en: Return value
ja: 戻り値

en: ``request_cancel`` command returns the result of the cancel request::
ja: ``request_cancel`` コマンドはキャンセルリクエストの結果を返します。::

en: See :doc:`/reference/command/output_format` about ``HEADER``.
ja: ``HEADER`` については :doc:`/reference/command/output_format` を参照してください。

en: The ID of the target request.
ja: 対象のリクエストのIDです。

en: If the cancel request is accepted, this is ``true``, otherwise this is ``false``.
ja: もし、このキャンセルリクエストが受け付けられたら ``true`` 、そうでなければ ``false`` になります。

en: Note that "cancel request is accepted" doesn't means that "the target request is canceled". It just means "cancel request is notified to the target request but the cancel request may be ignored by the target request".
ja: 「キャンセルリクエストが受け付けられた」というのは「対象リクエストがキャンセルされた」という意味ではないことに注意してください。これは「キャンセルリクエストは対象リクエストに通知したが、対象リクエストはそのキャンセルリクエストを無視するかもしれない」という意味です。

en: If request assigned with the request ID doesn't exist, this is ``false``.
ja: 指定したリクエストIDが割り当てられているリクエストが存在しなければ ``false`` になります。

en: See also
ja: 参考
