1.2.1 - en to ja translation catalogue (98 entries)

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

en: Summary
ja: 概要

en: ``logical_table_remove`` removes tables and their columns for the specified logical table. If there are one or more indexes against key of the tables and their columns, they are also removed.
ja: ``logical_table_remove`` は指定した論理テーブルのテーブルとそのカラムを削除します。もし、テーブルのキーあるいはそのテーブルのカラムにインデックスが張ってある場合はそれらも削除します。

en: If you specify the part of a shard, table of the shard isn't removed. ``logical_table_remove`` just deletes records in the table.
ja: シャードの一部を指定すると、そのシャードのテーブルは削除しません。テーブル内のレコードを削除するだけです。

en: For example, there are the following records in a table:
ja: 例えば、テーブル内に以下のレコードがあるとします。

en: Record1: ``2016-03-18 00:30:00``
ja: レコード1： ``2016-03-18 00:30:00``

en: Record2: ``2016-03-18 01:00:00``
ja: レコード2： ``2016-03-18 01:00:00``

en: Record3: ``2016-03-18 02:00:00``
ja: レコード3： ``2016-03-18 02:00:00``

en: ``logical_table_remove`` deletes "Record1" and "Record2" when you specify range as between ``2016-03-18 00:00:00`` and ``2016-03-18 01:30:00``. ``logical_table_remove`` doesn't delete "Record3". ``logical_table_remove`` doesn't remove the table.
ja: 範囲として ``2016-03-18 00:00:00`` から ``2016-03-18 01:30:00`` までを指定すると、「レコード1」と「レコード2」を削除します。「レコード3」は削除しません。テーブルも削除しません。

en: You can also remove tables and columns that reference the target table and tables related with the target shard by using ``dependent`` parameter.
ja: ``dependent`` パラメーターを使うと、対象テーブルを参照しているテーブル・カラムと対象シャードに関連しているテーブルも一緒に削除できます。

en: You can remove broken tables and columns as much as possible by using ``force`` parameter.
ja: ``force`` パラメーターを使うと壊れているテーブル・カラムでもできるだけ削除することができます。

en: Syntax
ja: 構文

en: This command takes many parameters.
ja: このコマンドにはたくさんの引数があります。

en: The required parameters are ``logical_table`` and ``shard_key``::
ja: 必須引数は2つあります。 ``logical_table`` と ``shard_key`` です。

en: Usage
ja: 使い方

en: You specify logical table name and shard key what you want to remove.
ja: 削除したい論理テーブル名とシャードキーを指定します。

en: This section describes about the followings:
ja: このセクションでは次のことについて説明します。

en: Basic usage
ja: 基本的な使い方

en: Removes parts of a logical table
ja: 論理テーブルの一部を削除

en: Unremovable cases
ja: 削除できないケース

en: Removes with related tables
ja: 関連するテーブルと一緒に削除

en: Removes broken tables as much as possible
ja: 可能な限り壊れているテーブルを削除

en: Decreases used resources
ja: 利用リソースの削減

en: Register ``sharding`` plugin to use this command in advance.
ja: このコマンドを使うには事前に ``sharding`` プラグインを登録します。

en: You can remove all tables for the logical table by specifying only ``logical_table`` and ``shard_key``.
ja: ``logical_table`` と ``shard_key`` だけを指定することで対象論理テーブル用のすべてのテーブルを削除できます。

en: Here are commands to create 2 shards:
ja: 以下は2つのシャードを作成するコマンドです。

en: You can confirm existing shards by :doc:`logical_shard_list`:
ja: 存在するシャードは :doc:`logical_shard_list` で確認できます。

en: You can remove all shards:
ja: すべてのシャードを削除できます。

en: There are no shards after you remove all shards:
ja: すべてのシャードを削除した後はシャードは存在しません。

en: You can specify range of shards by the following parameters:
ja: 次のパラメーターでシャードの範囲を指定できます。

en: See the following documents of :doc:`logical_select` for each parameter:
ja: 各パラメーターについては :doc:`logical_select` の以下のドキュメントを参照してください。

en: If the specified range doesn't cover all records in a shard, table for the shard isn't removed. Target records in the table are only deleted.
ja: 指定した範囲がシャード内のすべてのレコードを含んでいなかったら、そのシャードのテーブルは削除しません。テーブル内の対象レコードのみ削除します。

en: If the specified range covers all records in a shard, table for the shard is removed.
ja: 指定した範囲がシャード内のすべてのレコードを含んでいれば、そのシャード用のテーブルを削除します。

en: Here is a logical table to show the behavior. The logical table has two shards:
ja: 以下はこの挙動を示すための論理テーブルです。この論理テーブルには2つのシャードがあります。

en: There are the following records in ``Logs_20160318`` table:
ja: ``Logs_20160318`` テーブルには次のレコードがあります。

en: Record1: ``"2016-03-18 00:30:00"``
ja: レコード1： ``"2016-03-18 00:30:00"``

en: Record2: ``"2016-03-18 01:00:00"``
ja: レコード2： ``"2016-03-18 01:00:00"``

en: Record3: ``"2016-03-18 02:00:00"``
ja: レコード3： ``"2016-03-18 02:00:00"``

en: There are the following records in ``Logs_20160319`` table:
ja: ``Logs_20160319`` テーブルには次のレコードがあります。

en: Record1: ``"2016-03-19 00:30:00"``
ja: レコード1： ``"2016-03-19 00:30:00"``

en: Record2: ``"2016-03-19 01:00:00"``
ja: レコード2： ``"2016-03-19 01:00:00"``

en: The following range doesn't cover "Record1" in ``Logs_20160318`` table but covers all records in ``Logs_20160319`` table:
ja: 次の範囲は ``Logs_20160318`` テーブル内の「レコード1」を含んでいませんが、 ``Logs_20160319`` テーブルのすべてのレコードを含んでいます。

en: Parameter
ja: パラメーター

en: Value
ja: 値

en: ``logical_table_remove`` with the range deletes "Record2" and "Record3" in ``Logs_20160318`` table but doesn't remove ``Logs_20160318`` table. Because there is "Record1" in ``Logs_20160318`` table.
ja: この範囲を指定した ``logical_table_remove`` は ``Logs_20160318`` テーブルの「レコード2」と「レコード3」を削除します。しかし、 ``Logs_20160318`` テーブルは削除しません。なぜなら、 ``Logs_20160318`` テーブルには「レコード1」があるからです。

en: ``logical_table_remove`` with the range removes ``Logs_20160319`` table because the range covers all records in ``Logs_20160319`` table.
ja: この範囲を指定した ``logical_table_remove`` は ``Logs_20160319`` テーブルを削除します。なぜなら、この範囲は ``Logs_20160319`` テーブルのすべてのレコードを含んでいるからです。

en: Here is an example to use ``logical_table_remove`` with the range:
ja: この範囲を指定した ``logical_table_remove`` を使う例です。

en: :doc:`dump` shows that there is "Record1" in ``Logs_20160318`` table:
ja: :doc:`dump` を使うと ``Logs_20160318`` テーブルに「レコード1」があることを確認できます。

en: There are some unremovable cases. See :ref:`table-remove-unremovable-cases` for details. Because ``logical_table_remove`` uses the same checks.
ja: いくつか削除できない場合があります。詳細は :ref:`table-remove-unremovable-cases` を参照してください。なぜなら ``logical_table_remove`` も同じようにチェックしているからです。

en: If you understand what you'll do, you can also remove tables and columns that depend on the target shard with one ``logical_table_remove`` command by using ``--dependent yes`` parameter.
ja: もし、自分がなにをしようとしているかちゃんと理解しているのであれば、 ``--dependent yes`` パラメーターを使うことで1回の ``logical_table_remove`` で対象シャードに依存しているテーブルとカラムも削除することができます。

en: Here are conditions for dependent. If table or column satisfies one of the conditions, the table or column depends on the target shard:
ja: 以下が依存していると判断する条件です。もし、テーブル・カラムがこれらの条件のどれか1つでも満たしていてれば、そのテーブル・カラムは対象シャードに依存しています。

en: Tables and columns that reference the target shard
ja: 対象シャードを参照しているテーブル・カラム

en: Tables for the shard (= The table has the same ``_YYYYMMDD`` postfix as the target shard and is referenced from the target shard)
ja: 対象シャード用のテーブル（= 名前の末尾が対象シャードと同じ ``_YYYYMMDD`` で、対象シャードが参照しているテーブル)

en: If there are one or more tables and columns that reference the target shard, ``logical_table_remove`` is failed. It's for avoiding dangling references.
ja: 対象シャードを参照しているテーブル・カラムが1つ以上あれば、 ``logical_table_remove`` は失敗します。これは、参照先がなくなることを防ぐためです。

en: ``Bookmarks.log_20160320`` column in the following is the column that references the target shard:
ja: 以下の ``Bookmarks.log_20160320`` カラムは対象シャードを参照しています。

en: You can't remove ``Logs_20160320`` by ``logical_table_remove`` by default:
ja: デフォルトでは ``logical_table_remove`` で ``Logs_20160320`` を削除できません。

en: You can remove ``Logs_20160320`` by ``logical_table_remove`` with ``--dependent yes`` parameter. ``Bookmarks.log_20160320`` is also removed:
ja: ``--dependent yes`` パラメーター付きの ``logical_table_remove`` では ``Logs_20160320`` を削除できます。 ``Bookmarks.log_20160320`` も一緒に削除します。

en: :doc:`object_exist` shows that ``Logs_20160320`` table and ``Bookmarks.log_20160320`` column are removed:
ja: :doc:`object_exist` で ``Logs_20160320`` テーブルと ``Bookmarks.log_20160320`` カラムが削除されていることを確認できます。

en: If there is one or more tables for the target shard, ``logical_table_remove`` with ``--dependent yes`` also removes them. Tables that have the same ``_YYYYMMDD`` postfix as the target shard are treated as tables for the target shard.
ja: 対象シャード用のテーブルが1つ以上ある場合、 ``--dependent yes`` 付きの ``logical_table_remove`` はそれらも一緒に削除します。 対象シャード用のテーブルかどうかは対象シャードと同じ ``_YYYYMMDD`` がテーブル名の末尾にあるかどうかで判断します。

en: Here are two tables that have ``_20160320`` postfix. ``NotRelated_20160320`` table isn't used by ``Logs_20160320`` table. ``Users_20160320`` table is used by ``Logs_20160320`` table. ``Servers`` table exists and used by ``Logs_20160320`` table:
ja: 末尾が ``_20160320`` のテーブルは2つあります。 ``NotRelated_20160320`` テーブルは ``Logs_20160320`` テーブルから使われていません。 ``Users_20160320`` テーブルは ``Logs_20160320`` テーブルが使っています。 ``Servers`` テーブルもあり、これは ``Logs_20160320`` テーブルが使っています。

en: ``logical_table_remove`` with ``--dependent yes`` parameter removes only ``Logs_20160320`` table and ``Users_20160320`` table. Because ``Users_20160320`` table has ``_20160320`` postfix and used by ``Logs_20160320``. ``NotRelated_20160320`` table and ``Servers`` table aren't removed. Because ``NotRelated_20160320`` table has ``_20160320`` postfix but isn't used by ``Logs_20160320``. ``Servers`` table is used by ``Logs_20160320`` but doesn't have ``_20160320`` postfix:
ja: ``--dependent yes`` パラメーター付きの ``logical_table_remove`` は ``Logs_20160320`` テーブルと ``Users_20160320`` テーブルだけ削除します。なぜなら、 ``Users_20160320`` テーブルは名前の末尾が ``_20160320`` で、 ``Logs_20160320`` テーブルが使っているからです。 ``NotRelated_20160320`` テーブルと ``Servers`` テーブルは削除しません。なぜなら、 ``NotRelated_20160320`` は名前の末尾が ``_20160320`` ですが、 ``Logs_20160320`` テーブルは使っていないからです。 ``Servers`` テーブルは ``Logs_20160320`` テーブルが使っていますが、名前の末尾は ``_20160320`` ではありません。

en: You can confirm that ``Logs_20160320`` table and ``Users_20160320`` table are removed but ``NotRelated_20160320`` table and ``Servers`` table aren't removed:
ja: ``Logs_20160320`` テーブルと ``Users_20160320`` テーブルは削除されていて、 ``NotRelated_20160320`` テーブルと ``Servers`` テーブルは削除されていないことを確認します。

en: If the target tables are broken, you can't remove them. But you can remove them as much as possible by using ``force`` parameter.
ja: 対象のテーブルが壊れていた場合は削除できません。しかし、 ``force`` パラメーターを指定することで可能な限り削除することができます。

en: If you specify ``--force yes``, they are removed as much as possible. You can also use ``--dependent yes`` with ``--force yes``.
ja: ``--force yes`` を指定すると、対象テーブルを可能な限り削除します。 ``--force yes`` と一緒に ``--dependent yes`` も指定することができます。

en: Here is a sample schema to show how ``--force yes`` behavior:
ja: 以下は ``--force yes`` の挙動を示すサンプルスキーマです。

en: You can't remove ``Logs_20160320`` when ``Timestamps.logs_20160320_timestamp`` is broken:
ja: ``Timestamps.logs_20160320_timestamp`` が壊れていると ``Logs_20160320`` を削除できません。

en: You can remove ``Logs_20160320`` and its columns by using ``--force yes`` parameter even when ``Timestamps.logs_20160320_timestamp`` is broken:
ja: ``--force yes`` パラメーターを使うと、たとえ ``Timestamps.logs_20160320_timestamp`` が壊れていても ``Logs_20160320`` とこのテーブルのカラムを削除できます。

en: ``Logs_20160320``, its columns and ``Timestamps.logs_20160320_timestamp`` are removed:
ja: ``Logs_20160320`` とそのテーブルのカラムと ``Timestamps.logs_20160320_timestamp`` が削除されます。

en: ``--force yes`` parameter is a dangerous parameter. Normally, you don't need to use it.
ja: ``--force yes`` パラメーターは危険なパラメーターです。通常これを使う必要はありません。

en: You can decrease resources for this command. See :ref:`table-remove-decreases-used-resources` for details. Because ``logical_table_remove`` uses the same logic as :doc:`table_remove`.
ja: このコマンドが使うリソースを削減できます。詳細は :ref:`table-remove-decreases-used-resources` を参照してください。なぜなら ``logical_table_remove`` は :doc:`table_remove` と同じロジックを使っているからです。

en: Parameters
ja: 引数

en: This section describes parameters of ``logical_table_remove``.
ja: このセクションでは ``logical_table_remove`` の引数について説明します。

en: Required parameters
ja: 必須引数

en: There are required parameters.
ja: いくつか必須の引数があります。

en: Specifies logical table name. It means table name without ``_YYYYMMDD`` postfix.  If you use actual table such as ``Logs_20150203``, ``Logs_20150203`` and so on, logical table name is ``Logs``.
ja: 論理テーブル名を指定します。これは ``_YYYYMMDD`` をテーブル名から除いたものです。実際のテーブルが ``Logs_20150203`` や ``Logs_20150203`` といったものなら、論理テーブル名は ``Logs`` です。

en: See also :ref:`logical-select-logical-table`.
ja: :ref:`logical-select-logical-table` も参照してください。

en: Specifies column name which is treated as shared key.
ja: シャードキーとして使うカラム名を指定します。

en: See also :ref:`logical-select-shard-key`.
ja: :ref:`logical-select-shard-key` も参照してください。

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

en: There are optional parameters.
ja: いくつか省略可能な引数があります。

en: Specifies the minimum value of ``shard_key`` column.
ja: ``shard_key`` カラムの最小値を指定します。

en: See also :ref:`logical-select-min`.
ja: :ref:`logical-select-min` も参照してください。

en: Specifies whether the minimum value is included or not. ``include`` and ``exclude`` are available. The default is ``include``.
ja: 最小値を含めるかどうかを指定します。 ``include`` か ``exclude`` を指定します。デフォルトは ``include`` です。

en: See also :ref:`logical-select-min-border`.
ja: :ref:`logical-select-min-border` も参照してください。

en: Specifies the maximum value of ``shard_key`` column.
ja: ``shard_key`` カラムの最大値を指定します。

en: See also :ref:`logical-select-max`.
ja: :ref:`logical-select-max` も参照してください。

en: Specifies whether the maximum value is included or not. ``include`` and ``exclude`` are available. The default is ``include``.
ja: 最大値を含めるかどうかを指定します。 ``include`` か ``exclude`` を指定します。デフォルトは ``include`` です。

en: See also :ref:`logical-select-max-border`.
ja: :ref:`logical-select-max-border` も参照してください。

en: Specifies whether tables and columns that depend on the target shard are also removed or not.
ja: 対象シャードに依存しているテーブル・カラムも一緒に削除するかどうかを指定します。

en: If this value is ``yes``, tables and columns that depend on the target shard are also removed. Otherwise, they aren't removed. If there are one or more tables that reference the target shard, an error is returned. If there are tables for the shared, they are not touched.
ja: ``yes`` を指定した場合は、対象シャードに依存しているテーブル・カラムも削除します。 ``yes`` を指定しなければ削除しません。もし、対象シャードを参照しているテーブル・カラムが1つ以上あればエラーになります。もし、対象シャード用のテーブルがあっても、それらを削除しません。

en: You should use this parameter carefully. This is a danger parameter.
ja: このパラメーターは注意して使ってください。危険なパラメーターです。

en: See :ref:`logical-table-remove-removes-with-related-tables` how to use this parameter.
ja: このパラメーターの使い方は :ref:`logical-table-remove-removes-with-related-tables` を参照してください。

en: Specifies whether you want to remove target tables and columns even if some problems exist.
ja: もし問題があったとしても対象テーブル・カラムを削除したいかどうかを指定します。

en: See :ref:`logical-table-remove-removes-broken-tables-as-much-as-possible` how to use this parameter.
ja: このパラメーターの使い方は :ref:`logical-table-remove-removes-broken-tables-as-much-as-possible` を参照してください。

en: Return value
ja: 戻り値

en: The command returns ``true`` as body on success such as::
ja: このコマンドが成功したときは以下のようにボディは ``true`` になります::

en: If the command fails, error details are in ``HEADER``.
ja: このコマンドが失敗すると、 ``HEADER`` にエラーの詳細が含まれます。

en: See :doc:`/reference/command/output_format` for ``HEADER``.
ja: ``HEADER`` については :doc:`/reference/command/output_format` を参照してください。
