From a0b273878f2d81ab980a265dfc518a06800d6d8c Mon Sep 17 00:00:00 2001 From: Toshihiro Nakamura Date: Tue, 29 Oct 2024 21:31:44 +0900 Subject: [PATCH 1/2] Add urls --- docs/query-dsl.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/query-dsl.rst b/docs/query-dsl.rst index cd0b33c6a..ff189fd74 100644 --- a/docs/query-dsl.rst +++ b/docs/query-dsl.rst @@ -420,6 +420,9 @@ The following operators and predicates are supported: If the right-hand operand is ``null``, the WHERE or HAVING clause will exclude the operator. See `WhereDeclaration`_ and `HavingDeclaration`_ javadoc for details. +.. _WhereDeclaration: https://www.javadoc.io/doc/org.seasar.doma/doma-core/latest/org/seasar/doma/jdbc/criteria/declaration/WhereDeclaration.html +.. _HavingDeclaration: https://www.javadoc.io/doc/org.seasar.doma/doma-core/latest/org/seasar/doma/jdbc/criteria/declaration/HavingDeclaration.html + We also support utility operators: * eqOrIsNull - ("=" or "is null") From f00c0bcb40640abcb3b2f33165fc49c508855640 Mon Sep 17 00:00:00 2001 From: Toshihiro Nakamura Date: Sun, 3 Nov 2024 23:27:05 +0900 Subject: [PATCH 2/2] Translate query-dsl.rst into Japanese --- docs/criteria-api.rst | 11 +- docs/locale/ja/LC_MESSAGES/criteria-api.po | 696 ++++++------ docs/locale/ja/LC_MESSAGES/index.po | 22 +- docs/locale/ja/LC_MESSAGES/query-dsl.po | 1164 ++++++++++++++++++++ docs/query-dsl.rst | 11 +- 5 files changed, 1539 insertions(+), 365 deletions(-) create mode 100644 docs/locale/ja/LC_MESSAGES/query-dsl.po diff --git a/docs/criteria-api.rst b/docs/criteria-api.rst index f6eb56721..9ced49100 100644 --- a/docs/criteria-api.rst +++ b/docs/criteria-api.rst @@ -1,6 +1,6 @@ -============ -Criteria API -============ +==================== +Classic Criteria API +==================== .. contents:: :depth: 4 @@ -10,8 +10,9 @@ Introduction .. warning:: - Please use the :doc:`query-dsl` instead of the Entityql DSL or NativeSql DSL described on this page. - The Query DSL integrates both the Entityql DSL and NativeSql DSL. + Please use the Query DSL introduced on the :doc:`query-dsl` page instead of the Entityql and NativeSql + DSLs explained here. + The Query DSL is a new, unified interface that combines both Entityql and NativeSql DSLs. .. note:: diff --git a/docs/locale/ja/LC_MESSAGES/criteria-api.po b/docs/locale/ja/LC_MESSAGES/criteria-api.po index 578565c41..730f692bd 100644 --- a/docs/locale/ja/LC_MESSAGES/criteria-api.po +++ b/docs/locale/ja/LC_MESSAGES/criteria-api.po @@ -2,7 +2,7 @@ msgid "" msgstr "" "Project-Id-Version: doma-docs\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-19 20:27+0900\n" +"POT-Creation-Date: 2024-11-03 19:28+0900\n" "Last-Translator: \n" "Language-Team: Japanese\n" "MIME-Version: 1.0\n" @@ -16,7 +16,7 @@ msgstr "" "Language: ja_JP\n" #: ../../criteria-api.rst:3 -msgid "Criteria API" +msgid "Classic Criteria API" msgstr "" #: ../../criteria-api.rst:6 @@ -28,1112 +28,1116 @@ msgid "Introduction" msgstr "イントロダクション" #: ../../criteria-api.rst:13 +msgid "Please use the Query DSL introduced on the :doc:`query-dsl` page instead of the Entityql and NativeSql DSLs explained here. The Query DSL is a new, unified interface that combines both Entityql and NativeSql DSLs." +msgstr "ここで説明する Entityql と NativeSql DSL の代わりに :doc:`query-dsl` のページで紹介する Query DSL を使用してください。 Query DSLは、EntityqlとNativeSql DSLの両方を組み合わせた新しい統合インターフェイスです。" + +#: ../../criteria-api.rst:19 msgid "In Kotlin environment, use Kotlin specific DSLs instead of the following DSLs. See :ref:`kotlin-specific-criteria-api`." msgstr "Kotlin 環境では、次の DSL の代わりに Kotlin 固有の DSL を使用できます。 :ref:`kotlin-specific-criteria-api` を参照してください。" -#: ../../criteria-api.rst:16 +#: ../../criteria-api.rst:22 msgid "There are two kinds of DSLs in the Criteria API:" msgstr "Criteria API には 2 種類の DSL があります。" -#: ../../criteria-api.rst:18 +#: ../../criteria-api.rst:24 msgid "The Entityql DSL" msgstr "Entityql DSL" -#: ../../criteria-api.rst:19 +#: ../../criteria-api.rst:25 msgid "The NativeSql DSL" msgstr "NativeSql DSL" -#: ../../criteria-api.rst:21 +#: ../../criteria-api.rst:27 msgid "Both requires predefined Entity classes and metamodel classes." msgstr "どちらも、事前定義されたエンティティクラスとメタモデルクラスを必要とします。" -#: ../../criteria-api.rst:23 +#: ../../criteria-api.rst:29 msgid "We use the following Entity classes to show you some examples:" msgstr "次のエンティティクラスを使用して、いくつかの例を示します。" -#: ../../criteria-api.rst:99 +#: ../../criteria-api.rst:105 msgid "Note that the above classes are annotated with ``@Entity(metamodel = @Metamodel)``. The ``metamodel = @Metamodel`` indicates that the annotated entity has a corresponding metamodel class generated by Doma's annotation processor ." msgstr "上記のクラスには ``@Entity(metamodel = @Metamodel)`` というアノテーションが付けられていることに注意してください。 ``metamodel = @Metamodel`` は、エンティティクラスに対応するメタモデルクラスをDoma の アノテーションプロセッサー により生成することを示します。" -#: ../../criteria-api.rst:103 +#: ../../criteria-api.rst:109 msgid "In our examples, the metamodel classes are ``Employee_``, ``Department_``, ``Emp_`` and ``Dept_``. These metamodels allow you to make your query typesafe." msgstr "この例では、メタモデルクラスは ``Employee_``、``Department_``、``Emp_``、および ``Dept_`` です。これらのメタモデルクラスを使用すると、クエリをタイプセーフに構築できます。" -#: ../../criteria-api.rst:106 +#: ../../criteria-api.rst:112 msgid "You can customize the name of the metamodels by the Metamodel annotation elements." msgstr "メタモデルの名前は、メタモデルのアノテーション要素によってカスタマイズできます。" -#: ../../criteria-api.rst:108 +#: ../../criteria-api.rst:114 msgid "To customize all metamodels in bulk, you can use the annotation processor options. See :doc:`annotation-processing` and check the following options:" msgstr "すべてのメタモデルを一括でカスタマイズするには、アノテーションプロセッサのオプションを使用できます。 :doc:`annotation-processing` を参照して、次のオプションを確認してください。" -#: ../../criteria-api.rst:111 +#: ../../criteria-api.rst:117 msgid "doma.metamodel.enabled" msgstr "" -#: ../../criteria-api.rst:112 +#: ../../criteria-api.rst:118 msgid "doma.metamodel.prefix" msgstr "doma.metamodel.prefix" -#: ../../criteria-api.rst:113 +#: ../../criteria-api.rst:119 msgid "doma.metamodel.suffix" msgstr "doma.metamodel.suffix" -#: ../../criteria-api.rst:116 +#: ../../criteria-api.rst:122 msgid "Entityql DSL" msgstr "" -#: ../../criteria-api.rst:118 +#: ../../criteria-api.rst:124 msgid "The Entityql DSL can query and associate entities. The entry point is the ``org.seasar.doma.jdbc.criteria.Entityql`` class. This class has the following methods:" msgstr "Entityql DSL は、エンティティをクエリして関連付けることができます。エントリポイントは ``org.seasar.doma.jdbc.criteria.Entityql`` クラスです。このクラスには次のメソッドがあります。" -#: ../../criteria-api.rst:122 -#: ../../criteria-api.rst:173 +#: ../../criteria-api.rst:128 +#: ../../criteria-api.rst:179 msgid "from" msgstr "" -#: ../../criteria-api.rst:123 -#: ../../criteria-api.rst:175 +#: ../../criteria-api.rst:129 +#: ../../criteria-api.rst:181 msgid "insert" msgstr "insert" -#: ../../criteria-api.rst:124 -#: ../../criteria-api.rst:174 +#: ../../criteria-api.rst:130 +#: ../../criteria-api.rst:180 msgid "delete" msgstr "delete" -#: ../../criteria-api.rst:125 -#: ../../criteria-api.rst:176 +#: ../../criteria-api.rst:131 +#: ../../criteria-api.rst:182 msgid "update" msgstr "update" -#: ../../criteria-api.rst:127 +#: ../../criteria-api.rst:133 msgid "You can instantiate the ``Entityql`` class as follows:" msgstr "次のように ``Entityql`` クラスをインスタンス化できます。" -#: ../../criteria-api.rst:133 +#: ../../criteria-api.rst:139 msgid "For example, to query ``Employee`` and ``Department`` entities and associate them, write as follows:" msgstr "たとえば、 ``Employee`` エンティティと ``Department`` エンティティをクエリしてそれらを関連付けるには、次のように記述します。" -#: ../../criteria-api.rst:154 -#: ../../criteria-api.rst:201 -#: ../../criteria-api.rst:367 -#: ../../criteria-api.rst:391 -#: ../../criteria-api.rst:417 -#: ../../criteria-api.rst:442 -#: ../../criteria-api.rst:457 -#: ../../criteria-api.rst:486 -#: ../../criteria-api.rst:556 -#: ../../criteria-api.rst:579 -#: ../../criteria-api.rst:646 -#: ../../criteria-api.rst:666 -#: ../../criteria-api.rst:702 -#: ../../criteria-api.rst:758 -#: ../../criteria-api.rst:864 -#: ../../criteria-api.rst:880 -#: ../../criteria-api.rst:929 -#: ../../criteria-api.rst:972 -#: ../../criteria-api.rst:1001 -#: ../../criteria-api.rst:1020 -#: ../../criteria-api.rst:1048 -#: ../../criteria-api.rst:1079 -#: ../../criteria-api.rst:1174 -#: ../../criteria-api.rst:1249 -#: ../../criteria-api.rst:1279 -#: ../../criteria-api.rst:1354 -#: ../../criteria-api.rst:1385 -#: ../../criteria-api.rst:1436 -#: ../../criteria-api.rst:1460 -#: ../../criteria-api.rst:1586 -#: ../../criteria-api.rst:1628 -#: ../../criteria-api.rst:1671 -#: ../../criteria-api.rst:1704 -#: ../../criteria-api.rst:1725 -#: ../../criteria-api.rst:1763 -#: ../../criteria-api.rst:1806 -#: ../../criteria-api.rst:1850 -#: ../../criteria-api.rst:1890 +#: ../../criteria-api.rst:160 +#: ../../criteria-api.rst:207 +#: ../../criteria-api.rst:373 +#: ../../criteria-api.rst:397 +#: ../../criteria-api.rst:423 +#: ../../criteria-api.rst:448 +#: ../../criteria-api.rst:463 +#: ../../criteria-api.rst:492 +#: ../../criteria-api.rst:562 +#: ../../criteria-api.rst:585 +#: ../../criteria-api.rst:652 +#: ../../criteria-api.rst:672 +#: ../../criteria-api.rst:708 +#: ../../criteria-api.rst:764 +#: ../../criteria-api.rst:870 +#: ../../criteria-api.rst:886 +#: ../../criteria-api.rst:935 +#: ../../criteria-api.rst:978 +#: ../../criteria-api.rst:1007 +#: ../../criteria-api.rst:1026 +#: ../../criteria-api.rst:1054 +#: ../../criteria-api.rst:1085 +#: ../../criteria-api.rst:1180 +#: ../../criteria-api.rst:1255 +#: ../../criteria-api.rst:1285 +#: ../../criteria-api.rst:1360 +#: ../../criteria-api.rst:1391 +#: ../../criteria-api.rst:1442 +#: ../../criteria-api.rst:1466 +#: ../../criteria-api.rst:1592 +#: ../../criteria-api.rst:1634 +#: ../../criteria-api.rst:1677 +#: ../../criteria-api.rst:1710 +#: ../../criteria-api.rst:1731 +#: ../../criteria-api.rst:1769 +#: ../../criteria-api.rst:1812 +#: ../../criteria-api.rst:1856 +#: ../../criteria-api.rst:1896 msgid "The above query issues the following SQL statement:" msgstr "上記のクエリは次の SQL ステートメントを発行します。" -#: ../../criteria-api.rst:165 +#: ../../criteria-api.rst:171 msgid "NativeSql DSL" msgstr "" -#: ../../criteria-api.rst:167 +#: ../../criteria-api.rst:173 msgid "The NativeSql DSL can issue more complex SQL statements rather than the Entityql DSL. But note that the NativeSql DSL doesn't support to associate entities." msgstr "NativeSql DSL は、Entityql DSL よりも複雑な SQL ステートメントを発行できます。ただし、NativeSql DSL はエンティティの関連付けをサポートしていないことに注意してください。" -#: ../../criteria-api.rst:170 +#: ../../criteria-api.rst:176 msgid "The entry point is the ``org.seasar.doma.jdbc.criteria.NativeSql`` class. This class has the following methods:" msgstr "エントリポイントは ``org.seasar.doma.jdbc.criteria.NativeSql`` クラスです。このクラスには次のメソッドがあります。" -#: ../../criteria-api.rst:178 +#: ../../criteria-api.rst:184 msgid "You can instantiate the ``NativeSql`` class as follows:" msgstr "次のように ``NativeSql`` クラスをインスタンス化できます。" -#: ../../criteria-api.rst:184 +#: ../../criteria-api.rst:190 msgid "For example, to query two columns with GROUP BY and HAVING clauses, write as follows:" msgstr "たとえば、GROUP BY 句と HAVING 句を使用して 2 つの列をクエリするには、次のように記述します。" -#: ../../criteria-api.rst:212 +#: ../../criteria-api.rst:218 msgid "The difference between two DSLs" msgstr "2 つの DSL の違い" -#: ../../criteria-api.rst:214 +#: ../../criteria-api.rst:220 msgid "The biggest difference between two DSLs is that the Entityql DSL removes duplicated data from the fetched results, but the NativeSQL DSL doesn't." msgstr "2 つの DSL の最大の違いは、Entityql DSL はフェッチされた結果から重複データを削除しますが、NativeSQL DSL は削除しないことです。" -#: ../../criteria-api.rst:217 +#: ../../criteria-api.rst:223 msgid "See the following example:" msgstr "次の例を参照してください。" -#: ../../criteria-api.rst:235 +#: ../../criteria-api.rst:241 msgid "Both (1) and (2) issue the same SQL statement as follows:" msgstr "(1) と (2) の両方とも、以下のように同じ SQL ステートメントを発行します。" -#: ../../criteria-api.rst:243 +#: ../../criteria-api.rst:249 msgid "The ResultSet contains 14 rows, but the Entityql DSL returns only 3 rows because it removes duplicate Department entities. The Entityql DSL uses the id properties to know the uniqueness of the entities." msgstr "ResultSet には 14 行が含まれていますが、Entityql DSL は重複するDepartment エンティティを削除するため、3 行のみを返します。 Entityql DSL は、id プロパティを使用してエンティティの一意性を認識します。" -#: ../../criteria-api.rst:247 +#: ../../criteria-api.rst:253 msgid "On the other hand, the NativeSql DSL returns the data as it retrieves from the database. It puts results into entity objects, but it handles them as the plain DTOs." msgstr "一方、NativeSql DSL は、データベースから取得したデータを返します。結果はエンティティオブジェクトに格納されますが、それらはプレーンな DTO として処理されます。" -#: ../../criteria-api.rst:251 +#: ../../criteria-api.rst:257 msgid "Select statement" msgstr "Select ステートメント" -#: ../../criteria-api.rst:254 +#: ../../criteria-api.rst:260 msgid "Select settings (Entityql, NativeSql)" msgstr "Select 設定 (Entityql, NativeSql)" -#: ../../criteria-api.rst:256 -#: ../../criteria-api.rst:1205 -#: ../../criteria-api.rst:1291 -#: ../../criteria-api.rst:1524 +#: ../../criteria-api.rst:262 +#: ../../criteria-api.rst:1211 +#: ../../criteria-api.rst:1297 +#: ../../criteria-api.rst:1530 msgid "We support the following settings:" msgstr "次の設定をサポートしています。" -#: ../../criteria-api.rst:258 -#: ../../criteria-api.rst:1207 -#: ../../criteria-api.rst:1526 +#: ../../criteria-api.rst:264 +#: ../../criteria-api.rst:1213 +#: ../../criteria-api.rst:1532 msgid "allowEmptyWhere" msgstr "" -#: ../../criteria-api.rst:259 -#: ../../criteria-api.rst:1209 -#: ../../criteria-api.rst:1293 -#: ../../criteria-api.rst:1528 +#: ../../criteria-api.rst:265 +#: ../../criteria-api.rst:1215 +#: ../../criteria-api.rst:1299 +#: ../../criteria-api.rst:1534 msgid "comment" msgstr "" -#: ../../criteria-api.rst:260 +#: ../../criteria-api.rst:266 msgid "fetchSize" msgstr "" -#: ../../criteria-api.rst:261 +#: ../../criteria-api.rst:267 msgid "maxRows" msgstr "" -#: ../../criteria-api.rst:262 -#: ../../criteria-api.rst:1211 -#: ../../criteria-api.rst:1294 -#: ../../criteria-api.rst:1530 +#: ../../criteria-api.rst:268 +#: ../../criteria-api.rst:1217 +#: ../../criteria-api.rst:1300 +#: ../../criteria-api.rst:1536 msgid "queryTimeout" msgstr "" -#: ../../criteria-api.rst:263 -#: ../../criteria-api.rst:1212 -#: ../../criteria-api.rst:1295 -#: ../../criteria-api.rst:1531 +#: ../../criteria-api.rst:269 +#: ../../criteria-api.rst:1218 +#: ../../criteria-api.rst:1301 +#: ../../criteria-api.rst:1537 msgid "sqlLogType" msgstr "" -#: ../../criteria-api.rst:265 +#: ../../criteria-api.rst:271 msgid "They are all optional. You can apply them as follows:" msgstr "これらはすべてオプションです。それらは次のように適用できます。" -#: ../../criteria-api.rst:282 +#: ../../criteria-api.rst:288 msgid "Fetching (Entityql, NativeSql)" msgstr "フェッチ (Entityql、NativeSql)" -#: ../../criteria-api.rst:284 +#: ../../criteria-api.rst:290 msgid "Both Entityql DSL and NativeSql DSL support the following methods to fetch data from a database:" msgstr "Entityql DSL と NativeSql DSL はどちらも、データベースからデータをフェッチする次のメソッドをサポートしています。" -#: ../../criteria-api.rst:286 +#: ../../criteria-api.rst:292 msgid "fetch" msgstr "" -#: ../../criteria-api.rst:287 +#: ../../criteria-api.rst:293 msgid "fetchOne" msgstr "" -#: ../../criteria-api.rst:288 +#: ../../criteria-api.rst:294 msgid "fetchOptional" msgstr "" -#: ../../criteria-api.rst:289 +#: ../../criteria-api.rst:295 msgid "stream" msgstr "" -#: ../../criteria-api.rst:313 +#: ../../criteria-api.rst:319 msgid "Streaming (NativeSql)" msgstr "ストリーミング (NativeSql)" -#: ../../criteria-api.rst:315 +#: ../../criteria-api.rst:321 msgid "The NativeSql DSL supports the following methods:" msgstr "NativeSql DSL は次のメソッドをサポートしています。" -#: ../../criteria-api.rst:317 +#: ../../criteria-api.rst:323 msgid "mapStream" msgstr "" -#: ../../criteria-api.rst:318 +#: ../../criteria-api.rst:324 msgid "collect" msgstr "" -#: ../../criteria-api.rst:319 +#: ../../criteria-api.rst:325 msgid "openStream" msgstr "" -#: ../../criteria-api.rst:344 +#: ../../criteria-api.rst:350 msgid "These methods handle the stream that wraps a JDBC ResultSet. So they are useful to process a large ResultSet effectively." msgstr "これらのメソッドは、JDBC ResultSet をラップするストリームを処理します。したがって、これらは大規模な ResultSet を効率的に処理するのに役立ちます。" -#: ../../criteria-api.rst:348 +#: ../../criteria-api.rst:354 msgid "Select expression" msgstr "Select 式" -#: ../../criteria-api.rst:351 +#: ../../criteria-api.rst:357 msgid "Entity selection (Entityql, NativeSql)" msgstr "エンティティの検索 (Entityql、NativeSql)" -#: ../../criteria-api.rst:353 +#: ../../criteria-api.rst:359 msgid "By default, the result entity type is the same as the one specified at the ``from`` method. See the following code:" msgstr "デフォルトでは、結果のエンティティタイプは ``from`` メソッドで指定されたものと同じです。次のコードを参照してください。" -#: ../../criteria-api.rst:376 +#: ../../criteria-api.rst:382 msgid "To choose a joined entity type as the result entity type, call the ``select`` method as follows:" msgstr "結合されたエンティティの型を結果のエンティティの型として選択するには、次のように ``select`` メソッドを呼び出します。" -#: ../../criteria-api.rst:400 +#: ../../criteria-api.rst:406 msgid "Multiple entity selection (NativeSql)" msgstr "複数のエンティティの検索 (NativeSql)" -#: ../../criteria-api.rst:402 +#: ../../criteria-api.rst:408 msgid "You can specify multiple entity types and fetch them as a tuple as follows:" msgstr "次のように、複数のエンティティの型を指定してタプルとしてフェッチできます。" -#: ../../criteria-api.rst:427 +#: ../../criteria-api.rst:433 msgid "The entity included in the tuple may be null when the all properties of the entity are null." msgstr "エンティティのすべてのプロパティが null の場合、タプルに含まれるエンティティは null になる可能性があります。" -#: ../../criteria-api.rst:430 +#: ../../criteria-api.rst:436 msgid "Column projection (NativeSql)" msgstr "カラムの射影 (NativeSql)" -#: ../../criteria-api.rst:432 +#: ../../criteria-api.rst:438 msgid "To project columns, use the ``select`` method:" msgstr "カラムを射影するには、 ``select`` メソッドを使用します。" -#: ../../criteria-api.rst:434 +#: ../../criteria-api.rst:440 msgid "To project one column, pass one property to the select method as follows:" msgstr "1 つのカラムを射影するには、次のように 1 つのプロパティを select メソッドに渡します。" -#: ../../criteria-api.rst:448 +#: ../../criteria-api.rst:454 msgid "To project two or more columns, pass two or more properties to the select method as follows:" msgstr "2 つ以上のカラムを射影するには、次のように 2 つ以上のプロパティを select メソッドに渡します。" -#: ../../criteria-api.rst:463 +#: ../../criteria-api.rst:469 msgid "Up to 9 numbers, the column results are held by ``Tuple2`` to ``Tuple9``. For more than 9 numbers, the results are held by ``Row``." msgstr "9 個までのカラムの結果は ``Tuple2`` から ``Tuple9`` に保持されます。 9 個を超える数値の場合、結果は ``Row`` によって保持されます。" -#: ../../criteria-api.rst:466 +#: ../../criteria-api.rst:472 msgid "You can get a ``Row`` list explicitly by using ``selectAsRow`` as follows:" msgstr "次のように ``selectAsRow`` を使用すると、 ``Row`` リストを明示的に取得できます。" -#: ../../criteria-api.rst:476 +#: ../../criteria-api.rst:482 msgid "Column projection and mapping (Entityql, NativeSql)" msgstr "カラムの射影とマッピング (Entityql、NativeSql)" -#: ../../criteria-api.rst:478 +#: ../../criteria-api.rst:484 msgid "To project columns and map them to an entity, use the ``selectTo`` method as follows:" msgstr "カラムを射影してエンティティにマップするには、次のように ``selectTo`` メソッドを使用します。" -#: ../../criteria-api.rst:492 +#: ../../criteria-api.rst:498 msgid "Note that the select clause of the above SQL statement contains the primary key \"EMPLOYEE_ID\". The ``selectTo`` method always includes the id properties of the entity, even if you don't." msgstr "上記の SQL ステートメントの SELECT 句には主キー ``EMPLOYEE_ID`` が含まれていることに注意してください。 ``selectTo`` メソッドにエンティティの id プロパティが含まれていない場合でも、SELECT 句には常に主キーが含まれます。" -#: ../../criteria-api.rst:498 +#: ../../criteria-api.rst:504 msgid "Where expression (Entityql, NativeSql)" msgstr "Where 式 (Entityql、NativeSql)" -#: ../../criteria-api.rst:500 +#: ../../criteria-api.rst:506 msgid "We support the following operators and predicates:" msgstr "次の演算子と述語がサポートされています。" -#: ../../criteria-api.rst:502 -#: ../../criteria-api.rst:902 +#: ../../criteria-api.rst:508 +#: ../../criteria-api.rst:908 msgid "eq - (=)" msgstr "" -#: ../../criteria-api.rst:503 -#: ../../criteria-api.rst:903 +#: ../../criteria-api.rst:509 +#: ../../criteria-api.rst:909 msgid "ne - (<>)" msgstr "" -#: ../../criteria-api.rst:504 -#: ../../criteria-api.rst:904 +#: ../../criteria-api.rst:510 +#: ../../criteria-api.rst:910 msgid "ge - (>=)" msgstr "" -#: ../../criteria-api.rst:505 -#: ../../criteria-api.rst:905 +#: ../../criteria-api.rst:511 +#: ../../criteria-api.rst:911 msgid "gt - (>)" msgstr "" -#: ../../criteria-api.rst:506 -#: ../../criteria-api.rst:906 +#: ../../criteria-api.rst:512 +#: ../../criteria-api.rst:912 msgid "le - (<=)" msgstr "" -#: ../../criteria-api.rst:507 -#: ../../criteria-api.rst:907 +#: ../../criteria-api.rst:513 +#: ../../criteria-api.rst:913 msgid "lt - (<)" msgstr "" -#: ../../criteria-api.rst:508 +#: ../../criteria-api.rst:514 msgid "isNull - (is null)" msgstr "" -#: ../../criteria-api.rst:509 +#: ../../criteria-api.rst:515 msgid "isNotNull - (is not null)" msgstr "" -#: ../../criteria-api.rst:510 +#: ../../criteria-api.rst:516 msgid "like" msgstr "" -#: ../../criteria-api.rst:511 +#: ../../criteria-api.rst:517 msgid "notLike - (not like)" msgstr "" -#: ../../criteria-api.rst:512 +#: ../../criteria-api.rst:518 msgid "between" msgstr "" -#: ../../criteria-api.rst:513 +#: ../../criteria-api.rst:519 msgid "in" msgstr "" -#: ../../criteria-api.rst:514 +#: ../../criteria-api.rst:520 msgid "notIn - (not in)" msgstr "" -#: ../../criteria-api.rst:515 +#: ../../criteria-api.rst:521 msgid "exists" msgstr "" -#: ../../criteria-api.rst:516 +#: ../../criteria-api.rst:522 msgid "notExists - (not exists)" msgstr "" -#: ../../criteria-api.rst:520 +#: ../../criteria-api.rst:526 msgid "If the right hand operand is ``null``, the WHERE or the HAVING clause doesn't include the operator. See WhereDeclaration_ and HavingDeclaration_ javadoc for more details." msgstr "右側のオペランドが ``null`` の場合、WHERE 句または HAVING 句には演算子が含まれません。詳細については、 WhereDeclaration_ および HavingDeclaration_ の javadoc を参照してください。" -#: ../../criteria-api.rst:526 +#: ../../criteria-api.rst:532 msgid "We also support the following utility operators:" msgstr "次のユーティリティ演算子もサポートしています。" -#: ../../criteria-api.rst:528 +#: ../../criteria-api.rst:534 msgid "eqOrIsNull - (\"=\" or \"is null\")" msgstr "" -#: ../../criteria-api.rst:529 +#: ../../criteria-api.rst:535 msgid "neOrIsNotNull - (\"<>\" or \"is not null\")" msgstr "" -#: ../../criteria-api.rst:531 -#: ../../criteria-api.rst:909 +#: ../../criteria-api.rst:537 +#: ../../criteria-api.rst:915 msgid "We also support the following logical operators:" msgstr "次の論理演算子もサポートしています。" -#: ../../criteria-api.rst:533 -#: ../../criteria-api.rst:911 +#: ../../criteria-api.rst:539 +#: ../../criteria-api.rst:917 msgid "and" msgstr "" -#: ../../criteria-api.rst:534 -#: ../../criteria-api.rst:912 +#: ../../criteria-api.rst:540 +#: ../../criteria-api.rst:918 msgid "or" msgstr "" -#: ../../criteria-api.rst:535 -#: ../../criteria-api.rst:913 +#: ../../criteria-api.rst:541 +#: ../../criteria-api.rst:919 msgid "not" msgstr "" -#: ../../criteria-api.rst:565 +#: ../../criteria-api.rst:571 msgid "You can write a subquery as follows:" msgstr "サブクエリは次のように記述できます。" -#: ../../criteria-api.rst:590 +#: ../../criteria-api.rst:596 msgid "Dynamic where expression (Entityql, NativeSql)" msgstr "動的 where 式 (Entityql、NativeSql)" -#: ../../criteria-api.rst:592 +#: ../../criteria-api.rst:598 msgid "A where expression uses only evaluated operators to build a WHERE clause." msgstr "where 式は、評価された演算子のみを使用して WHERE 句を構築します。" -#: ../../criteria-api.rst:594 +#: ../../criteria-api.rst:600 msgid "When every operators are not evaluated in a where expression, the built statement doesn't have any WHERE clause." msgstr "where 式ですべての演算子が評価されない場合、構築されたステートメントには WHERE 句が含まれません。" -#: ../../criteria-api.rst:597 -#: ../../criteria-api.rst:947 +#: ../../criteria-api.rst:603 +#: ../../criteria-api.rst:953 msgid "As well as, when every operators are not evaluated in a logical operator expression, the built statement doesn't have the logical operator expression." msgstr "また、すべての演算子が論理演算子の式で評価されない場合、構築されたステートメントには論理演算子の式が含まれません。" -#: ../../criteria-api.rst:600 +#: ../../criteria-api.rst:606 msgid "For example, suppose that a where expression contains a conditional expression as follows:" msgstr "たとえば、where 式に次のような条件式が含まれているとします。" -#: ../../criteria-api.rst:618 +#: ../../criteria-api.rst:624 msgid "In the case that the ``enableNameCondition`` variable is ``false``, the ``like`` expression is ignored. The above query issues the following SQL statement:" msgstr "``enableNameCondition`` 変数が ``false`` の場合、``like`` 式は無視されます。上記のクエリは次の SQL ステートメントを発行します。" -#: ../../criteria-api.rst:628 +#: ../../criteria-api.rst:634 msgid "Join expression" msgstr "Join 式" -#: ../../criteria-api.rst:630 -#: ../../criteria-api.rst:1061 +#: ../../criteria-api.rst:636 +#: ../../criteria-api.rst:1067 msgid "We support the following expressions:" msgstr "次の式がサポートされています。" -#: ../../criteria-api.rst:632 +#: ../../criteria-api.rst:638 msgid "innerJoin - (inner join)" msgstr "innerJoin - (内部結合)" -#: ../../criteria-api.rst:633 +#: ../../criteria-api.rst:639 msgid "leftJoin - (left outer join)" msgstr "leftJoin - (左外部結合)" -#: ../../criteria-api.rst:636 +#: ../../criteria-api.rst:642 msgid "innerJoin (Entityql, NativeSql)" msgstr "innerJoin (Entityql、NativeSql)" -#: ../../criteria-api.rst:656 +#: ../../criteria-api.rst:662 msgid "leftJoin (Entityql, NativeSql)" msgstr "leftJoin (Entityql、NativeSQL)" -#: ../../criteria-api.rst:678 +#: ../../criteria-api.rst:684 msgid "association (Entityql)" msgstr "関連付け (Entityql)" -#: ../../criteria-api.rst:680 +#: ../../criteria-api.rst:686 msgid "You can associate entities with the ``associate`` operation in the Entityql DSL. You have to use the ``associate`` operation with join expression." msgstr "Entityql DSL の ``associate`` メソッドを使用してエンティティを関連付けることができます。 join 式と一緒に ``associate`` メソッドを使用する必要があります。" -#: ../../criteria-api.rst:712 +#: ../../criteria-api.rst:718 msgid "You can associate many entities:" msgstr "多くのエンティティを関連付けることができます。" -#: ../../criteria-api.rst:737 +#: ../../criteria-api.rst:743 msgid "association for immutable entities (Entityql)" msgstr "不変エンティティの関連付け (Entityql)" -#: ../../criteria-api.rst:739 +#: ../../criteria-api.rst:745 msgid "You can associate immutable entities with the ``associateWith`` operation in the Entityql DSL. You have to use the ``associateWith`` operation with join expression." msgstr "不変エンティティを Entityql DSL の ``associateWith`` メソッドに関連付けることができます。 join 式と一緒に ``associateWith`` メソッドを使用する必要があります。" -#: ../../criteria-api.rst:773 +#: ../../criteria-api.rst:779 msgid "Dynamic join expression (Entityql, NativeSql)" msgstr "動的 join 式 (Entityql、NativeSql)" -#: ../../criteria-api.rst:775 +#: ../../criteria-api.rst:781 msgid "A join expression uses only evaluated operators to build a JOIN clause." msgstr "join 式は、評価された演算子のみを使用して JOIN 句を構築します。" -#: ../../criteria-api.rst:777 +#: ../../criteria-api.rst:783 msgid "When every operators are not evaluated in a join expression, the built statement doesn't have any JOIN clause." msgstr "すべての演算子が join 式で評価されない場合、構築されたステートメントには JOIN 句は含まれません。" -#: ../../criteria-api.rst:780 +#: ../../criteria-api.rst:786 msgid "For example, suppose that a join expression contains a conditional expression as follows:" msgstr "たとえば、 join 式に条件分岐が含まれているとします。" -#: ../../criteria-api.rst:799 +#: ../../criteria-api.rst:805 msgid "In the case that the ``join`` variable is ``false``, the ``on`` expression is ignored. The above query issues the following SQL statement:" msgstr "``join`` 変数が ``false`` の場合、``on`` 式は無視されます。上記のクエリは次の SQL ステートメントを発行します。" -#: ../../criteria-api.rst:809 +#: ../../criteria-api.rst:815 msgid "Dynamic association (Entityql)" msgstr "動的関連付け (Entityql)" -#: ../../criteria-api.rst:811 +#: ../../criteria-api.rst:817 msgid "When you use the above dynamic join expression, the association must be optional. To do it, pass the result of ``AssociationOption.optional()`` to the associate method:" msgstr "上記の動的 join 式を使用する場合、関連付けはオプションである必要があります。これを行うには、 ``AssociationOption.optional()`` の結果を関連付けメソッドに渡します。" -#: ../../criteria-api.rst:840 +#: ../../criteria-api.rst:846 msgid "Aggregate Functions (NativeSql)" msgstr "集約関数 (NativeSql)" -#: ../../criteria-api.rst:842 +#: ../../criteria-api.rst:848 msgid "We support the following aggregate functions:" msgstr "次の集約関数をサポートしています。" -#: ../../criteria-api.rst:844 +#: ../../criteria-api.rst:850 msgid "avg(property)" msgstr "" -#: ../../criteria-api.rst:845 +#: ../../criteria-api.rst:851 msgid "avgAsDouble(property)" msgstr "" -#: ../../criteria-api.rst:846 +#: ../../criteria-api.rst:852 msgid "count()" msgstr "" -#: ../../criteria-api.rst:847 +#: ../../criteria-api.rst:853 msgid "count(property)" msgstr "" -#: ../../criteria-api.rst:848 +#: ../../criteria-api.rst:854 msgid "countDistinct(property)" msgstr "" -#: ../../criteria-api.rst:849 +#: ../../criteria-api.rst:855 msgid "max(property)" msgstr "" -#: ../../criteria-api.rst:850 +#: ../../criteria-api.rst:856 msgid "min(property)" msgstr "" -#: ../../criteria-api.rst:851 +#: ../../criteria-api.rst:857 msgid "sum(property)" msgstr "" -#: ../../criteria-api.rst:853 +#: ../../criteria-api.rst:859 msgid "These are defined in the ``org.seasar.doma.jdbc.criteria.expression.Expressions`` class. Use them with static import." msgstr "これらは ``org.seasar.doma.jdbc.criteria.expression.Expressions`` クラスで定義されています。静的インポートで使用します。" -#: ../../criteria-api.rst:856 +#: ../../criteria-api.rst:862 msgid "For example, you can pass the ``sum`` function to the select method:" msgstr "たとえば、 ``sum`` 関数を select メソッドに渡すことができます。" -#: ../../criteria-api.rst:871 +#: ../../criteria-api.rst:877 msgid "Group by expression (NativeSql)" msgstr "Group by 式 (NativeSql)" -#: ../../criteria-api.rst:886 +#: ../../criteria-api.rst:892 msgid "When you don't specify a group by expression, the expression is inferred from the select expression automatically. So the following code issue the same SQL statement above:" msgstr "group by 式を指定しない場合、group by 式は select 式から自動的に推測されます。したがって、次のコードは上記と同じ SQL ステートメントを発行します。" -#: ../../criteria-api.rst:898 +#: ../../criteria-api.rst:904 msgid "Having expression (NativeSql)" msgstr "Having 式(NativeSql)" -#: ../../criteria-api.rst:900 +#: ../../criteria-api.rst:906 msgid "We support the following operators:" msgstr "次の演算子をサポートしています。" -#: ../../criteria-api.rst:940 +#: ../../criteria-api.rst:946 msgid "Dynamic having expression (NativeSql)" msgstr "動的 Having 式 (NativeSql)" -#: ../../criteria-api.rst:942 +#: ../../criteria-api.rst:948 msgid "A having expression uses only evaluated operators to build a HAVING clause." msgstr "having 式では、評価された演算子のみを使用して HAVING 句を構築します。" -#: ../../criteria-api.rst:944 +#: ../../criteria-api.rst:950 msgid "When every operators are not evaluated in a having expression, the built statement doesn't have any HAVING clause." msgstr "having 式ですべての演算子が評価されない場合、構築されたステートメントには HAVING 句は含まれません。" -#: ../../criteria-api.rst:951 +#: ../../criteria-api.rst:957 msgid "Order by expression (Entityql, NativeSql)" msgstr "Order by 式 (Entityql、NativeSql)" -#: ../../criteria-api.rst:953 +#: ../../criteria-api.rst:959 msgid "We support the following order operations:" msgstr "次のソート操作をサポートしています。" -#: ../../criteria-api.rst:955 +#: ../../criteria-api.rst:961 msgid "asc" msgstr "" -#: ../../criteria-api.rst:956 +#: ../../criteria-api.rst:962 msgid "desc" msgstr "\n" -#: ../../criteria-api.rst:982 +#: ../../criteria-api.rst:988 msgid "Dynamic order by expression (NativeSql)" msgstr "動的 Order by 式 (NativeSql)" -#: ../../criteria-api.rst:984 +#: ../../criteria-api.rst:990 msgid "An order by expression uses only evaluated operators to build an ORDER BY clause." msgstr "order by 式では、評価された演算子のみを使用して ORDER BY 句を作成します。" -#: ../../criteria-api.rst:986 +#: ../../criteria-api.rst:992 msgid "When every operators are not evaluated in a order by expression, the built statement doesn't have any ORDER BY clause." msgstr "すべての演算子が order by 式で評価されない場合、構築されたステートメントには ORDER BY 句は含まれません。" -#: ../../criteria-api.rst:990 +#: ../../criteria-api.rst:996 msgid "Distinct expression (Entityql, NativeSql)" msgstr "Distinct 式 (Entityql、NativeSql)" -#: ../../criteria-api.rst:1011 +#: ../../criteria-api.rst:1017 msgid "Limit and Offset expression (Entityql, NativeSql)" msgstr "Limit および offset 式 (Entityql、NativeSql)" -#: ../../criteria-api.rst:1031 +#: ../../criteria-api.rst:1037 msgid "Dynamic Limit and Offset expression (Entityql, NativeSql)" msgstr "動的な limit および offset 式 (Entityql、NativeSql)" -#: ../../criteria-api.rst:1033 +#: ../../criteria-api.rst:1039 msgid "A limit expressions uses only non-null value to build a FETCH FIRST clause. When the value is null ,the built statement doesn't have any FETCH FIRST clause." msgstr "limit 式では、null 以外の値のみを使用して FETCH FIRST 句を構築します。値が null の場合、構築されたステートメントには FETCH FIRST 句がありません。" -#: ../../criteria-api.rst:1036 +#: ../../criteria-api.rst:1042 msgid "As well as, an offset expressions uses only non-null value to build a OFFSET clause. When the value is null ,the built statement doesn't have any OFFSET clause." msgstr "また、offset 式では、OFFSET 句を構築するために null 以外の値のみが使用されます。値が null の場合、構築されたステートメントには OFFSET 句がありません。" -#: ../../criteria-api.rst:1040 +#: ../../criteria-api.rst:1046 msgid "For Update expression (Entityql, NativeSql)" msgstr " For update 式 (Entityql、NativeSql)" -#: ../../criteria-api.rst:1059 +#: ../../criteria-api.rst:1065 msgid "Union expression (NativeSql)" msgstr "Union 式（NativeSql）" -#: ../../criteria-api.rst:1063 +#: ../../criteria-api.rst:1069 msgid "union" msgstr "" -#: ../../criteria-api.rst:1064 +#: ../../criteria-api.rst:1070 msgid "unionAll - (union all)" msgstr "" -#: ../../criteria-api.rst:1087 +#: ../../criteria-api.rst:1093 msgid "The order by expression with index is supported:" msgstr "インデックスを使用した式による順序付けがサポートされています。" -#: ../../criteria-api.rst:1104 +#: ../../criteria-api.rst:1110 msgid "Derived Table expression (Entityql, NativeSql)" msgstr "派生テーブル式 (Entityql、NativeSql)" -#: ../../criteria-api.rst:1106 +#: ../../criteria-api.rst:1112 msgid "We support subqueries using derived tables. However, an entity class corresponding to the derived table is required." msgstr "派生テーブルを使用したサブクエリをサポートします。ただし、派生テーブルに対応するエンティティクラスが必要です。" -#: ../../criteria-api.rst:1109 +#: ../../criteria-api.rst:1115 msgid "Define the entity class corresponding to the derived table as follows:" msgstr "派生テーブルに対応するエンティティ クラスを次のように定義します。" -#: ../../criteria-api.rst:1156 +#: ../../criteria-api.rst:1162 msgid "A subquery using a derived table can be written as follows." msgstr "派生テーブルを使用したサブクエリは次のように記述できます。" -#: ../../criteria-api.rst:1197 +#: ../../criteria-api.rst:1203 msgid "Delete statement" msgstr "Delete ステートメント" -#: ../../criteria-api.rst:1199 +#: ../../criteria-api.rst:1205 msgid "For the specification of the where expression, see :ref:`criteria_where`. The same rule is applied to delete statements." msgstr "where 式の仕様については、:ref:`criteria_where` を参照してください。同じルールがステートメントの削除にも適用されます。" -#: ../../criteria-api.rst:1203 +#: ../../criteria-api.rst:1209 msgid "Delete settings (Entityql, NativeSql)" msgstr "Delete 設定（Entityql、NativeSql）" -#: ../../criteria-api.rst:1208 -#: ../../criteria-api.rst:1296 -#: ../../criteria-api.rst:1527 +#: ../../criteria-api.rst:1214 +#: ../../criteria-api.rst:1302 +#: ../../criteria-api.rst:1533 msgid "batchSize" msgstr "" -#: ../../criteria-api.rst:1210 -#: ../../criteria-api.rst:1529 +#: ../../criteria-api.rst:1216 +#: ../../criteria-api.rst:1535 msgid "ignoreVersion" msgstr "ignoreVersion" -#: ../../criteria-api.rst:1213 -#: ../../criteria-api.rst:1532 +#: ../../criteria-api.rst:1219 +#: ../../criteria-api.rst:1538 msgid "suppressOptimisticLockException" msgstr "suppressOptimisticLockException" -#: ../../criteria-api.rst:1215 -#: ../../criteria-api.rst:1302 -#: ../../criteria-api.rst:1537 +#: ../../criteria-api.rst:1221 +#: ../../criteria-api.rst:1308 +#: ../../criteria-api.rst:1543 msgid "They are all optional." msgstr "これらはすべてオプションです。" -#: ../../criteria-api.rst:1217 -#: ../../criteria-api.rst:1304 -#: ../../criteria-api.rst:1539 +#: ../../criteria-api.rst:1223 +#: ../../criteria-api.rst:1310 +#: ../../criteria-api.rst:1545 msgid "You can apply them as follows:" msgstr "それらは次のように適用できます。" -#: ../../criteria-api.rst:1235 +#: ../../criteria-api.rst:1241 msgid "If you want to build a delete statement without a WHERE clause, you have to enable the `allowEmptyWhere` setting." msgstr "WHERE 句のない削除ステートメントを構築したい場合は、`allowEmptyWhere` 設定を有効にする必要があります。" -#: ../../criteria-api.rst:1239 +#: ../../criteria-api.rst:1245 msgid "Delete statement (Entityql)" msgstr "Delete ステートメント (Entityql)" -#: ../../criteria-api.rst:1255 +#: ../../criteria-api.rst:1261 msgid "Batch Delete is also supported:" msgstr "バッチ削除もサポートされています。" -#: ../../criteria-api.rst:1266 -#: ../../criteria-api.rst:1412 -#: ../../criteria-api.rst:1443 -#: ../../criteria-api.rst:1605 -#: ../../criteria-api.rst:1635 +#: ../../criteria-api.rst:1272 +#: ../../criteria-api.rst:1418 +#: ../../criteria-api.rst:1449 +#: ../../criteria-api.rst:1611 +#: ../../criteria-api.rst:1641 msgid "The execute method may throw following exceptions:" msgstr "実行メソッドは次の例外をスローする場合があります。" -#: ../../criteria-api.rst:1268 -#: ../../criteria-api.rst:1607 +#: ../../criteria-api.rst:1274 +#: ../../criteria-api.rst:1613 msgid "OptimisticLockException: if the entity has a version property and an update count is 0" msgstr "OptimisticLockException: エンティティにバージョン プロパティがあり、更新件数が 0 の場合" -#: ../../criteria-api.rst:1271 +#: ../../criteria-api.rst:1277 msgid "Delete statement (NativeSql)" msgstr "Delete ステートメント (NativeSql)" -#: ../../criteria-api.rst:1286 +#: ../../criteria-api.rst:1292 msgid "Insert statement" msgstr "Insert ステートメント" -#: ../../criteria-api.rst:1289 +#: ../../criteria-api.rst:1295 msgid "Insert settings (Entityql, NativeSql)" msgstr "Insert 設定 (Entityql、NativeSql)" -#: ../../criteria-api.rst:1297 -#: ../../criteria-api.rst:1533 +#: ../../criteria-api.rst:1303 +#: ../../criteria-api.rst:1539 msgid "excludeNull" msgstr "" -#: ../../criteria-api.rst:1298 -#: ../../criteria-api.rst:1534 +#: ../../criteria-api.rst:1304 +#: ../../criteria-api.rst:1540 msgid "include" msgstr "" -#: ../../criteria-api.rst:1299 -#: ../../criteria-api.rst:1535 +#: ../../criteria-api.rst:1305 +#: ../../criteria-api.rst:1541 msgid "exclude" msgstr "" -#: ../../criteria-api.rst:1300 +#: ../../criteria-api.rst:1306 msgid "ignoreGeneratedKeys" msgstr "" -#: ../../criteria-api.rst:1340 +#: ../../criteria-api.rst:1346 msgid "Insert statement (Entityql)" msgstr "Insert ステートメント (Entityql)" -#: ../../criteria-api.rst:1361 +#: ../../criteria-api.rst:1367 msgid "Batch Insert is also supported:" msgstr "バッチ追加もサポートされています。" -#: ../../criteria-api.rst:1373 +#: ../../criteria-api.rst:1379 msgid "Multi-row Insert is also supported:" msgstr "複数行追加もサポートされています。" -#: ../../criteria-api.rst:1392 -#: ../../criteria-api.rst:1468 +#: ../../criteria-api.rst:1398 +#: ../../criteria-api.rst:1474 msgid "Upsert is also supported:" msgstr "Upsertもサポートされています" -#: ../../criteria-api.rst:1394 +#: ../../criteria-api.rst:1400 msgid "By calling on `onDuplicateKeyUpdate`, you can update when a key is duplicated." msgstr "`onDuplicateKeyUpdate` を呼び出すことで、キーが重複した場合に更新することができます。" -#: ../../criteria-api.rst:1403 +#: ../../criteria-api.rst:1409 msgid "By calling on `onDuplicateKeyIgnore`, you can ignore errors when a key is duplicated." msgstr "`onDuplicateKeyIgnore` を呼び出すことで、キーが重複した場合のエラーを無視することができます。" -#: ../../criteria-api.rst:1414 -#: ../../criteria-api.rst:1445 -#: ../../criteria-api.rst:1608 -#: ../../criteria-api.rst:1637 +#: ../../criteria-api.rst:1420 +#: ../../criteria-api.rst:1451 +#: ../../criteria-api.rst:1614 +#: ../../criteria-api.rst:1643 msgid "UniqueConstraintException: if an unique constraint is violated" msgstr "UniqueConstraintException: 一意制約に違反した場合" -#: ../../criteria-api.rst:1417 +#: ../../criteria-api.rst:1423 msgid "Insert statement (NativeSql)" msgstr "Insert ステートメント (NativeSql)" -#: ../../criteria-api.rst:1447 +#: ../../criteria-api.rst:1453 msgid "We also support the INSERT SELECT syntax as follows:" msgstr "次のような INSERT SELECT 構文もサポートされています。" -#: ../../criteria-api.rst:1470 +#: ../../criteria-api.rst:1476 msgid "By calling on `onDuplicateKeyUpdate`, you can update when a key is duplicated. You can specify keys for duplicate check targets in `keys`. You can specify the value of the update in case of duplicates in `set`." msgstr "`onDuplicateKeyUpdate` を呼び出すことで、キーが重複したときに更新することができます。 `keys` で重複チェック対象のキーを指定できます。`set` で重複した場合の更新の値を指定できます。" -#: ../../criteria-api.rst:1496 +#: ../../criteria-api.rst:1502 msgid "By calling on `onDuplicateKeyIgnore`, you can ignore errors when a key is duplicated. You can specify keys for duplicate check targets in `keys`." msgstr "`onDuplicateKeyIgnore` を呼び出すことで、キーが重複したときのエラーを無視することができます。 `keys` で重複チェック対象のキーを指定できます。" -#: ../../criteria-api.rst:1516 +#: ../../criteria-api.rst:1522 msgid "Update statement" msgstr "Update ステートメント" -#: ../../criteria-api.rst:1518 +#: ../../criteria-api.rst:1524 msgid "For the specification of the where expression, see :ref:`criteria_where`. The same rule is applied to update statements." msgstr "where 式の仕様については、:ref:`criteria_where` を参照してください。同じルールが更新ステートメントにも適用されます。" -#: ../../criteria-api.rst:1522 +#: ../../criteria-api.rst:1528 msgid "Update settings (Entityql, NativeSql)" msgstr "Update 設定 (Entityql、NativeSql)" -#: ../../criteria-api.rst:1570 +#: ../../criteria-api.rst:1576 msgid "If you want to build a update statement without a WHERE clause, you have to enable the `allowEmptyWhere` setting." msgstr "WHERE 句のない update ステートメントを構築したい場合は、`allowEmptyWhere` 設定を有効にする必要があります。" -#: ../../criteria-api.rst:1574 +#: ../../criteria-api.rst:1580 msgid "Update statement (Entityql)" msgstr "Update ステートメント (Entityql)" -#: ../../criteria-api.rst:1593 +#: ../../criteria-api.rst:1599 msgid "Batch Update is also supported:" msgstr "バッチ更新もサポートされています。" -#: ../../criteria-api.rst:1611 +#: ../../criteria-api.rst:1617 msgid "Update statement (NativeSql)" msgstr "Update ステートメント (NativeSql)" -#: ../../criteria-api.rst:1640 +#: ../../criteria-api.rst:1646 msgid "Property expressions (Entityql, NativeSql)" msgstr "プロパティ式 (Entityql、NativeSql)" -#: ../../criteria-api.rst:1642 +#: ../../criteria-api.rst:1648 msgid "All expression methods are defined in the ``org.seasar.doma.jdbc.criteria.expression.Expressions`` class." msgstr "すべての式メソッドは ``org.seasar.doma.jdbc.criteria.expression.Expressions`` クラスで定義されています。" -#: ../../criteria-api.rst:1645 +#: ../../criteria-api.rst:1651 msgid "Use them with static import." msgstr "静的インポートで使用します。" -#: ../../criteria-api.rst:1648 +#: ../../criteria-api.rst:1654 msgid "Arithmetic expressions" msgstr "算術式" -#: ../../criteria-api.rst:1650 +#: ../../criteria-api.rst:1656 msgid "We provide the following methods:" msgstr "次の方法を提供します。" -#: ../../criteria-api.rst:1652 +#: ../../criteria-api.rst:1658 msgid "add - (+)" msgstr "" -#: ../../criteria-api.rst:1653 +#: ../../criteria-api.rst:1659 msgid "sub - (-)" msgstr "" -#: ../../criteria-api.rst:1654 +#: ../../criteria-api.rst:1660 msgid "mul - (*)" msgstr "" -#: ../../criteria-api.rst:1655 +#: ../../criteria-api.rst:1661 msgid "div - (/)" msgstr "" -#: ../../criteria-api.rst:1656 +#: ../../criteria-api.rst:1662 msgid "mod - (%)" msgstr "" -#: ../../criteria-api.rst:1658 +#: ../../criteria-api.rst:1664 msgid "You can use the ``add`` method as follows:" msgstr "次のように ``add`` メソッドを使用できます。" -#: ../../criteria-api.rst:1680 +#: ../../criteria-api.rst:1686 msgid "String functions" msgstr "文字列関数" -#: ../../criteria-api.rst:1682 -#: ../../criteria-api.rst:1715 +#: ../../criteria-api.rst:1688 +#: ../../criteria-api.rst:1721 msgid "We provide the following method:" msgstr "以下の方法を提供します。" -#: ../../criteria-api.rst:1684 +#: ../../criteria-api.rst:1690 msgid "concat" msgstr "" -#: ../../criteria-api.rst:1685 +#: ../../criteria-api.rst:1691 msgid "lower" msgstr "" -#: ../../criteria-api.rst:1686 +#: ../../criteria-api.rst:1692 msgid "upper" msgstr "" -#: ../../criteria-api.rst:1687 +#: ../../criteria-api.rst:1693 msgid "trim" msgstr "" -#: ../../criteria-api.rst:1688 +#: ../../criteria-api.rst:1694 msgid "ltrim" msgstr "" -#: ../../criteria-api.rst:1689 +#: ../../criteria-api.rst:1695 msgid "rtrim" msgstr "" -#: ../../criteria-api.rst:1691 +#: ../../criteria-api.rst:1697 msgid "You can use the ``concat`` method as follows:" msgstr "次のように ``concat`` メソッドを使用できます。" -#: ../../criteria-api.rst:1713 +#: ../../criteria-api.rst:1719 msgid "Literal expression" msgstr "リテラル表現" -#: ../../criteria-api.rst:1717 +#: ../../criteria-api.rst:1723 msgid "literal (for all basic data types)" msgstr "" -#: ../../criteria-api.rst:1719 +#: ../../criteria-api.rst:1725 msgid "You can use the ``literal`` method as follows:" msgstr "次のように ``literal`` メソッドを使用できます。" -#: ../../criteria-api.rst:1736 +#: ../../criteria-api.rst:1742 msgid "Note that the literal expressions are not recognized as bind variables." msgstr "リテラル式はバインド変数として認識されないことに注意してください。" -#: ../../criteria-api.rst:1739 +#: ../../criteria-api.rst:1745 msgid "Case expression" msgstr "Case 式" -#: ../../criteria-api.rst:1741 -#: ../../criteria-api.rst:1776 +#: ../../criteria-api.rst:1747 +#: ../../criteria-api.rst:1782 msgid "We support the following method:" msgstr "次の方法をサポートしています。" -#: ../../criteria-api.rst:1743 +#: ../../criteria-api.rst:1749 msgid "when" msgstr "" -#: ../../criteria-api.rst:1745 +#: ../../criteria-api.rst:1751 msgid "You can use the ``when`` method as follows:" msgstr "次のように ``when`` メソッドを使用できます。" -#: ../../criteria-api.rst:1774 +#: ../../criteria-api.rst:1780 msgid "Subquery select expression" msgstr "サブクエリ select 式" -#: ../../criteria-api.rst:1778 +#: ../../criteria-api.rst:1784 msgid "select" msgstr "" -#: ../../criteria-api.rst:1780 +#: ../../criteria-api.rst:1786 msgid "You can use the ``select`` method as follows:" msgstr "次のように ``select`` メソッドを使用できます。" -#: ../../criteria-api.rst:1820 +#: ../../criteria-api.rst:1826 msgid "User-defined expressions" msgstr "ユーザー定義式" -#: ../../criteria-api.rst:1822 +#: ../../criteria-api.rst:1828 msgid "You can define user-defined expressions by calling ``Expressions.userDefined``." msgstr "``Expressions.userDefined`` を呼び出すことで、ユーザー定義の式を定義できます。" -#: ../../criteria-api.rst:1824 +#: ../../criteria-api.rst:1830 msgid "In the example below, the replace function is defined:" msgstr "以下の例では、replace 関数が定義されています。" -#: ../../criteria-api.rst:1840 +#: ../../criteria-api.rst:1846 msgid "You can use the replace function in your query as follows:" msgstr "クエリで replace 関数を使用するには、次のようにします。" -#: ../../criteria-api.rst:1857 +#: ../../criteria-api.rst:1863 msgid "Scopes (Entityql, NativeSql)" msgstr "スコープ (Entityql、NativeSQL)" -#: ../../criteria-api.rst:1859 +#: ../../criteria-api.rst:1865 msgid "Scoping allow you to specify commonly-used query conditions." msgstr "スコープを使用すると、一般的に使用されるクエリ条件を指定できます。" -#: ../../criteria-api.rst:1861 +#: ../../criteria-api.rst:1867 msgid "To define a simple scope, create the class which has a method annotated with ``@Scope``:" msgstr "単純なスコープを定義するには、 ``@Scope`` アノテーションが付けられたメソッドを持つクラスを作成します。" -#: ../../criteria-api.rst:1873 +#: ../../criteria-api.rst:1879 msgid "To enable the scope, specify the above class in the scopes element of ``@Metamodel``:" msgstr "スコープを有効にするには、 ``@Metamodel`` のscopes 要素に上記のクラスを指定します。" -#: ../../criteria-api.rst:1881 +#: ../../criteria-api.rst:1887 msgid "Now the metamodel ``Department_`` has a ``onlyTokyo`` method. You can use it as follows:" msgstr "上述の設定によりメタモデル ``Department_`` には ``onlyTokyo`` メソッドが生成されます。次のように使用できます。" -#: ../../criteria-api.rst:1897 +#: ../../criteria-api.rst:1903 msgid "When you want to combine other query conditions with scopes, compose them using the `andThen` method:" msgstr "他のクエリ条件をスコープと組み合わせたい場合は、 `andThen` メソッドを使用して条件を作成します。" -#: ../../criteria-api.rst:1906 +#: ../../criteria-api.rst:1912 msgid "You can define several scopes in a class as follows:" msgstr "次のように、クラス内に複数のスコープを定義できます。" -#: ../../criteria-api.rst:1928 +#: ../../criteria-api.rst:1934 msgid "Tips" msgstr "ちょっとした便利機能" -#: ../../criteria-api.rst:1931 +#: ../../criteria-api.rst:1937 msgid "Execution in Dao (Entityql, NativeSql)" msgstr "DAOでの実行（Entityql、NativeSql）" -#: ../../criteria-api.rst:1933 +#: ../../criteria-api.rst:1939 msgid "It is useful to execute DSLs in the default method of the Dao interface. To get a ``config`` object, call ``Config.get(this)`` in the default method as follows:" msgstr "DAO インターフェースのデフォルトのメソッドで DSL を実行すると便利です。 ``config`` オブジェクトを取得するには、次のようにデフォルトのメソッドで ``Config.get(this)`` を呼び出します。" -#: ../../criteria-api.rst:1950 +#: ../../criteria-api.rst:1956 msgid "Overwriting the table name (Entityql, NativeSql)" msgstr "テーブル名の上書き（Entityql、NativeSql）" -#: ../../criteria-api.rst:1952 +#: ../../criteria-api.rst:1958 msgid "A metamodel constructor accepts the qualified table name and the metamodel overwrites its table name." msgstr "メタモデル コンストラクターは修飾されたテーブル名を受け入れ、メタモデルはそのテーブル名を上書きします。" -#: ../../criteria-api.rst:1955 +#: ../../criteria-api.rst:1961 msgid "It is useful to handle two tables that have the same data structure:" msgstr "同じデータ構造を持つ 2 つのテーブルを処理すると便利です。" -#: ../../criteria-api.rst:1975 +#: ../../criteria-api.rst:1981 msgid "Debugging (Entityql, NativeSql)" msgstr "デバッグ (Entityql、NativeSql)" -#: ../../criteria-api.rst:1977 +#: ../../criteria-api.rst:1983 msgid "To know the SQL statement built by the DSLs, use the ``asSql`` method:" msgstr "DSL によって構築された SQL ステートメントを知るには、 ``asSql`` メソッドを使用します。" -#: ../../criteria-api.rst:1989 -#: ../../criteria-api.rst:2016 +#: ../../criteria-api.rst:1995 +#: ../../criteria-api.rst:2022 msgid "The above code prints as follows:" msgstr "上記のコードは次のように出力されます。" -#: ../../criteria-api.rst:1996 +#: ../../criteria-api.rst:2002 msgid "The ``asSql`` method doesn't issue the SQL statement to your Database. It only builds the SQL statement and return it as an ``Sql`` object." msgstr "``asSql`` メソッドはデータベースに SQL ステートメントを発行しません。 SQL ステートメントを構築し、それを ``Sql`` オブジェクトとして返すだけです。" -#: ../../criteria-api.rst:1999 +#: ../../criteria-api.rst:2005 msgid "You can also get the ``Sql`` object by calling the ``peek`` method." msgstr "``peek`` メソッドを呼び出して ``Sql`` オブジェクトを取得することもできます。" -#: ../../criteria-api.rst:2026 +#: ../../criteria-api.rst:2032 msgid "Sample projects" msgstr "サンプルプロジェクト" -#: ../../criteria-api.rst:2028 +#: ../../criteria-api.rst:2034 msgid "`simple-examples `_" msgstr "" -#: ../../criteria-api.rst:2029 +#: ../../criteria-api.rst:2035 msgid "`kotlin-sample `_" msgstr "" diff --git a/docs/locale/ja/LC_MESSAGES/index.po b/docs/locale/ja/LC_MESSAGES/index.po index 0927fd8e7..296643fce 100644 --- a/docs/locale/ja/LC_MESSAGES/index.po +++ b/docs/locale/ja/LC_MESSAGES/index.po @@ -2,7 +2,7 @@ msgid "" msgstr "" "Project-Id-Version: doma-docs\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-09-01 09:20+0900\n" +"POT-Creation-Date: 2024-10-29 21:55+0900\n" "Last-Translator: \n" "Language-Team: Japanese\n" "MIME-Version: 1.0\n" @@ -75,43 +75,43 @@ msgstr "日本語にローカライズするには、`Crowdin プロジェクト msgid "User Documentation" msgstr "ユーザー向けドキュメンテーション" -#: ../../index.rst:68 +#: ../../index.rst:69 msgid "About Doma" msgstr "Domaについて" -#: ../../index.rst:76 +#: ../../index.rst:77 msgid "Links" msgstr "リンク集" -#: ../../index.rst:78 +#: ../../index.rst:79 msgid "`News and announcements `_" msgstr "`ニュースやアナウンス `_" -#: ../../index.rst:79 +#: ../../index.rst:80 msgid "`GitHub repository `_" msgstr "`GitHub リポジトリ `_" -#: ../../index.rst:80 +#: ../../index.rst:81 msgid "`Release Notes `_" msgstr "`リリースノート `_" -#: ../../index.rst:81 +#: ../../index.rst:82 msgid "`JavaDoc `_" msgstr "" -#: ../../index.rst:82 +#: ../../index.rst:83 msgid "`Examples `_" msgstr "`サンプルプロジェクト `_" -#: ../../index.rst:83 +#: ../../index.rst:84 msgid "`Doma Compile Plugin `_" msgstr "" -#: ../../index.rst:84 +#: ../../index.rst:85 msgid "`Doma CodeGen Plugin `_" msgstr "" -#: ../../index.rst:85 +#: ../../index.rst:86 msgid "`Doma version 1 `_" msgstr "`Doma v1.x のWebサイト `_" diff --git a/docs/locale/ja/LC_MESSAGES/query-dsl.po b/docs/locale/ja/LC_MESSAGES/query-dsl.po new file mode 100644 index 000000000..8ba91603f --- /dev/null +++ b/docs/locale/ja/LC_MESSAGES/query-dsl.po @@ -0,0 +1,1164 @@ +msgid "" +msgstr "" +"Project-Id-Version: doma-docs\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-11-03 19:28+0900\n" +"Last-Translator: \n" +"Language-Team: Japanese\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=1; plural=0;\n" +"X-Crowdin-Project: doma-docs\n" +"X-Crowdin-Project-ID: 657384\n" +"X-Crowdin-Language: ja\n" +"X-Crowdin-File-ID: 240\n" +"Language: ja_JP\n" + +#: ../../query-dsl.rst:3 +msgid "Unified Criteria API" +msgstr "" + +#: ../../query-dsl.rst:6 +msgid "Contents" +msgstr "" + +#: ../../query-dsl.rst:9 +msgid "Introduction" +msgstr "" + +#: ../../query-dsl.rst:11 +msgid "The Unified Criteria API unifies the :doc:`criteria-api`, Entityql and NativeSql DSLs, providing a clear and intuitive interface." +msgstr "Unified Criteria APIは:doc:`critera-api`であるEntityqlとNativeSqlのDSLを統一し、分かりやすいインタフェースを提供します。" + +#: ../../query-dsl.rst:14 +msgid "The following entity classes are used in the examples below:" +msgstr "次のエンティティクラスは以下の例で使用されます。" + +#: ../../query-dsl.rst:90 +msgid "Note that the above classes are annotated with ``@Entity(metamodel = @Metamodel)``. The ``metamodel = @Metamodel`` indicates that the annotated entity has a corresponding metamodel class generated by Doma's annotation processor." +msgstr "上記のクラスには ``@Entity(metamodel = @Metamodel)`` というアノテーションが付けられていることに注意してください。 ``metamodel = @Metamodel`` は、エンティティクラスに対応するメタモデルクラスをDoma の アノテーションプロセッサー により生成することを示します。" + +#: ../../query-dsl.rst:94 +msgid "In our examples, the metamodel classes are ``Employee_``, ``Department_``, ``Emp_`` and ``Dept_``. These metamodels enable type-safe query creation." +msgstr "この例では、メタモデルクラスは ``Employee_``、``Department_``、``Emp_``、および ``Dept_`` です。これらのメタモデルクラスを使用すると、クエリをタイプセーフに構築できます。" + +#: ../../query-dsl.rst:97 +msgid "You can customize the metamodel names using the elements in the `Metamodel` annotation." +msgstr "`Metamodel`注釈の要素を使用して、メタモデル名をカスタマイズできます。" + +#: ../../query-dsl.rst:99 +msgid "To bulk customize all metamodels, you can use annotation processor options. See :doc:`annotation-processing` and refer to the following options:" +msgstr "すべてのメタモデルを一括でカスタマイズするには、アノテーションプロセッサのオプションを使用できます。 :doc:`annotation-processing` を参照して、次のオプションを確認してください。" + +#: ../../query-dsl.rst:102 +msgid "doma.metamodel.enabled" +msgstr "" + +#: ../../query-dsl.rst:103 +msgid "doma.metamodel.prefix" +msgstr "" + +#: ../../query-dsl.rst:104 +msgid "doma.metamodel.suffix" +msgstr "" + +#: ../../query-dsl.rst:107 +msgid "Query DSL" +msgstr "" + +#: ../../query-dsl.rst:109 +msgid "The Unified Criteria API is, in essence, the Query DSL." +msgstr "Unified Criteria API の実体はQuery DSLです。" + +#: ../../query-dsl.rst:111 +msgid "The Query DSL can perform entity queries and associations. The entry point is the ``org.seasar.doma.jdbc.criteria.QueryDsl`` class. This class includes the following methods:" +msgstr "Query DSL は、エンティティをクエリして関連付けることができます。エントリポイントは ``org.seasar.doma.jdbc.criteria.QueryDsl`` クラスです。このクラスには次のメソッドがあります。" + +#: ../../query-dsl.rst:115 +msgid "from" +msgstr "" + +#: ../../query-dsl.rst:116 +msgid "insert" +msgstr "" + +#: ../../query-dsl.rst:117 +msgid "delete" +msgstr "" + +#: ../../query-dsl.rst:118 +msgid "update" +msgstr "" + +#: ../../query-dsl.rst:120 +msgid "Instantiate the ``QueryDsl`` class as follows:" +msgstr "``QueryDsl`` クラスを以下のようにインスタンス化します。" + +#: ../../query-dsl.rst:126 +msgid "For example, to query ``Employee`` and ``Department`` entities and associate them, use:" +msgstr "例えば、``Employee`` と ``Department`` エンティティを照会し、それらを関連付けるには、次のようにします。" + +#: ../../query-dsl.rst:147 +msgid "The query above generates the following SQL statement:" +msgstr "上記のクエリは、次の SQL ステートメントを生成します。" + +#: ../../query-dsl.rst:159 +msgid "In Kotlin, use ``org.seasar.doma.kotlin.jdbc.criteria.KQueryDsl`` instead of ``QueryDsl``. ``KQueryDsl`` is included in the doma-kotlin module." +msgstr "Kotlin では、``QueryDsl`` の代わりに ``org.seasar.doma.kotlin.jdbc.critera.KQueryDsl`` を使用します。doma-kotlin モジュールに ``KQueryDsl`` が含まれています。" + +#: ../../query-dsl.rst:163 +msgid "Select Statement" +msgstr "Select ステートメント" + +#: ../../query-dsl.rst:166 +msgid "Select Settings" +msgstr "" + +#: ../../query-dsl.rst:168 +msgid "We support the following settings:" +msgstr "次の設定をサポートしています。" + +#: ../../query-dsl.rst:170 +#: ../../query-dsl.rst:1082 +#: ../../query-dsl.rst:1378 +msgid "allowEmptyWhere" +msgstr "" + +#: ../../query-dsl.rst:171 +#: ../../query-dsl.rst:1084 +#: ../../query-dsl.rst:1170 +#: ../../query-dsl.rst:1380 +msgid "comment" +msgstr "" + +#: ../../query-dsl.rst:172 +msgid "fetchSize" +msgstr "" + +#: ../../query-dsl.rst:173 +msgid "maxRows" +msgstr "" + +#: ../../query-dsl.rst:174 +#: ../../query-dsl.rst:1086 +#: ../../query-dsl.rst:1171 +#: ../../query-dsl.rst:1382 +msgid "queryTimeout" +msgstr "" + +#: ../../query-dsl.rst:175 +#: ../../query-dsl.rst:1087 +#: ../../query-dsl.rst:1172 +#: ../../query-dsl.rst:1383 +msgid "sqlLogType" +msgstr "" + +#: ../../query-dsl.rst:177 +#: ../../query-dsl.rst:1090 +#: ../../query-dsl.rst:1179 +#: ../../query-dsl.rst:1389 +msgid "All are optional and can be applied as follows:" +msgstr "すべてオプションで、以下のように適用できます:" + +#: ../../query-dsl.rst:193 +msgid "Fetching" +msgstr "" + +#: ../../query-dsl.rst:195 +msgid "The Query DSL provides the following data-fetching methods:" +msgstr "Query DSLは以下のデータフェッチのメソッドを提供します。" + +#: ../../query-dsl.rst:197 +msgid "fetch" +msgstr "" + +#: ../../query-dsl.rst:198 +msgid "fetchOne" +msgstr "" + +#: ../../query-dsl.rst:199 +msgid "fetchOptional" +msgstr "" + +#: ../../query-dsl.rst:200 +msgid "stream" +msgstr "" + +#: ../../query-dsl.rst:219 +msgid "Streaming" +msgstr "" + +#: ../../query-dsl.rst:221 +msgid "The Query DSL supports the following stream-handling methods:" +msgstr "Query DSLでは、以下のストリーム処理のメソッドをサポートしています。" + +#: ../../query-dsl.rst:223 +msgid "mapStream" +msgstr "" + +#: ../../query-dsl.rst:224 +msgid "collect" +msgstr "" + +#: ../../query-dsl.rst:225 +msgid "openStream" +msgstr "" + +#: ../../query-dsl.rst:246 +msgid "These methods provide efficient processing for large result sets." +msgstr "これらのメソッドは、大きな結果セットに対して効率的な処理を提供します。" + +#: ../../query-dsl.rst:249 +msgid "Select Expression" +msgstr "" + +#: ../../query-dsl.rst:252 +msgid "Entity Selection" +msgstr "" + +#: ../../query-dsl.rst:254 +msgid "By default, the result entity type is the same as the type specified in the ``from`` method:" +msgstr "デフォルトでは、結果エンティティの型は ``from`` メソッドで指定された型と同じです。" + +#: ../../query-dsl.rst:266 +msgid "The above query generates the following SQL statement:" +msgstr "上記のクエリは、次の SQL ステートメントを生成します。" + +#: ../../query-dsl.rst:275 +msgid "To choose a joined entity type as the result entity type, use ``project`` or ``select``:" +msgstr "結果のエンティティタイプとして結合されたエンティティタイプを選択するには、``project`` または ``select`` を使用します:" + +#: ../../query-dsl.rst:288 +msgid "This query generates the following SQL:" +msgstr "このクエリは以下のSQLを生成します。" + +#: ../../query-dsl.rst:298 +msgid "The ``project`` method removes duplicate entities, while ``select`` does not. If you call neither method, duplicates are removed by default." +msgstr "``project`` メソッドは重複したエンティティを削除しますが、``select`` は削除しません。どちらのメソッドも呼び出さない場合、重複はデフォルトで削除されます。" + +#: ../../query-dsl.rst:302 +msgid "Multiple Entity Selection" +msgstr "" + +#: ../../query-dsl.rst:304 +msgid "Specify multiple entity types and fetch them as tuples:" +msgstr "複数のエンティティタイプを指定し、タプルとしてフェッチします:" + +#: ../../query-dsl.rst:318 +#: ../../query-dsl.rst:389 +#: ../../query-dsl.rst:592 +#: ../../query-dsl.rst:645 +#: ../../query-dsl.rst:888 +msgid "This query generates:" +msgstr "このクエリは次のように生成されます。" + +#: ../../query-dsl.rst:328 +msgid "In the tuple, an entity is null if all its properties are null." +msgstr " " + +#: ../../query-dsl.rst:332 +msgid "The ``select`` method does not remove duplicates." +msgstr "``select`` メソッドは重複を削除しません。" + +#: ../../query-dsl.rst:335 +msgid "Column Projection" +msgstr "" + +#: ../../query-dsl.rst:337 +msgid "To project columns, use ``select``. For one column:" +msgstr "カラムを選択するには、``select`` を使用します。1つのカラムの選択は次のようにします:" + +#: ../../query-dsl.rst:345 +#: ../../query-dsl.rst:362 +#: ../../query-dsl.rst:458 +#: ../../query-dsl.rst:539 +#: ../../query-dsl.rst:560 +#: ../../query-dsl.rst:739 +#: ../../query-dsl.rst:913 +#: ../../query-dsl.rst:973 +#: ../../query-dsl.rst:1050 +#: ../../query-dsl.rst:1123 +#: ../../query-dsl.rst:1150 +#: ../../query-dsl.rst:1226 +#: ../../query-dsl.rst:1249 +#: ../../query-dsl.rst:1299 +#: ../../query-dsl.rst:1321 +#: ../../query-dsl.rst:1435 +#: ../../query-dsl.rst:1472 +#: ../../query-dsl.rst:1508 +#: ../../query-dsl.rst:1537 +#: ../../query-dsl.rst:1558 +#: ../../query-dsl.rst:1591 +#: ../../query-dsl.rst:1627 +#: ../../query-dsl.rst:1671 +#: ../../query-dsl.rst:1706 +#: ../../query-dsl.rst:1782 +msgid "This generates:" +msgstr "このクエリは次のように生成されます。" + +#: ../../query-dsl.rst:351 +msgid "For multiple columns:" +msgstr "" + +#: ../../query-dsl.rst:368 +msgid "Columns up to 9 are held in ``Tuple2`` to ``Tuple9``. Beyond that, they are held in ``Row``." +msgstr "9 列までは ``Tuple2`` から ``Tuple9`` で保持されます。それ以外は ``Row`` で保持されます。" + +#: ../../query-dsl.rst:370 +msgid "Use ``selectAsRow`` for a ``Row`` list:" +msgstr "``Row`` リストには ``selectAsRow`` を使用します。" + +#: ../../query-dsl.rst:379 +msgid "Column Projection and Mapping" +msgstr "" + +#: ../../query-dsl.rst:381 +msgid "To project columns and map them to an entity, use the ``projectTo`` or ``selectTo`` methods:" +msgstr "カラムを選択しエンティティにマップするには、``projectTo`` または ``selectTo`` メソッドを使用します。" + +#: ../../query-dsl.rst:395 +msgid "Note that the SQL select clause includes the primary key \"EMPLOYEE_ID\". The ``projectTo`` and ``selectTo`` methods always include the entity's ID properties, even if they aren't explicitly specified." +msgstr "SQL の select 句にはプライマリキー \"EMPLOYEE_ID\" が含まれていることに注意してください。 ``projectTo`` と ``selectTo`` メソッドは、明示的に指定されていない場合でも、エンティティの ID プロパティを常に含めます。" + +#: ../../query-dsl.rst:399 +msgid "The ``projectTo`` method removes duplicate entity IDs from the results, while ``selectTo`` does not." +msgstr "``projectTo`` メソッドは結果から重複したエンティティIDを削除しますが、``selectTo`` メソッドは削除しません。" + +#: ../../query-dsl.rst:404 +msgid "Where Expression" +msgstr "" + +#: ../../query-dsl.rst:406 +msgid "The following operators and predicates are supported:" +msgstr "以下の演算子と述語がサポートされています。" + +#: ../../query-dsl.rst:408 +#: ../../query-dsl.rst:779 +msgid "eq - (=)" +msgstr "" + +#: ../../query-dsl.rst:409 +#: ../../query-dsl.rst:780 +msgid "ne - (<>)" +msgstr "" + +#: ../../query-dsl.rst:410 +#: ../../query-dsl.rst:781 +msgid "ge - (>=)" +msgstr "" + +#: ../../query-dsl.rst:411 +#: ../../query-dsl.rst:782 +msgid "gt - (>)" +msgstr "" + +#: ../../query-dsl.rst:412 +#: ../../query-dsl.rst:783 +msgid "le - (<=)" +msgstr "" + +#: ../../query-dsl.rst:413 +#: ../../query-dsl.rst:784 +msgid "lt - (<)" +msgstr "" + +#: ../../query-dsl.rst:414 +msgid "isNull - (is null)" +msgstr "" + +#: ../../query-dsl.rst:415 +msgid "isNotNull - (is not null)" +msgstr "" + +#: ../../query-dsl.rst:416 +msgid "like" +msgstr "" + +#: ../../query-dsl.rst:417 +msgid "notLike - (not like)" +msgstr "" + +#: ../../query-dsl.rst:418 +msgid "between" +msgstr "" + +#: ../../query-dsl.rst:419 +msgid "in" +msgstr "" + +#: ../../query-dsl.rst:420 +msgid "notIn - (not in)" +msgstr "" + +#: ../../query-dsl.rst:421 +msgid "exists" +msgstr "" + +#: ../../query-dsl.rst:422 +msgid "notExists - (not exists)" +msgstr "" + +#: ../../query-dsl.rst:426 +msgid "If the right-hand operand is ``null``, the WHERE or HAVING clause will exclude the operator. See `WhereDeclaration`_ and `HavingDeclaration`_ javadoc for details." +msgstr "右側のオペランドが ``null`` の場合、WHEREまたはHAVING句は演算子を除外します。詳細は `WhereDeclaration`_ と `HavingDeclaration`_ の javadoc を参照してください。" + +#: ../../query-dsl.rst:431 +msgid "We also support utility operators:" +msgstr "次のユーティリティ演算子もサポートしています。" + +#: ../../query-dsl.rst:433 +msgid "eqOrIsNull - (\"=\" or \"is null\")" +msgstr "" + +#: ../../query-dsl.rst:434 +msgid "neOrIsNotNull - (\"<>\" or \"is not null\")" +msgstr "" + +#: ../../query-dsl.rst:436 +msgid "Additionally, the following logical operators are supported:" +msgstr "さらに、以下の論理演算子がサポートされています。" + +#: ../../query-dsl.rst:438 +#: ../../query-dsl.rst:788 +msgid "and" +msgstr "" + +#: ../../query-dsl.rst:439 +#: ../../query-dsl.rst:789 +msgid "or" +msgstr "" + +#: ../../query-dsl.rst:440 +#: ../../query-dsl.rst:790 +msgid "not" +msgstr "" + +#: ../../query-dsl.rst:467 +msgid "Subqueries can be written as follows:" +msgstr "サブクエリは以下のように記述できます。" + +#: ../../query-dsl.rst:480 +#: ../../query-dsl.rst:805 +msgid "The above query generates:" +msgstr "上記のクエリは以下のものを生成します。" + +#: ../../query-dsl.rst:491 +msgid "Dynamic Where Expression" +msgstr "" + +#: ../../query-dsl.rst:493 +msgid "A WHERE expression uses only evaluated operators to build a WHERE clause. When no operators are evaluated in the expression, the statement omits the WHERE clause." +msgstr "WHERE式はWHERE句を構築するために評価された演算子のみを使用します。 式で演算子が評価されない場合は、WHERE句は省略されます。" + +#: ../../query-dsl.rst:495 +msgid "For example, with a conditional expression:" +msgstr "例えば、条件付き式を指定します。" + +#: ../../query-dsl.rst:511 +msgid "If ``enableNameCondition`` is ``false``, the ``like`` expression is ignored, generating:" +msgstr "``enableNameCondition`` が ``false`` の場合、``like`` 式は無視されます。" + +#: ../../query-dsl.rst:520 +msgid "Join Expression" +msgstr "" + +#: ../../query-dsl.rst:522 +msgid "We support the following join expressions:" +msgstr "以下のjoin式をサポートします。" + +#: ../../query-dsl.rst:524 +msgid "innerJoin - (inner join)" +msgstr "" + +#: ../../query-dsl.rst:525 +msgid "leftJoin - (left outer join)" +msgstr "" + +#: ../../query-dsl.rst:527 +msgid "Example for innerJoin:" +msgstr "innerJoinの例:" + +#: ../../query-dsl.rst:548 +msgid "Example for leftJoin:" +msgstr "leftJoinの例:" + +#: ../../query-dsl.rst:570 +msgid "Association" +msgstr "" + +#: ../../query-dsl.rst:572 +msgid "You can associate entities using the ``associate`` operation in conjunction with a join expression:" +msgstr "joinと一緒に``associate`` を使用し、エンティティを関連付けることができます" + +#: ../../query-dsl.rst:602 +msgid "Associating Multiple Entities:" +msgstr "" + +#: ../../query-dsl.rst:626 +msgid "Associating Immutable Entities" +msgstr "" + +#: ../../query-dsl.rst:628 +msgid "To associate immutable entities, use the ``associateWith`` operation with a join expression:" +msgstr "イミュータブルなエンティティを関連付けるには、joinと一緒に``associateWith`` を使用します。" + +#: ../../query-dsl.rst:660 +msgid "Dynamic Join Expression" +msgstr "" + +#: ../../query-dsl.rst:662 +msgid "A join expression uses only evaluated operators to build a JOIN clause. When no operators are evaluated, the JOIN clause is omitted." +msgstr "join式は、評価された演算子のみを使用してJOIN句を構築します。演算子が評価されない場合は、JOIN句は省略されます。" + +#: ../../query-dsl.rst:664 +msgid "For example, with a conditional join:" +msgstr "例えば、条件付きjoinを使用する場合:" + +#: ../../query-dsl.rst:680 +msgid "If ``join`` is ``false``, the ``on`` expression is ignored, generating:" +msgstr "``join`` が ``false`` の場合、``on`` 式は無視されます。" + +#: ../../query-dsl.rst:689 +msgid "Dynamic Association" +msgstr "" + +#: ../../query-dsl.rst:691 +msgid "With dynamic join expressions, associations can be made optional. Use ``AssociationOption.optional()`` in the ``associate`` method:" +msgstr "動的なjoin式では、関連付けを任意にすることができます。``AssociationOption.optional()`` を ``associate`` メソッドで使用します。" + +#: ../../query-dsl.rst:716 +msgid "Aggregate Functions" +msgstr "" + +#: ../../query-dsl.rst:718 +msgid "The following aggregate functions are supported:" +msgstr "次の集約関数がサポートされています:" + +#: ../../query-dsl.rst:720 +msgid "avg(property)" +msgstr "" + +#: ../../query-dsl.rst:721 +msgid "avgAsDouble(property)" +msgstr "" + +#: ../../query-dsl.rst:722 +msgid "count()" +msgstr "" + +#: ../../query-dsl.rst:723 +msgid "count(property)" +msgstr "" + +#: ../../query-dsl.rst:724 +msgid "countDistinct(property)" +msgstr "" + +#: ../../query-dsl.rst:725 +msgid "max(property)" +msgstr "" + +#: ../../query-dsl.rst:726 +msgid "min(property)" +msgstr "" + +#: ../../query-dsl.rst:727 +msgid "sum(property)" +msgstr "" + +#: ../../query-dsl.rst:729 +msgid "These functions are defined in the ``org.seasar.doma.jdbc.criteria.expression.Expressions`` class and can be used with static imports." +msgstr "これらは ``org.seasar.doma.jdbc.criteria.expression.Expressions`` クラスで定義されており、静的インポートで使用できます。" + +#: ../../query-dsl.rst:731 +msgid "For example, to pass the ``sum`` function to the select method:" +msgstr "たとえば、 ``sum`` 関数を select メソッドに渡すことができます。" + +#: ../../query-dsl.rst:746 +msgid "Group By Expression" +msgstr "" + +#: ../../query-dsl.rst:748 +msgid "Group by expressions allow for grouping results based on specified columns:" +msgstr "Group by式を使うと、指定された列に基づいて結果をグループ化できます:" + +#: ../../query-dsl.rst:760 +msgid "The above code generates:" +msgstr "上記のコードは以下のものを生成します。" + +#: ../../query-dsl.rst:766 +msgid "When a group by expression is not specified, the expression is inferred from the select expression automatically. Thus, the following code issues the same SQL as above:" +msgstr "group by 式を指定しない場合、group by 式は select 式から自動的に推測されます。したがって、次のコードは上記と同じ SQL ステートメントを発行します。" + +#: ../../query-dsl.rst:775 +msgid "Having Expression" +msgstr "" + +#: ../../query-dsl.rst:777 +msgid "The following operators are supported in having expressions:" +msgstr "以下の演算子は、having 式でサポートされています。" + +#: ../../query-dsl.rst:786 +msgid "Logical operators are also supported:" +msgstr "論理演算子もサポートされています。" + +#: ../../query-dsl.rst:816 +msgid "Dynamic Having Expression" +msgstr "" + +#: ../../query-dsl.rst:818 +msgid "A having expression includes only evaluated operators, omitting the HAVING clause if no operators are evaluated." +msgstr "having 式は評価された演算子のみを含み、どの演算子も評価されない場合は HAVING 句を省略します。" + +#: ../../query-dsl.rst:820 +msgid "For instance, a conditional expression in a having clause:" +msgstr "例えば、HAVING句の条件式は以下の通りです。" + +#: ../../query-dsl.rst:839 +msgid "If ``countCondition`` is ``false``, the ``having`` clause is ignored in the SQL statement." +msgstr "``countCondition`` が ``false`` の場合、SQL文では``having`` 句は無視されます。" + +#: ../../query-dsl.rst:842 +msgid "Order By Expression" +msgstr "" + +#: ../../query-dsl.rst:844 +msgid "Supported ordering operations are:" +msgstr "サポートされている順序操作は次のとおりです。" + +#: ../../query-dsl.rst:846 +msgid "asc" +msgstr "" + +#: ../../query-dsl.rst:847 +msgid "desc" +msgstr "" + +#: ../../query-dsl.rst:861 +#: ../../query-dsl.rst:943 +msgid "The query above generates:" +msgstr "上記のクエリは以下のものを生成します。" + +#: ../../query-dsl.rst:871 +msgid "Dynamic Order By Expression" +msgstr "" + +#: ../../query-dsl.rst:873 +msgid "Order by expressions use only evaluated operators to build the ORDER BY clause. When no operators are evaluated, the ORDER BY clause is omitted." +msgstr "order by式は、評価された演算子のみを使用してORDER BY句を構築します。演算子が評価されない場合は、ORDER BY句は省略されます。" + +#: ../../query-dsl.rst:876 +msgid "Distinct Expression" +msgstr "" + +#: ../../query-dsl.rst:878 +msgid "To select distinct rows, use ``distinct()``:" +msgstr "重複のない行を検索するには、 ``distinct()`` を使用します。" + +#: ../../query-dsl.rst:898 +msgid "Limit and Offset Expression" +msgstr "" + +#: ../../query-dsl.rst:900 +msgid "To limit the number of rows and specify an offset:" +msgstr "行数を制限し、オフセットを指定するには、次のようにします。" + +#: ../../query-dsl.rst:924 +msgid "Dynamic Limit and Offset Expression" +msgstr "" + +#: ../../query-dsl.rst:926 +msgid "Limit and offset expressions include only non-null values in the SQL. If either value is null, the corresponding FETCH FIRST or OFFSET clause is omitted." +msgstr "limit および offset 式は SQL 内で null でない値のみを含みます。null の場合、対応する FETCH FIRST または OFFSET 句は省略されます。" + +#: ../../query-dsl.rst:929 +msgid "For Update Expression" +msgstr "" + +#: ../../query-dsl.rst:931 +msgid "The ``forUpdate`` method allows row locking in SQL:" +msgstr "``forUpdate`` メソッドはSQLで行をロックできます。" + +#: ../../query-dsl.rst:954 +msgid "Union Expression" +msgstr "" + +#: ../../query-dsl.rst:956 +msgid "Supported union operations include:" +msgstr "サポートされているUNION操作は次のとおりです。" + +#: ../../query-dsl.rst:958 +msgid "union" +msgstr "" + +#: ../../query-dsl.rst:959 +msgid "unionAll - (union all)" +msgstr "" + +#: ../../query-dsl.rst:981 +msgid "Using order by with an index in union queries:" +msgstr "UNIONクエリでインデックスを指定してorder byを使用するには次のようにします。" + +#: ../../query-dsl.rst:994 +msgid "Derived Table Expression" +msgstr "" + +#: ../../query-dsl.rst:996 +msgid "Subqueries using derived tables are supported. A corresponding entity class for the derived table is required." +msgstr "派生テーブルを使用したサブクエリがサポートされていますが、派生テーブルに対応するエンティティクラスが必要です。" + +#: ../../query-dsl.rst:998 +msgid "Define the entity class for the derived table as follows:" +msgstr "派生テーブルに対応するエンティティ クラスを次のように定義します。" + +#: ../../query-dsl.rst:1031 +msgid "A subquery using a derived table can be written as follows:" +msgstr "派生テーブルを使用したサブクエリは次のように記述できます。" + +#: ../../query-dsl.rst:1073 +msgid "Delete Statement" +msgstr "" + +#: ../../query-dsl.rst:1075 +msgid "The delete statement follows the same rules as the :ref:`query_dsl_where`." +msgstr "DELETEステートメントは、 :ref:`query_dsl_where`と同じルールに従います。" + +#: ../../query-dsl.rst:1078 +msgid "Delete Settings" +msgstr "" + +#: ../../query-dsl.rst:1080 +#: ../../query-dsl.rst:1376 +msgid "The following settings are supported:" +msgstr "次の設定がサポートされています。" + +#: ../../query-dsl.rst:1083 +#: ../../query-dsl.rst:1173 +#: ../../query-dsl.rst:1379 +msgid "batchSize" +msgstr "" + +#: ../../query-dsl.rst:1085 +#: ../../query-dsl.rst:1381 +msgid "ignoreVersion" +msgstr "" + +#: ../../query-dsl.rst:1088 +#: ../../query-dsl.rst:1384 +msgid "suppressOptimisticLockException" +msgstr "" + +#: ../../query-dsl.rst:1110 +msgid "To allow a delete statement with an empty WHERE clause, enable the `allowEmptyWhere` setting." +msgstr "空のWHERE句でDELETEステートメントを許可するには、`allowEmptyWhere`設定を有効にしてください。" + +#: ../../query-dsl.rst:1113 +msgid "Delete Record by Entity" +msgstr "" + +#: ../../query-dsl.rst:1129 +msgid "Batch Delete is also supported:" +msgstr "バッチ削除もサポートされています。" + +#: ../../query-dsl.rst:1137 +msgid "Exceptions thrown by the execute method include:" +msgstr "execute メソッドによって投げられる例外は次のとおりです。" + +#: ../../query-dsl.rst:1139 +msgid "OptimisticLockException: if the entity has a version property and an update count is 0" +msgstr "OptimisticLockException: エンティティにバージョンプロパティがあり、更新件数が 0 の場合" + +#: ../../query-dsl.rst:1142 +msgid "Delete Records by Where Expression" +msgstr "" + +#: ../../query-dsl.rst:1144 +msgid "To delete by a condition:" +msgstr "条件で削除するには次のようにします。" + +#: ../../query-dsl.rst:1156 +msgid "To delete all records, use the ``all`` method:" +msgstr "すべてのレコードを削除するには、``all`` メソッドを使用します。" + +#: ../../query-dsl.rst:1163 +msgid "Insert Statement" +msgstr "" + +#: ../../query-dsl.rst:1166 +msgid "Insert Settings" +msgstr "" + +#: ../../query-dsl.rst:1168 +msgid "Supported insert settings include:" +msgstr "サポートされている追加の設定は次のとおりです:" + +#: ../../query-dsl.rst:1174 +#: ../../query-dsl.rst:1385 +msgid "excludeNull" +msgstr "" + +#: ../../query-dsl.rst:1175 +#: ../../query-dsl.rst:1386 +msgid "include" +msgstr "" + +#: ../../query-dsl.rst:1176 +#: ../../query-dsl.rst:1387 +msgid "exclude" +msgstr "" + +#: ../../query-dsl.rst:1177 +msgid "ignoreGeneratedKeys" +msgstr "" + +#: ../../query-dsl.rst:1201 +msgid "You can specify excluded columns:" +msgstr "除外するカラムを指定できます:" + +#: ../../query-dsl.rst:1212 +msgid "Insert Record with Entity" +msgstr "" + +#: ../../query-dsl.rst:1214 +msgid "Inserting a single entity:" +msgstr "単一のエンティティの追加:" + +#: ../../query-dsl.rst:1233 +msgid "Batch Insert is also supported:" +msgstr "バッチ追加もサポートされています。" + +#: ../../query-dsl.rst:1243 +msgid "Multi-row Insert is also supported:" +msgstr "複数行追加もサポートされています。" + +#: ../../query-dsl.rst:1256 +msgid "Upsert is supported as well, with options to handle duplicate keys:" +msgstr "Upsert もサポートされており、重複キーを処理するオプションがあります。" + +#: ../../query-dsl.rst:1258 +msgid "To update on duplicate key:" +msgstr "重複キーがあった場合に更新するには:" + +#: ../../query-dsl.rst:1268 +msgid "To ignore duplicates:" +msgstr "重複を無視するには:" + +#: ../../query-dsl.rst:1278 +msgid "Exceptions include:" +msgstr "例外は次のとおりです：" + +#: ../../query-dsl.rst:1280 +#: ../../query-dsl.rst:1308 +msgid "UniqueConstraintException: if a unique constraint is violated." +msgstr "UniqueConstraintException: 一意制約に違反した場合." + +#: ../../query-dsl.rst:1283 +msgid "Insert Record with Specified Values" +msgstr "" + +#: ../../query-dsl.rst:1285 +msgid "Inserting records by specifying values:" +msgstr "値を指定してレコードを追加する:" + +#: ../../query-dsl.rst:1306 +msgid "Unique constraints may throw:" +msgstr "ユニーク制約違反があると次の例外がスローされます" + +#: ../../query-dsl.rst:1310 +msgid "We also support the INSERT SELECT syntax:" +msgstr "INSERT SELECT 構文もサポートしています。" + +#: ../../query-dsl.rst:1329 +msgid "For upserts, specify keys and update values on duplicates:" +msgstr "UPSERTの場合は、キーと重複時に更新する値を指定します。" + +#: ../../query-dsl.rst:1351 +msgid "To ignore duplicates and specify keys:" +msgstr "重複を無視する際のキーを指定するには次のようにします。" + +#: ../../query-dsl.rst:1369 +msgid "Update Statement" +msgstr "" + +#: ../../query-dsl.rst:1371 +msgid "The update statement follows the same specifications as the :ref:`query_dsl_where`." +msgstr "UPDATEステートメントは、 :ref:`query_dsl_where`と同じルールに従います。" + +#: ../../query-dsl.rst:1374 +msgid "Update Settings" +msgstr "" + +#: ../../query-dsl.rst:1408 +msgid "You can also specify excluded columns:" +msgstr "除外するカラムを指定することもできます。" + +#: ../../query-dsl.rst:1420 +msgid "To perform an update without a WHERE clause, enable the `allowEmptyWhere` setting." +msgstr "WHERE句なしで更新を実行するには、`allowEmptyWhere`の設定を有効にしてください。" + +#: ../../query-dsl.rst:1423 +msgid "Update Record by Entity" +msgstr "" + +#: ../../query-dsl.rst:1425 +msgid "Updating a single entity:" +msgstr "単一のエンティティを更新するには次のようにします。" + +#: ../../query-dsl.rst:1442 +msgid "Batch Update is also supported:" +msgstr "バッチ更新もサポートされています。" + +#: ../../query-dsl.rst:1452 +msgid "Exceptions from the execute method may include:" +msgstr "execute メソッドによって投げられる例外は次のとおりです。" + +#: ../../query-dsl.rst:1454 +msgid "OptimisticLockException: if the entity has a version property and the update count is 0" +msgstr "OptimisticLockException: エンティティにバージョンプロパティがあり、更新件数が 0 の場合" + +#: ../../query-dsl.rst:1455 +#: ../../query-dsl.rst:1481 +msgid "UniqueConstraintException: if a unique constraint is violated" +msgstr "UniqueConstraintException: 一意制約に違反した場合" + +#: ../../query-dsl.rst:1458 +msgid "Update Records by Where Expression" +msgstr "" + +#: ../../query-dsl.rst:1460 +msgid "To update records based on a condition:" +msgstr "条件に基づいてレコードを更新するには次のようにします。" + +#: ../../query-dsl.rst:1479 +msgid "Exceptions may include:" +msgstr "例外には以下のものがあります。" + +#: ../../query-dsl.rst:1484 +msgid "Property Expressions" +msgstr "" + +#: ../../query-dsl.rst:1486 +msgid "All property expression methods are in the ``org.seasar.doma.jdbc.criteria.expression.Expressions`` class and can be used with static imports." +msgstr "すべてのプロパティ式メソッドは ``org.seasar.doma.jdbc.criteria.expressions. Expressions `` クラスにあり、静的なインポートで使用できます。" + +#: ../../query-dsl.rst:1489 +msgid "Arithmetic Expressions" +msgstr "" + +#: ../../query-dsl.rst:1491 +msgid "The following methods are available for arithmetic expressions:" +msgstr "算術式には以下のメソッドがあります。" + +#: ../../query-dsl.rst:1493 +msgid "add - (+)" +msgstr "" + +#: ../../query-dsl.rst:1494 +msgid "sub - (-)" +msgstr "" + +#: ../../query-dsl.rst:1495 +msgid "mul - (*)" +msgstr "" + +#: ../../query-dsl.rst:1496 +msgid "div - (/)" +msgstr "" + +#: ../../query-dsl.rst:1497 +msgid "mod - (%)" +msgstr "" + +#: ../../query-dsl.rst:1499 +msgid "Example of using the ``add`` method:" +msgstr "``add`` メソッドを使用する例です。" + +#: ../../query-dsl.rst:1517 +msgid "String Functions" +msgstr "" + +#: ../../query-dsl.rst:1519 +msgid "The following string functions are provided:" +msgstr "次の文字列関数が提供されます。" + +#: ../../query-dsl.rst:1521 +msgid "concat" +msgstr "" + +#: ../../query-dsl.rst:1522 +msgid "lower" +msgstr "" + +#: ../../query-dsl.rst:1523 +msgid "upper" +msgstr "" + +#: ../../query-dsl.rst:1524 +msgid "trim" +msgstr "" + +#: ../../query-dsl.rst:1525 +msgid "ltrim" +msgstr "" + +#: ../../query-dsl.rst:1526 +msgid "rtrim" +msgstr "" + +#: ../../query-dsl.rst:1528 +msgid "Example using ``concat``:" +msgstr "``concat`` を使用した例です。" + +#: ../../query-dsl.rst:1546 +msgid "Literal Expression" +msgstr "" + +#: ../../query-dsl.rst:1548 +msgid "The ``literal`` method supports all basic data types." +msgstr "``literal`` メソッドはすべての基本データ型をサポートしています。" + +#: ../../query-dsl.rst:1550 +msgid "Example of using ``literal``:" +msgstr "``literal`` を使用する例です。" + +#: ../../query-dsl.rst:1569 +msgid "Literal expressions are not recognized as bind variables." +msgstr "literal式はバインド変数として認識されません。" + +#: ../../query-dsl.rst:1572 +msgid "Case Expression" +msgstr "" + +#: ../../query-dsl.rst:1574 +msgid "The following method is supported for case expressions:" +msgstr "以下のメソッドがcase式でサポートされています。" + +#: ../../query-dsl.rst:1576 +msgid "when" +msgstr "" + +#: ../../query-dsl.rst:1578 +msgid "Example of using ``when``:" +msgstr "``when`` を使用する例は次のとおりです。" + +#: ../../query-dsl.rst:1602 +msgid "Subquery Select Expression" +msgstr "" + +#: ../../query-dsl.rst:1604 +msgid "The ``select`` method supports subquery select expressions." +msgstr "``select`` メソッドはサブクエリのselect式をサポートします。" + +#: ../../query-dsl.rst:1606 +msgid "Example usage:" +msgstr "使用例です。" + +#: ../../query-dsl.rst:1642 +msgid "User-Defined Expressions" +msgstr "" + +#: ../../query-dsl.rst:1644 +msgid "You can define user-defined expressions using ``Expressions.userDefined``." +msgstr "``Expressions.userDefined`` を利用することで、ユーザー定義の式を定義できます。" + +#: ../../query-dsl.rst:1646 +msgid "Example of defining a custom ``replace`` function:" +msgstr "カスタムの ``replace`` 関数を定義する例です。" + +#: ../../query-dsl.rst:1662 +msgid "Using the custom ``replace`` function in a query:" +msgstr "クエリでカスタムの ``replace`` 関数を使用します。" + +#: ../../query-dsl.rst:1678 +msgid "Scopes" +msgstr "" + +#: ../../query-dsl.rst:1680 +msgid "Scopes allow you to specify commonly-used query conditions." +msgstr "スコープを使用すると、よく使用されるクエリ条件を指定できます。" + +#: ../../query-dsl.rst:1682 +msgid "To define a scope, create a class with a method annotated with ``@Scope``:" +msgstr "スコープを定義するには、``@Scope``で注釈されたメソッドを持つクラスを作成します。" + +#: ../../query-dsl.rst:1693 +msgid "To enable the scope, specify the scope class in the ``scopes`` element of ``@Metamodel``:" +msgstr "スコープを有効にするには、``@Metamodel`` の ``scopes`` 要素にスコープクラスを指定します。" + +#: ../../query-dsl.rst:1700 +msgid "Now ``Department_`` includes the ``onlyTokyo`` method, which can be used as follows:" +msgstr "``Department_`` には ``onlyTokyo`` メソッドが含まれています。このメソッドは以下のように使用できます。" + +#: ../../query-dsl.rst:1713 +msgid "To combine other query conditions with scopes, use the ``andThen`` method:" +msgstr "" + +#: ../../query-dsl.rst:1722 +msgid "Defining multiple scopes within a class:" +msgstr "クラス内で複数のスコープを定義する:" + +#: ../../query-dsl.rst:1744 +msgid "Tips" +msgstr "" + +#: ../../query-dsl.rst:1747 +msgid "Execution in DAO" +msgstr "" + +#: ../../query-dsl.rst:1749 +msgid "It can be useful to execute DSLs within a default method of the DAO interface. To obtain a ``config`` object, call ``Config.get(this)`` within the default method:" +msgstr "DAOインタフェースのデフォルトメソッド内でDSLを実行すると便利です。 ``config`` オブジェクトを取得するには、デフォルトメソッド内で ``Config.get(this)`` を呼び出します。" + +#: ../../query-dsl.rst:1766 +msgid "Overwriting the Table Name" +msgstr "" + +#: ../../query-dsl.rst:1768 +msgid "A metamodel constructor can accept a qualified table name, which allows the metamodel to overwrite its default table name." +msgstr "メタモデルのコンストラクタは修飾されたテーブル名を受け付けることができます。これにより、デフォルトのテーブル名を上書きできます。" + +#: ../../query-dsl.rst:1770 +msgid "This feature is useful for working with two tables that share the same structure:" +msgstr "この機能は、同じ構造を共有する2つのテーブルを扱う場合に便利です。" + +#: ../../query-dsl.rst:1791 +msgid "Debugging" +msgstr "" + +#: ../../query-dsl.rst:1793 +msgid "To inspect the SQL statement generated by DSLs, use the ``asSql`` method:" +msgstr "DSL によって生成された SQL ステートメントを調べるには、``asSql`` メソッドを使用します。" + +#: ../../query-dsl.rst:1805 +msgid "The code above outputs the following:" +msgstr "上記のコードは以下を出力します:" + +#: ../../query-dsl.rst:1812 +msgid "The ``asSql`` method does not execute the SQL statement against the database; it only builds the SQL statement and returns it as an ``Sql`` object." +msgstr "``asSql`` メソッドはSQLステートメントをデータベースに対して実行しません。SQLステートメントのみを構築し、``Sql`` オブジェクトとして返します。" + +#: ../../query-dsl.rst:1814 +msgid "You can also obtain the ``Sql`` object by using the ``peek`` method:" +msgstr "``peek`` メソッドを使用して ``Sql`` オブジェクトを取得することもできます。" + +#: ../../query-dsl.rst:1829 +msgid "The code above outputs SQL statements at various stages of the query:" +msgstr "上記のコードは、クエリの様々な段階で SQL ステートメントを出力します。" + +#: ../../query-dsl.rst:1839 +msgid "Sample Projects" +msgstr "" + +#: ../../query-dsl.rst:1841 +msgid "You can refer to the following sample projects for additional guidance:" +msgstr "追加のガイダンスについては、以下のサンプルプロジェクトを参照してください。" + +#: ../../query-dsl.rst:1843 +msgid "`simple-examples `_" +msgstr "" + +#: ../../query-dsl.rst:1844 +msgid "`kotlin-sample `_" +msgstr "" + diff --git a/docs/query-dsl.rst b/docs/query-dsl.rst index ff189fd74..d74c9fbf8 100644 --- a/docs/query-dsl.rst +++ b/docs/query-dsl.rst @@ -1,6 +1,6 @@ -========= -Query DSL -========= +==================== +Unified Criteria API +==================== .. contents:: :depth: 4 @@ -8,6 +8,9 @@ Query DSL Introduction ============ +The Unified Criteria API unifies the :doc:`criteria-api`, Entityql and NativeSql DSLs, +providing a clear and intuitive interface. + The following entity classes are used in the examples below: .. code-block:: java @@ -103,6 +106,8 @@ See :doc:`annotation-processing` and refer to the following options: Query DSL --------- +The Unified Criteria API is, in essence, the Query DSL. + The Query DSL can perform entity queries and associations. The entry point is the ``org.seasar.doma.jdbc.criteria.QueryDsl`` class. This class includes the following methods: