Skip to main content
`Ctrl`+`K`

# 7.3.36. `logical_shard_list`

## 7.3.36.1. 概要

バージョン 5.0.7 で追加.

`logical_shard_list` は指定した論理テーブル名に対するすべてのシャード名を返します。

## 7.3.36.2. 構文

このコマンドの引数は1つで必須です:

    logical_shard_list logical_table

## 7.3.36.3. 使い方

このコマンドを使うには事前に `sharding` プラグインを登録します。

実行例:

    plugin_register sharding
    # [[0, 1337566253.89858, 0.000355720520019531], true]

サンプルシャードは次の通りです。

実行例:

    table_create  Logs_20150801           TABLE_HASH_KEY ShortText
    # [[0, 1337566253.89858, 0.000355720520019531], true]
    column_create Logs_20150801 timestamp COLUMN_SCALAR  Time
    # [[0, 1337566253.89858, 0.000355720520019531], true]
    table_create  Logs_20150802           TABLE_HASH_KEY ShortText
    # [[0, 1337566253.89858, 0.000355720520019531], true]
    column_create Logs_20150802 timestamp COLUMN_SCALAR  Time
    # [[0, 1337566253.89858, 0.000355720520019531], true]
    table_create  Logs_20150930           TABLE_HASH_KEY ShortText
    # [[0, 1337566253.89858, 0.000355720520019531], true]
    column_create Logs_20150930 timestamp COLUMN_SCALAR  Time
    # [[0, 1337566253.89858, 0.000355720520019531], true]

論理テーブル名として `Logs` を指定すると昇順ですべてのシャード名を取得できます。

実行例:

    logical_shard_list --logical_table Logs
    # [
    #   [
    #     0,
    #     1337566253.89858,
    #     0.000355720520019531
    #   ],
    #   [
    #     {
    #       "name": "Logs_20150801"
    #     },
    #     {
    #       "name": "Logs_20150802"
    #     },
    #     {
    #       "name": "Logs_20150930"
    #     }
    #   ]
    # ]

## 7.3.36.4. 引数

このセクションでは引数について説明します。

### 7.3.36.4.1. 必須引数

必須の引数は1つです。

#### 7.3.36.4.1.1. `logical_table`

論理テーブル名を指定します。 `logical_shard_list` は指定した論理テーブルのシャード名のリストを返します。

実行例:

    logical_shard_list --logical_table Logs
    # [
    #   [
    #     0,
    #     1337566253.89858,
    #     0.000355720520019531
    #   ],
    #   [
    #     {
    #       "name": "Logs_20150801"
    #     },
    #     {
    #       "name": "Logs_20150802"
    #     },
    #     {
    #       "name": "Logs_20150930"
    #     }
    #   ]
    # ]

このリストは昇順でソート済みです。

### 7.3.36.4.2. 省略可能引数

省略可能な引数はありません。

## 7.3.36.5. 戻り値

このコマンドは昇順でソートしたシャード名のリストを返します:

    [
      HEADER,
      [
        {"name": "SHARD_NAME_1"},
        {"name": "SHARD_NAME_2"},
        ...
        {"name": "SHARD_NAME_N"}
      ]
    ]

`HEADER` については 出力形式 を参照してください。

## 7.3.36.6. 参考

> - シャーディング