← Back to branch summary

~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/queries.rst

  • Committer: Daniel Nichter
  • Date: 2011-10-23 16:01:37 UTC
  • mto: This revision was merged to the branch mainline in revision 2448.
  • Revision ID: daniel@percona.com-20111023160137-7ac3blgz8z4tf8za
Add Administration Getting Started and Logging.  Capitalize SQL clause keywords.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/queries.rst
 
1
Executing Queries
 
2
=================
 
3
 
 
4
Queries retrieve data from a database based on specific criteria. They
 
5
are performed with the declarative SELECT statement, which has no
 
6
persistent effects on the database. SELECT simply retrieves data from
 
7
one or more tables, or expressions.
 
8
 
 
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.