Kouhei Sutou
null+****@clear*****
Wed Aug 24 14:53:58 JST 2016
Kouhei Sutou 2016-08-24 14:53:58 +0900 (Wed, 24 Aug 2016) New Revision: 1b8591aa9a19f42021614143affe86a4851c9bbb https://github.com/groonga/groonga/commit/1b8591aa9a19f42021614143affe86a4851c9bbb Message: doc: update table limitations Modified files: doc/locale/ja/LC_MESSAGES/limitations.po doc/locale/ja/LC_MESSAGES/reference.po doc/source/limitations.rst doc/source/reference/tables.rst Modified: doc/locale/ja/LC_MESSAGES/limitations.po (+43 -8) =================================================================== --- doc/locale/ja/LC_MESSAGES/limitations.po 2016-08-24 14:40:30 +0900 (5f4ee83) +++ doc/locale/ja/LC_MESSAGES/limitations.po 2016-08-24 14:53:58 +0900 (e140a89) @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: 1.2.1\n" "Report-Msgid-Bugs-To: \n" -"PO-Revision-Date: 2016-03-11 18:10+0900\n" +"PO-Revision-Date: 2016-08-24 14:57+0900\n" "Last-Translator: Kouhei Sutou <kou �� clear-code.com>\n" "Language-Team: Japanese\n" "Language: ja\n" @@ -30,21 +30,56 @@ msgid "A table has the following limitations." msgstr "テーブルには以下の制限があります。" msgid "The maximum one key size: 4KiB" -msgstr "1つのキーの最大サイズ: 4KiB" +msgstr "1つのキーの最大サイズ：4KiB" + +msgid "The maximum total size of keys:" +msgstr "カラムに格納した値の合計サイズの上限値：" + +msgid "4GiB by default." +msgstr "デフォルトは4GiB。" msgid "" -"The maximum total size of keys: 4GiB or 1TiB (by specifying ``KEY_LARGE`` " -"flag to :ref:`table-create-flags`)" +"1TiB by specifying ``KEY_LARGE`` flag to :ref:`table-create-flags`. " +"``KEY_LARGE`` can be used only with :ref:`table-hash-key`." msgstr "" -"最大総キーサイズ: 4GiBまたは1TiB（ :ref:`table-create-flags` に " -"``KEY_LARGE`` フラグを指定した場合）" +":ref:`table-create-flags` に ``KEY_LARGE`` フラグを指定すると1TiB。ただし、 " +"``KEY_LARGE`` は :ref:`table-hash-key` でしか使えない。" -msgid "The maximum number of records: 268,435,455 (more than 268 million)" -msgstr "最大レコード数: 268,435,455 (約2億6千万)" +msgid "The maximum number of records:" +msgstr "最大レコード数：" + +msgid ":ref:`table-no-key`: 1,073,741,815 (2 :sup:`30` - 9)" +msgstr "" + +msgid ":ref:`table-hash-key`: 536,870,912 (2 :sup:`29`)" +msgstr "" + +msgid ":ref:`table-pat-key`: 1,073,741,823 (2 :sup:`30` - 1)" +msgstr "" + +msgid ":ref:`table-dat-key`: 268,435,455 (2 :sup:`28` - 1)" +msgstr "" msgid "Keep in mind that these limitations may vary depending on conditions." msgstr "実際には他の諸条件の制約により上記の値まで到達しない場合もあります。" +msgid "" +"For example, you need to use small size type for key to store many records. " +"Because the maximum total size of keys limitation is exceeded before the " +"maximum number of records limitation is exceeded. If you use ``UInt64`` " +"(8byte) type and store 2 :sup:`29` records, total key size is 4GiB (= 8 * " +"(2 :sup:`29`)). You can't add more records. You need to choose decreasing " +"key size (e.g. ``UInt32``) or using ``KEY_LARGE`` and :ref:`table-hash-key` " +"to store more records." +msgstr "" +"たとえば、大量のレコードを保存する場合はキーの型は小さいサイズの型を使う必要" +"があります。なぜなら、最大レコード数の上限に達する前に最大総キーサイズの上限" +"に達するからです。もし、 ``UInt64`` （8バイト）型を使って 2 :sup:`29` レコー" +"ド保存すると、総キーサイズは4GiB（= 8 * (2 :sup:`29`)）になります。この状態で" +"はこれ以上レコードを追加できません。さらにレコードを保存したい場合は、キーの" +"サイズを小さくする（たとえば ``UInt32`` にする）か、 ``KEY_LARGE`` と :ref:" +"`table-hash-key` を使うか、どちらかを選びます。" + msgid "Limitations of indexing" msgstr "インデックス上限値" Modified: doc/locale/ja/LC_MESSAGES/reference.po (+34 -1) =================================================================== --- doc/locale/ja/LC_MESSAGES/reference.po 2016-08-24 14:40:30 +0900 (7246f64) +++ doc/locale/ja/LC_MESSAGES/reference.po 2016-08-24 14:53:58 +0900 (8314d8e) @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: 1.2.1\n" "Report-Msgid-Bugs-To: \n" -"PO-Revision-Date: 2016-08-24 14:40+0900\n" +"PO-Revision-Date: 2016-08-24 14:48+0900\n" "Last-Translator: Masafumi Yokoyama <yokoyama �� clear-code.com>\n" "Language-Team: Japanese\n" "Language: ja\n" @@ -22378,6 +22378,39 @@ msgstr "前方一致検索" msgid "Range search" msgstr "範囲検索" +msgid "The maximum one key size" +msgstr "1つのキーの最大サイズ" + +msgid "4KiB" +msgstr "" + +msgid "The maximum total size of keys" +msgstr "最大総キーサイズ" + +msgid "" +"4GiB or 1TiB (by specifying ``KEY_LARGE`` flag to :ref:`table-create-flags`)" +msgstr "" +"4GiBまたは1TiB（ :ref:`table-create-flags` に ``KEY_LARGE`` フラグを指定した" +"場合）" + +msgid "4GiB" +msgstr "" + +msgid "The maximum number of records" +msgstr "最大レコード数" + +msgid "1,073,741,815 (2 :sup:`30` - 9)" +msgstr "" + +msgid "536,870,912 (2 :sup:`29`)" +msgstr "" + +msgid "1,073,741,823 (2 :sup:`30` - 1)" +msgstr "" + +msgid "268,435,455 (2 :sup:`28` - 1)" +msgstr "" + msgid "" "``TABLE_NO_KEY`` is very fast and very small but it doesn't support key. " "``TABLE_NO_KEY`` is a only table that doesn't support key." Modified: doc/source/limitations.rst (+24 -5) =================================================================== --- doc/source/limitations.rst 2016-08-24 14:40:30 +0900 (bcf998b) +++ doc/source/limitations.rst 2016-08-24 14:53:58 +0900 (0c5553c) @@ -1,5 +1,4 @@ .. -*- rst -*- -.. Groonga Project .. highlightlang:: none @@ -14,11 +13,31 @@ Limitations of table A table has the following limitations. * The maximum one key size: 4KiB -* The maximum total size of keys: 4GiB or 1TiB (by specifying - ``KEY_LARGE`` flag to :ref:`table-create-flags`) -* The maximum number of records: 268,435,455 (more than 268 million) +* The maximum total size of keys: -Keep in mind that these limitations may vary depending on conditions. + * 4GiB by default. + + * 1TiB by specifying ``KEY_LARGE`` flag to + :ref:`table-create-flags`. ``KEY_LARGE`` can be used only with + :ref:`table-hash-key`. + +* The maximum number of records: + + * :ref:`table-no-key`: 1,073,741,815 (2 :sup:`30` - 9) + * :ref:`table-hash-key`: 536,870,912 (2 :sup:`29`) + * :ref:`table-pat-key`: 1,073,741,823 (2 :sup:`30` - 1) + * :ref:`table-dat-key`: 268,435,455 (2 :sup:`28` - 1) + +Keep in mind that these limitations may vary depending on +conditions. + +For example, you need to use small size type for key to store many +records. Because the maximum total size of keys limitation is exceeded +before the maximum number of records limitation is exceeded. If you +use ``UInt64`` (8byte) type and store 2 :sup:`29` records, total key +size is 4GiB (= 8 * (2 :sup:`29`)). You can't add more records. You +need to choose decreasing key size (e.g. ``UInt32``) or using +``KEY_LARGE`` and :ref:`table-hash-key` to store more records. Limitations of indexing ----------------------- Modified: doc/source/reference/tables.rst (+16 -0) =================================================================== --- doc/source/reference/tables.rst 2016-08-24 14:40:30 +0900 (0dedf9e) +++ doc/source/reference/tables.rst 2016-08-24 14:53:58 +0900 (a9e6d97) @@ -95,6 +95,22 @@ prefix is omitted in the table.) - x - o - o + * - The maximum one key size + - \- + - 4KiB + - 4KiB + - 4KiB + * - The maximum total size of keys + - \- + - 4GiB or 1TiB (by specifying ``KEY_LARGE`` flag to + :ref:`table-create-flags`) + - 4GiB + - 4GiB + * - The maximum number of records + - 1,073,741,815 (2 :sup:`30` - 9) + - 536,870,912 (2 :sup:`29`) + - 1,073,741,823 (2 :sup:`30` - 1) + - 268,435,455 (2 :sup:`28` - 1) .. _table-no-key: -------------- next part -------------- HTML����������������������������...下载
