タイタンConfiguration / コンフィグレーション

このドキュメントでは、対応する構成アイテムを使用して巨人を有効または無効にする方法、および関連するパラメーターとレベルマージ機能を紹介します。

タイタンを有効にする

TitanはRocksDBと互換性があるため、RocksDBを使用する既存のTiKVインスタンスでTitanを直接有効にすることができます。次の2つの方法のいずれかを使用して、Titanを有効にできます。

• 方法1：TiUPを使用してクラスタをデプロイした場合は、次の例に示すように、 tiup cluster edit-config ${cluster-name}コマンドを実行してTiKV構成ファイルを編集できます。

    tikv:
      rocksdb.titan.enabled: true
  

  構成をリロードすると、TiKVはオンラインでローリングリスタートされます。

  tiup cluster reload ${cluster-name} -R tikv
  

  詳細なコマンドについては、 TiUPを使用して構成を変更しますを参照してください。

• 方法2：TiKV構成ファイルを直接編集して、Titanを有効にします（実稼働環境には推奨されません）。

  [rocksdb.titan]
  enabled = true
  

Titanを有効にした後、RocksDBに保存されている既存のデータはすぐにはTitanエンジンに移動されません。新しいデータがTiKVフォアグラウンドに書き込まれ、RocksDBが圧縮を実行すると、値はキーから徐々に分離され、Titanに書き込まれます。 TiKVの詳細-> Titankv- > blobファイルサイズパネルを表示して、Titanに保存されているデータのサイズを確認できます。

書き込みプロセスを高速化する場合は、tikv-ctlを使用してTiKVクラスタ全体のデータを手動で圧縮します。詳細については、 手動圧縮を参照してください。

ノート：

Titanが無効になっている場合、RocksDBはTitanに移行されたデータを読み取ることができません。 Titanがすでに有効になっているTiKVインスタンスでTitanが誤って無効にされている場合（誤ってrocksdb.titan.enabledからfalseに設定されている場合）、TiKVは起動に失敗し、 You have disabled titan when its data directory is not emptyエラーがTiKVログに表示されます。 Titanを正しく無効にするには、 タイタンを無効にするを参照してください。

パラメーター

TiUPを使用してTitan関連のパラメータを調整するには、 構成を変更するを参照してください。

• タイタンGCスレッド数。

  [ **TiKVの詳細]** ->[スレッドCPU ]->[ RocksDBCPU ]パネルから、Titan GCスレッドが長時間フルキャパシティーになっていることを確認した場合は、TitanGCスレッドプールのサイズを増やすことを検討してください。

  [rocksdb.titan]
  max-background-gc = 1
  

• 値のサイズのしきい値。

  フォアグラウンドに書き込まれる値のサイズがしきい値よりも小さい場合、この値はRocksDBに保存されます。それ以外の場合、この値はTitanのblobファイルに保存されます。値のサイズの分布に基づいて、しきい値を大きくすると、より多くの値がRocksDBに保存され、TiKVは小さな値の読み取りでより優れたパフォーマンスを発揮します。しきい値を下げると、より多くの値がTitanに送られ、RocksDBの圧縮がさらに減少します。

  [rocksdb.defaultcf.titan]
  min-blob-size = "1KB"
  

• Titanで値を圧縮するために使用されるアルゴリズムで、値を単位とします。

  [rocksdb.defaultcf.titan]
  blob-file-compression = "lz4"
  

• Titanの値キャッシュのサイズ。

  キャッシュサイズが大きいほど、Titanの読み取りパフォーマンスが高くなります。ただし、キャッシュサイズが大きすぎると、メモリ不足（OOM）が発生します。データベースが安定して実行されている場合は、ストアサイズからblobファイルサイズを引いた値にstorage.block-cache.capacityの値を設定し、監視メトリックに従ってblob-cache-sizeからmemory size * 50% - block cache sizeに設定することをお勧めします。これにより、ブロックキャッシュがRocksDBエンジン全体に対して十分に大きい場合に、blobキャッシュサイズが最大化されます。

  [rocksdb.defaultcf.titan]
  blob-cache-size = 0
  

• BLOBファイル内の破棄可能なデータ（対応するキーが更新または削除された）の比率が次のしきい値を超えると、TitanGCがトリガーされます。

  discardable-ratio = 0.5
  

  Titanがこのblobファイルの有用なデータを別のファイルに書き込む場合、 discardable-ratioの値を使用して、書き込み増幅とスペース増幅の上限を見積もることができます（圧縮が無効になっていると仮定）。

  ライトアンプリフィケーションの上限=1/ destroyable_ratio

  スペース増幅の上限=1/（1-discardable_ratio）

  上記の2つの式から、 discardable_ratioの値を減らすとスペースの増幅が減る可能性がありますが、TitanではGCの頻度が高くなることがわかります。値を大きくすると、Titan GC、対応するI / O帯域幅、およびCPU消費量が減少しますが、ディスク使用量は増加します。

• 次のオプションは、RocksDB圧縮のI/Oレートを制限します。トラフィックのピーク時には、RocksDBの圧縮、I / O帯域幅、およびCPU消費を制限することで、フォアグラウンドの書き込みおよび読み取りパフォーマンスへの影響を軽減します。

  Titanが有効になっている場合、このオプションはRocksDB圧縮とTitanGCの合計I/Oレートを制限します。 RocksDBコンパクションとTitanGCのI/OやCPUの消費量が多すぎる場合は、このオプションをディスクI/O帯域幅と実際の書き込みトラフィックに応じて適切な値に設定してください。

  [rocksdb]
  rate-bytes-per-sec = 0
  

タイタンを無効にする（実験的）

Titanを無効にするには、 rocksdb.defaultcf.titan.blob-run-modeオプションを構成できます。 blob-run-modeのオプションの値は次のとおりです。

• オプションがnormalに設定されている場合、Titanは通常どおり読み取りおよび書き込み操作を実行します。
• オプションがread-onlyに設定されている場合、値のサイズに関係なく、新しく書き込まれたすべての値がRocksDBに書き込まれます。
• オプションがfallbackに設定されている場合、値のサイズに関係なく、新しく書き込まれたすべての値がRocksDBに書き込まれます。また、Titan BLOBファイルに保存されているすべての圧縮値は、自動的にRocksDBに戻されます。

Titanを無効にするには、 blob-run-mode = "fallback"を設定し、tikv-ctlを使用して完全な圧縮を実行します。その後、監視メトリックを確認し、blobファイルのサイズが0に減少することを確認します。次に、 rocksdb.titan.enabledをfalseに設定して、TiKVを再起動できます。

レベルマージ（実験的）

TiKV 4.0では、範囲クエリのパフォーマンスを改善し、フォアグラウンド書き込み操作に対するTitan GCの影響を減らすために、新しいアルゴリズムであるレベルマージが導入されました。次のオプションを使用して、レベルマージを有効にできます。

[rocksdb.defaultcf.titan]
level-merge = true

レベルマージを有効にすると、次の利点があります。

• Titan範囲クエリのパフォーマンスを大幅に向上させます。
• フォアグラウンド書き込み操作に対するTitanGCの影響を減らし、書き込みパフォーマンスを向上させます。
• Titanのスペース増幅とディスク使用量を減らします（デフォルト構成のディスク使用量と比較して）。

したがって、レベルマージを有効にした場合のライトアンプリフィケーションは、Titanのライトアンプリフィケーションよりもわずかに高くなりますが、ネイティブのRocksDBのライトアンプリフィケーションよりは低くなります。