Cassandraドキュメント

バージョン

プレリリースバージョンのドキュメントを表示しています。

sstablepartitions

SSTableの大きなパーティションを識別し、パーティションサイズ(バイト単位)、行数、セル数、およびトゥームストーン数を 出力します。

任意の数のSSTableファイルパス、またはSSTableを含むディレクトリを指定できます。各SSTableは個別に分析されます。

`--min-size`、`--min-rows`、`--min-cells`、`--min-tombstones`などのメトリックしきい値が指定されている場合、しきい値を超えるパーティションキーが出力に表示されます。また、テーブルのメトリックの概要も出力します。メトリックのパーセンタイルは推定値ですが、最小/最大/カウントメトリックは正確です。

このツールのデフォルト出力は、人が読むことを意図しています。今後のバージョンでは、小さな書式変更が含まれたり、スクリプトの読み取りを妨げる新しいデータが表示されたりする可能性があります。スクリプトまたはその他の自動ツールは、`--csv`フラグを使用して、機械で判読可能な出力を生成する必要があります。今後のバージョンでは、新しい列が追加される場合を除き、CSV出力の形式は変更されないため、出力を消費する適切なCSVパーサーは引き続き機能します。

このツールを実行する前に、Cassandraを実行している必要はありません。

使用方法

sstablepartitions <オプション> <sstableファイルまたはディレクトリ>

-t, --min-size <arg>

パーティションサイズのしきい値。バイト数、または10KiB、20MiB、30GiBなどの単位を持つサイズとして表されます。

-w, --min-rows <arg>

パーティションの行数のしきい値。

-c, --min-cells <arg>

パーティションのセル数のしきい値。

-o, --min-tombstones <arg>

パーティションのトゥームストーン数のしきい値。

-k, --key <arg>

すべてのパーティションをスキャンする代わりに、含めるパーティションキー。

-x, --exclude-key <arg>

除外するパーティションキー。

-r, --recursive

SSTableを再帰的にスキャンする

-b, --backups

ディレクトリをスキャンするときに、データディレクトリに存在するバックアップを含める

-s, --snaphsots

ディレクトリをスキャンするときに、データディレクトリに存在するスナップショットを含める

-u, --current-timestamp <arg>

TTL期限切れの計算のためのタイムスタンプ(エポックからの秒数、単位時間)。

-y, --partitions-only

簡単なパーティション情報のみ。パーティションごとの詳細な行/セル/トゥームストーン情報をプロセスと出力から除外します。

-m, --csv

生成されたCSV出力(機械可読)

単一のSSTableのパーティション統計を分析する

SSTableファイルへのパスを唯一の引数として使用します。

sstablepartitions data/data/k/t-d7be5e90e90111ed8b54efe3c39cb0bb/oa-8-big-Data.db

Processing k.t-d7be5e90e90111ed8b54efe3c39cb0bb #8 (big-oa) (1.368 GiB uncompressed, 534.979 MiB on disk)
               Partition size            Row count           Cell count      Tombstone count
  ~p50            767.519 KiB                  770                 1916                    0
  ~p75              2.238 MiB                 2299                 5722                    0
  ~p90              3.867 MiB                 3311                 9887                   50
  ~p95             16.629 MiB                14237                42510                  446
  ~p99            148.267 MiB               126934               379022                 1331
  ~p999           368.936 MiB               315852               943127                 2759
  min              56.854 KiB                  100                  150                    0
  max             356.067 MiB               310706               932118                 2450
  count                   210

ディレクトリ内のすべてのSSTableのパーティション統計を分析する

SSTableディレクトリへのパスを唯一の引数として使用します。

sstablepartitions data/data/k/t-d7be5e90e90111ed8b54efe3c39cb0bb

Processing k.t-d7be5e90e90111ed8b54efe3c39cb0bb #8 (big-oa) (1.368 GiB uncompressed, 534.979 MiB on disk)
               Partition size            Row count           Cell count      Tombstone count
  ~p50            767.519 KiB                  770                 1916                    0
  ~p75              2.238 MiB                 2299                 5722                    0
  ~p90              3.867 MiB                 3311                 9887                   50
  ~p95             16.629 MiB                14237                42510                  446
  ~p99            148.267 MiB               126934               379022                 1331
  ~p999           368.936 MiB               315852               943127                 2759
  min              56.854 KiB                  100                  150                    0
  max             356.067 MiB               310706               932118                 2450
  count                   210

Processing k.t-d7be5e90e90111ed8b54efe3c39cb0bb #9 (big-oa) (457.540 MiB uncompressed, 174.880 MiB on disk)
               Partition size            Row count           Cell count      Tombstone count
  ~p50              1.865 MiB                 1597                 4768                    0
  ~p75             13.858 MiB                14237                42510                    0
  ~p90             28.735 MiB                29521                73457                   50
  ~p95             34.482 MiB                29521                88148                 8239
  ~p99             49.654 MiB                42510               126934                14237
  ~p999            49.654 MiB                42510               126934                14237
  min              47.272 KiB                  100                  150                    0
  max              45.133 MiB                39429               118287                13030
  count                    57

サイズが100MiBを超えるパーティションのみを出力する

`--min-size`オプションを使用して、出力に含める必要があるパーティションの最小サイズを指定します。

sstablepartitions data/data/k/t-d7be5e90e90111ed8b54efe3c39cb0bb/oa-8-big-Data.db --min-size 100MiB

Processing k.t-d7be5e90e90111ed8b54efe3c39cb0bb #8 (big-oa) (1.368 GiB uncompressed, 534.979 MiB on disk)
  Partition: '13' (0000000d) live, size: 105.056 MiB, rows: 91490, cells: 274470, tombstones: 50 (row:50, range:0, complex:0, cell:0, row-TTLd:0, cell-TTLd:0)
  Partition: '1' (00000001) live, size: 127.241 MiB, rows: 111065, cells: 333195, tombstones: 50 (row:50, range:0, complex:0, cell:0, row-TTLd:0, cell-TTLd:0)
  Partition: '8' (00000008) live, size: 356.067 MiB, rows: 310706, cells: 932118, tombstones: 0 (row:0, range:0, complex:0, cell:0, row-TTLd:0, cell-TTLd:0)
  Partition: '2' (00000002) live, size: 213.341 MiB, rows: 186582, cells: 559125, tombstones: 978 (row:978, range:0, complex:0, cell:0, row-TTLd:0, cell-TTLd:0)
Summary of k.t-d7be5e90e90111ed8b54efe3c39cb0bb #8 (big-oa):
  File: /Users/adelapena/src/cassandra/trunk/data/data/k/t-d7be5e90e90111ed8b54efe3c39cb0bb/oa-8-big-Data.db
  4 partitions match
  Keys: 13 1 8 2
               Partition size            Row count           Cell count      Tombstone count
  ~p50            767.519 KiB                  770                 1916                    0
  ~p75              2.238 MiB                 2299                 5722                    0
  ~p90              3.867 MiB                 3311                 9887                   50
  ~p95             16.629 MiB                14237                42510                  446
  ~p99            148.267 MiB               126934               379022                 1331
  ~p999           368.936 MiB               315852               943127                 2759
  min              56.854 KiB                  100                  150                    0
  max             356.067 MiB               310706               932118                 2450
  count                   210

トゥームストーンが1000を超えるパーティションのみを出力する

`--min-tombstones`オプションを使用して、出力に含める必要があるパーティションの最小トゥームストーン数を指定します。

sstablepartitions data/data/k/t-d7be5e90e90111ed8b54efe3c39cb0bb/oa-8-big-Data.db --min-tombstones 1000

Processing k.t-d7be5e90e90111ed8b54efe3c39cb0bb #8 (big-oa) (1.368 GiB uncompressed, 534.979 MiB on disk)
  Partition: '55' (00000037) live, size: 1.290 MiB, rows: 2317, cells: 3474, tombstones: 1159 (row:1159, range:0, complex:0, cell:0, row-TTLd:0, cell-TTLd:0)
  Partition: '28' (0000001c) live, size: 1.198 MiB, rows: 2099, cells: 3147, tombstones: 1050 (row:1050, range:0, complex:0, cell:0, row-TTLd:0, cell-TTLd:0)
  Partition: '89' (00000059) live, size: 1.346 MiB, rows: 2226, cells: 3339, tombstones: 1113 (row:1113, range:0, complex:0, cell:0, row-TTLd:0, cell-TTLd:0)
  Partition: '21' (00000015) live, size: 3.853 MiB, rows: 4900, cells: 9927, tombstones: 2450 (row:2450, range:0, complex:0, cell:0, row-TTLd:0, cell-TTLd:0)
Summary of k.t-d7be5e90e90111ed8b54efe3c39cb0bb #8 (big-oa):
  File: /Users/adelapena/src/cassandra/trunk/data/data/k/t-d7be5e90e90111ed8b54efe3c39cb0bb/oa-8-big-Data.db
  4 partitions match
  Keys: 55 28 89 21
               Partition size            Row count           Cell count      Tombstone count
  ~p50            767.519 KiB                  770                 1916                    0
  ~p75              2.238 MiB                 2299                 5722                    0
  ~p90              3.867 MiB                 3311                 9887                   50
  ~p95             16.629 MiB                14237                42510                  446
  ~p99            148.267 MiB               126934               379022                 1331
  ~p999           368.936 MiB               315852               943127                 2759
  min              56.854 KiB                  100                  150                    0
  max             356.067 MiB               310706               932118                 2450
  count                   210

CSV機械可読出力を出力する

`--csv`オプションを使用して、しきい値と組み合わせて、CSV機械可読出力を出力します。

sstablepartitions data/data/k/t-d7be5e90e90111ed8b54efe3c39cb0bb/oa-8-big-Data.db --min-size 100MiB --csv
key,keyBinary,live,offset,size,rowCount,cellCount,tombstoneCount,rowTombstoneCount,rangeTombstoneCount,complexTombstoneCount,cellTombstoneCount,rowTtlExpired,cellTtlExpired,directory,keyspace,table,index,snapshot,backup,generation,format,version
"13",0000000d,true,186403543,110158965,91490,274470,50,50,0,0,0,0,0,/Users/adelapena/src/cassandra/trunk/data/data/k/t-d7be5e90e90111ed8b54efe3c39cb0bb/oa-8-big-Data.db,k,t,,,,8,big,oa
"1",00000001,true,325141542,133422183,111065,333195,50,50,0,0,0,0,0,/Users/adelapena/src/cassandra/trunk/data/data/k/t-d7be5e90e90111ed8b54efe3c39cb0bb/oa-8-big-Data.db,k,t,,,,8,big,oa
"8",00000008,true,477133752,373362819,310706,932118,0,0,0,0,0,0,0,/Users/adelapena/src/cassandra/trunk/data/data/k/t-d7be5e90e90111ed8b54efe3c39cb0bb/oa-8-big-Data.db,k,t,,,,8,big,oa
"2",00000002,true,851841363,223704192,186582,559125,978,978,0,0,0,0,0,/Users/adelapena/src/cassandra/trunk/data/data/k/t-d7be5e90e90111ed8b54efe3c39cb0bb/oa-8-big-Data.db,k,t,,,,8,big,oa