データ更新：Update Dataコンポーネント（AI Flowi Workflow）

データ更新を行うUpdate Dataは、カタログでは「指定したフィールドを使ってデータを動的に更新または追加する」と説明されています。まず既存のDataまたはJSONの供給元をold_dataに接続し、Update DataのJSON出力を、互換性のある後続ステップで使用します。

Update Dataはカタログに記載されていますが、Ai Flowiによる本番環境でのテストは行われていません。

執筆：Ai Flowi · 公開日

カタログの参照情報

2026年10月9日にエクスポートされたAI Flowi Workflow 1.9.2のprocessing.UpdateData項目に、既存データを扱うこのインターフェースが記載されています。カテゴリ内の項目は コンポーネントカタログ で確認できます。

入力

このリファレンスにある4つの入力のうち、必須フィールドはold_dataだけです。静的なエクスポートデータには、エディターで生成される個々のフィールド名や値は含まれていません。

カタログに記載されたUpdate Dataの入力（狭い画面ではスクロールできます）
名前型必須接続可能な入力型説明
number_of_fieldsintいいえ記載なしフィールド数を整数で指定する設定です。生成されるフィールドの定義、範囲、既定値は含まれていません。
old_dataotherはいData, JSON必須の既存データです。DataまたはJSONの接続を受け付けます。
text_keystrいいえMessageUpdate Dataのテキストキー設定はMessageの接続を受け付けます。更新対象のフィールドとの関係は、カタログでは説明されていません。
text_key_validatorboolいいえ記載なしテキストキーの検証を真偽値で指定する設定です。検証規則や失敗時の動作は示されていません。

出力

エクスポートデータに記載されたUpdate Dataの出力
表示名名前型
JSONdataJSON

Update Dataにはdataという名前の出力が1つあり、表示名と型はいずれもJSONです。エクスポートされたデータには、更新前後のペイロードの例はありません。

Update Dataを使用する場合

既存のデータで指定したフィールドを追加または更新する場合に、Update Dataを使用します。まず既存の供給元を接続し、更新内容を指定する前に、エディターで生成されたフィールドの設定項目を確認してください。

別のコンポーネントを選ぶ場合

更新対象となる既存の供給元がない場合は、 Create Dataを比較検討してください。既存オブジェクトに対して複数の操作を選択する場合は、Update Dataを操作の選択機能として扱うのではなく、 JSON Operations のガイドに従ってください。

最小構成

設定例です。実施記録のあるテストではありません

Update Dataの設定例
カタログの入力名設定例
old_data合成データを含む前段のJSON出力を接続します。
number_of_fields1

これは、エクスポートデータに基づく1フィールド分の初期設定であり、更新手順の全体を示すものではありません。エディターに表示されるフィールドの設定項目を確認し、そこで対象のフィールドを指定してください。設定項目の名前と値の形式はカタログに記載されていないため、この例ではフィールド入力や更新結果を推測して補っていません。

制限事項

  • number_of_fieldsは記載されていますが、エクスポートされたデータにはフィールドごとの入力やシリアライズ形式が含まれていません。静的な設定だけでは、追加や更新に必要な設定の全体を示せません。
  • 説明には、キーが重複した場合の優先順位、入れ子構造の更新、リストの扱い、old_data自体が変更されるかどうかの定義がありません。後続のノードが保持されたフィールドを利用する前に、これらの詳細を確認してください。
  • text_key_validatorには検証基準の記載がなく、text_keyにも既定値やパスの構文は示されていません。いずれのフィールドも、スキーマ検証や認可が行われることを保証するものではありません。
  • これらの入力には、保存先や永続化の操作は含まれていません。ワークフロー内のデータを更新しても、データベースやスプレッドシートへの書き込みが保存されるとは限りません。

外部サービスの設定については、 接続ガイドに従ってください。このページには、認証情報の設定や保存の手順は追加していません。

ノードの使用量

Update Dataを使うワークフローの予算は、 料金 と ワークフローの費用ガイドを参考に見積もってください。

Create Data · JSON Operations · Extract Key · Data → DataFrame