Uploaded image for project: 'Couchbase Documentation'
  1. Couchbase Documentation
  2. DOC-5873

Durability needs updating in light of ACID

    XMLWordPrintable

Details

    • DOC-2020-S6-Apr05
    • 1

    Description

      "Couchbase Server supports durability for single-document writes only. "

      This statement is confusing people in light of 6.5 ACID

      cc/ Shivani Gupta

      Attachments

        Issue Links

          No reviews matched the request. Check your Options in the drop-down menu of this sections header.

          Activity

            perry Perry Krug created issue -
            shivani.gupta Shivani Gupta made changes -
            Field Original Value New Value
            Fix Version/s Mad Hatter [ 15119 ]
            richard.smedley Richard Smedley made changes -
            Link This issue has to be done after DOC-5910 [ DOC-5910 ]
            amarantha.kulkarni Amarantha Kulkarni (Inactive) made changes -
            Assignee Amarantha Kulkarni [ amarantha.kulkarni ] Tony Hillman [ tony.hillman ]
            amarantha.kulkarni Amarantha Kulkarni (Inactive) made changes -
            Fix Version/s 6.5 Milestone 1 [ 16654 ]
            Fix Version/s Mad Hatter [ 15119 ]
            amarantha.kulkarni Amarantha Kulkarni (Inactive) made changes -
            Component/s concepts [ 12110 ]
            amarantha.kulkarni Amarantha Kulkarni (Inactive) made changes -
            Fix Version/s to-be-triaged [ 16762 ]
            tony.hillman Tony Hillman added a comment -

            I've discussed this with Daniel Owen, and have confirmed that the statement is accurate. So, what might be the alternative phrasing?

            tony.hillman Tony Hillman added a comment - I've discussed this with Daniel Owen, and have confirmed that the statement is accurate. So, what might be the alternative phrasing?
            tony.hillman Tony Hillman made changes -
            Status Open [ 1 ] In Progress [ 3 ]
            tony.hillman Tony Hillman made changes -
            Sprint DOC-2020-S6-Apr05 [ 1012 ]
            tony.hillman Tony Hillman made changes -
            Rank Ranked lower
            simon.dew Simon Dew made changes -
            Sprint DOC-2020-S6-Apr05 [ 1012 ] DOC-2020-S6-Apr05, DOC-2020-S7-Apr19 [ 1012, 1021 ]
            tony.hillman Tony Hillman made changes -
            Sprint DOC-2020-S6-Apr05, DOC-2020-S7-Apr19 [ 1012, 1021 ] DOC-2020-S6-Apr05 [ 1012 ]
            tony.hillman Tony Hillman made changes -
            Sprint DOC-2020-S6-Apr05 [ 1012 ] DOC-2020-S6-Apr05, DOC-2020-S8-May03 [ 1012, 1031 ]
            tony.hillman Tony Hillman made changes -
            Rank Ranked higher
            tony.hillman Tony Hillman made changes -
            Sprint DOC-2020-S6-Apr05, DOC-2020-S8-May03 [ 1012, 1031 ] DOC-2020-S6-Apr05 [ 1012 ]
            tony.hillman Tony Hillman made changes -
            Sprint DOC-2020-S6-Apr05 [ 1012 ] Sprint 3, DOC-2020-S6-Apr05 [ 826, 1012 ]
            tony.hillman Tony Hillman made changes -
            Rank Ranked higher
            brett19 Brett Lawson made changes -
            Story Points 1
            simon.dew Simon Dew made changes -
            Rank Ranked lower
            simon.dew Simon Dew made changes -
            Sprint Sprint 3, DOC-2020-S6-Apr05 [ 826, 1012 ] DOC-2020-S6-Apr05, DOC-2020-S10-May31 [ 1012, 1060 ]
            simon.dew Simon Dew made changes -
            Rank Ranked lower
            tony.hillman Tony Hillman made changes -
            Sprint DOC-2020-S6-Apr05, DOC-2020-S10-May31 [ 1012, 1060 ] DOC-2020-S6-Apr05 [ 1012 ]
            tony.hillman Tony Hillman made changes -
            Sprint DOC-2020-S6-Apr05 [ 1012 ] DOC-2020-S6-Apr05, DOC-2020-S11-Jun14 [ 1012, 1075 ]
            tony.hillman Tony Hillman made changes -
            Rank Ranked higher
            tony.hillman Tony Hillman made changes -
            Sprint DOC-2020-S6-Apr05, DOC-2020-S11-Jun14 [ 1012, 1075 ] DOC-2020-S6-Apr05 [ 1012 ]
            tony.hillman Tony Hillman made changes -
            Sprint DOC-2020-S6-Apr05 [ 1012 ] DOC-2020-S6-Apr05, DOC-2020-S12-Jun28 [ 1012, 1091 ]
            tony.hillman Tony Hillman made changes -
            Rank Ranked higher
            tony.hillman Tony Hillman made changes -
            Sprint DOC-2020-S6-Apr05, DOC-2020-S12-Jun28 [ 1012, 1091 ] DOC-2020-S6-Apr05 [ 1012 ]
            tony.hillman Tony Hillman made changes -
            Sprint DOC-2020-S6-Apr05 [ 1012 ] DOC-2020-S6-Apr05, DOC-2020-S13-Jul12 [ 1012, 1115 ]
            tony.hillman Tony Hillman made changes -
            Rank Ranked higher
            tony.hillman Tony Hillman made changes -
            Sprint DOC-2020-S6-Apr05, DOC-2020-S13-Jul12 [ 1012, 1115 ] DOC-2020-S6-Apr05 [ 1012 ]
            tony.hillman Tony Hillman made changes -
            Sprint DOC-2020-S6-Apr05 [ 1012 ] DOC-2020-S6-Apr05, DOC-2020-S14-Jul26 [ 1012, 1127 ]
            tony.hillman Tony Hillman made changes -
            Rank Ranked higher
            tony.hillman Tony Hillman made changes -
            Sprint DOC-2020-S6-Apr05, DOC-2020-S14-Jul26 [ 1012, 1127 ] DOC-2020-S6-Apr05 [ 1012 ]
            tony.hillman Tony Hillman made changes -
            Rank Ranked lower
            perry Perry Krug added a comment -

            This issue here is that on other pages we say that Couchbase supports "multi-document" ACID transactions (D=durability) and then on this specific page, we say that Couchbase only supports single-document durability.  From the eyes of the user, that's the inconsistency (no pun intended) and in reality isn't true anymore because we do support durability for multiple documents at the same time.  

             

            The concepts of "durability" (replication and disk persistence), as well as "consistency" need to be updated throughout the docs to tie everything together.

            perry Perry Krug added a comment - This issue here is that on other pages we say that Couchbase supports "multi-document" ACID transactions (D=durability) and then on this specific page, we say that Couchbase only supports single-document durability.  From the eyes of the user, that's the inconsistency (no pun intended) and in reality isn't true anymore because we do support durability for multiple documents at the same time.     The concepts of "durability" (replication and disk persistence), as well as "consistency" need to be updated throughout the docs to tie everything together.

            Daniel Owen this is coming up again and again. Why do you think the current statement is accurate and advised Tony to keep it as is?

            shivani.gupta Shivani Gupta added a comment - Daniel Owen  this is coming up again and again. Why do you think the current statement is accurate and advised Tony to keep it as is?

            Chin Hong copying you as this comes up a lot.

            shivani.gupta Shivani Gupta added a comment - Chin Hong  copying you as this comes up a lot.
            chinhong Chin Hong added a comment -

            Tony Hillman Chip Owen this statement NOT correct and we need to fix it ASAP so that we don't confuse users as we support ACID transactions for multiple documents starting with CB 6.5.

            chinhong Chin Hong added a comment - Tony Hillman Chip Owen this statement NOT correct and we need to fix it ASAP so that we don't confuse users as we support ACID transactions for multiple documents starting with CB 6.5.
            owend Daniel Owen added a comment -

            Have discussed with Dave Rigby. We are supportive of the removal of the statement "Couchbase Server supports durability for single-document writes only. "
            I beleive Tony Hillman is out this week therefore assigning to Ray Offiah

            owend Daniel Owen added a comment - Have discussed with Dave Rigby . We are supportive of the removal of the statement "Couchbase Server supports durability for single-document writes only. " I beleive Tony Hillman is out this week therefore assigning to Ray Offiah
            owend Daniel Owen made changes -
            Assignee Tony Hillman [ tony.hillman ] Ray Offiah [ JIRAUSER26039 ]
            owend Daniel Owen added a comment - - edited

            Had a quick chat with Tony Hillman and wanted to clarify for all those on the ticket.

            "Couchbase Server supports durability for single-document writes only. "

            is a correct statement (assuming durability is the synonymous for synchronous write)

            And in fact it would be incorrect to state

            "Couchbase Server supports durability for multi-document writes. "

            However from a development perspective we understand that including the statement "Couchbase Server supports durability for single-document writes only. " can be confusing to the developer. As from this the developer might assume we do not support transactions, when in fact we do as described https://docs.couchbase.com/server/current/learn/data/transactions.html

            owend Daniel Owen added a comment - - edited Had a quick chat with Tony Hillman and wanted to clarify for all those on the ticket. "Couchbase Server supports durability for single-document writes only. " is a correct statement (assuming durability is the synonymous for synchronous write) And in fact it would be incorrect to state "Couchbase Server supports durability for multi-document writes. " However from a development perspective we understand that including the statement "Couchbase Server supports durability for single-document writes only. " can be confusing to the developer. As from this the developer might assume we do not support transactions, when in fact we do as described https://docs.couchbase.com/server/current/learn/data/transactions.html

            "Couchbase Server supports durability for single-document writes only. "

            The above is a redundant statement which only causes harm rather than do any good. Please remove it.

            shivani.gupta Shivani Gupta added a comment - "Couchbase Server supports durability for single-document writes only. " The above is a redundant statement which only causes harm rather than do any good. Please remove it.
            ray.offiah Ray Offiah added a comment - - edited https://github.com/couchbase/docs-server/pull/2233 https://github.com/couchbase/docs-server/pull/2244 https://github.com/couchbase/docs-server/pull/2245
            ray.offiah Ray Offiah made changes -
            Resolution Fixed [ 1 ]
            Status In Progress [ 3 ] Resolved [ 5 ]
            ray.offiah Ray Offiah made changes -
            Status Resolved [ 5 ] Closed [ 6 ]

            People

              ray.offiah Ray Offiah
              perry Perry Krug
              Votes:
              0 Vote for this issue
              Watchers:
              7 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved:

                Gerrit Reviews

                  There are no open Gerrit changes

                  PagerDuty