ConsumeAMQP 2025.5.31.15

Bundle

org.apache.nifi | nifi-amqp-nar

Description

Consomme les messages AMQP provenant d’un broker AMQP utilisant le protocole AMQP 0.9.1. Chaque message reçu du broker AMQP sera émis comme un fichier FlowFile distinct vers la relation « success ».

Balises

amqp, consume, get, message, rabbit, receive

Exigences en matière d’entrées

FORBIDDEN

Prend en charge les propriétés dynamiques sensibles

false

Propriétés

Propriété

Description

Version AMQP

AMQP Version. Seul AMQP v0.9.1 est actuellement pris en charge.

Brokers

La liste séparée par des virgules des brokers AMQP connus, au format <hôte>:<port> (par exemple, localhost:5672). Si cette propriété est définie, les champs Host Name et Port sont ignorés. N’incluez que des hôtes appartenant à un même cluster AMQP.

Client Certificate Authentication Enabled

L’authentification se fait à l’aide du certificat SSL plutôt que par nom d’utilisateur/mot de passe.

Host Name

Adresse réseau du broker AMQP (par exemple, localhost). Si le paramètre Brokers est défini, cette propriété est ignorée.

Max Inbound Message Body Size

Taille maximale du corps des messages entrants (reçus).

Mot de passe

Mot de passe utilisé pour l’authentification et l’autorisation.

Port

Valeur numérique identifiant le port du broker AMQP (par exemple, 5671). Si le paramètre Brokers est défini, cette propriété est ignorée.

Queue

Le nom de la file d’attente AMQP existante à partir de laquelle les messages seront consommés. Généralement prédéfini par l’administrateur AMQP.

Service contextuel SSL

Le service de contexte SSL utilisé pour fournir des informations sur les certificats des clients pour les connexions TLS/SSL.

NomUtilisateur

Nom d’utilisateur utilisé pour l’authentification et l’autorisation.

Virtual Host

Nom d’hôte virtuel qui isole le système AMQP pour une sécurité améliorée.

auto.acknowledge

Si cette propriété est définie sur false (Non-Auto-Acknowledge), les messages seront acquittés par le processeur après le transfert des FlowFiles vers la relation « success » et la validation de la session NiFi. Le mode Non-Auto-Acknowledge fournit une sémantique de livraison « au moins une fois ». Si cette propriété est définie sur true (Auto-Acknowledge), les messages qui sont délivrés au client AMQP seront auto-acquittés par le broker AMQP juste après leur envoi. Cela permet généralement d’obtenir un meilleur débit, mais les messages sont perdus en cas de redémarrage ou de panne du broker AMQP, de NiFi ou du processeur. Le mode Auto-Acknowledge fournit une sémantique de livraison « au plus une fois » et n’est recommandé que si la perte de messages est acceptable.

batch.size

Le nombre maximum de messages qui doivent être traités dans une seule session. Une fois que ce nombre de messages a été reçu (ou qu’il n’y a plus de messages disponibles), les messages reçus sont transférés à la relation « success » et un accusé de réception est envoyé au broker AMQP. Une valeur plus élevée pourrait améliorer les performances, en particulier pour les très petits messages, mais risque également d’entraîner la duplication d’un plus grand nombre de messages lors d’un redémarrage soudain de NiFi.

header.format

Définit comment sortir les en-têtes du message reçu

header.key.prefix

Texte à préfixer aux clés d’en-tête lorsque celles-ci sont ajoutées aux attributs du FlowFile. Le processeur ajoutera « . » à la valeur de cette propriété

header.separator

Le caractère utilisé pour séparer la clé et la valeur d’un en-tête sous forme de chaîne de caractères. La valeur ne doit comporter qu’un seul caractère.

prefetch.count

Nombre maximal de messages non acquittés pour le consommateur. Si le consommateur a ce nombre de messages non acquittés, le broker AMQP n’enverra plus de nouveaux messages jusqu’à ce que le consommateur acquitte certains des messages qui lui ont déjà été livrés. Valeurs autorisées : de 0 à 65535. 0 signifie aucune limite

remove.curly.braces

Si cette propriété est définie sur true, les accolades figurant dans l’en-tête seront automatiquement supprimées.

Relations

Nom

Description

success

Tous les FlowFiles reçus de la file d’attente AMQP sont routés vers cette relation

Écrit les attributs

Nom

Description

amqp$appId

Le champ App ID du message AMQP

amqp$contentEncoding

Le codage du contenu signalé par le message AMQP

amqp$contentType

Le type de contenu signalé par le message AMQP

amqp$headers

Les en-têtes présents dans le message AMQP. Ajoutés uniquement si le processeur est configuré pour produire cet attribut.

<Préfixe de clé d’en-tête>.<attribut>

Chaque en-tête de message sera inséré avec ce nom d’attribut, à condition que le processeur soit configuré pour générer les en-têtes sous la forme d’un attribut

amqp$deliveryMode

Indicateur numérique du mode d’acheminement du message

amqp$priority

La priorité du message

amqp$correlationId

L’ID de corrélation du message

amqp$replyTo

La valeur du champ Reply-To du message

amqp$expiration

L’expiration du message

amqp$messageId

L’ID unique du message

amqp$timestamp

L’horodatage du message, en nombre de millisecondes depuis l’époque

amqp$type

Le type du message

amqp$userId

L’ID de l’utilisateur

amqp$clusterId

L’ID du cluster AMQP

amqp$routingKey

La clé de routage du message AMQP

amqp$exchange

L’exchange à partir duquel le message AMQP a été reçu