Skip to content

[Doc] "negatively acknowledged cumulatively" ambiguous? #18208

Closed

Description

@startjava

Search before asking

  • I searched in the issues and found nothing similar.

What issue do you find in Pulsar docs?

This website:

https://pulsar.apache.org/docs/concepts-messaging/#negative-acknowledgement

The:

Messages are negatively acknowledged individually or cumulatively, depending on the consumption subscription type.

The inner "opened indispensable cumulatively", does it have this function in pulsar? At least I did not find the corresponding API for this function.

I don't know if there is some ambiguity in the document, or if there is some problem with my understanding.

In addition:

In Exclusive and Failover subscription types, consumers only negatively acknowledge the last message they receive.

In Shared and Key_Shared subscription types, consumers can negatively acknowledge messages individually.

Are these two paragraphs necessary? In fact, it is the feature of four subscription types, namely whether there is one consumer or how many consumers, and it feels like adding these two paragraphs adds complexity to this technical point.

What is your suggestion?

?

Any reference?

No response

Are you willing to submit a PR?

  • I'm willing to submit a PR!

Activity

  1. added
    doc-requiredYour PR changes impact docs and you will update later.
    on Oct 26, 2022
  2. startjava commented on Oct 26, 2022

    @startjava
    Author

    Actually I want to know what situation belongs to "the acknowledged cumulatively"?
    thank you !

  3. zymap commented on Nov 15, 2022

    @zymap
    Member
  4. startjava commented on Nov 15, 2022

    @startjava
    Author

    Do you want this? https://pulsar.apache.org/docs/concepts-messaging#acknowledgement

    YES,i see the doc too .

  5. startjava commented on Nov 16, 2022

    @startjava
    Author

    @momo-jun please see the question

  6. momo-jun commented on Nov 22, 2022

    @momo-jun
    Contributor

    Messages are negatively acknowledged individually or cumulatively, depending on the consumption subscription type.

    • In Exclusive and Failover subscription types, consumers only negatively acknowledge the last message they receive.
    • In Shared and Key_Shared subscription types, consumers can negatively acknowledge messages individually.

    I don't see the ambiguity in this paragraph. It means the negative acknowledgment of messages can be performed either individually (in Shared and Key_Shared subscription types) or cumulatively (Exclusive and Failover subscription types).

    Did this answer your question? @startjava

  7. startjava commented on Nov 22, 2022

    @startjava
    Author

    @momo-jun

    question1:
    why
    (1)individually (in Shared and Key_Shared subscription types)
    (2)cumulatively (Exclusive and Failover subscription types).

    why bottom is error:
    (1)cumulatively (in Shared and Key_Shared subscription types)
    (2)individually (Exclusive and Failover subscription types).

    question2:
    but not have about "negatively acknowledged cumulatively" api,only have "negatively acknowledged individually" api(Consumer.negativeAcknowledeg)

    i have 2 question
    thank you jun !

  8. labuladong commented on Nov 29, 2022

    @labuladong
    Contributor

    You can try negativeAcknowledge in Failover/Exclusive subscription types. All the messages the consumer didn't acknowledge will be redelivered, this behavior could be negatively acknowledged cumulatively. But there do have some discussions about the redelivery behavior on Failover/Exclusive subscription types, see https://lists.apache.org/thread/vdwhg5wrpjc8x41oqwxrsdhx7dmyzt3j

  9. startjava commented on Nov 29, 2022

    @startjava
    Author

    but i don't know what mean "negatively acknowledged cumulatively"。

  10. momo-jun commented on Nov 29, 2022

    @momo-jun
    Contributor

    but i don't know what mean "negatively acknowledged cumulatively"。

    You can understand it as "Cumulative NACK" - the negative acknowledgement is performed cumulatively, that is, consumers only negatively acknowledge the last message they receive.

  11. locked and limited conversation to collaborators on Dec 6, 2022
  12. converted this issue into a discussion #18771 on Dec 6, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    doc-requiredYour PR changes impact docs and you will update later.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions