[Groonga-commit] groonga/groonga at 097ab85 [master] doc: document KEY_LARGE

Back to archive index

Kouhei Sutou null+****@clear*****
Fri Mar 11 17:37:54 JST 2016


Kouhei Sutou	2016-03-11 17:37:54 +0900 (Fri, 11 Mar 2016)

  New Revision: 097ab85341bd28a9fa23152ab49ab8ed581b3b7d
  https://github.com/groonga/groonga/commit/097ab85341bd28a9fa23152ab49ab8ed581b3b7d

  Message:
    doc: document KEY_LARGE

  Added files:
    doc/source/example/reference/commands/table_create/large_data_store_table.log
  Modified files:
    doc/source/reference/commands/table_create.rst

  Added: doc/source/example/reference/commands/table_create/large_data_store_table.log (+4 -0) 100644
===================================================================
--- /dev/null
+++ doc/source/example/reference/commands/table_create/large_data_store_table.log    2016-03-11 17:37:54 +0900 (1fd6b48)
@@ -0,0 +1,4 @@
+Execution example::
+
+  table_create Paths TABLE_HASH_KEY|KEY_LARGE ShortText
+  # [[0, 1337566253.89858, 0.000355720520019531], true]

  Modified: doc/source/reference/commands/table_create.rst (+25 -0)
===================================================================
--- doc/source/reference/commands/table_create.rst    2016-03-11 16:38:18 +0900 (e2b6cf5)
+++ doc/source/reference/commands/table_create.rst    2016-03-11 17:37:54 +0900 (bef513f)
@@ -60,6 +60,28 @@ If your records are searched by key or referenced by one or more
 columns, ``TABLE_NO_KEY`` type isn't suitable. Lexicon for fulltext
 search is the case.
 
+Create large data store table
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If you want to store many large keys, your table can't store them. If
+total key data is larger than 4GiB, you can't store all key data into
+your table by default.
+
+You can expand the maximum total key size to 1TiB from 4GiB by
+``KEY_LARGE`` flag. ``KEY_LARGE`` flag can be used with only
+``TABLE_HASH_KEY``. You can't use ``KEY_LARGE`` flag with
+``TABLE_NO_KEY``, ``TABLE_PAT_KEY`` nor ``TABLE_DAT_KEY``.
+
+Here is an example to create a table that can store many large keys:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/table_create/large_data_store_table.log
+.. table_create Paths TABLE_HASH_KEY|KEY_LARGE ShortText
+
+The ``table_create`` command creates a table that is named ``Paths``
+and is ``TABLE_HASH_KEY`` type. The ``Paths`` table can store many
+large keys.
+
 Create lexicon table
 ^^^^^^^^^^^^^^^^^^^^
 
@@ -203,6 +225,9 @@ Here are available flags:
      - Double array trie. See also :ref:`table-dat-key`.
    * - ``KEY_WITH_SIS``
      - Enable Semi Infinite String. Require ``TABLE_PAT_KEY``.
+   * - ``KEY_LARGE``
+     - Expand the maximum total key size to 1TiB from 4GiB. Require
+       ``TABLE_HASH_KEY``.
 
 .. note::
    Since Groonga 2.1.0 ``KEY_NORMALIZE`` flag is deprecated. Use
-------------- next part --------------
HTML����������������������������...
下载 



More information about the Groonga-commit mailing list
Back to archive index