Apache Kafka - メッセージ公開アクション(バッチ)

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

Publish messagesバッチアクションは、選択したKafkaトピックに複数のメッセージを1回のバッチ操作で公開します。 Kafkaメッセージ本文とメッセージキーに対して、AVRO形式またはProtobuf形式のスキーマを選択できます。

要件と制限

このアクションには、オンプレミスエージェントバージョン31以降が必要です。

バッチの制限:

  • 最大バッチサイズ: 50 MB
  • 最大メッセージ数: バッチあたり100件のメッセージ

入力

入力フィールド説明
トピックメッセージを公開するトピックの名前を選択または入力します。
メッセージスキーマソースメッセージスキーマの定義場所を選択します。 オプションは次のとおりです:

  • Common data model - Workatoで定義されたスキーマを使用します
  • Schema registry - Kafkaクラスターで定義されたスキーマを使用します。 schema.registry.urlプロパティを設定する必要があります
  • Common data model - Protobuf - Workatoで定義されたProtobufスキーマを使用します
WorkatoはAVROおよびProtobuf形式のスキーマをサポートしています。
メッセージスキーマMessage schema sourceの選択内容に基づいてメッセージスキーマを選択します。
ProtobufメッセージスキーマスキーマレジストリからProtobufメッセージスキーマを選択します。

このフィールドは、メッセージスキーマソースとしてCommon data model - Protobufが選択されている場合に表示されます。
キースキーマタイプメッセージキーのスキーマタイプを設定します。 オプションは次のとおりです:

  • Plaintext - 単純な文字列キーを使用します
  • Schema registry - Kafkaクラスターのスキーマを使用します。 schema.registry.urlプロパティを設定する必要があります
WorkatoはAVROおよびProtobuf形式のスキーマをサポートしています。
キースキーマ使用可能なスキーマからキースキーマを選択します。

このフィールドは、キースキーマタイプとしてSchema registryが選択されている場合に表示されます。
パーティション明示的に公開するトピックパーティション(インデックスは0から始まります)を指定します。 指定しない場合、Kafkaがパーティションを自動的に選択します。
レコードKafkaトピックに公開するレコードのリストを指定します。 このセクションを展開して、レコードソースと個々のメッセージの詳細を設定します。
レコードソースリスト(Records)公開するレコードを含むリストデータピルを指定します。 リスト内の各項目は、Kafkaに公開する1つのメッセージを表します。 リスト入力の詳細
レコードフィールド(Message)各レコードのメッセージ内容を指定します。
キー(レコード)各メッセージと共に保存するメッセージキーを指定します。
メッセージヘッダー(レコード)各メッセージと共にヘッダーとして保存するキーと値のペアのリストを指定します。 ヘッダーキーは重複できます。

出力

出力には、正常に公開されたメッセージと、バッチ公開中に発生した失敗に関する情報が含まれます。 ダウンストリームステップで出力を使用するには、関連するデータピルをマッピングします。

出力フィールド説明
成功正常に公開された各メッセージの結果を含むリスト。
インデックス(成功)元の入力バッチ内のメッセージのインデックス(0から開始)。
キー(成功)メッセージと共に公開されたメッセージキー。
サイズ(成功)公開されたメッセージのサイズ。
タイムスタンプ(成功)公開されたメッセージのタイムスタンプ。
パーティション(成功)メッセージが追加されたパーティションID。
オフセット(成功)Kafka内の一意のメッセージ識別子であるメッセージオフセット。
失敗公開に失敗した各メッセージの詳細を含むリスト。
インデックス(失敗)元の入力バッチ内の失敗したメッセージのインデックス(0から開始)。
キー(失敗)失敗したメッセージのメッセージキー。
エラー(失敗)メッセージの公開に失敗した理由を説明するエラーメッセージ。

Last updated: