← Back to branch summary

~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/queries.rst

  • Committer: Brian Aker
  • Date: 2011-02-17 10:09:00 UTC
  • mfrom: (2173.2.1 clean-include-usuage)
  • Revision ID: brian@tangent.org-20110217100900-4tpuxxzdl1sj00sh
Merge Monty for headers.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/queries.rst
1
 
Executing Queries 
 
1
Executing Queries
2
2
=================
3
3
 
4
4
Queries retrieve data from a database based on specific criteria. They
6
6
persistent effects on the database. SELECT simply retrieves data from
7
7
one or more tables, or expressions.
8
8
 
9
 
A query includes a list of columns to be included in a result set; an example of this would be:  ::
10
 
 
11
 
        SELECT * FROM table_1;
12
 
 
13
 
SELECT * FROM is an example of using SELECT with a clause. Other keywords and clauses include:
14
 
 
15
 
* The FROM clause
16
 
* The WHERE clause
17
 
* The GROUP BY clause
18
 
* The HAVING clause
19
 
* The ORDER BY clause
 
 
b'\\ No newline at end of file'
 
9
A query includes a list of columns to be included in a result set; an example of this would be:
 
10
 
 
11
.. code-block:: mysql
 
12
 
 
13
        SELECT * FROM table_name;
 
14
 
 
15
SELECT * FROM is an example of using SELECT with clauses. The select clause specifies the columns you want to retrieve. The from clause specifies the tables to search. 
 
16
 
 
17
Keywords and clauses include:
 
18
 
 
19
.. toctree::
 
20
   :maxdepth: 2
 
21
 
 
22
   where
 
23
   distinct
 
24
   groupby
 
25
   having
 
26
   orderby
 
27
   join
 
28
 
 
29
For example:
 
30
 
 
31
.. code-block:: mysql
 
32
 
 
33
        SELECT first_column_name, second_column_name
 
34
        FROM table_name
 
35
        WHERE first_column_name > 1000;
 
36
 
 
37
The column names that follow the SELECT keyword determine the columns that will be returned in the results. You can select as many column names that you'd like, or you can use a * to select all columns (as shown in the first example above). The order in which they are specified will be reflected in your query results.
 
38
 
 
39
The table name that follows the keyword FROM specifies the table that will be queried to retrieve the desired results.
 
40
 
 
41
The WHERE clause (optional) specifies the data values or rows to be returned or displayed, based on the criteria described after the keyword WHERE.