📣
TiDB Cloud Serverless が
Starter
に変わりました！このページは自動翻訳されたものです。
原文はこちらからご覧ください。
TiDB Cloud
TiDB Self-Managed
Learning Center
お問い合わせ

CALIBRATE RESOURCE

CALIBRATE RESOURCEステートメントは、現在のクラスターの「リクエストユニット（RU）」容量を推定して出力するために使用されます。

注記：

この機能は TiDB Self-Managed にのみ適用され、 TiDB Cloudでは使用できません。

概要

CalibrateResourceStmt
CALIBRATERESOURCEWorkloadOption
WorkloadOption
WORKLOADTPCCOLTP_READ_WRITEOLTP_READ_ONLYOLTP_WRITE_ONLYSTART_TIMETIMESTAMPDURATIONstringLitEND_TIMETIMESTAMP

権限

このコマンドを実行するには、次の要件が満たされていることを確認してください。

容量を推定する方法

TiDB は推定に 2 つの方法を提供します。

実際の作業負荷に基づいて容量を見積もる

アプリケーションが既に本番環境で稼働している場合、または実際のビジネステストを実行できる場合は、一定期間にわたる実際のワークロードを使用して総容量を見積もることをお勧めします。見積りの精度を向上させるには、以下の制約に従ってください。

  • START_TIMEパラメータを使用して、推定を開始する時刻を2006-01-02 15:04:05形式で指定します。推定のデフォルトの終了時刻は現在の時刻です。
  • START_TIMEパラメータを指定した後、 END_TIMEパラメータを使用して推定終了時刻を指定したり、 DURATIONパラメータを使用してSTART_TIMEからの推定時間ウィンドウを指定したりできます。
  • 時間枠は 10 分から 24 時間までです。
  • 指定された時間枠内で、TiDB と TiKV の CPU 使用率が低すぎる場合、容量を見積もることはできません。

注記：

TiKVはmacOSのCPU使用率メトリクスを監視しません。macOSの実際のワークロードに基づく容量推定はサポートしていません。

ハードウェアの展開に基づいて容量を見積もる

この方法は、主に現在のクラスタ構成と、様々なワークロードで観測された経験値に基づいて容量を推定します。ワークロードの種類によって必要なハードウェア比率が異なるため、同じハードウェア構成でも出力容量が異なる場合があります。ここでのWORKLOADパラメータは、以下の異なるワークロードタイプを受け入れます。デフォルト値はTPCCです。

  • TPCC : 大量のデータ書き込みを伴うワークロードに適用されます。これはTPC-Cと同様のワークロードモデルに基づいて推定されます。
  • OLTP_WRITE_ONLY : 大量のデータ書き込みを伴うワークロードに適用されます。これはsysbench oltp_write_onlyと同様のワークロードモデルに基づいて推定されます。
  • OLTP_READ_WRITE : データの読み取りと書き込みが均等なワークロードに適用されます。これはsysbench oltp_read_writeと同様のワークロードモデルに基づいて推定されます。
  • OLTP_READ_ONLY : 大量のデータ読み取りを伴うワークロードに適用されます。これはsysbench oltp_read_onlyと同様のワークロードモデルに基づいて推定されます。
  • TPCH_10 : APクエリに適用されます。2 からのTPCH-10Gのクエリに基づいて推定されます。

注記：

クラスタのRU容量は、クラスタのトポロジと各コンポーネントのハードウェアおよびソフトウェア構成によって異なります。各クラスタが提供できる実際のRUは、実際のワークロードにも依存します。ハードウェア構成に基づく推定値は参考値であり、実際の最大値と異なる場合があります実際の作業量に基づいて容量を見積もるを推奨します。

例

実際のワークロードに応じて RU 容量を表示するには、開始時刻START_TIMEと時間ウィンドウDURATIONを指定します。

CALIBRATE RESOURCE START_TIME '2023-04-18 08:00:00' DURATION '20m';
+-------+
| QUOTA |
+-------+
| 27969 |
+-------+
1 row in set (0.01 sec)

実際のワークロードに応じて RU 容量を表示するには、開始時刻START_TIMEと終了時刻END_TIME指定します。

CALIBRATE RESOURCE START_TIME '2023-04-18 08:00:00' END_TIME '2023-04-18 08:20:00';
+-------+
| QUOTA |
+-------+
| 27969 |
+-------+
1 row in set (0.01 sec)

時間ウィンドウ範囲DURATION 10 分から 24 時間の範囲にない場合は、エラーが発生します。

CALIBRATE RESOURCE START_TIME '2023-04-18 08:00:00' DURATION '25h';
ERROR 1105 (HY000): the duration of calibration is too long, which could lead to inaccurate output. Please make the duration between 10m0s and 24h0m0s
CALIBRATE RESOURCE START_TIME '2023-04-18 08:00:00' DURATION '9m';
ERROR 1105 (HY000): the duration of calibration is too short, which could lead to inaccurate output. Please make the duration between 10m0s and 24h0m0s

実際の作業負荷に基づく容量推定機能の監視メトリックには、 tikv_cpu_quota 、 tidb_server_maxprocs 、 resource_manager_resource_unit 、 process_cpu_usage 、 tiflash_cpu_quota 、 tiflash_resource_manager_resource_unit 、 tiflash_process_cpu_usageが含まれます。CPUクォータ監視データが空の場合、次の例に示すように、対応する監視メトリック名にエラーが発生します。

CALIBRATE RESOURCE START_TIME '2023-04-18 08:00:00' DURATION '60m';
Error 1105 (HY000): There is no CPU quota metrics, metrics 'tikv_cpu_quota' is empty

時間枠内のワークロードが低すぎる場合、または監視データresource_manager_resource_unitとprocess_cpu_usage欠落している場合、以下のエラーが報告されます。また、TiKVはmacOSのCPU使用率を監視しないため、実際のワークロードに基づく容量推定をサポートしておらず、このエラーも報告されます。

CALIBRATE RESOURCE START_TIME '2023-04-18 08:00:00' DURATION '60m';
ERROR 1105 (HY000): The workload in selected time window is too low, with which TiDB is unable to reach a capacity estimation; please select another time window with higher workload, or calibrate resource by hardware instead

RU容量を表示するにはWORKLOAD指定します。デフォルト値はTPCCです。

CALIBRATE RESOURCE;
+-------+
| QUOTA |
+-------+
| 190470 |
+-------+
1 row in set (0.01 sec)

CALIBRATE RESOURCE WORKLOAD OLTP_WRITE_ONLY;
+-------+
| QUOTA |
+-------+
| 27444 |
+-------+
1 row in set (0.01 sec)

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