← Back to branch summary

~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/join.rst

  • Committer: Brian Aker
  • Date: 2011-01-12 06:45:23 UTC
  • mto: (2073.1.4 catalogs)
  • mto: This revision was merged to the branch mainline in revision 2080.
  • Revision ID: brian@tangent.org-20110112064523-rqhptaqbph22qmj1
Remove custom error.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/join.rst
6
6
Queries can access multiple tables at once, or access the same table in such a way that multiple rows of the table are being processed at the same time. For instance, in order to list all the 'interest' records together with the location of the associated city. To do this, it's necessary to compare the city column of each row of the 'Interests" table with the name column of all rows in the cities table, and select the pairs of rows where these values match. As such, a JOIN statement involves combining records from two tables by using values common to each. 
7
7
 
8
8
Take the "Interests" table:
9
 
 
10
 
+---------+--------------+--------------+-------------+----------+
11
 
|Id       |DateAdded     |InterestType  |Name         | userID   |
12
 
+=========+==============+==============+=============+==========+
13
 
| 1       |2011-01-02    | Sport        |45           |2         |
14
 
+---------+--------------+--------------+-------------+----------+
15
 
| 2       |2011-01-02    | Art          |10           |4         |
16
 
+---------+--------------+--------------+-------------+----------+
17
 
| 3       |2011-01-02    | Music        |25           |1         |
18
 
+---------+--------------+--------------+-------------+----------+
19
 
| 4       |2011-01-02    | Food         |125          |1         |
20
 
+---------+--------------+--------------+-------------+----------+
21
 
| 5       |2011-01-03    | Music        |40           |2         |
22
 
+---------+--------------+--------------+-------------+----------+
23
 
| 6       |2011-01-03    | Food         |20           |3         |
 
9
 
 
10
+---------+--------------+--------------+-------------+----------+
 
11
|Id       |DateAdded     |InterestType  |Name         | userID   |
 
12
+=========+==============+==============+=============+==========+
 
13
| 1       |2011-01-02    | Sport        |45           |2         |
 
14
+---------+--------------+--------------+-------------+----------+
 
15
| 2       |2011-01-02    | Art          |10           |4         |
 
16
+---------+--------------+--------------+-------------+----------+
 
17
| 3       |2011-01-02    | Music        |25           |1         |
 
18
+---------+--------------+--------------+-------------+----------+
 
19
| 4       |2011-01-02    | Food         |125          |1         |
 
20
+---------+--------------+--------------+-------------+----------+
 
21
| 5       |2011-01-03    | Music        |40           |2         |
 
22
+---------+--------------+--------------+-------------+----------+
 
23
| 6       |2011-01-03    | Food         |20           |3         |
24
24
+---------+--------------+--------------+-------------+----------+
25
25
 
26
26
 
49
49
    * JOIN: Return rows when there is at least one match in both tables
50
50
    * LEFT JOIN: Return all rows from the left table, even if there are no matches in the right table
51
51
    * RIGHT JOIN: Return all rows from the right table, even if there are no matches in the left table
52
 
    * CROSS JOIN: Return rows when there is a match in one of the tables
53
 
 
54
 
.. note::
55
 
 
56
 
   Implicit cartesian products of the form ``SELECT * FROM t1, t2`` without a 
57
 
   ``WHERE`` or ``ON`` condition will error.  If such behaviour is intended
58
 
   please use ``SELECT * FROM t1 CROSS JOIN t2``.
59
 
 
60
 
.. todo::
61
 
 
62
 
   how joins are executed. i.e. nested loop join.
 
52
    * FULL JOIN: Return rows when there is a match in one of the tables