1.2.1 - en to ja translation catalogue (102 entries)

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

en: Summary
ja: 概要

en: ``logical_count`` is a command that has only count feature in :doc:`logical_select`. :doc:`logical_select` searches records from multiple tables, outputs the number of matched records, outputs columns of the matched records and so on. ``logical_count`` only searches records from multiple tables and output the number of matched records.
ja: ``logical_count`` は :doc:`logical_select` の件数カウント機能だけを提供するコマンドです。 :doc:`logical_select` は複数のテーブルからレコードを検索し、マッチしたレコード数を出力し、マッチしたレコードのカラムを出力し、他にもいろいろします。 ``logical_count`` は複数のテーブルからレコードを検索し、マッチしたレコード数を出力するだけです。

en: ``logical_count`` is useful when you just want the number of matched records. You can use ``logical_count`` and :doc:`logical_range_filter` at once. You can show the first N matched records before you get the number of matched records. If you use only :doc:`logical_select`, you need to wait finishing all search.
ja: ``logical_count`` はマッチしたレコードの数だけを知りたいときに便利です。 ``logical_count`` と :doc:`logical_range_filter` を一緒に使えます。一緒に使うと、マッチしたレコード数を取得する前に、マッチしたレコードのうち先頭のNレコードだけを先に表示できます。 :doc:`logical_select` だけを使っている場合は、すべての検索処理が終わるまで待たなければいけません。

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``. Other parameters are optional::
ja: 必須の引数は ``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: Note that ``logical_count`` is implemented as an experimental plugin, and the specification may be changed in the future.
ja: ``logical_count`` コマンドは実験的なプラグインです。このコマンドは将来的に変更されるかもしれません。

en: Here is the simple example which shows how to use this feature. Let's consider to count specified logs which are stored into multiple tables.
ja: この機能を使う簡単な例を示します。複数のテーブルに保存されている特定のログをカウントしてみましょう。

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: Here is an example to count the number of records which have ``Groonga`` or ``Senna`` in ``content`` column. ``logical_count`` searches records over all ``Entries_YYYYMMDD`` tables.
ja: 以下は ``content`` カラムに ``Groonga`` または ``Senna`` を含むレコード数を数える例です。 ``logical_count`` はすべての ``Entries_YYYYMMDD`` テーブルを検索します。

en: Here are matched records:
ja: マッチしたレコードは次の通りです。

en: ``_key:"Groonga"`` in ``Entries_20150708``
ja: ``Entries_20150708`` の中の ``_key:"Groonga"``

en: ``_key:"Good-bye Senna"`` in ``Entries_20150709``
ja: ``Entries_20150709`` の中の ``_key:"Good-bye Senna"``

en: Parameters
ja: 引数

en: This section describes parameters of this command.
ja: このセクションではこのコマンドのパラメーターを説明します。

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 ``Logs_20150203``, ``Logs_20150203`` and so on, logical table name is ``Logs``.
ja: 論理テーブル名を指定します。これは ``_YYYYMMDD`` をテーブル名から除いたものです。実際のテーブルが ``Logs_20150203`` や ``Logs_20150203`` といったものなら、論理テーブル名は ``Logs`` です。

en: You can count all records by specifying only ``logical_table`` and ``shard_key`` parameters. They are required parameters.
ja: ``logical_table`` と ``shard_key`` だけを指定すると全レコード数をカウントできます。これらの引数は必須の引数です。

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

en: Specifies column name which is treated as shared key. Shard key is a column that stores data that is used for distributing records to suitable shards.
ja: シャードキーとして使うカラム名を指定します。シャードキーは適切なシャードへレコードを分配するために使う値を保存しているカラムです。

en: Shard key must be ``Time`` type for now.
ja: 今のところ、シャードキーは ``Time`` 型でなければいけません。

en: See :ref:`logical-count-logical-table` how to specify ``shard_key``.
ja: ``shard_key`` の指定方法は :ref:`logical-count-logical-table` を見てください。

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

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

en: Specifies the minimum value of ``shard_key`` column. If shard doesn't have any matched records, the shard isn't searched.
ja: ``shard_key`` カラムの最小値を指定します。シャードにマッチするレコードがない場合は、そのシャードは検索対象外になります。

en: For example, ``min`` is ``"2015/07/09 00:00:00"``, ``Entry_20150708`` isn't searched. Because ``Entry_20150708`` has only records for ``"2015/07/08"``.
ja: たとえば、 ``min`` が ``"2015/07/09 00:00:00"`` なら、 ``Entry_20150708`` は検索対象外です。なぜなら、 ``Entry_20150708`` は ``"2015/07/08"`` のレコードしかないからです。

en: The following example only uses ``Entry_20150709`` table. ``Entry_20150708`` isn't used.
ja: 以下の例は ``Entry_20150709`` テーブルだけを使う例です。 ``Entry_20150708`` は使われません。

en: Specifies whether the minimum value is included or not. Here is available values.
ja: 最小値を含めるかどうかを指定します。指定可能な値は次の通りです。

en: Value
ja: 値

en: Description
ja: 説明

en: Includes ``min`` value. This is the default.
ja: ``min`` の値を含みます。これがデフォルト値です。

en: Doesn't include ``min`` value.
ja: ``min`` の値を含みません。

en: Here is an example for ``exclude``. The result doesn't include the ``"Good-bye Senna"`` record because its ``created_at`` value is ``"2015/07/09 00:00:00"``.
ja: 次の例は ``exclude`` の使用例です。結果には ``"Good-bye Senna"`` レコードは含まれません。このレコードの ``created_at`` の値が ``"2015/07/09 00:00:00"`` だからです。

en: Specifies the maximum value of ``shard_key`` column. If shard doesn't have any matched records, the shard isn't searched.
ja: ``shard_key`` カラムの最大値を指定します。シャードにマッチするレコードがない場合、そのシャードは検索対象外になります。

en: For example, ``max`` is ``"2015/07/08 23:59:59"``, ``Entry_20150709`` isn't searched. Because ``Entry_20150709`` has only records for ``""2015/07/09"``.
ja: たとえば、 ``max`` が ``"2015/07/08 23:59:59"`` なら ``Entry_20150709`` は検索対象外です。なぜなら ``Entry_20150709`` には ``""2015/07/09"`` のレコードしかないからです。

en: The following example only uses ``Entry_20150708`` table. ``Entry_20150709`` isn't used.
ja: 以下の例は ``Entry_20150708`` テーブルだけを使います。 ``Entry_20150709`` は使いません。

en: Specifies whether the maximum value is included or not. Here is available values.
ja: 最大値を含めるかどうかを指定します。指定可能な値は次の通りです。

en: Includes ``max`` value. This is the default.
ja: ``max`` の値を含みます。これがデフォルト値です。

en: Doesn't include ``max`` value.
ja: ``max`` の値を含みません。

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:`select-filter`.
ja: ``filtered`` ステージの動的カラムが生成されてから実行するフィルターを指定します。 ``post_filter`` を使うと ``filtered`` ステージの動的カラムを使って絞り込むことができます。他は :ref:`select-filter` と同じです。

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

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: 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: ``initial`` stage and ``filtered`` stage are valid. Because there are no processes after ``output`` stages.
ja: ``initial`` ステージと ``filtered`` ステージが有効です。なぜなら ``output`` ステージ以降にはなにも処理がないからです。

en: ``filtered`` stage is valid since 8.0.1.
ja: ``filtered`` ステージは8.0.1から使えます。

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

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-count-window-function-related-parameters` for details.
ja: ウィンドウ関数を使う場合は、 ``value`` の値に :doc:`/reference/window_function` を指定し、さらに他のウィンドウ関数関連のパラメーターも指定する必要があります。詳細は :ref:`logical-count-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-count-columns-name-window-sort-keys` or :ref:`logical-count-columns-name-window-group-keys` to use window function.
ja: ウィンドウ関数を使うには :ref:`logical-count-columns-name-window-sort-keys` または :ref:`logical-count-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: 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: ``N_HITS`` is the number of matched records.
ja: ``N_HITS`` はマッチしたレコード数です。
