/ Notes About Checkin 718ead55

Ticket [de3403bf5ae] describes a three-step algorithm for determining column names, here repeated and expanded:

  1. If there is an AS clause, then always use the right-hand side of the AS as the column name. No exceptions.
  1. If the expression is a reference to a column of a table in the FROM clause, then use that column as the name of the result set column. If the connection is configured with PRAGMA full_column_names=ON setting, then the result-set column name is "TABLE.COLUMN". Otherwise if the connection is configured with PRAGMA short_column_names=ON then the result-set column name is just "COLUMN". Skip this step if the connection is configured with both PRAGMA short_column_names=OFF and PRAGMA full_column_names=OFF.
  1. Use the text of the expression as it appears in the SELECT statement as the column name. So if the expression is "a+b" then the result-set column name will be "a+b".

The default column-name configuration is

When computing the names of columns is a subquery in the FROM clause, the default column-name configuration is always used, regardless of how the connection is otherwise configured.

The above is how column names where computed beginning with check-in [be0e24a0293f31b8] until now. This check-in introduces one very simple change:

Formerly, the default column-name configuration would be used to compute the names of FROM-clause subqueries regardless of the application-defined setting.

Steps (1) and (3) above are always used when computing column names. This check-in and the PRAGMAs only affect step (2). There are three possibilities for step (2):

  1. Use a name of the form "COLUMN"
  2. Use a name of the form "TABLE.COLUMN"
  3. Skip step (2) entirely.

The following table shows how the PRAGMAs affect step (2):


short_column_names Step (2) for result-set columns Step (2) for the column names of FROM-clause subqueries
ON Don't care B A

This check-in changes the bahavior of the square in the lower right (the light blue box) from "A" to "C". Since the default column-name configuration shown in in middle row is used by 99.9% of all applications, this should should have minimal impact. Indeed, all rows other than the middle row are deprecated, so applications should not be using any rows other than the middle row anyhow.