📣
TiDB Cloud Premium はパブリックプレビュー中です。エンタープライズワークロード向けの無制限のスケーリング、即時の弾力性、高度なセキュリティを提供します。このページは自動翻訳されたものです。原文はこちらからご覧ください。

ti fs-journal append-journal-entries



1 つの JSON イベントまたは JSON 配列をジャーナルに追加します。

構文

ti fs-journal append-journal-entries --journal-id <string> [--dry-run] [--entry-json <string>] [--entry-type <string>] [--file-system-id <string>] [--fs-token <string>] [--help] [--idempotency-key <string>] [--json-array] [--source <string>] [--subject <string>] [--version]

オプション

  • --journal-id <string>: ジャーナル ID。[required]
  • --dry-run: 変更を適用せずにリクエストを検証します。
  • --entry-json <string>: 1 つの JSON ジャーナルエントリオブジェクト。繰り返し指定できます。サポートされるフィールドについては、エントリ JSON 形式 を参照してください。
  • --entry-type <string>: 入力オブジェクトで type が省略されている場合に使用するエントリタイプ。入力オブジェクト内で明示的に指定された type が優先されます。
  • --file-system-id <string>: ファイルシステムを選択します。TI_FS_FILE_SYSTEM_ID を設定することもできます。
  • --fs-token <string>: Filesystem トークンを設定します。省略した場合、コマンドは TI_FS_TOKEN 環境変数を使用します。どちらも指定されていない場合、コマンドは選択した Filesystem 用にローカルに保存されているトークンを使用します。
  • --help: ヘルプ情報を表示します。
  • --idempotency-key <string>: 同じ追加リクエストの再試行を重複排除するために使用するキー。省略した場合、呼び出しごとに新しいキーが割り当てられます。
  • --json-array: JSONL の代わりに標準入力から JSON 配列を読み取ります。
  • --source <string>: エントリソース。
  • --subject <string>: エントリのサブジェクト。繰り返し指定できます。
  • --version: バージョン情報を表示します。

すべてのコマンドで共通のオプションについては、グローバルオプション を参照してください。

エントリ JSON 形式

各入力オブジェクトは、次のフィールドをサポートします。

フィールド型説明
typestringイベントタイプ。--entry-type でデフォルトが指定されていない限り必須です。小文字で始まる必要があり、小文字、数字、アンダースコア (_)、ピリオド (.)、またはハイフン (-) を含めることができます。
schema_versionintegerイベントペイロードのスキーマバージョン。1 未満の値は 1 として扱われます。
statusstringオプションのユーザー定義ステータス。CLI はこれを小文字に変換します。
occurred_atRFC3339 timestampイベントが発生した時刻。省略した場合、サービスが時刻を設定します。
actorobjecttype および id の string フィールドを持つオプションのアクター。
sourcestringイベントソース。サポートされる値は self_reported、gateway_observed、server_observed、imported です。 [default: self_reported]
parent_entry_idstringオプションの親イベント ID。
correlation_idstring関連するイベントをグループ化するためのオプションの ID。
subjectsarray of stringstype:id 形式のサブジェクト。--subject で指定した値はこの配列に追加されます。
summaryJSON valueオプションのインラインイベントペイロード。

artifact 参照は現在サポートされていません。エントリに artifacts または artifact_refs を含めないでください。

--source を指定すると、すべての入力オブジェクトの source 値が置き換えられます。--entry-type は type が省略されているオブジェクトにのみ適用されます。

例

  • 1 つの JSON エントリを追加します。

    # Record an event object and let the CLI or service apply default metadata. ti fs-journal append-journal-entries --file-system-id <file-system-id> --journal-id jrn-demo --entry-json '{"type":"task.started"}'
  • 冪等な型付きエントリを追加します。

    # Prevent retries from recording the same completion event twice. ti fs-journal append-journal-entries --file-system-id <file-system-id> --journal-id jrn-demo --entry-type task.completed --subject issue:42 --idempotency-key issue-42-complete
  • 標準入力から JSON 配列を追加します。

    # Batch multiple ordered events in a single append operation. printf '[{"type":"step.started"},{"type":"step.completed"}]' | ti fs-journal append-journal-entries --file-system-id <file-system-id> --journal-id jrn-demo --json-array

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