1.2.1 - en to ja translation catalogue (113 entries)

en: Execution example::
ja: 実行例::

en: Summary
ja: 概要

en: ``logical_range_filter`` is a sharding version of :doc:`range_filter`. ``logical_range_filter`` searches records from multiple tables and outputs them.
ja: ``logical_range_filter`` は :doc:`range_filter` のシャーディングバージョンです。 ``logical_range_filter`` は複数のテーブルからレコードを検索し、マッチしたレコードを出力します。

en: ``logical_range_filter`` is similar to :doc:`logical_select`. Both of them searches records from multiples tables and outputs them. ``logical_range_filter`` stops searching when the number of matched records is requested the number of records. :doc:`logical_select` searches all records and outputs only needed records.
ja: ``logical_range_filter`` は :doc:`logical_select` に似ています。どちらも複数のテーブルからレコードを検索し、見つかったレコードを出力します。 ``logical_range_filter`` は要求されたレコード数分のレコードが見つかったらそこで検索を終了します。 :doc:`logical_select` はすべてのレコードを検索し、必要なレコードだけ出力します。

en: ``logical_range_filter`` has performance merit but some restrictions.
ja: ``logical_range_filter`` の方が性能面で有利ですがいくつか制約があります。

en: If many records are matched and requested records are small, ``logical_range_filter`` will be faster than :doc:`logical_select`.
ja: 大量のレコードがマッチし、要求されているレコード数が小さい場合、 ``logical_range_filter`` の方が :doc:`logical_select` よりも速いです。

en: ``logical_range_filter`` doesn't support drilldown because drilldown requires all matched records. ``logical_range_filter`` may not find all matched records. So ``logical_range_filter`` doesn't support drilldown.
ja: ``logical_range_filter`` はドリルダウンをサポートしていません。なぜなら、ドリルダウンをするためにはマッチしたレコードがすべて必要だからです。 ``logical_range_filter`` はマッチするレコードをすべて検索しないかもしれません。そのため、 ``logical_range_filter`` はドリルダウンをサポートしていません。

en: ``logical_range_filter`` doesn't return the number of all matched records. Because ``logical_range_filter`` may not search all matched records.
ja: ``logical_range_filter`` はマッチしたレコードの総数を返しません。なぜなら、 ``logical_range_filter`` はマッチするレコードをすべて検索しないかもしれないからです。

en: You need to :doc:`plugin_register` ``sharding`` plugin because this command is included in ``sharding`` plugin.
ja: このコマンド は ``sharding`` プラグインに含まれているので、 ``sharding`` プラグインを :doc:`plugin_register` する必要があります。

en: Syntax
ja: 構文

en: This command takes many parameters.
ja: このコマンドにはたくさんの引数があります。

en: The required parameters are ``logical_table`` and ``shard_key``::
ja: 必須引数は2つあります。 ``logical_table`` と ``shard_key`` です。

en: There are some parameters that can be only used as named parameters. You can't use these parameters as ordered parameters. You must specify parameter name.
ja: いくつか名前付き引数としてしか使えない引数があります。これらの引数を「○番目の引数」として使うことはできません。必ず名前を指定する必要があります。

en: Here are parameters that can be only used as named parameters:
ja: 名前付き引数としてしか使えない引数は次の通りです。

en: This command has the following named parameters for dynamic columns:
ja: 以下の名前付き引数で動的カラム機能を使うことができます。

en: You can use one or more alphabets, digits, ``_`` for ``${NAME}``. For example, ``column1`` is a valid ``${NAME}``. This is the same rule as normal column. See also :ref:`column-create-name`.
ja: ``${NAME}`` には1つ以上のアルファベット、数字、 ``_``  を使うことができます。たとえば、 ``column1`` は有効な ``${NAME}`` です。これは通常のカラムと同じルールです。 :ref:`column-create-name` も見てください。

en: Parameters that have the same ``${NAME}`` are grouped.
ja: 同じ ``${NAME}`` も持つ引数は同じグループになります。

en: For example, the following parameters specify one dynamic column:
ja: たとえば、以下の引数は1つの動的カラムを指定しています。

en: The following parameters specify two dynamic columns:
ja: 以下の引数は2つの動的カラムを指定しています。

en: Usage
ja: 使い方

en: Let's learn about usage with examples. This section shows many popular usages.
ja: 例を使いながら使い方を学びましょう。このセクションではよく使われる使い方を紹介します。

en: You need to register ``sharding`` plugin because this command is included in ``sharding`` plugin.
ja: このコマンドは ``sharding`` プラグインに含まれているので ``sharding`` プラグインを登録する必要があります。

en: Here are a schema definition and sample data to show usage.
ja: 使い方を示すために使うスキーマ定義とサンプルデータは以下の通りです。

en: There are two tables, ``Entries_20150708`` and ``Entries_20150709``, for blog entries.
ja: ブログエントリー用に ``Entries_20150708`` と ``Entries_20150709`` の2つのテーブルがあります。

en: You need to use ``${LOGICAL_TABLE_NAME}_${YYYYMMDD}`` naming rule for table names. In this example, ``LOGICAL_TABLE_NAME`` is ``Entries`` and ``YYYYMMDD`` is ``20150708`` or ``20150709``.
ja: テーブル名には ``${論理テーブル名}_${YYYYMMDD}`` という命名規則を使う必要があります。この例では、 ``論理テーブル名`` は ``Entries`` で ``YYYYMMDD`` は ``20150708`` または ``20150709`` です。

en: An entry has title, created time, content, the number of likes for the entry and tag. Title is key of ``Entries_YYYYMMDD``. Created time is value of ``Entries_YYYYMMDD.created_at`` column. Content is value of ``Entries_YYYYMMDD.content`` column. The number of likes is value of ``Entries_YYYYMMDD.n_likes`` column. Tag is value of ``Entries_YYYYMMDD.tag`` column.
ja: 各エントリはタイトルと作成日時と内容と「いいね！」数、タグを持っています。タイトルは ``Entries_YYYYMMDD`` のキーとします。作成日時は ``Entries_YYYYMMDD.created_at`` カラムの値とします。内容は ``Entries_YYYYMMDD.content`` カラムの値とします。「いいね！」数は ``Entries_YYYYMMDD.n_likes`` カラムの値とします。タグは ``Entries_YYYYMMDD.tag`` カラムの値とします。

en: ``Entries_YYYYMMDD._key`` column and ``Entries_YYYYMMDD.content`` column are indexed using ``TokenBigram`` tokenizer. So both ``Entries_YYYYMMDD._key`` and ``Entries_YYYYMMDD.content`` are fulltext search ready.
ja: ``Entries_YYYYMMDD._key`` カラムと ``Entries_YYYYMMDD.content`` カラムには ``TokenBigram`` トークナイザーを使ったインデックスを作成します。そのため、 ``Entries_YYYYMMDD._key`` と ``Entries_YYYYMMDD.content`` は両方とも全文検索できます。

en: OK. The schema and data for examples are ready.
ja: これで例を示すためのスキーマとデータの準備ができました。

en: Simple usage
ja: 簡単な使い方

en: Parameters
ja: 引数

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

en: Required parameters
ja: 必須引数

en: There are required parameters, ``logical_table`` and ``shard_key``.
ja: 必須引数は二つあります。 ``logical_table`` と ``shard_key`` です。

en: Specifies logical table name. It means table name without ``_YYYYMMDD`` postfix. If you use actual table such as ``Entries_20150708``, ``Entries_20150709`` and so on, logical table name is ``Entries``.
ja: 論理テーブル名を指定します。これは ``_YYYYMMDD`` をテーブル名からのぞいたものです。実際のテーブルが ``Entries_20150708`` や ``Entries_20150709`` といったものなら、論理テーブル名は ``Entries`` です。

en: If nonexistent table is specified, an error is returned.
ja: 存在しないテーブルを指定するとエラーが返ります。

en: Specifies column name which is treated as shared key in each parted table.
ja: 個々のテーブルで共通のキーとして扱うカラム名を指定します。

en: Optional parameters
ja: 省略可能引数

en: There are optional parameters.
ja: いくつか省略可能な引数があります。

en: Specifies the min value of ``shard_key``
ja: ``shard_key`` の最小値を指定します。

en: Specifies whether the min value of borderline must be include or not. Specify ``include`` or ``exclude`` as the value of this parameter.
ja: 最小値を境界値として含めるのか否かを指定します。 ``include`` もしくは ``exclude`` を指定します。

en: Specifies the max value of ``shard_key``.
ja: ``shard_key`` の最大値を指定します。

en: Specifies whether the max value of borderline must be include or not. Specify ``include`` or ``exclude`` as the value of this parameter.
ja: 最大値を境界値として含めるのか否かを指定します。 ``include`` もしくは ``exclude`` を指定します。

en: Specifies order of search result. Specify ``ascending`` or ``descending`` as the value of this parameter.
ja: 検索結果の順序を指定します。``ascending`` もしくは ``descending`` を指定します。

en: If we set ``ascending`` in this parameter, search results are sorted by ascending order based on ``shared_key``. If we set ``descending`` in this parameter, search results are sorted by descending order based on ``shared_key``.
ja: ``ascending`` を設定した場合は、 ``shard_key`` を基準に検索結果は昇順に並べられます。``descending`` を設定した場合は、 ``shard_key`` を基準に検索結果は降順に並べられます。

en: Search related parameters
ja: 検索関係の引数

en: This command provides :doc:`select` compatible search related parameters.
ja: このコマンドは :doc:`select` 互換の検索関連パラメーターをサポートしています。

en: Corresponds to :ref:`select-filter` in :doc:`select`. See :ref:`select-filter` for details.
ja: :doc:`select` の :ref:`select-filter` に対応しています。詳細は :ref:`select-filter` を見てください。

en: Here is an example:
ja: 以下は例です。

en: Specifies the filter text that is processed after ``filtered`` stage dynamic columns are generated. You can use ``post_filter`` to filter by ``filtered`` stage dynamic columns. Others are the same as :ref:`logical-range-filter-filter`.
ja: ``filtered`` ステージの動的カラムが生成されてから実行するフィルターを指定します。 ``post_filter`` を使うと ``filtered`` ステージの動的カラムを使って絞り込むことができます。他は :ref:`logical-range-filter-filter` と同じです。

en: If you use ``post_filter``, "stop searching when enough records are matched in a table" feature is disabled. ("Stop searching against rest tables when enough records are matched" is still enabled.)  Because ``post_filter`` needs to wait dynamic columns generation. See also :ref:`logical-range-filter-dynamic-column-related-parameters`.
ja: ``post_filter`` を使うと、「十分なレコードがマッチしたらそのテーブルの検索を切り上げる」機能が無効になります。（「十分なレコードがマッチしたら残りのテーブルの検索を切り上げる」機能は有効です。）なぜなら ``post_filter`` は動的カラムが生成されるのを待つ必要があるからです。 :ref:`logical-range-filter-dynamic-column-related-parameters` も参照してください。

en: Here is an example that shows entries only in popular tag. All target entries have ``system`` or ``use`` words:
ja: 以下は人気のあるタグのエントリーだけを表示する例です。対象となるすべてのエントリーには ``system`` または ``use`` という単語が含まれています。

en: Output related parameters
ja: 出力関連の引数

en: Corresponds to :ref:`select-output-columns` in :doc:`select`. See :ref:`select-output-columns` for details.
ja: :doc:`select` の :ref:`select-output-columns` に対応しています。詳細は :ref:`select-output-columns` を見てください。

en: Corresponds to :ref:`select-sort-keys` in :doc:`select`. See :ref:`select-sort-keys` for details.
ja: :doc:`select` の :ref:`select-sort-keys` に対応しています。詳細は :ref:`select-sort-keys` を見てください。

en: ``sort_keys`` has a limitation. It works only when the number of search target shards is one. If the number of search target shards is larger than one, ``sort_keys`` doesn't work.
ja: ``sort_keys`` には制限があります。検索対象のシャードが1つの場合のみ動作します。もし、検索対象のシャードが複数ある場合、 ``sort_keys`` は正常な動作をしません。

en: There is one exception for multiple shards. When the same value is specified for ``shard_key`` and ``sort_keys``, they are supported. This command processes target shards one by one by ascending order. Thus, in this process, magnitude correlation about the value of ``shard_key`` is kept among them. This is because ``sort_keys`` is supported when ``shard_key`` and ``sort_keys`` is same.
ja: 複数のシャードに関して例外があります。``shard_key`` と ``sort_keys`` に同じ値が指定された場合です。その場合はサポートしています。このコマンドはシャードを昇順で順番に処理します。そのため、``shard_key`` の大小関係は保たれるので、正しくソートできます。

en: Here is an example that uses only one shard:
ja: 以下は1つのシャードのみを使っている例です。

en: Here is an example that uses ``shard_key`` based value as the first sort key:
ja: 以下は ``shard_key`` ベースの値を第一ソートキーに指定している例です。

en: Corresponds to :ref:`select-offset` in :doc:`select`. See :ref:`select-offset` for details.
ja: :doc:`select` の :ref:`select-offset` に対応しています。詳細は :ref:`select-offset` を見てください。

en: Corresponds to :ref:`select-limit` in :doc:`select`. See :ref:`select-limit` for details.
ja: :doc:`select` の :ref:`select-limit` に対応しています。詳細は :ref:`select-limit` を見てください。

en: The difference from :doc:`select` is that this command stops searching when all requested records specified by :ref:`logical-range-filter-offset` and :ref:`logical-range-filter-limit` are found.
ja: :doc:`select` との違いは、このコマンドは :ref:`logical-range-filter-offset` と :ref:`logical-range-filter-limit` で指定したレコードを見つけたら検索を終了することです。

en: Test related parameters
ja: テスト関連の引数

en: Specifies whether range_index is used or not. Note that it's a parameter for test. It should not be used for production.
ja: range_indexを使うかどうかを指定します。ただし、この引数はテスト用なので、本番で使うべきではありません。

en: Dynamic column related parameters
ja: 動的カラム関連の引数

en: All dynamic column related parameters in :doc:`select` are supported. See :ref:`select-dynamic-column-related-parameters` for details.
ja: :doc:`select` のすべての動的カラム関連パラメーターをサポートしています。詳細は :ref:`select-dynamic-column-related-parameters` を見てください。

en: If you use one or more dynamic columns, "stop searching when enough records are matched in a table" feature is disabled. ("Stop searching against rest tables when enough records are matched" is still enabled.)  ``logical_range_filter`` searches all matched records in a table even when requested the number of matched records is small. It's for supporting window function. Running window function requires all target records in a table.
ja: 動的カラムを1つ以上使うと、「十分なレコードがマッチしたらそのテーブルの検索を切り上げる」機能が無効になります。（「十分なレコードがマッチしたら残りのテーブルの検索を切り上げる」機能は有効です。） ``logical_range_filter`` は要求されているマッチレコード数が小さくても各テーブルですべてのマッチするレコードを検索します。これはウィンドウ関数をサポートするためです。ウィンドウ関数を実行するには同一テーブル内のすべての対象レコードが必要です。

en: Corresponds to :ref:`select-columns-name-stage` in :doc:`select`. See :ref:`select-columns-name-stage` for details.
ja: :doc:`select` の :ref:`select-columns-name-stage` に対応しています。詳細は :ref:`select-columns-name-stage` を見てください。

en: This is a required parameter.
ja: 必須の引数です。

en: Here is an example that creates ``is_popular`` column at ``initial`` stage. You can use ``is_popular`` in all parameters such as ``filter`` and ``output_columns``:
ja: 以下は ``initial`` ステージで ``is_popular`` カラムを作る例です。作成した ``is_popular`` カラムは ``filter`` や ``output_columns`` を含むすべてのパラメーターで使えます。

en: Corresponds to :ref:`select-columns-name-flags` in :doc:`select`. See :ref:`select-columns-name-flags` for details.
ja: :doc:`select` の :ref:`select-columns-name-flags` に対応しています。詳細は :ref:`select-columns-name-flags` を見てください。

en: The default value is ``COLUMN_SCALAR``.
ja: デフォルト値は ``COLUMN_SCALAR`` です。

en: Here is an example that creates a vector column by ``COLUMN_VECTOR`` flags. ``plugin_register functions/vector`` is for using :doc:`/reference/functions/vector_new` function:
ja: 以下は ``COLUMN_VECTOR`` フラグを指定してベクターカラムを作る例です。 ``plugin_register functions/vector`` は :doc:`/reference/functions/vector_new` 関数を使うために実行しています。:

en: Corresponds to :ref:`select-columns-name-type` in :doc:`select`. See :ref:`select-columns-name-type` for details.
ja: :doc:`select` の :ref:`select-columns-name-type` に対応しています。詳細は :ref:`select-columns-name-type` を見てください。

en: Here is an example that creates a ``ShortText`` type column. Stored value is casted to ``ShortText`` automatically. In this example, number is casted to ``ShortText``:
ja: 以下は ``ShortText`` 型のカラムを作る例です。保存された値は自動的に ``ShortText`` にキャストされます。この例では数値が ``ShortText`` にキャストされています。

en: Corresponds to :ref:`select-columns-name-value` in :doc:`select`. See :ref:`select-columns-name-value` for details.
ja: :doc:`select` の :ref:`select-columns-name-value` に対応しています。詳細は :ref:`select-columns-name-value` を見てください。

en: You need to specify :doc:`/reference/window_function` as ``value`` value and other window function related parameters when you use window function. See :ref:`logical-range-filter-window-function-related-parameters` for details.
ja: ウィンドウ関数を使う場合は、 ``value`` の値に :doc:`/reference/window_function` を指定し、さらに他のウィンドウ関数関連のパラメーターも指定する必要があります。詳細は :ref:`logical-range-filter-window-function-related-parameters` を見てください。

en: Here is an example that creates a new dynamic column that stores the number of characters of content. This example uses :doc:`/reference/functions/string_length` function in ``functions/string`` plugin to compute the number of characters in a string. :doc:`plugin_register` is used to register ``functions/string`` plugin:
ja: 以下は内容の文字数を格納するための動的カラムを1つ作る例です。この例では文字数を数えるために ``functions/string`` プラグイン内の :doc:`/reference/functions/string_length` 関数を使っています。 ``functions/string`` プラグインを登録するために :doc:`plugin_register` を使っています。

en: Window function related parameters
ja: ウィンドウ関数関連の引数

en: All window function related parameters in :doc:`select` are supported. See :ref:`select-window-function-related-parameters` for details.
ja: :doc:`select` のすべてのウィンドウ関数関連パラメーターをサポートしています。詳細は :ref:`select-window-function-related-parameters` を見てください。

en: Window function over multiple tables aren't supported version 9.0.1 or before. Groonga supported it since version 9.0.2 or later. However, we need to align the same order for shard key and leading group key or sort key.
ja: バージョン9.0.1以前では、複数のテーブルをまたがったウィンドウ関数はサポートしていません。バージョン9.0.2以降ではサポートしていますが、先頭のグループキーまたは、ソートキーがシャードキーと同じ順序で並んでいる必要があります。

en: For example, we can apply the window function to over multiple tables as below case. Because the below example aligns the same order for shard key and leading group key.
ja: 例えば、以下のようなケースでは、複数のテーブルをまたいでウインドウ関数を適用できます。以下の例では、先頭のグループキーがシャードキーと同じ順序で並んでいるからです。

en: The leading group key is ``price`` and shard key is ``timestamp`` in the below example. We can apply the window function to over multiple tables in the below example. Because ``price`` and ``timestamp`` aligns the same order.
ja: 以下の例では、先頭のグループキーは ``price`` でシャードキーは ``timestamp`` です。 ``price`` と ``timestamp`` は同じ順序で並んでいるため、複数のテーブルをまたいでウインドウ関数を適用できます。

en: Corresponds to :ref:`select-columns-name-window-sort-keys` in :doc:`select`. See :ref:`select-columns-name-window-sort-keys` for details.
ja: :doc:`select` の :ref:`select-columns-name-window-sort-keys` に対応しています。詳細は :ref:`select-columns-name-window-sort-keys` を見てください。

en: You must specify :ref:`logical-range-filter-columns-name-window-sort-keys` or :ref:`logical-range-filter-columns-name-window-group-keys` to use window function.
ja: ウィンドウ関数を使うには :ref:`logical-range-filter-columns-name-window-sort-keys` または :ref:`logical-range-filter-columns-name-window-group-keys` を指定しなければいけません。

en: Here is an example that computes cumulative sum per ``Entries.tag``. Each group is sorted by ``Entries._key``:
ja: 以下は ``Entries.tag`` 毎に累積和を計算する例です。各グループ内のレコードは ``Entries._key`` でソートします。

en: Corresponds to :ref:`select-columns-name-window-group-keys` in :doc:`select`. See :ref:`select-columns-name-window-group-keys` for details.
ja: :doc:`select` の :ref:`select-columns-name-window-group-keys` に対応しています。詳細は :ref:`select-columns-name-window-group-keys` を見てください。

en: Here is an example that computes sum per ``Entries.tag``:
ja: 以下は ``Entries.tag`` 毎に合計を計算する例です。

en: Cache related parameter
ja: キャッシュ関連の引数

en: Specifies whether caching the result of this query or not.
ja: このクエリーの結果をキャッシュするかどうかを指定します。

en: If the result of this query is cached, the next same query returns response quickly by using the cache.
ja: このクエリーの結果がキャッシュしてあると、次に同じクエリーを実行するときはキャッシュを使って高速にレスポンスを返すことができます。

en: It doesn't control whether existing cached result is used or not.
ja: これは既存のキャッシュされた結果を使うかどうかを指定するものではありません。

en: Here are available values:
ja: 指定可能な値は以下の通りです。

en: Value
ja: 値

en: Description
ja: 説明

en: Don't cache the output of this query.
ja: このクエリーの出力をキャッシュしない。

en: Cache the output of this query. It's the default value.
ja: このクエリーの出力をキャッシュする。デフォルト値。

en: Here is an example to disable caching the result of this query:
ja: このクエリーの結果をキャッシュしないようにする例です。

en: The default value is ``yes``.
ja: デフォルト値は ``yes`` です。

en: Return value
ja: 戻り値

en: The command returns a response with the following format::
ja: このコマンドは以下のフォーマットのレスポンスを返します。::

en: If the command fails, error details are in ``HEADER``.
ja: このコマンドが失敗すると、 ``HEADER`` にエラーの詳細が含まれます。

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

en: ``COLUMNS`` describes about output columns specified by :ref:`logical-range-filter-output-columns`. It uses the following format::
ja: ``COLUMNS`` は :ref:`logical-range-filter-output-columns` で指定した出力カラムの情報を表しています。これは次のフォーマットになっています::

en: ``COLUMNS`` includes one or more output column information. Each output column information includes the followings:
ja: ``COLUMNS`` は1つ以上の出力カラムの情報を含んでいます。各出力カラムの情報は次の情報を含んでいます。

en: Column name as string
ja: カラム名（文字列）

en: Column type as string or ``null``
ja: カラムの型（文字列または ``null`` ）

en: Column name is extracted from value specified as :ref:`logical-range-filter-output-columns`.
ja: カラム名は :ref:`logical-range-filter-output-columns` で指定された値から抽出しています。

en: Column type is Groonga's type name or ``null``. It doesn't describe whether the column value is vector or scalar. You need to determine it by whether real column value is array or not.
ja: カラムの方はGroongaでの型名または ``null`` です。カラムがベクターかスカラーかの情報は持っていません。実際のカラムの値が配列かどうかで判断する必要があります。

en: See :doc:`/reference/types` for type details.
ja: 型の詳細は :doc:`/reference/types` を見てください。

en: ``null`` is used when column value type isn't determined. For example, function call in :ref:`logical-range-filter-output-columns` such as ``--output_columns "snippet_html(content)"`` uses ``null``.
ja: ``null`` になるときはカラムの値の型を決められないときです。たとえば、 ``--output_columns "snippet_html(content)"`` というように :ref:`logical-range-filter-output-columns` の中で関数呼び出しを使ったときは ``null`` になります。

en: Here is an example of ``COLUMNS``::
ja: 以下は ``COLUMNS`` の使用例です::

en: ``RECORDS`` includes column values for each matched record. Included records are selected by :ref:`logical-range-filter-offset` and :ref:`logical-range-filter-limit`. It uses the following format::
ja: ``RECORDS`` はマッチした各レコードのカラムの値を含んでいます。 ``RECORDS`` に含まれるレコードは :ref:`logical-range-filter-offset` と :ref:`logical-range-filter-limit` で選択されたレコードです。 ``RECORDS`` は次のフォーマットです::

en: Here is an example ``RECORDS``::
ja: 以下は ``RECORDS`` の例です::
