SQL Syntax
From AgileApps Support Wiki
Revision as of 19:02, 17 November 2011 by imported>Aeric (→table_reference)
Here is the syntax for the SQL SELECT statement that the SQL parser recognizes.
- Considerations
-
- SQL syntax is case insensitive.
- Field and table names are case sensitive
- Legend
-
- [ x ] - Optional (one or none)
- [, x ... ] - Optional additional values, in a comma-separated list
- x | y - Choose one. Curly braces are added when needed: { x | y } ...
- CAPITALIZED - SQL Keyword (case insensitive)
- italicized - Value you supply. (Table names and column names are case-sensitive)
SELECT Statement
In a select statement, you designate one more columns separated by commas (or "*" for all columns), plus a table or join to get the data from, and additional options:
- SELECT
- [DISTINCT]
- [(] column_expr [, column_expr ...] [)]
- FROM table_references
- [WHERE where_clause]
- [GROUP BY col_name [ASC|DESC] [, col_name [ASC|DESC] ...]
- [WITH ROLLUP]
- [HAVING where_clause]
- ]
- [ORDER BY col_name [ASC|DESC] [, col_name [ASC|DESC] ...]
- [LIMIT {maximum_rows | offset, maximum_rows} ]
where:
- DISTINCT
- Eliminates duplicate rows from the result set.
- For example: DISTINCT(customer_name, address)
- (Parentheses are optional, but must be matched if present.)
- HAVING
- Is only allowed as part of GROUP BY, for performance reasons. (WHERE does the same thing outside of a GROUP BY clause, only more efficiently.)
- ASC
- Ascending (the default).
- DESC
- Descending.
- maximum_rows
- Maximum number of rows to return.
- offset
- The row to start from. Offset for the first row is zero (0).
- Learn more:: MySQL Select Statement syntax
column_expr
- * | table_alias.* | col_name [ [AS] col_alias ] | expr [AS] col_alias
where:
- col_alias
- Used for the column name in the result set in the SQL Browser, or for the tag name in the REST execSQL resource.
- Required when an expression is specified.
- Can be used as a field name in a group_by_clause or order_by_clause.
- For example:
- SELECT CONCAT(last_name,', ',first_name) AS full_name
- FROM Customer_Contacts ORDER BY full_name;
- SELECT CONCAT(last_name,', ',first_name) AS full_name
table_references
- [(] table_reference [, table_reference ...] [)]
table_reference
tbl_name [[AS] alias] | join_table
join_table
table_reference [INNER | LEFT | RIGHT] JOIN table_references [ON on_clause]
on_clause
on_condition [{AND|OR} on_condition ...]
on_condition
table_alias.column_name IS [NOT] NULL | table_alias.column_name = table_alias.column_name | table_alias.column_name != table_alias.column_name | ( on_clause )
where_clause
An expression that evaluates to true or false for a row. When true, the row is selected. The expression has the form:
- ...
where:
- xxx
- ...
expr
- SQL Function
- | 'string literal'
- | ( expr }
- | [+|-] expr
- Our expression / MySQL simpleExpression:
- | expr + expr
- | expr - expr
- | expr * expr
- | expr / expr
- MySQL expression:
- | expr OR expr
- | expr AND expr
- Our BNF:
- | expr IS [NOT] NULL
- | expr =