Kouhei Sutou
null+****@clear*****
Fri Jun 16 15:40:30 JST 2017
Kouhei Sutou 2017-06-16 15:40:30 +0900 (Fri, 16 Jun 2017) New Revision: 6348ddf2fa81eb667c4b2344a0ddec7f2f3a3585 https://github.com/groonga/groonga/commit/6348ddf2fa81eb667c4b2344a0ddec7f2f3a3585 Message: doc io_flush: add only_opened option Added files: doc/source/example/reference/commands/io_flush/only_opened_yes.log Modified files: doc/files.am doc/locale/ja/LC_MESSAGES/reference.po doc/source/reference/commands/io_flush.rst Modified: doc/files.am (+2 -0) =================================================================== --- doc/files.am 2017-06-16 15:00:05 +0900 (1a89004) +++ doc/files.am 2017-06-16 15:40:30 +0900 (2b94110) @@ -93,6 +93,7 @@ absolute_source_files = \ $(top_srcdir)/doc/source/example/reference/commands/delete/cascade.log \ $(top_srcdir)/doc/source/example/reference/commands/delete/status.log \ $(top_srcdir)/doc/source/example/reference/commands/io_flush/all.log \ + $(top_srcdir)/doc/source/example/reference/commands/io_flush/only_opened_yes.log \ $(top_srcdir)/doc/source/example/reference/commands/io_flush/recursive_default.log \ $(top_srcdir)/doc/source/example/reference/commands/io_flush/recursive_invalid.log \ $(top_srcdir)/doc/source/example/reference/commands/io_flush/recursive_no.log \ @@ -1014,6 +1015,7 @@ source_files_relative_from_doc_dir = \ source/example/reference/commands/delete/cascade.log \ source/example/reference/commands/delete/status.log \ source/example/reference/commands/io_flush/all.log \ + source/example/reference/commands/io_flush/only_opened_yes.log \ source/example/reference/commands/io_flush/recursive_default.log \ source/example/reference/commands/io_flush/recursive_invalid.log \ source/example/reference/commands/io_flush/recursive_no.log \ Modified: doc/locale/ja/LC_MESSAGES/reference.po (+53 -4) =================================================================== --- doc/locale/ja/LC_MESSAGES/reference.po 2017-06-16 15:00:05 +0900 (e06fcf8) +++ doc/locale/ja/LC_MESSAGES/reference.po 2017-06-16 15:40:30 +0900 (3e42ebf) @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: 1.2.1\n" "Report-Msgid-Bugs-To: \n" -"PO-Revision-Date: 2017-06-07 18:39+0900\n" +"PO-Revision-Date: 2017-06-16 15:38+0900\n" "Last-Translator: Masafumi Yokoyama <yokoyama �� clear-code.com>\n" "Language-Team: Japanese\n" "Language: ja\n" @@ -6380,12 +6380,12 @@ msgstr "" "リー上に多くの変更があるなら、それらをディスクに書き出す処理は重い処理になり" "ます。" -msgid "This command takes two parameters." -msgstr "このコマンドには2つの引数があります。" - msgid "All parameters are optional::" msgstr "すべての引数は省略可能です::" +msgid ":ref:`io-flush-only-opened` is added." +msgstr ":ref:`io-flush-only-opened` が追加されました。" + msgid "You can flush all changes in memory to disk with no arguments:" msgstr "" "引数無しで実行するとメモリー上のすべての変更をディスクに書き出すことができま" @@ -6508,6 +6508,13 @@ msgid "Child objects of column is nothing." msgstr "カラムの子オブジェクトはありません。" msgid "" +"If you specify ``yes`` to :ref:`io-flush-only-opened`, ``recursive`` is " +"ignored." +msgstr "" +":ref:`io-flush-only-opened` に ``yes`` を指定すると ``recursive`` は無視され" +"ます。" + +msgid "" "``recursive`` value must be ``yes`` or ``no``. ``yes`` means that all of the " "specified flush target object and child objects are flush target objects. " "``no`` means that only the specified flush target object is flush target " @@ -6548,6 +6555,45 @@ msgstr "" "``recursive`` パラメーターが指定されていないので、次のケースでは ``yes`` が使" "われます。" +msgid "``only_opened``" +msgstr "" + +msgid "Specifies whether opened objects are only flushed." +msgstr "すでに開かれているオブジェクトだけフラッシュするかどうかを指定します。" + +msgid "" +"If there is only one process that changes the target database, flush " +"performance will be improved by specifying ``yes`` to ``only_opened``. It " +"skips needless flushes." +msgstr "" +"対象のデータベースを変更するプロセスが1つだけの場合、 ``only_opened`` に " +"``yes`` を指定することでフラッシュの性能が改善する可能性があります。これは、" +"不要なフラッシュを省略するからです。" + +msgid "" +"You can't specify :ref:`io-flush-target-name` with ``only_opened`` option. " +"If you specify :ref:`io-flush-target-name`, ``only_opened`` is ignored." +msgstr "" +":ref:`io-flush-target-name` と ``only_opened`` オプションを一緒に指定すること" +"はできません。もし、 :ref:`io-flush-target-name` を指定した場合は " +"``only_opened`` は無視されます。" + +msgid "" +"If you specify ``yes`` to ``only_opened``, :ref:`io-flush-recursive` is " +"ignored." +msgstr "" +"``only_opened`` に ``yes`` を指定した場合、 :ref:`io-flush-recursive` は無視" +"されます。" + +msgid "" +"``only_opened`` value must be ``yes`` or ``no``. ``yes`` means that opened " +"objects are only flushed. ``no`` means that all target objects are flushed " +"even they aren't opened." +msgstr "" +"``only_opened`` の値は ``yes`` または ``no`` でなければいけません。 ``yes`` " +"の場合はすでに開かれているオブジェクトだけフラッシュします。 ``no`` の場合は" +"開いているかどうかに関わらず、対象のオブジェクトをフラッシュします。" + msgid "``load``" msgstr "" @@ -14782,6 +14828,9 @@ msgstr "" msgid "TOOD: Write me" msgstr "" +msgid "This command takes two parameters." +msgstr "このコマンドには2つの引数があります。" + msgid "Specifies the table name of source table." msgstr "ソーステーブル名を指定します。" Added: doc/source/example/reference/commands/io_flush/only_opened_yes.log (+4 -0) 100644 =================================================================== --- /dev/null +++ doc/source/example/reference/commands/io_flush/only_opened_yes.log 2017-06-16 15:40:30 +0900 (a68d0de) @@ -0,0 +1,4 @@ +Execution example:: + + io_flush --only_opened yes + # [[0, 1337566253.89858, 0.000355720520019531], true] Modified: doc/source/reference/commands/io_flush.rst (+40 -1) =================================================================== --- doc/source/reference/commands/io_flush.rst 2017-06-16 15:00:05 +0900 (30380e7) +++ doc/source/reference/commands/io_flush.rst 2017-06-16 15:40:30 +0900 (78d68a7) @@ -48,12 +48,17 @@ changes in memory, flushing them to disk is a heavy process. Syntax ------ -This command takes two parameters. +This command takes three parameters. All parameters are optional:: io_flush [target_name=null] [recursive=yes] + [only_opened=no] + +.. versionadded:: 7.0.4 + + :ref:`io-flush-only-opened` is added. Usage ----- @@ -219,6 +224,9 @@ Child objects of table is all its columns. Child objects of column is nothing. +If you specify ``yes`` to :ref:`io-flush-only-opened`, ``recursive`` +is ignored. + ``recursive`` value must be ``yes`` or ``no``. ``yes`` means that all of the specified flush target object and child objects are flush target objects. ``no`` means that only the specified flush target @@ -254,6 +262,37 @@ isn't specified: .. include:: ../../example/reference/commands/io_flush/recursive_default.log .. io_flush +.. _io-flush-only-opened: + +``only_opened`` +""""""""""""""" + +.. versionadded:: 7.0.4 + +Specifies whether opened objects are only flushed. + +If there is only one process that changes the target database, flush +performance will be improved by specifying ``yes`` to +``only_opened``. It skips needless flushes. + +You can't specify :ref:`io-flush-target-name` with ``only_opened`` +option. If you specify :ref:`io-flush-target-name`, ``only_opened`` is +ignored. + +If you specify ``yes`` to ``only_opened``, :ref:`io-flush-recursive` +is ignored. + +``only_opened`` value must be ``yes`` or ``no``. ``yes`` means that +opened objects are only flushed. ``no`` means that all target objects +are flushed even they aren't opened. + +The following ``io_flush`` flushes all changes in database, all tables +and all columns: + +.. groonga-command +.. include:: ../../example/reference/commands/io_flush/only_opened_yes.log +.. io_flush --only_opened yes + Return value ------------ -------------- next part -------------- HTML����������������������������...下載
