[DERBY-4401] Document USING clause in joins

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 10.6.1.0
• Fix Version/s: 10.6.1.0
• Component/s: Documentation
• Assignee: Knut Anders Hatlen
• Reporter: Knut Anders Hatlen
• Created: 08/Oct/09 14:20
• Updated: 30/Apr/10 11:45
• Resolved: 26/Apr/10 08:22

Description

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.

Issue Links

• blocks: DERBY-4370 Implement JOIN ... USING syntax