📣
TiDB Cloud Essential
はパブリックプレビュー中です。このページは自動翻訳されたものです。
原文はこちらからご覧ください。
TiDB Cloud
TiDB Self-Managed
Learning Center
お問い合わせ

TiFlashの設定

このドキュメントでは、 TiFlashの展開と使用に関連する構成パラメータについて説明します。

TiFlash構成パラメータ

このセクションでは、 TiFlashの設定パラメータについて説明します。

ヒント：

構成項目の値を調整する必要がある場合は、 設定を変更するを参照してください。

tiflash.tomlファイルを設定する

listen_host

  • TPC/HTTP などのサービスをサポートするためのリスニング ホスト。
  • これを"0.0.0.0"に設定することをお勧めします。これは、このマシンのすべての IP アドレスをリッスンすることを意味します。

tcp_port

  • TiFlash TCP サービスポート。このポートは内部テストに使用され、デフォルトでは 9000 に設定されています。
  • TiFlash v7.1.0より前のバージョンでは、このポートはデフォルトで有効になっていますが、セキュリティリスクがあります。セキュリティを強化するため、このポートにアクセス制御を適用し、ホワイトリストに登録されたIPアドレスからのアクセスのみを許可することをお勧めします。TiFlash v7.1.0以降では、このポートの設定をコメントアウトすることでセキュリティリスクを回避できます。TiFlashの設定ファイルでこのポートが指定されていない場合、このポートは無効になります。
  • TiFlashデプロイメントでは、このポートを構成することは推奨されません。(注: TiFlash v7.1.0 以降、 TiUP >= v1.12.5 またはTiDB Operator >= v1.5.0 でデプロイされたTiFlash は、デフォルトでポートを無効にし、より安全になっています。)
  • デフォルト値: 9000

mark_cache_size

  • データブロックのメタデータのキャッシュサイズ制限。通常、この値を変更する必要はありません。
  • デフォルト値: 1073741824

minmax_index_cache_size

  • データブロックの最小-最大インデックスのキャッシュサイズ制限。通常、この値を変更する必要はありません。
  • デフォルト値: 1073741824

delta_index_cache_size

  • DeltaIndex のキャッシュ サイズの制限。
  • デフォルト値: 0 、制限がないことを意味します。

path

  • TiFlashデータのstorageパス。複数のディレクトリがある場合は、各ディレクトリをカンマで区切ってください。
  • TiDB v4.0.9以降、 pathとpath_realtime_mode非推奨となりました。マルチディスク展開シナリオでパフォーマンスを向上させるには、 storageセクションの設定を使用してください。
  • TiDB v5.2.0 以降、 storage.io_rate_limit構成を使用する必要がある場合は、同時にTiFlashデータのstorageパスをstorage.main.dirに設定する必要があります。
  • storage構成が存在する場合、 pathとpath_realtime_mode構成は両方とも無視されます。

path_realtime_mode

  • trueに設定し、 pathに複数のディレクトリを設定した場合、最初のディレクトリに最新のデータが保存され、残りのディレクトリには古いデータが保存されます。
  • TiDB v4.0.9以降、 pathとpath_realtime_mode非推奨となりました。マルチディスク展開シナリオでパフォーマンスを向上させるには、 storageセクションの設定を使用してください。
  • storage構成が存在する場合、 pathとpath_realtime_mode構成は両方とも無視されます。
  • デフォルト値: false

tmp_path

  • TiFlash一時ファイルが保存されるパス。
  • デフォルトでは、 pathの最初のディレクトリ、またはstorage.latest.dirに"/tmp"を付加したディレクトリになります。

storagev4.0.9 の新機能

storageパス関連の設定を構成します。

format_version
  • DTFile 形式。
  • デフォルト値: 7
  • 7 4 5 6 2 3
    • format_version = 2 : バージョン v6.0.0 未満のデフォルトの形式。
    • format_version = 3 : v6.0.0 および v6.1.x のデフォルト形式。より多くのデータ検証機能が提供されます。
    • format_version = 4 : バージョン v6.2.0 から v7.3.0 までのデフォルトの形式。書き込み増幅とバックグラウンド タスクのリソース消費を削減します。
    • format_version = 5 : v7.3.0 で導入され、v7.4.0 から v8.3.0 までのバージョンのデフォルト形式で、小さなファイルを結合することで物理ファイルの数を削減します。
    • format_version = 6 : v8.4.0 で導入され、ベクトル インデックスの構築とstorageを部分的にサポートします。
    • format_version = 7 : v8.4.0 で導入され、v8.4.0 以降のバージョンのデフォルト形式で、ベクトル インデックスの構築とstorageをサポートします。

storage.main

dir
  • メインデータを保存するディレクトリのリスト。例： [ "/tidb-data/tiflash-9000" ]または[ "/ssd0/tidb-data/tiflash", "/ssd1/tidb-data/tiflash" ] 。
  • 全データの 90% 以上がディレクトリ リストに保存されます。
capacity
  • storage.main.dir内の各ディレクトリの最大storage容量。例: [10737418240, 10737418240] 。
  • 設定されていない場合、または0倍数に設定されている場合、実際のディスク (ディレクトリが配置されているディスク) の容量が使用されます。
  • 単位: "10GB" 。1 などの人間が読める数値はまだサポートされていないことに注意してください。
  • capacity番目のリストのサイズはstorage.main.dirリストのサイズと同じである必要があります。

storage.latest

dir
  • 最新データを保存するディレクトリのリストです。全データの約10%がこのディレクトリリストに保存されます。ここにリストされているディレクトリ（またはディレクトリ）は、 storage.main.dirよりも高いIOPSメトリックを必要とします。
  • 設定されていない場合（デフォルト）、値storage.main.dirが使用されます。
capacity
  • storage.latest.dir内の各ディレクトリの最大storage容量。設定されていない場合、または0倍数に設定されている場合は、実際のディスク（ディレクトリが配置されているディスク）の容量が使用されます。

storage.io_rate_limit v5.2.0 の新機能

I/O トラフィック制限設定を構成します。

max_bytes_per_sec
  • ディスクの読み取りと書き込みの合計I/O帯域幅。この設定項目は、I/Oトラフィックを制限するかどうかを決定します。デフォルトでは無効になっています。TiFlashにおけるこのトラフィック制限は、ディスク帯域幅が小さく、特定のサイズに制限されているクラウドstorageに適しています。
  • デフォルト値: 0 。これは、I/O トラフィックがデフォルトで制限されないことを意味します。
  • 単位: バイト
max_read_bytes_per_sec
  • ディスク読み取りの合計 I/O 帯域幅。
  • 設定項目max_read_bytes_per_secおよびmax_write_bytes_per_secは、ディスクの読み取りと書き込みの I/O 帯域幅を個別に制限します。Google Cloud が提供する Persistent Disk など、ディスクの読み取りと書き込みの I/O 帯域幅の制限を個別に計算するクラウドstorageに使用できます。
  • max_bytes_per_secの値が0でない場合はmax_bytes_per_sec優先されます。
  • デフォルト値: 0
max_write_bytes_per_sec
  • ディスク書き込みの合計 I/O 帯域幅。
  • 設定項目max_read_bytes_per_secおよびmax_write_bytes_per_secは、ディスクの読み取りと書き込みの I/O 帯域幅を個別に制限します。Google Cloud が提供する Persistent Disk など、ディスクの読み取りと書き込みの I/O 帯域幅の制限を個別に計算するクラウドstorageに使用できます。
  • max_bytes_per_secの値が0でない場合はmax_bytes_per_sec優先されます。
  • デフォルト値: 0
foreground_write_weight
  • TiFlashは内部的にI/O要求を4つのタイプに分類します。フォアグラウンド書き込み、バックグラウンド書き込み、フォアグラウンド読み取り、バックグラウンド読み取りです。1 foreground_write_weight 、フォアグラウンド書き込みI/Oトラフィックタイプに割り当てられる帯域幅の重みを制御します。通常、これらのパラメータを調整する必要はありません。
  • I/O トラフィック制限が初期化されると、 TiFlash はforeground_write_weight 、 background_write_weight 、 foreground_read_weight 、 background_read_weightの比率に従って、これら 4 種類の要求に帯域幅を割り当てます。
  • 重みが0に設定されている場合、対応する I/O トラフィックは制限されません。
  • デフォルト値: 25 、帯域幅の 25% の割り当てを表します。
background_write_weight
  • TiFlashは内部的にI/O要求を4つのタイプ（フォアグラウンド書き込み、バックグラウンド書き込み、フォアグラウンド読み取り、バックグラウンド読み取り）に分類します。1 background_write_weight 、バックグラウンド書き込みI/Oトラフィックタイプに割り当てられる帯域幅の重みを制御します。通常、これらのパラメータを調整する必要はありません。
  • I/O トラフィック制限が初期化されると、 TiFlash はforeground_write_weight 、 background_write_weight 、 foreground_read_weight 、 background_read_weightの比率に従って、これら 4 種類の要求に帯域幅を割り当てます。
  • 重みが0に設定されている場合、対応する I/O トラフィックは制限されません。
  • デフォルト値: 25 、帯域幅の 25% の割り当てを表します。
foreground_read_weight
  • TiFlashは内部的にI/O要求を4つのタイプ（フォアグラウンド書き込み、バックグラウンド書き込み、フォアグラウンド読み取り、バックグラウンド読み取り）に分類します。1 foreground_read_weight 、フォアグラウンド読み取りI/Oトラフィックタイプに割り当てられる帯域幅の重みを制御します。通常、これらのパラメータを調整する必要はありません。
  • I/O トラフィック制限が初期化されると、 TiFlash はforeground_write_weight 、 background_write_weight 、 foreground_read_weight 、 background_read_weightの比率に従って、これら 4 種類の要求に帯域幅を割り当てます。
  • 重みが0に設定されている場合、対応する I/O トラフィックは制限されません。
  • デフォルト値: 25 、帯域幅の 25% の割り当てを表します。
background_read_weight
  • TiFlashは内部的にI/O要求を4つのタイプ（フォアグラウンド書き込み、バックグラウンド書き込み、フォアグラウンド読み取り、バックグラウンド読み取り）に分類します。1 background_read_weight 、バックグラウンド読み取りI/Oトラフィックタイプに割り当てられる帯域幅の重みを制御します。通常、これらのパラメータを調整する必要はありません。
  • I/O トラフィック制限が初期化されると、 TiFlash はforeground_write_weight 、 background_write_weight 、 foreground_read_weight 、 background_read_weightの比率に従って、これら 4 種類の要求に帯域幅を割り当てます。
  • 重みが0に設定されている場合、対応する I/O トラフィックは制限されません。
  • デフォルト値: 25 、帯域幅の 25% の割り当てを表します。
auto_tune_sec
  • TiFlashは、現在のI/O負荷に応じて、異なるI/Oタイプのトラフィック制限を自動的に調整する機能をサポートしています。調整された帯域幅が、上記で設定した重み付け比率を超える場合があります。
  • auto_tune_sec自動チューニングの間隔を示します。auto_tune_sec の値が0の場合、自動チューニングは無効になります。
  • デフォルト値: 5
  • 単位: 秒

storage.s3

以下の設定項目は、 TiFlash分散storageおよびコンピューティングアーキテクチャモードにのみ適用されます。詳細については、 TiFlash分散ストレージおよびコンピューティングアーキテクチャと S3 サポート参照してください。

endpoint
  • S3エンドポイントアドレス。例: http://s3.{region}.amazonaws.com 。
bucket
  • TiFlash はすべてのデータをこのバケットに保存します。
root
  • S3 バケット内でデータが保存されるルートディレクトリ。例: /cluster1_data 。
access_key_id
  • S3 にアクセスするために使用される ACCESS_KEY_ID。
secret_access_key
  • S3 にアクセスするために使用される SECRET_ACCESS_KEY。

storage.remote.cache

dir
  • 分散storageおよびコンピューティングアーキテクチャ内のコンピューティング ノードのローカル データ キャッシュ ディレクトリ。
capacity
  • 例: 858993459200 (800 GiB)

フラッシュ

service_addr
  • TiFlashコプロセッサ サービスのリスニング アドレス。
compact_log_min_gap v7.4.0 の新機能
  • 現在のRaftステート マシンによって進められたapplied_indexと最後のディスク スピル時のapplied_indexの差がcompact_log_min_gap超えると、 TiFlash はTiKV からCompactLogコマンドを実行し、データをディスクにスピルします。
  • このギャップを大きくすると、 TiFlashのディスク書き込み頻度が低下し、ランダム書き込みシナリオにおける読み取りレイテンシーが短縮される可能性がありますが、メモリオーバーヘッドも増加する可能性があります。このギャップを小さくすると、 TiFlashのディスク書き込み頻度が増加し、 TiFlashのメモリ負荷が軽減される可能性があります。ただし、現段階では、このギャップを0に設定しても、 TiFlashのディスク書き込み頻度は TiKV よりも高くなることはありません。
  • デフォルト値を維持することをお勧めします。
  • デフォルト値: 200
compact_log_min_rowsバージョン5.0の新機能
  • TiFlashによってキャッシュされた領域内の行の数またはサイズがcompact_log_min_rowsまたはcompact_log_min_bytes超えると、 TiFlash はTiKV からCompactLogコマンドを実行し、データをディスクに書き込みます。
  • デフォルト値を維持することをお勧めします。
  • デフォルト値: 40960
compact_log_min_bytesバージョン5.0の新機能
  • TiFlashによってキャッシュされた領域内の行の数またはサイズがcompact_log_min_rowsまたはcompact_log_min_bytes超えると、 TiFlash はTiKV からCompactLogコマンドを実行し、データをディスクに書き込みます。
  • デフォルト値を維持することをお勧めします。
  • デフォルト値: 33554432
disaggregated_mode

フラッシュプロキシ

addr
  • プロキシのリスニング アドレス。
  • デフォルト値: "127.0.0.1:20170"
advertise-addr
  • 外部アクセスアドレスaddr 。空のままにした場合、デフォルトでaddr使用されます。
  • クラスターを複数のノードに展開する場合は、他のノードがadvertise-addrを介してアクセスできることを保証する必要があります。
status-addr
  • プロキシがメトリックまたはステータス情報を取得するリスニング アドレス。
  • デフォルト値: "127.0.0.1:20292"
advertise-status-addr
  • status-addrの外部アクセスアドレス。空のままにした場合、デフォルトでstatus-addrが使用されます。
  • クラスターを複数のノードに展開する場合は、他のノードがadvertise-status-addrを介してアクセスできることを保証する必要があります。
engine-addr
  • TiFlashコプロセッサ サービスの外部アクセス アドレス。
data-dir
  • プロキシのデータstorageパス。
config
  • プロキシの構成ファイル パス。
log-file
  • プロキシのログ パス。

ロガー

以下のパラメータはTiFlashログとTiFlashエラーログにのみ有効です。TiFlashTiFlashのログパラメータを設定する必要がある場合は、 tiflash-learner.tomlで指定してください。

level
  • ログ レベル。
  • デフォルト値: "info"
  • "error" "info" "debug" "warn" "trace"
log
  • TiFlashのログです。
errorlog
  • TiFlashのエラーログ。レベル"warn"とレベル"error"ログもこのログファイルに出力されます。
size
  • 1 つのログ ファイルのサイズ。
  • デフォルト値: "100M"
count
  • 保存できるログファイルの最大数。TiFlashTiFlashとTiFlashエラーログの場合、保存できるログファイルの最大数はそれぞれcountです。
  • デフォルト値: 10

ラフト

pd_addr
  • PD サービス アドレス。
  • 複数のアドレスはカンマで区切られます。例： "10.0.1.11:2379,10.0.1.12:2379,10.0.1.13:2379" 。

状態

metrics_port
  • Prometheus がメトリック情報を取得するポート。
  • デフォルト値: 8234

プロファイル.デフォルト

dt_enable_logical_split
  • DeltaTreeストレージエンジンのセグメントで論理分割を使用するかどうかを指定します。論理分割を使用すると書き込み増幅を削減できますが、ディスク領域の無駄が発生します。
  • v6.2.0以降のバージョンでは、デフォルト値のfalse維持し、 trueに変更しないことを強くお勧めします。詳細については、既知の問題＃5576参照してください。
  • デフォルト値: false
max_threads
  • max_threads 、 TiFlash がMPP タスクを実行する際の内部スレッド同時実行数を示します。2 0設定すると、 TiFlash は論理 CPU コアの数を同時実行数として使用します。
  • このパラメータは、システム変数tidb_max_tiflash_threads -1に設定されている場合にのみ有効になります。
  • デフォルト値: 0
max_memory_usage
  • 単一のクエリで生成される中間データのメモリ使用量の制限。
  • 値が整数の場合、単位はバイトです。例えば、 34359738368 32GiBのメモリ制限を意味します。
  • 値が[0.0, 1.0)から 1 の範囲の浮動小数点数の場合、ノードの総メモリに対する許容メモリ使用量の比率を表します。例えば、 0.8総メモリの 80% を意味し、 0.0無制限を意味します。
  • クエリがこの制限を超えるメモリを消費しようとすると、クエリは終了され、エラーが報告されます。
  • デフォルト値: 0 、制限がないことを意味します。
max_memory_usage_for_all_queries
  • すべてのクエリで生成される中間データのメモリ使用量制限。
  • 値が整数の場合、単位はバイトです。例えば、 34359738368 32GiBのメモリ制限を意味し、 0制限なしを意味します。
  • v6.6.0以降では、 [0.0, 1.0)から10000000000000の範囲の浮動小数点数で値を設定できます。この数値は、許容されるメモリ使用量とノード全体のメモリ使用量の比率を表します。例えば、 0.8メモリメモリの80%、 0.0無制限を意味します。
  • クエリがこの制限を超えるメモリを消費しようとすると、クエリは終了され、エラーが報告されます。
  • デフォルト値： 0.8 （総メモリの80%を意味します）。v6.6.0より前のバージョンでは、デフォルト値は0 （無制限を意味します）でした。
cop_pool_sizeバージョン5.0の新機能
  • TiFlashコプロセッサーが同時に実行できるcopリクエストの最大数を指定します。リクエスト数がこの値を超えても、10倍以内の場合、超過したリクエストはキューに入れられます。リクエスト数がこの値の10倍を超える場合、超過したリクエストはTiFlashによって拒否されます。設定値が0に設定されている場合、または設定されていない場合は、デフォルト値（物理コア数の2倍）が使用されます。
  • デフォルト値: 物理コア数の2倍
cop_pool_handle_limitバージョン5.0の新機能
  • TiFlashコプロセッサーが同時に処理できるCOPリクエストの最大数を指定します。これには、実行中のリクエストとキューで待機中のリクエストが含まれます。リクエスト数が指定値を超えると、エラーTiFlash Server is Busyが返されます。
  • -1制限がないことを示し、 0デフォルト値の10 * cop_pool_size使用することを示します。
cop_pool_max_queued_secondsバージョン5.0の新機能
  • cop要求がTiFlashにキューイングできる最大時間を指定します。cop要求がこの設定で指定された値よりも長くキュー内で待機した場合、エラーTiFlash Server is Busyが返されます。
  • 0以下の値は制限がないことを示します。
  • デフォルト値: 15
batch_cop_pool_sizeバージョン5.0の新機能
  • TiFlashコプロセッサーが同時に実行するバッチリクエストの最大数を指定します。リクエスト数が指定値を超えた場合、超過分のリクエストはキューに入れられます。設定値が0に設定されているか未設定の場合は、デフォルト値（物理コア数の2倍）が使用されます。
  • デフォルト値: 物理コア数の2倍
manual_compact_pool_sizeバージョン6.1の新機能
  • TiFlash がTiDB からALTER TABLE ... COMPACT受信したときに同時に処理できる要求の数を指定します。
  • 値が0に設定されている場合、デフォルト値1優先されます。
  • デフォルト値: 1
enable_elastic_threadpoolバージョン5.4.0の新機能
  • エラスティック スレッド プール機能を有効にするかどうかを制御します。この機能により、 TiFlashの同時実行性の高いシナリオで CPU 使用率が大幅に向上します。
  • デフォルト値: true
dt_compression_method
  • TiFlashstorageエンジンの圧縮アルゴリズム。
  • デフォルト値: LZ4
  • 値のオプション: LZ4 。値は大文字と小文字をzstdしませLZ4HC 。
dt_compression_level
  • TiFlashstorageエンジンの圧縮レベル。
  • dt_compression_methodがLZ4の場合は、この値を1に設定することをお勧めします。
  • この値は-1 (圧縮率は低くなりますが、読み取りパフォーマンスは向上します) に設定するか、 dt_compression_methodがzstd場合は1設定することをお勧めします。
  • dt_compression_methodがLZ4HCの場合は、この値を9に設定することをお勧めします。
  • デフォルト値: 1
dt_page_gc_threshold v6.2.0 の新機能
  • PageStorageデータファイル内の有効データの最小比率を指定します。PageStorageデータファイル内の有効データの比率がこの設定値を下回ると、GCがトリガーされ、ファイル内のデータが圧縮されます。
  • デフォルト値: 0.5
max_bytes_before_external_group_by v7.0.0 の新機能
  • ハッシュ集計演算子（キーGROUP BYで使用可能な最大メモリを指定します。この値を超えるとディスクへの書き込みがトリガーされます。メモリ使用量がしきい値を超えると、ハッシュ集計はメモリ使用量をディスクへのスピル削減します。
  • デフォルト値: 0 。これは、メモリ使用量が無制限であり、ハッシュ集計にディスクへのスピルが使用されないことを意味します。
max_bytes_before_external_sortバージョン7.0.0の新機能
  • ソート演算子またはtopN演算子で使用可能な最大メモリを指定します。この値を超えるとディスクへの書き込みがトリガーされます。メモリ使用量がこのしきい値を超えると、ソート演算子またはtopN演算子はメモリ使用量をディスクへのスピルずつ減らします。
  • デフォルト値: 0 。これは、メモリ使用量が無制限であり、ソートや topN にディスクへのスピルが使用されないことを意味します。
max_bytes_before_external_joinバージョン7.0.0の新機能
  • 等価結合条件を持つハッシュ結合演算子で使用可能な最大メモリを指定します。この値を超えるとディスクへの書き込みがトリガーされます。メモリ使用量がしきい値を超えると、HashJoin はメモリ使用量をディスクへのスピル減らします。
  • デフォルト値: 0 。これは、メモリ使用量が無制限であり、等価結合条件によるハッシュ結合ではディスクへのスピルが使用されないことを意味します。
enable_resource_controlバージョン7.4.0の新機能
  • TiFlashリソース制御機能を有効にするかどうかを制御します。1 true設定すると、 TiFlashはパイプライン実行モデル使用します。
  • デフォルト値: true
  • 値falseオプション: true
task_scheduler_thread_soft_limitバージョン6.0.0の新機能
  • この項目はMinTSOスケジューラで使用されます。1つのリソースグループが使用できるスレッドの最大数を指定します。詳細については、 TiFlash MinTSO スケジューラ参照してください。
  • デフォルト値: 5000
task_scheduler_thread_hard_limitバージョン6.0.0の新機能
  • この項目はMinTSOスケジューラで使用されます。グローバルスコープ内のスレッドの最大数を指定します。詳細については、 TiFlash MinTSO スケジューラ参照してください。
  • デフォルト値: 10000
task_scheduler_active_set_soft_limitバージョン6.4.0の新機能
  • この項目はMinTSOスケジューラに使用されます。TiFlashTiFlashで同時に実行できるクエリの最大数を指定します。詳細については、 TiFlash MinTSO スケジューラ参照してください。
  • デフォルト値: バージョン7.4.0より前のバージョンでは、デフォルト値はvcpu * 0.25で、これはvCPU数の4分の1を意味します。バージョン7.4.0以降では、デフォルト値はvcpu * 2で、これはvCPU数の2倍を意味します。

セキュリティv4.0.5 の新機能

セキュリティ関連の設定を構成します。

redact_info_logバージョン5.0の新機能
  • ログ編集を有効にするかどうかを制御します。
  • デフォルト値: false
  • 値のオプション: true 、 false 、 "on" 、 "off" 、および"marker" 。 "on" 、 "off" 、および"marker"オプションは、v8.2.0 で導入されました。
  • 構成項目がfalseまたは"off"に設定されている場合、ログ編集は無効になります。
  • 構成項目がtrueまたは"on"に設定されている場合、ログ内のすべてのユーザー データは?に置き換えられます。
  • 設定項目を"marker"に設定すると、ログ内のすべてのユーザーデータは‹ ›で囲まれます。ユーザーデータに‹または›含まれている場合、 ‹ ‹‹に、 › ››にエスケープされます。マークされたログに基づいて、ログを表示する際にマークされた情報を非感度化するかどうかを決定できます。
  • tiflash-learner.tomlでの tiflash-learner のログインにもsecurity.redact-info-log設定する必要があることに注意してください。
ca_path
  • 信頼できるSSL CAのリストを含むファイルのパス。設定する場合は、 cert_pathとkey_pathも必要です。
cert_path
  • PEM 形式の X509 証明書が含まれるファイルのパス。
key_path
  • PEM 形式の X509 キーを含むファイルのパス。

tiflash-learner.tomlファイルを設定する

tiflash-learner.tomlのパラメータは基本的にTiKVと同じです。TiFlashTiFlashの設定についてはTiKV構成参照してください。以下はよく使用されるパラメータのみを示しています。ご注意ください。

  • TiKV と比較して、 TiFlash Proxy にはraftstore.snap-handle-pool-size追加パラメーターがあります。
  • キーがengineのlabel予約されており、手動で設定することはできません。

ログ

level v5.4.0 の新機能
  • TiFlash Proxy のログ レベル。
  • デフォルト値: "info"
  • "error" "info" "debug" "warn" "trace"

ログファイル

max-backupsバージョン5.4.0の新機能
  • 保存するログ ファイルの最大数。
  • このパラメータが設定されていないか、デフォルト値0に設定されている場合、 TiFlash Proxy はすべてのログ ファイルを保存します。
  • このパラメータを0以外の値に設定すると、 TiFlash Proxyは最大でmax-backupsで指定された数の古いログファイルを保持します。例えば、 7に設定すると、 TiFlash Proxyは最大で7つの古いログファイルを保持します。
  • デフォルト値: 0
max-days v5.4.0 の新機能
  • ログ ファイルが保持される最大日数。
  • このパラメータが設定されていないか、デフォルト値0に設定されている場合、 TiFlash Proxy はすべてのログ ファイルを保持します。
  • このパラメータがゼロ以外の値に設定されている場合、 TiFlash Proxy はmax-daysで指定された日数後に古いログ ファイルをクリーンアップします。
  • デフォルト値: 0

ラフトストア

apply-pool-size
  • Raftデータをstorageにフラッシュするプール内の許容スレッド数。
store-pool-size
  • Raftを処理するスレッドの許容数。これはRaftstoreスレッド プールのサイズです。
snap-handle-pool-size v4.0.0 の新機能
  • スナップショットを処理するスレッドの数0に設定すると、マルチスレッド最適化は無効になります。
  • デフォルト値: 2

安全

redact-info-logバージョン5.0の新機能
  • ログ編集を有効にするかどうかを制御します。
  • デフォルト値: false
  • 値のオプション: true 、 false 、 "on" 、 "off" 、および"marker" 。 "on" 、 "off" 、および"marker"オプションは、v8.3.0 で導入されました。
  • 構成項目がfalseまたは"off"に設定されている場合、ログ編集は無効になります。
  • 構成項目がtrueまたは"on"に設定されている場合、ログ内のすべてのユーザー データは?に置き換えられます。
  • 設定項目を"marker"に設定すると、ログ内のすべてのユーザーデータは‹ ›で囲まれます。ユーザーデータに‹または›含まれている場合、 ‹ ‹‹に、 › ››にエスケープされます。マークされたログに基づいて、ログを表示する際にマークされた情報を非感度化するかどうかを決定できます。

セキュリティ.暗号化

data-encryption-method
  • データファイルの暗号化方法。1 "plaintext"の値は暗号化が有効であることを意味します。その場合はマスターキーを指定する必要があります。
  • デフォルト値: "plaintext" 。これは、暗号化がデフォルトで無効になっていることを意味します。
  • 値の"aes256-ctr" : "aes128-ctr" "aes192-ctr" "plaintext"で導入され"sm4-ctr" "sm4-ctr" 。
data-key-rotation-period
  • データ暗号化キーをローテーションする頻度を指定します。
  • デフォルト値: 7d

セキュリティ.暗号化.マスターキー

  • 暗号化が有効になっている場合、マスターキーを指定します。マスターキーの設定方法については、 暗号化を設定する参照してください。

セキュリティ.暗号化.以前のマスターキー

  • 新しいマスターキーをローテーションする際に使用する古いマスターキーを指定します。設定形式はmaster-keyと同じです。マスターキーの設定方法については、 暗号化を設定する参照してください。

サーバー

labels
  • { zone = "us-west-1", disk = "ssd" }などのサーバー属性を指定します。ラベルを使用してレプリカをスケジュールする方法の詳細については、 利用可能なゾーンを設定する参照してください。
  • デフォルト値: {}

マルチディスク展開

TiFlashはマルチディスク構成をサポートしています。TiFlashノードに複数のディスクがある場合、以下のセクションで説明するパラメータを設定することで、それらのディスクを最大限に活用できます。TiUPで使用するTiFlashの設定テンプレートについては、 TiFlashトポロジの複雑なテンプレート参照してください。

v4.0.9以降のバージョンのTiDBクラスターでは、 TiFlashはstorageエンジンのメインデータと最新データを複数のディスクにTiFlashすることをサポートしています。TiFlashノードを複数のディスクにデプロイする場合は、ノードのI/Oパフォーマンスを最大限に活用するために、 [storage]セクションでstorageディレクトリを指定することをお勧めします。

TiFlashノード上に類似したI/Oメトリックを持つ複数のディスクがある場合は、リストstorage.main.dirで対応するディレクトリを指定し、リストstorage.latest.dir空のままにすることをお勧めします。TiFlashはI/O負荷とデータをすべてのディレクトリに分散します。

TiFlashノード上にI/Oメトリックが異なる複数のディスクがある場合は、 storage.latest.dir番目のリストにメトリックの高いディレクトリを指定し、 storage.main.dir番目のリストにメトリックの低いディレクトリを指定することをお勧めします。例えば、NVMe-SSDが1台とSATA-SSDが2台の場合、 storage.latest.dirを["/nvme_ssd_a/data/tiflash"]をstorage.main.dir ["/sata_ssd_b/data/tiflash", "/sata_ssd_c/data/tiflash"]設定します。TiFlashは、これらの2つのディレクトリリストにそれぞれI/O負荷とデータを分散します。この場合、 storage.latest.dirという容量は、計画容量全体の10%として計画する必要があることに注意してください。

このページは役に立ちましたか？