📣
TiDB Cloud Essential はパブリックプレビュー中です。このページは自動翻訳されたものです。原文はこちらからご覧ください。
AI
開発者向け
ベストプラクティス
API

チェンジフィード（ベータ版）

TiDB Cloud changefeed は、TiDB Cloudから他のデータサービスへのデータストリーミングに役立ちます。現在、 TiDB Cloud はApache Kafka と MySQL へのデータストリーミングをサポートしています。

注記：

  • 現在、 TiDB Cloud、 TiDB Cloud Essential クラスターごとに最大 10 個の変更フィードのみが許可されます。
  • TiDB Cloudスタータークラスターでは、changefeed 機能は使用できません。

制限

  • Changefeed は、1 つのRENAME TABLEステートメント（例: RENAME TABLE t1 TO t3, t2 TO t4 ）で複数のテーブルの名前を変更する DDL ステートメントをサポートしていません。このステートメントを実行すると、Changefeed データのレプリケーションが永続的に中断されます。
  • チェンジフィードのスループットは約20 MiB/秒です。増分データ量がこの制限を超える場合は、 TiDB Cloudサポートお問い合わせください。

サポートされている地域

changefeed 機能は次のリージョンで利用できます。

クラウドプロバイダーサポートされている地域
AWS
  • ap-east-1
  • ap-northeast-1
  • ap-southeast-1
  • eu-central-1
  • us-east-1
  • us-west-2
    • アリババクラウド
  • ap-southeast-1
  • ap-southeast-5
  • cn-hongkong

    • 今後、他の地域でもサポートされる予定です。特定の地域での緊急サポートについては、 TiDB Cloudサポートお問い合わせください。

    Changefeedページをビュー

    changefeed 機能にアクセスするには、次の手順を実行します。

    1. TiDB Cloudコンソールにログインし、プロジェクトのクラスターページに移動します。

      ヒント：

      左上隅のコンボ ボックスを使用して、組織、プロジェクト、クラスターを切り替えることができます。

    2. ターゲットクラスターの名前をクリックして概要ページに移動し、左側のナビゲーションペインで「データ」 > 「Changefeed」をクリックします。Changefeedページが表示されます。

    「Changefeed」ページでは、変更フィードを作成したり、既存の変更フィードの一覧を表示したり、既存の変更フィードを操作したり (変更フィードの一時停止、再開、編集、削除など) できます。

    チェンジフィードを作成する

    チェンジフィードを作成するには、チュートリアルを参照してください。

    チェンジフィードをビュー

    TiDB CloudコンソールまたはTiDB Cloud CLI を使用して変更フィードを表示できます。

      1. ターゲット TiDB クラスターのチェンジフィードページに移動します。
      2. 表示する対応する変更フィードを見つけて、 [アクション]列の[...] > [ビュー]をクリックします。
      3. 構成、ステータス、メトリックなど、変更フィードの詳細を確認できます。

      次のコマンドを実行します。

      ticloud serverless changefeed get --cluster-id <cluster-id> --changefeed-id <changefeed-id>

      チェンジフィードを一時停止または再開する

      TiDB CloudコンソールまたはTiDB Cloud CLI を使用して、変更フィードを一時停止または再開できます。

        1. ターゲット TiDB クラスターのチェンジフィードページに移動します。
        2. 一時停止または再開する対応する変更フィードを見つけて、 [アクション]列の[...] > [一時停止/再開]をクリックします。

        変更フィードを一時停止するには、次のコマンドを実行します。

        ticloud serverless changefeed pause --cluster-id <cluster-id> --changefeed-id <changefeed-id>

        チェンジフィードを再開するには:

        ticloud serverless changefeed resume -c <cluster-id> --changefeed-id <changefeed-id>

        変更フィードを編集する

        注記：

        TiDB Cloud現在、一時停止状態の変更フィードのみ編集できます。

        TiDB CloudコンソールまたはTiDB Cloud CLI を使用して、変更フィードを編集できます。

          1. ターゲット TiDB クラスターのチェンジフィードページに移動します。

          2. 一時停止する変更フィードを見つけて、 [アクション]列の[...] > [一時停止]をクリックします。

          3. changefeed のステータスがPausedに変更されたら、 [...] > [編集]をクリックして、対応する changefeed を編集します。

            TiDB Cloud はデフォルトで changefeed 設定を設定します。以下の設定を変更できます。

            • Apache Kafka シンク: Destination 、 Connection 、 Start Positionを除くすべての構成
            • MySQLシンク:宛先、接続、開始位置を除くすべての構成

          4. 設定を編集した後、 [...] > [再開]をクリックして、対応する変更フィードを再開します。

          Apache Kafka シンクを使用して変更フィードを編集します。

          ticloud serverless changefeed edit --cluster-id <cluster-id> --changefeed-id <changefeed-id> --name <new-displayName> --kafka <full-specified-kafka> --filter <full-specified-filter>

          MySQL シンクを使用して変更フィードを編集します。

          ticloud serverless changefeed edit --cluster-id <cluster-id> --changefeed-id <changefeed-id> --name <new-displayName> --mysql <full-specified-mysql> --filter <full-specified-filter>

          チェンジフィードを複製する

          1. ターゲット TiDB クラスターのチェンジフィードページに移動します。
          2. 複製したい変更フィードを見つけます。 「アクション」列で、 「...」 > 「複製」をクリックします。
          3. TiDB Cloud は、新しい変更フィード設定に元の設定を自動的に入力します。必要に応じて設定を確認し、変更できます。
          4. 設定を確認したら、 [送信]をクリックして新しい変更フィードを作成し、開始します。

          変更フィードを削除する

          TiDB CloudコンソールまたはTiDB Cloud CLI を使用して、変更フィードを削除できます。

            1. ターゲット TiDB クラスターのチェンジフィードページに移動します。
            2. 削除する変更フィードを見つけて、 [アクション]列の[...] > [削除]をクリックします。

            次のコマンドを実行します。

            ticloud serverless changefeed delete --cluster-id <cluster-id> --changefeed-id <changefeed-id>

            チェンジフィード課金

            ベータ フェーズでは、Changefeeds は無料です。

            チェンジフィードの状態

            実行プロセス中に、変更フィードがエラーで失敗したり、手動で一時停止または再開されたりすることがあります。これらの動作により、変更フィードの状態が変化する可能性があります。

            各状態は次のように説明されます。

            • CREATING : 変更フィードを作成中です。
            • CREATE_FAILED : 変更フィードの作成に失敗しました。変更フィードを削除して、新しい変更フィードを作成する必要があります。
            • RUNNING : チェンジフィードは正常に実行され、チェックポイント ts は正常に進行します。
            • PAUSED : チェンジフィードは一時停止されます。
            • WARNING : チェンジフィードは警告を返します。回復可能なエラーのため、チェンジフィードは続行できません。この状態のチェンジフィードは、状態がRUNNINGに遷移するまで再開を試行し続けます。この状態のチェンジフィードはGC操作ブロックします。
            • RUNNING_FAILED : 変更フィードが失敗しました。何らかのエラーが発生したため、変更フィードを再開できず、自動復旧もできません。増分データのガベージコレクション(GC) 前に問題が解決された場合は、失敗した変更フィードを手動で再開できます。増分データのデフォルトの Time-To-Live (TTL) 期間は 24 時間です。つまり、変更フィードが中断されてから 24 時間以内には、GC メカニズムによってデータが削除されることはありません。

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