Difference between revisions of "SQL SELECT"
Yvonnemilne (Talk | contribs) |
Yvonnemilne (Talk | contribs) |
||
Line 376: | Line 376: | ||
[[Category:Commands|SELECT]] | [[Category:Commands|SELECT]] | ||
[[Category:SQL|SELECT]] | [[Category:SQL|SELECT]] | ||
+ | [[Category:Objects]] | ||
+ | [[Category:Objects Commands]] |
Revision as of 14:51, 14 December 2009
Purpose
Retrieves data from one or more tables or views
Syntax
SELECT [ALL | DISTINCT | DISTINCTROW | TOP <expN> [PERCENT]] * | [<t_alias>|<"t_alias">.]<column>|<"column"> | <constant> | <function> | <aggregate> [[ AS] <c_alias>] [,...] [, *]
FROM {OJ <"t_alias"> <table> [LEFT | RIGHT | FULL] OUTER JOIN <"t_alias"> <table2> ON <exp> = <exp>} | [FORCE] [<database>!]<table> | <view> [AS <t_alias> [, ...]]
[INNER JOIN | OUTER JOIN | LEFT [OUTER] JOIN | RIGHT [OUTER] JOIN (<nested select>) | [<database>!]<table2>
ON [<database>!]<table>.<column> = [<database>!]<table2>.<column> | CROSS JOIN | FULL [OUTER] JOIN [<database>!]<table2>]
[WHERE <condition>]
[GROUP BY <expr> | <column> | <number> [ASC | DESC] [,...]]
[HAVING <condition>]
[ORDER BY <expr> |<column> | <number> [ASC | DESC] [,...]]
[FOR UPDATE]
[INTO [,...] | ARRAY <array-name> | CURSOR <cursor-name> [NOFILTER | READWRITE] | NAME | OBJECT <CONSOLE | STDOUT | object-ref> | JSON <CONSOLE | STDOUT | filename> | HTML <CONSOLE | STDOUT | html filename> | XML <CONSOLE | STDOUT | xml filename> | DBF | TABLE <table-name> [DATABASE <database> [NAME <long table-name>]]
| SAVE AS [<database>!]<table-name> | XML <xml filename> [FORMAT <RECITAL | ADO>]] | TO FILE <text filename> [DELIMITED] | PRINTER [PROMPT] | SCREEN
[PREFERENCE <preference>] [NOCONSOLE] [PLAIN] [NOWAIT]
[UNION [ALL] <nested select>]
See Also
AGGREGATES, CREATE CURSOR, CREATE TABLE, EXPLAIN, FETCH, INSERT, OPERATORS, PREDICATES, PSEUDO COLUMNS, SET SQLROWID, SET TCACHE, SET XMLFORMAT, SYSTEM TABLES, UPDATE
Description
The SELECT statement is used to retrieve data from one or more tables or views. It creates a logical table from other tables. A logical table is a temporary collection of data that satisfy conditions specified in a SELECT statement. To select data you must be the owner of the table or have already been granted SELECT privileges.
If no destination is specified for the results (INTO, SAVE AS or TO), then they are saved to a cursor, a temporary table with the alias name 'cursor'. This table is automatically opened in the next empty workarea and a BROWSE is issued.
Keywords | Description |
---|---|
ALL | Returns all the selected rows including duplicates. This is the default. |
DISTINCT | Only returns one copy of each set of duplicate rows selected. Duplicate rows are those with matching values of each expression in the select list. |
DISTINCTROW | Only returns one copy of each set of duplicate rows selected. Duplicate rows are those with matching values of the entire row, not just the columns in the select list. |
TOP <expN> [PERCENT] | The <expN> defines the TOP number of rows to be returned from the specified select statement. The optional PERCENT keyword causes the <expN> to be used as the percentage of rows to be returned. |
* | Selects all columns from all tables listed in the FROM clause. |
t_alias | Provides a different name for the table. Other references to table name throughout the query must refer to this alias name. The t_alias can be enclosed in double-quotes if required. |
column | The name of the column you are selecting. The column can be enclosed in double-quotes if required. |
AS | Used to specify an alternative name for a table or a column |
c_alias | Provides a different name for the column and column heading. |
constant | This specifies a constant expression. See expressions for more information. |
function | A 4GL function that may or may not include column names. See the function references for more information. |
aggregate | An aggregate expression uses an aggregate function to summarize selected data from a table. |
FORCE | The FORCE keyword specifies that the tables are joined in the order in which they are listed in the SELECT statement. |
database | The name of the database to which the table belongs. Databases in Recital are implemented as directories containing files that correspond to the tables and associated files in the database. Operating System file protection can be applied individually to the files for added security. The directory is a sub-directory of the Recital data directory. The environment variable / symbol DB_DATADIR points to the current Recital data directory and can be queried using the GETENV() function. Files from other directories can be added to the database using the ADD TABLE command or via the database catalog and SET AUTOCATALOG functionality. The '!' character must be included between the database name and the table name. |
table | The table name from which to select data. When data is being selected from encrypted tables, the table reference can include the three-part encryption key, enclosed in angled brackets, appended to the table name. The SET ENCRYPTION command allows a default encryption key to be defined. If the key is not included in the <table>, this default key will be used. If the default key is not the correct key for the table, an error will be given. If no default key is active, a dialog box will be displayed in Recital Terminal Developer to allow the user to enter the key. |
view | The name of a view defined with the CREATE VIEW statement |
{OJ … OUTER JOIN …} | Specifies the join type as left outer. This will return all the rows from the left table and matching rows from the right or a null row if no match is found. |
{OJ … LEFT OUTER JOIN …} | Specifies the join type as left outer. This will return all the rows from the left table and matching rows from the right or a null row if no match is found. |
{OJ … RIGHT OUTER JOIN …} | Specifies the join type as right outer. This will return all the rows from the right table and the matching rows from the left or a null row if no match is found. |
{OJ … FULL OUTER JOIN …} | Specifies the join type as full outer. This will return all the rows from both tables. |
<table2> | The name of the joined table in the query. When data is being selected from encrypted tables, the table2 reference can include the three-part encryption key, enclosed in angled brackets, appended to the table name. The SET ENCRYPTION command allows a default encryption key to be defined. If the key is not included in the <table2>, this default key will be used. If the default key is not the correct key for the table, an error will be given. If no default key is active, a dialog box will be displayed in Recital Terminal Developer to allow the user to enter the key. |
ON <exp> = <exp> | The expression used to JOIN the two tables together. |
INNER JOIN | Specifies the join type as inner. An inner join names the linking criterion used to find matches between the two tables. Only rows for which a match is found in both tables are returned. |
OUTER JOIN | Specifies the join type as outer. An outer join takes two tables and displays all the rows from one table and the matching rows from the other or a null row if no matches are found. |
LEFT [OUTER] JOIN | Specifies the join type as left outer. This will return all the rows from the left table and matching rows from the right or a null row if no match is found. |
RIGHT [OUTER] JOIN | Specifies the join type as right outer. This will return all the rows from the right table and the matching rows from the left or a null row if no match is found. |
CROSS JOIN | Specifies the join type as cross join. This will return a Cartesian product: all combination of rows. |
FULL [OUTER] JOIN | Specifies the join type as full outer. This will return all the rows from both tables. |
<nested select> | An additional SELECT statement. |
ON <table>.column = <table2>.column | The expression used to JOIN the two tables together. |
WHERE | This restricts the rows selected to those for which the condition is TRUE. If this clause is omitted than all rows are returned. The condition can be a SELECT sub-query. |
GROUP BY | Groups the selected rows based on the value of an expression, the column name or number for each row and returns a single row of summary information for each group. The default, ASC, returns the data in ascending order, specifying DESC returns the data in descending order. |
HAVING | Restricts the groups of rows returned to those groups for which the specified condition is TRUE. If you omit this clause then all rows are returned. |
ORDER BY | Orders rows based on the value returned by an expression, a column name or number. The default, ASC, returns the data in ascending order, specifying DESC returns the data in descending order. |
FOR UPDATE | Locks the selected rows. |
INTO <data variable> [,…] | Specify data variables to receive the data retrieved by the select statement. The select statement can only be a singleton select. The data variables will be created if they do not exist and overwritten if they do. |
INTO ARRAY <array-name> | Specify an array to receive the data retrieved by the select statement. The array is automatically created, so need not be pre-defined. |
INTO CURSOR <cursor-name> | Specify a cursor to receive the data retrieved by the select statement. This saves the data into a temporary table in a workarea. The Recital/4GL SELECT command can be used to select the workarea for processing with Recital/4GL commands. The NOFILTER keyword is used for creating a cursor that can be used in subsequent queries. The READWRITE keyword is used to create a temporary modifiable cursor. |
TABLE <table-name> | Specify a table to receive the data retrieved by the select statement. The table's database and a long name can optionally be specified using the DATABASE and NAME clauses respectively. |
SAVE AS <table-name> | Specify a table name to be created and populated with the result of the select statement. |
ADO>] | ADO>. |
TO FILE [DELIMITED] | Saves the results to the specified text file. If the DELIMITED keyword is included, the results are written out in delimited format. |
TO PRINTER | Sends the results to the currently defined printer. The optional PROMPT keyword is used to display a print dialog before printing. |
TO SCREEN | Sends the results to the main screen or active window. |
PREFERENCE | The PREFERENCE clause is used to save BROWSE window preferences. |
NOCONSOLE | PRINTER) also being displayed on the screen. |
PLAIN | The PLAIN keyword is used to disable the display of column headings. |
NOWAIT | The NOWAIT keyword is used to continue program execution immediately after BROWSE window display instead of when the BROWSE window is closed. |
UNION [ALL] | Combines the end result of the main SELECT statement with a secondary <nested select> SELECT statement. The ALL keyword specifies that duplicates should be retained. |
Example
// Select all rows, including duplicates, from an encrypted table EXEC SQL SELECT ALL * FROM enctab<key_1,key2,key_3>; // Select "last_name" column from rows with a unique "last_name" EXEC SQL SELECT DISTINCT last_name FROM customer; // Select "last_name" column from unique rows EXEC SQL SELECT DISTINCTROW last_name FROM customer; // Select first 10 rows EXEC SQL SELECT TOP 10 * FROM accounts; // Select first 50% of the rows EXEC SQL SELECT TOP 50 PERCENT * FROM accounts; // Crystal Reports / ODBC style JOINS: LEFT OUTER, RIGHT OUTER, FULL OUTER EXEC SQL SELECT customer.account_no, customer.last_name, accounts.ord_value FROM {OJ "customer" customer LEFT OUTER JOIN "accounts" accounts ON customer.account_no = accounts.account_no}; EXEC SQL SELECT customer.account_no, customer.last_name, accounts.ord_value FROM {OJ "customer" customer RIGHT OUTER JOIN "accounts" accounts ON customer.account_no = accounts.account_no}; EXEC SQL SELECT customer.account_no, customer.last_name, accounts.ord_value FROM {OJ "customer" customer FULL OUTER JOIN "accounts" accounts ON customer.account_no = accounts.account_no}; // JOINS: INNER, LEFT OUTER, RIGHT OUTER, CROSS, FULL EXEC SQL SELECT customer.account_no, customer.last_name, accounts.ord_value FROM customer INNER JOIN accounts ON customer.account_no = accounts.account_no; EXEC SQL SELECT customer.account_no, customer.last_name, accounts.ord_value FROM customer LEFT OUTER JOIN accounts ON customer.account_no = accounts.account_no; EXEC SQL SELECT customer.account_no, customer.last_name, accounts.ord_value FROM customer RIGHT OUTER JOIN accounts ON customer.account_no = accounts.account_no; EXEC SQL SELECT customer.account_no, customer.last_name, accounts.ord_value FROM customer CROSS JOIN accounts; EXEC SQL SELECT customer.account_no, customer.last_name, accounts.ord_value FROM customer FULL OUTER JOIN accounts; // JOINs with nested SELECTs EXEC SQL SELECT contactname FROM customers WHERE customerid IN (SELECT customerid FROM orders WHERE orderdate = {07/19/1996}); EXEC SQL SELECT shipname FROM orders,customers WHERE orders.customerid = customers.customerid AND employeeid = (SELECT max(employeeid) FROM orders WHERE orderdate = {07/19/1996}) order by shipname; EXEC SQL SELECT contactname FROM customers WHERE ctod("07/19/1996") > ANY (SELECT orderdate FROM orders WHERE customers.customerid = orders.customerid); EXEC SQL SELECT orders.customerid FROM orders WHERE 30 > ALL (SELECT sum(quantity) FROM order_details WHERE orders.orderid = order_details.orderid); EXEC SQL SELECT orderid,customerid FROM orders as o1 WHERE 2 < (SELECT quantity FROM order_details as i1 WHERE o1.orderid = i1.orderid AND i1.productid = 71); EXEC SQL SELECT lastname FROM employees WHERE exists (SELECT * FROM orders WHERE employees.employeeid = orders.employeeid AND orderdate = CTOD("11/11/1996")) ; EXEC SQL SELECT lastname FROM employees WHERE not exists (SELECT * FROM orders WHERE employees.employeeid = orders.employeeid AND orderdate = CTOD("11/11/1996")) ; EXEC SQL SELECT companyname,(select MAX(orderid) FROM orders as o1 WHERE o1.customerid = c1.customerid) FROM customers as c1; // Multiple JOINs EXEC SQL SELECT customer.account_no, customer.state, state.descript, accounts.ord_value FROM customer RIGHT OUTER JOIN accounts ON customer.account_no = accounts.account_no, customer INNER JOIN state ON customer.state = state.state ORDER BY account_no; // Select account number and order value details for Massachusetts customers EXEC SQL SELECT account_no, ord_value FROM accounts WHERE account_no in (SELECT account_no FROM customer WHERE state = 'MA') ORDER BY account_no; // Select all overdue accounts with 15% commission in sorted "last_name" order. EXEC SQL SELECT last_name, zip, balance, balance*1.15 FROM customer WHERE balance > 0 ORDER BY last_name; // Select total and average balance for all overdue accounts, grouped by "limit" EXEC SQL SELECT SUM(balance), AVG(balance) FROM customer WHERE balance > 0 GROUP BY limit; // Select total and average balance for all overdue accounts, grouped by "limit" with column aliases EXEC SQL SELECT SUM(balance) AS Total, AVG(balance) AS Average FROM customer WHERE balance > 0 GROUP BY limit; // Select total and average balance for all overdue accounts, grouped by "limit" with column aliases // For Massachusetts customers only EXEC SQL SELECT SUM(balance) AS Total, AVG(balance) AS Average FROM customer WHERE balance > 0 GROUP BY limit HAVING state = "MA"; // Save into an array EXEC SQL SELECT SUM(balance) AS Total, AVG(balance) AS Average FROM customer WHERE balance > 0 INTO ARRAY temp; // Create a cursor EXEC SQL SELECT SUM(balance) AS Total, AVG(balance) AS Average FROM customer WHERE balance > 0 INTO CURSOR temp; // Save as a table EXEC SQL SELECT SUM(balance) AS Total, AVG(balance) AS Average FROM customer WHERE balance > 0 INTO TABLE temp DATABASE mydbc; //or EXEC SQL SELECT SUM(balance) AS Total, AVG(balance) AS Average FROM customer WHERE balance > 0 SAVE AS temp; // Save in Microsoft® ActiveX® Data Objects XML format // Any XML files created in the ADO format can be loaded // with the Open method of the ADO Recordset object. EXEC SQL SELECT SUM(balance) AS Total, AVG(balance) AS Average FROM customer WHERE balance > 0 SAVE AS XML temp.xml FORMAT ADO; // In Visual Basic the file can then be loaded: // Set adoPrimaryRS = New Recordset // adoPrimaryRS.Open "temp.xml" // Save in text file format EXEC SQL SELECT SUM(balance) AS Total, AVG(balance) AS Average FROM customer WHERE balance > 0 TO FILE temp.txt; // Select all customer accounts that have an outstanding balance or are based in Massachusetts EXEC SQL SELECT account_no FROM customer WHERE state = 'MA' UNION SELECT account_no FROM accounts WHERE balance > 0 ORDER BY account_no;
Products
Recital Server, Recital