SELECT Statements
A SELECT statement can consist of the following basic clauses.
- SELECT
- INTO
- FROM
- JOIN
- WHERE
- GROUP BY
- HAVING
- UNION
- ORDER BY
- LIMIT
SELECT Syntax
The following syntax diagram outlines the syntax supported by the adapter:
SELECT {
[ TOP <numeric_literal> | DISTINCT ]
{
*
| {
<expression> [ [ AS ] <column_reference> ]
| { <table_name> | <correlation_name> } .*
} [ , ... ]
}
[ INTO csv:// [ filename= ] <file_path> [ ;delimiter=tab ] ]
{
FROM <table_reference> [ [ AS ] <identifier> ]
}
[ WHERE <search_condition> ]
[ UNION [ ALL ] <select_statement> ]
[
ORDER BY
<column_reference> [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ]
]
[
LIMIT <expression>
[
{ OFFSET | , }
<expression>
]
]
}
<expression> ::=
| <column_reference>
| @ <parameter>
| ?
| COUNT( * | { [ DISTINCT ] <expression> } )
| { AVG | MAX | MIN | SUM | COUNT } ( <expression> )
| NULLIF ( <expression> , <expression> )
| COALESCE ( <expression> , ... )
| CASE <expression>
WHEN { <expression> | <search_condition> } THEN { <expression> | NULL } [ ... ]
[ ELSE { <expression> | NULL } ]
END
| <literal>
| <sql_function>
<search_condition> ::=
{
<expression> { = | < | <= | > | >= | <> | != | OR | AND } [ <expression> ]
} [ { AND | OR } ... ]
Examples
- Return all columns:
SELECT * FROM ProductCategory
- Rename a column:
SELECT "CategoryName" AS MY_CategoryName FROM ProductCategory
- Cast a column's data as a different data type:
SELECT CAST(AnnualRevenue AS VARCHAR) AS Str_AnnualRevenue FROM ProductCategory
- Search data:
SELECT * FROM ProductCategory WHERE CategoryOwner = 'Bob'
- The APIs support the following operators in the WHERE clause: =, <, <=, >, >=, <>, !=, OR, AND.
SELECT * FROM ProductCategory WHERE CategoryOwner = 'Bob';
- Return the number of items matching the query criteria:
SELECT COUNT(*) AS MyCount FROM ProductCategory
- Return the number of unique items matching the query criteria:
SELECT COUNT(DISTINCT CategoryName) FROM ProductCategory
- Return the unique items matching the query criteria:
SELECT DISTINCT CategoryName FROM ProductCategory
- Sort a result set in ascending order:
SELECT CategoryId, CategoryName FROM ProductCategory ORDER BY CategoryName ASC