1.2.1 - en to ja translation catalogue (47 entries)

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

en: Summary
ja: 概要

en: You can use ``in_records`` for using an existing table as condition patterns. Each record in the existing table is treated as a condition pattern.
ja: ``in_records`` を使うと既存のテーブルを条件のパターンとして使うことができます。テーブル内の各レコードがそれぞれ条件のパターンになります。

en: You may be able to reduce multiple queries to only one query by ``in_records``.
ja: ``in_records`` を使うと複数のクエリーを1つのクエリーにできるかもしれません。

en: ``in_records`` is similar to :doc:`sub_filter`. Here are differences of them:
ja: ``in_records`` は :doc:`sub_filter` に似ています。2つの違いは次の通りです。

en: ``sub_filter`` requires a reference column to condition table but ``in_records`` doesn't require.
ja: ``sub_filter`` では条件テーブルを参照するカラムが必須ですが、 ``in_records`` では必要ありません。

en: ``sub_filter`` requires an index column for the reference column but ``in_records`` doesn't require.
ja: ``sub_filter`` では上述の参照カラム用のインデックスカラムが必須ですが、 ``in_records`` ではインデックスカラムは必要ありません。

en: ``sub_filter`` can use all logical operations but ``in_records`` can use only AND logical operation in one pattern.
ja: ``sub_filter`` ではすべての論理演算を使えますが、 ``in_records`` では1つのパターン内でAND論理演算しか使えません。

en: ``sub_filter`` can use only the value of one reference column for condition but ``in_records`` can use one or more values for condition. You can use multiple columns, functions and so on for multiple values.
ja: ``sub_filter`` では条件に1つの参照カラムの値しか使えませんが、 ``in_records`` では条件に1つ以上の値を使えます。複数の値を指定するために複数のカラムや関数などを使えます。

en: ``sub_filter`` uses index search but ``in_records`` uses sequential search.
ja: ``sub_filter`` ではインデックスサーチを使いますが、 ``in_records`` ではシーケンシャルサーチを使います。

en: Syntax
ja: 構文

en: ``in_records`` has four or more parameters::
ja: ``in_records`` には4つ以上のパラメーターがあります。::

en: Usage
ja: 使い方

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

en: Sample schema:
ja: サンプルスキーマ:

en: Sample data:
ja: サンプルデータ:

en: Sample conditions:
ja: サンプル条件：

en: Here is a simple usage of ``in_records`` that searches by records in ``Conditions`` table. Each record is used as a condition:
ja: 以下は ``Conditions`` テーブル内のレコードで検索をする ``in_records`` の使用例です。各レコードを条件として使います。

en: The ``filter`` tries the following three conditions for each record:
ja: この ``filter`` は各レコードに対して次の3つの条件で絞り込みます。

en: ``Memos.user`` matches (``@``) ``Conditions.user_pattern``.
ja: ``Memos.user`` が ``Conditions.user_pattern`` にマッチ（ ``@`` ）するか。

en: ``Memos.tag`` equals (``==``) ``Conditions.tag``.
ja: ``Memos.tag`` は ``Conditions.tag`` と等しい（ ``==`` ）か。

en: The number of characters in ``Memos._key`` is less than or equals to ``Conditions.max_length``.
ja: ``Memos._key`` の文字数が ``Conditions.max_length`` 以下か。

en: If at least one record in ``Conditions`` table returns true for the all three conditions, the record in ``Memos`` is matched.
ja: ``Conditions`` テーブル内の少なくとも1つのレコードがこれら3つの条件すべてで真を返せば ``Memos`` テーブルのそのレコードはマッチします。

en: The first record in ``Conditions`` table use the following conditions:
ja: ``Conditions`` テーブルの最初のレコードは次の条件を使います。

en: ``Memos.user`` has ``"lic"`` substring.
ja: ``Memos.user`` には部分文字列として ``"lic"`` がある。

en: ``Memos.tag`` is ``"groonga"``.
ja: ``Memos.tag`` は ``"groonga"`` である。

en: The number of characters in ``Memos._key`` is less than or equals to ``20``.
ja: ``Memos._key`` の文字数が ``20`` 以下である。

en: This condition matches the following records:
ja: この条件は次のレコードにマッチします。

en: The second record in ``Conditions`` table use the following conditions:
ja: ``Conditions`` テーブルの2つめのレコードは次の条件を使います。

en: ``Memos.user`` has ``"dav"`` substring.
ja: ``Memos.user`` には部分文字列として ``"dav"`` がある。

en: ``Memos.tag`` is ``"droonga"``.
ja: ``Memos.tag`` は ``"droonga"`` である。

en: The number of characters in ``Memos._key`` is less than or equals to ``50``.
ja: ``Memos._key`` の文字数が ``50`` 以下である。

en: The result has the all above records.
ja: 検索結果には前述のすべてのレコードが含まれます。

en: Parameters
ja: 引数

en: ``in_records`` requires four or more parameters.
ja: ``in_records`` には4つ以上のパラメーターが必須です。

en: Required parameters
ja: 必須引数

en: ``condition_table`` and tuples of ``value``, ``mode_name`` and ``condition_column_name`` are required. You can specify multiple tuples of ``value``, ``mode_name`` and ``condition_column_name``
ja: ``condition_table`` と「 ``value`` 、 ``mode_name`` 、 ``condition_column_name`` 」のセットです。「 ``value`` 、 ``mode_name`` 、 ``condition_column_name`` 」のセットは複数回指定できます。

en: Specifies a table that has conditions as its records.
ja: レコードとして条件が入っているテーブルを指定します。

en: Specifies a value to be compared.
ja: 比較対象の値を指定します。

en: Specifies a mode name that specifies how to compare :ref:`in-records-value` with a value of :ref:`in-records-condition-column-name`.
ja: :ref:`in-records-value` と :ref:`in-records-condition-column-name` の値の比較方法（モード名）を指定します。

en: See :ref:`query-default-mode` for available mode names. All mode names except ``"NEAR"``, ``"SIMILAR"`` and ``"SUFFIX"`` are supported.
ja: 利用可能なモード名は :ref:`query-default-mode` を見てください。 ``"NEAR"`` 、 ``"SIMILAR"`` と ``"SUFFIX"`` 以外のすべてのモード名をサポートしています。

en: Specifies a column name of :ref:`in-records-condition-table` to be used as condition.
ja: 条件として使う :ref:`in-records-condition-table` のカラム名を指定します。

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

en: There are no optional parameter.
ja: 省略可能な引数はありません。

en: Return value
ja: 戻り値

en: ``in_records`` returns whether the record is matched one of records of the specified condition table or not.
ja: ``in_records`` は対象レコードが指定した条件テーブル内の1つ以上のレコード（パターン）にマッチするかどうかを返します。

en: If the record is matched, it returns ``true``. Otherwise, it returns ``false``.
ja: もし該当レコードがマッチすれば、 ``true`` を返します。そうでなければ ``false`` を返します。
