読み取り専用ストレージノードのベストプラクティス

このドキュメントでは、読み取り専用storageノードを構成する方法と、バックアップ、分析、テスト、およびその他のトラフィックをこれらのノードに送信する方法について説明します。これにより、遅延に対する許容度の高い負荷を重要なオンラインサービスから物理的に分離できます。

手順

1. 一部のTiKVノードを読み取り専用として指定する

一部の TiKV ノードを読み取り専用として指定するには、これらのノードに特別なラベルを付けます (ラベルキーのプレフィックスとして$を使用します)。配置ルールを使用してこれらのノードにデータを保存するように明示的に指定しない限り、PD はこれらのノードにデータをスケジュールしません。

tiup cluster edit-configコマンドを実行して読み取り専用ノードを構成できます。

tikv_servers:
  - host: ...
    ...
    labels:
      $mode: readonly

2. 配置ルールを使用して、学習者として読み取り専用ノードにデータを保存する

pd-ctl config placement-rulesコマンドを実行して、デフォルトの配置ルールをエクスポートします。

pd-ctl config placement-rules rule-bundle load --out="rules.json"

以前に配置ルールを構成していない場合、出力は次のようになります。

[
  {
    "group_id": "pd",
    "group_index": 0,
    "group_override": false,
    "rules": [
      {
        "group_id": "pd",
        "id": "default",
        "start_key": "",
        "end_key": "",
        "role": "voter",
        "count": 3
      }
    ]
  }
]

すべてのデータを学習者として読み取り専用ノードに保存します。次の例は、デフォルトの構成に基づいています。

[
  {
    "group_id": "pd",
    "group_index": 0,
    "group_override": false,
    "rules": [
      {
        "group_id": "pd",
        "id": "default",
        "start_key": "",
        "end_key": "",
        "role": "voter",
        "count": 3
      },
      {
        "group_id": "pd",
        "id": "readonly",
        "start_key": "",
        "end_key": "",
        "role": "learner",
        "count": 1,
        "label_constraints": [
          {
            "key": "$mode",
            "op": "in",
            "values": [
              "readonly"
            ]
          }
        ],
        "version": 1
      }
    ]
  }
]

pd-ctl config placement-rulesコマンドを使用して、上記の構成を PD に書き込みます。
```
pd-ctl config placement-rules rule-bundle save --in="rules.json"
```

注記：
大規模なデータセットを持つクラスターで前述の操作を実行すると、クラスター全体で読み取り専用ノードにデータを完全に複製するのに時間がかかる場合があります。この期間中、読み取り専用ノードはサービスを提供できない可能性があります。
バックアップの特別な実装のため、各ラベルの学習者数は 1 を超えることはできません。そうしないと、バックアップ中に重複データが生成されます。

3. Follower Readを使用して読み取り専用ノードからデータを読み取る

3.1 TiDBでFollower Readを使用する

TiDB を使用するときに読み取り専用ノードからデータを読み取るには、システム変数tidb_replica_readをlearnerに設定します。

set tidb_replica_read=learner;

3.2 TiSparkでFollower Readを使用する

TiSpark を使用するときに読み取り専用ノードからデータを読み取るには、Spark 構成ファイルで構成項目spark.tispark.replica_read ～ learnerを設定します。

spark.tispark.replica_read learner

3.3 クラスターデータのバックアップ時にFollower Readを使用する

クラスターデータをバックアップするときに読み取り専用ノードからデータを読み取るには、br コマンドラインで--replica-read-labelオプションを指定できます。シェルで次のコマンドを実行するときは、 $解析されないようにラベルを一重引用符で囲む必要があることに注意してください。

tiup br backup full ... --replica-read-label '$mode:readonly'