TiDB Cloud Filesystem Journals を使う
ジャーナルは、TiDB Cloud Filesystem 上で実行されるエージェントワークフローおよび自動化パイプライン向けに、追記専用かつハッシュチェーン化されたイベントログを提供します。ti fs-journal コマンドを使用して、ジャーナルの作成、順序付きイベントの追記、それらの検索または読み取り、ハッシュチェーンの検証を行います。
前提条件
- TiDB Cloud CLI をインストールして設定する。
--file-system-idを渡す、TI_FS_FILE_SYSTEM_IDを設定する、または Filesystem を識別する FS トークンを指定して、Filesystem を選択します。--fs-token、TI_FS_TOKEN、または選択した Filesystem 用に保存されているローカル認証情報を通じて、ジャーナル権限を持つ FS トークンを指定します。
ジャーナルを作成する
ti fs-journal create-journal \
--journal-kind agent \
--title "review task" \
--actor agent:reviewer
返されたジャーナル ID を保存します。
エントリを追記する
ti fs-journal append-journal-entries \
--journal-id "<journal-id>" \
--entry-json '{"type":"review_started"}'
サポートされる入力形式とエントリフィールドについては、append-journal-entries リファレンスを参照してください。
エントリを読み取りおよび検索する
シーケンス順にエントリを読み取ります。
ti fs-journal read-journal-entries --journal-id "<journal-id>"
ジャーナルとエントリをまたいで検索します。
ti fs-journal search-journal-entries \
--entry-type review_started \
--include-entries
ジャーナルを検証する
ジャーナルのハッシュチェーンが完全であることを検証します。
ti fs-journal verify-journal --journal-id "<journal-id>"