Re: [Ietf-message-headers] Updates to registration request for EntityId, Isolation, OData-MaxVersion, and OData-Version

[Mark Nottingham <[e-mail]>]

Hi Chet,

I have to admit I was confused by Ralf's response. The purpose of asking why "Isolation" was chosen instead of "OData-Isolation" was to draw out how this header was potentially generic (i.e., applicable to other things than OData).

Cheers,


> On 19 Dec 2018, at 8:28 am, Chet Ensign <[e-mail]> wrote:
> 
> Hi Mark, 
> 
> Can you advise on the best way to proceed? Should I work with the TC to draft a revised registration request? 
> 
> Thank you, 
> 
> /chet 
> 
> On Fri, Dec 7, 2018 at 10:23 AM Handl, Ralf <[e-mail]> wrote:
> Hi Mark,
> 
> We no longer want to reserve it for single token use and instead want to register five values: read-uncommitted, read-committed, repeatable-read, snapshot, and serializable.
> 
> Thanks
> Ralf
> 
> -----Original Message-----
> From: Mark Nottingham <[e-mail]> 
> Sent: Freitag, 7. Dezember 2018 01:58
> To: Chet Ensign <[e-mail]>
> Cc: [e-mail]; Handl, Ralf <[e-mail]>
> Subject: Re: [Ietf-message-headers] Updates to registration request for EntityId, Isolation, OData-MaxVersion, and OData-Version
> 
> Chet,
> 
> Can you speak to why the request is still for "Isolation", instead of "OData-Isolation"?
> 
> Cheers,
> 
> 
> > On 7 Dec 2018, at 5:05 am, Chet Ensign <[e-mail]> wrote:
> > 
> > This message contains an update to the registration request submitted on August 29 2018 in https://www.ietf.org/mail-archive/web/ietf-message-headers/current/msg00195.html
> > 
> > In response to this request, on August 29, in https://www.ietf.org/mail-archive/web/ietf-message-headers/current/msg00196.html, Ted Hardie wrote: 
> > 
> > ---
> > 
> > I'm a little confused on one point.  The Isolation header states that it was called OData-Isolation in version 4.0, but the linked ABNF document says:
> > 
> > isolation  = [ "OData-" ] "Isolation" ":" OWS "snapshot"
> > 
> > That seems to indicate that both ODate-Isolation and Isolation are expected to be valid for this token.  The ABNF for EntityID is similar:
> > 
> > entityid   = [ "OData-" ] "EntityID" ":" OWS IRI-in-header
> > 
> > Can you clarify the intent here?  Are both expressions of this token expected to continue?
> > 
> > In general, "Isolation" seems to be a very general concept, and the reservation of it, unadorned, for a single token use ("snapshot") is somewhat surprising compared to the more-obviously scoped OData-isolation.  EntityID seems similar board in possible usage outside the OData specification.  
> > 
> > ---
> > 
> > In response, the TC renamed EntityId header to OData-EntityId and added additional values for the Isolation header to align with most database systems. 
> > 
> > 
> > On August 30, in https://www.ietf.org/mail-archive/web/ietf-message-headers/current/msg00197.html, Mark Nottingham wrote: 
> > 
> > --- 
> > 
> > "Applicable protocol" should be "http", I think.
> > 
> > --- 
> > 
> > In response, the TC changed the Applicable protocol to http. 
> > 
> > Below, please find the revised request. I have included the prior values in [ ]s so that all the changes are visible. 
> > 
> > Please let us know if this addresses your comments and if you have any other questions or concerns. 
> > 
> > ---
> > 
> > Open Data (OData) Protocol IANA Header registration request
> > 28-Nov-2018
> > 
> > This documentation contains the information needed for Permanent Registration of the OData specific request headers with IANA as called out in RFC 3864 - Registration Procedures for Message Header Fields.
> > 
> > The OData headers to be registered as Permanent Headers are
> > 
> > OData-EntityId  [WAS EntityID]
> > Isolation
> > OData-MaxVersion
> > OData-Version
> > 
> > The details as required by RFC 3864 for these headers are listed below
> >       
> > 
> > ####
> > Header field name:
> >       OData-EntityId  [WAS EntityID]
> > 
> > Applicable protocol:
> >       http   [WAS OASIS Open Data Protocol (OData)]
> > 
> > Status:
> >       Standard
> > 
> > Author/Change controller:
> >       OASIS
> > 
> > Specification document(s):
> >       
> > OData Version 4.01 Part 1: Protocol - 
> >               http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_HeaderEntityIdODataEntityId       
> > 
> > Related information:
> >       
> >     None  [WAS The EntityId header was named OData-EntityId in OData version 4.0.]
> > 
> > 
> > ####
> > Header field name:
> >       Isolation
> > 
> > Applicable protocol:
> >       http   [WAS OASIS Open Data Protocol (OData)]
> > 
> > Status:
> >       Standard
> > 
> > Author/Change controller:
> >       OASIS
> > 
> > Specification document(s):
> >       
> > OData Version 4.01 Part 1: Protocol - 
> >               http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_HeaderIsolationODataIsolation
> >          
> > Related information:
> >       
> > The Isolation header was named OData-Isolation in OData version 4.0.  The OData Protocol document referenced above defines one valid value, snapshot.  To make this header useful to applications other than OData this registration also defines the values read-uncommitted, read-committed, repeatable-read and serializable.  These correspond to the standard transaction isolation levels exposed by most database systems.   
> >    [WAS The Isolation header was named OData-Isolation in OData version 4.0.]
> > 
> > 
> > ####
> > Header field name:
> >       OData-MaxVersion
> > 
> > Applicable protocol:
> >       http   [WAS OASIS Open Data Protocol (OData)]
> > 
> > Status:
> >       Standard
> > 
> > Author/Change controller:
> >       OASIS
> > 
> > Specification document(s):
> > OData Version 4.01 Part 1: Protocol - 
> >               http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_HeaderODataMaxVersion     
> > 
> > 
> > Related information:
> >       <none>
> > 
> > 
> > 
> > ####
> > Header field name:
> >       OData-Version
> > 
> > Applicable protocol:
> >       http   [WAS OASIS Open Data Protocol (OData)]
> > 
> > Status:
> >       Standard
> > 
> > Author/Change controller:
> >       OASIS
> > 
> > Specification document(s):
> >       OData Version 4.01 Part 1: Protocol - 
> >               http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_HeaderODataVersion        
> > 
> > 
> > Related information:
> >       <none>
> > 
> > 
> > 
> > -- 
> > 
> > /chet 
> > ----------------
> > Chet Ensign
> > Chief Technical Community Steward
> > OASIS: Advancing open standards for the information society
> > http://www.oasis-open.org
> > 
> > Primary: [phone]
> > Mobile: [phone] 
> > _______________________________________________
> > Ietf-message-headers mailing list
> > [e-mail]
> > https://www.ietf.org/mailman/listinfo/ietf-message-headers
> 
> --
> Mark Nottingham   https://www.mnot.net/
> 
> 
> 
> -- 
> 
> /chet 
> ----------------
> Chet Ensign
> Chief Technical Community Steward
> OASIS: Advancing open standards for the information society
> http://www.oasis-open.org
> 
> Primary: [phone]
> Mobile: [phone] 

--
Mark Nottingham   https://www.mnot.net/