MySQL joins: ON vs. USING vs. Theta-style

What is the difference between the following three syntaxes?

SELECT * FROM film JOIN film_actor ON (film.film_id = film_actor.film_id)
SELECT * FROM film JOIN film_actor USING (film_id)
SELECT * FROM film, film_actor WHERE film.film_id = film_actor.film_id

The difference is mostly syntactic sugar, but with a couple interesting notes.

To put names, the first two are called “ANSI-style” while the third is called “Theta-style”.

Theta style

On the FROM clause, tables are listed as if with Cartesian products, and the WHERE clause specifies how the join should take place.

This is considered to be the “old” style. It is somewhat confusing to read. Consider the following query:

SELECT * FROM film, film_actor WHERE film.film_id = film_actor.film_id AND actor_id = 17 AND film.length > 120

The above lists films over 120 minutes in length, in which actor #17 plays. Never mind the results; what about the query? Being just one part of the WHERE clause, a one out of three elements in the AND expression, the join equation gets lost. It is difficult to find and isolate the terms which make for table joins as opposed to terms which filter out rows. In the above example it is still relatively easy to point out. How about a query with 5 tables and a 20 terms WHERE clause?

ANSI style: ON

With JOINON, one separates the join terms from the filtering terms. Rewriting the previous example:

SELECT * FROM film JOIN film_actor ON (film.film_id = film_actor.film_id) WHERE actor_id = 17 AND film.length > 120

It is quite clear now what belongs to what.

Note: the parenthesis are not strictly required in the ON clause. I personally like to use them: it makes for an even greater distinction between query parts. SQL syntax is such a mess!

ANSI style: USING

Is the special case where we join tables on columns of the same name, we can make a shortcut and use USING:

SELECT * FROM film JOIN film_actor USING (film_id) WHERE actor_id = 17 AND film.length > 120

This time the parenthesis are required (I’m not sure why the difference on that part).

This is mainly a nicety, less words to type, and a resulting prettified query. But also note a couple differences:

USING vs. ON

The following is valid:

SELECT film.title, film_id FROM film JOIN film_actor USING (film_id) WHERE actor_id = 17 AND film.length > 120;

But the following is not:

SELECT film.title, film_id FROM film JOIN film_actor ON (film.film_id = film_actor.film_id) WHERE actor_id = 17 AND film.length > 120;
ERROR 1052 (23000): Column 'film_id' in field list is ambiguous

Since USING “knows” the film_id column is shared between both tables, it doesn’t mind if we ask it without specifying an exact table. It would be the same value anyway!

ON is not as smart and requires further clarifications: which table exactly do you want?

And the above is actually the result of this interesting phenomena: when using USING, the column only appears once in the result set:

SELECT * FROM film JOIN film_actor USING (film_id) WHERE actor_id = 17 AND film.length > 120 LIMIT 1\G
*************************** 1. row ***************************
             film_id: 96
               title: BREAKING HOME
         description: A Beautiful Display of a Secret Agent And a Monkey who must Battle a Sumo Wrestler in An Abandoned Mine Shaft
        release_year: 2006
         language_id: 1
original_language_id: NULL
     rental_duration: 4
         rental_rate: 2.99
              length: 169
    replacement_cost: 21.99
              rating: PG-13
    special_features: Trailers,Commentaries
         last_update: 2006-02-15 05:03:42
            actor_id: 17
         last_update: 2006-02-15 05:05:03

But joining on ON, we get this column twice:

SELECT * FROM film JOIN film_actor ON film.film_id = film_actor.film_id WHERE actor_id = 17 AND film.length > 120 LIMIT 1\G
*************************** 1. row ***************************
             film_id: 96
               title: BREAKING HOME
         description: A Beautiful Display of a Secret Agent And a Monkey who must Battle a Sumo Wrestler in An Abandoned Mine Shaft
        release_year: 2006
         language_id: 1
original_language_id: NULL
     rental_duration: 4
         rental_rate: 2.99
              length: 169
    replacement_cost: 21.99
              rating: PG-13
    special_features: Trailers,Commentaries
         last_update: 2006-02-15 05:03:42
            actor_id: 17
             film_id: 96
         last_update: 2006-02-15 05:05:03

Behind the scenes

The news is that MySQL treats all in the exact same way. With the kind help of EXPLAIN EXTENDED, we see that:

EXPLAIN EXTENDED SELECT film.title, film_id FROM film JOIN film_actor USING (film_id) WHERE actor_id = 17 AND film.length > 120\G
*************************** 1. row ***************************
...
2 rows in set, 1 warning (0.00 sec)

root@mysql-5.1.51> SHOW WARNINGS\G
*************************** 1. row ***************************
  Level: Note
   Code: 1003
Message: select `sakila`.`film`.`title` AS `title`,`sakila`.`film`.`film_id` AS `film_id` 
         from `sakila`.`film` join `sakila`.`film_actor` 
         where (
                 (`sakila`.`film`.`film_id` = `sakila`.`film_actor`.`film_id`) 
                 and (`sakila`.`film_actor`.`actor_id` = 17) 
                 and (`sakila`.`film`.`length` > 120)
               )

All queries are translated internally to theta-style.

This post only discusses inner joins. With outer joins the situation is somewhat different. Read this post for more insight.

16 thoughts on “MySQL joins: ON vs. USING vs. Theta-style

  1. Perhaps you forgot the special NATURAL JOIN which is kind of like USING , but with different semantics about which columns are returned from the query.

  2. Great post! It begs the question, which syntax do you prefer?

    Personally, I strongly prefer ANSI-style over Theta-style because I find it much less error prone and more readable.

    As for USING vs. ON, I prefer ON. I find USING to be overly prescriptive in terms of column naming. Unless you never use self-referencing foreign keys or multiple foreign keys from a child table to the same parent table, then there will be cases where you need to use ON instead of USING.

    I’m not sure if you are advertising the “SELECT *” differences and the ability to omit the table alias as benefits of USING, but I do not see those as advantages. I try to avoid “SELECT *” as much as possible, especially when selecting from more than one table. And I also believe in always including the table alias for all columns in the SELECT clause when a join is involved. That way I protect myself from errors if I add a column in the future that would make a column reference in an existing query ambiguous.

  3. @Ike,
    When I started programming with SQL, I wan’t even aware of the “JOIN … ON” syntax. I was just doing Theta style.

    When I came to learn of the “JOIN … ON” I realized it was a much cleaner syntax. I now use it regularly.

    I don’t use USING much. Not because I don’t like to, but because you need to use a very specific naming convention to be able to use it. When possible, I typically use it.

    There can be, at rare times, an optimization issue, where you want to explicitly use the film.film_id in some equation.

    I’m not advertising the SELECT * and rarely use it. I use it here because it simplifies the query and allows me to focus on other parts. Also, it is an essential case for the ince/twice issue discussed.

  4. Hi!

    Nice write-up.

    My guess is, JOIN syntax will never cease to be an object of discussion. It’s clear to me there will always be a need to specify very specific join conditions, and we can’t get by with only “smart” join syntax like NATURAL and USING. (By “smart” I mean a declarative syntax, that does not require explicit comparisons and logical operators)

    That said, I think that at least 80% of all join syntax conforms to foreign keys, probably more in typical normalized OLTP data base schemas. So I think there certainly is room for a “smart” join syntax.

    Desite SQL being a declarative language, no RDBMS that I know of allows you to reference a foreign key constraint as a proxy for the join condition. (I wrote about it in detail here http://rpbouman.blogspot.nl/2006/04/intelligent-sql-join-syntax_09.html).

    TL;DR: if we have a table film_actor and it has a foreign key fk_film_actor_film to film, why can’t we write:

    FROM film RELATE fk_film_actor_film

    or if you insist on keeping table names, why can’t we write:

    FROM film JOIN film_actor VIA fk_film_actor_film

    The “named columns join” (aka the USING-syntax) looks like a step in the right direction, but it has a number of drawbacks that make me shun it, always.

    Shlomi pointed out that it requires a very strict naming convention. That’s true, but I’d argue that no naming convention is ever strict enough to make it generically usable. Simple example from the sakila database: consider film and language. There are 2 foreign keys between them, both from film pointing to language. Since the foreign key columns in film must have unique names, we can only use the named columns join for one of them. So if we’d have a query that gets both the language and the original language for a film, we’d get:

    FROM film
    JOIN language USING (language_id)
    LEFT JOIN language original_language ON film.original_language_id = original_language.language_id

    So, basically we’re doing the exact same thing in two different ways.

    Personally I prefer a uniform syntax over a more compact one, but I admit that this is ultimately a matter of taste. Some may have good reasons to prefer it the other way around.

    There is a more serious problem with the named columns join. It’s ok if you know how it works, but it’s not clear from the syntax itself. Consider this query:

    select address.address_id, customer.address_id, staff.address_id, store.address_id
    from address
    left join customer using(address_id)
    left join staff using (address_id)
    left join store using (address_id)

    what does this query mean? The first join is clear, take the rows from address and outer join to customer.

    But then, how should we join staff? does the second USING (address_id) refer to the shared column between customer and staff, or between address and staff? Same problem for the join to store.

    Don’t blame yourself if you didn’t know the answer, the syntax is such that it is unclear what is joined to what.

    My conclusion is that column names are simply not a good basis for defining declarative join syntax.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.