db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Kim Haase (JIRA)" <j...@apache.org>
Subject [jira] Commented: (DERBY-4401) Document USING clause in joins
Date Mon, 26 Apr 2010 14:25:31 GMT

    [ https://issues.apache.org/jira/browse/DERBY-4401?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12860932#action_12860932
] 

Kim Haase commented on DERBY-4401:
----------------------------------

This is terrific -- thank you, Knut. The new USING clause topic is really clear and well-written.

My only suggestion would be purely cosmetic -- that the ON and USING part of the INNER JOIN
syntax be put on separate lines to match the syntax in the LEFT OUTER JOIN and RIGHT OUTER
JOIN topics (which you cleaned up nicely, I notice).

Kim

> Document USING clause in joins
> ------------------------------
>
>                 Key: DERBY-4401
>                 URL: https://issues.apache.org/jira/browse/DERBY-4401
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.6.0.0
>            Reporter: Knut Anders Hatlen
>            Assignee: Knut Anders Hatlen
>            Priority: Minor
>             Fix For: 10.6.0.0
>
>         Attachments: using.diff, using.zip
>
>
> DERBY-4370 made some of the join operations accept a USING clause. This should be documented
in the reference manual.
> The JOIN operations section talks about "join clause", which should be fine since that
could mean both ON clause and USING clause.
> The sections INNER JOIN operation, LEFT OUTER JOIN operation and RIGHT OUTER JOIN operation
need to be updated with the new syntax. We need to replace
> {
>     ON booleanExpression
> }
> with
> {
>     { ON booleanExpression } |
>     { USING ( Simple-column-Name [ , Simple-column-Name ]* ) }
> }
> Perhaps it would make sense to factor out this part of the syntax into a separate element
JoinSpecification, and explain the meaning of USING there.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


Mime
View raw message