← 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: 2010-10-27 21:00:49 UTC
  • mto: This revision was merged to the branch mainline in revision 1886.
  • Revision ID: brian@tangent.org-20101027210049-zfpgx2cfbrh8maq9
A couple of fixes to documentation.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/queries.rst
1
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
 
        SELECT * FROM table_name;
12
 
 
13
 
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. 
14
 
 
15
 
Keywords and clauses include:
16
 
 
17
 
.. toctree::
18
 
   :maxdepth: 2
19
 
 
20
 
   where
21
 
   distinct
22
 
   groupby
23
 
   having
24
 
   orderby
25
 
   join
26
 
 
27
 
For example, ::
28
 
 
29
 
        SELECT first_column_name, second_column_name
30
 
        FROM table_name
31
 
        WHERE first_column_name > 1000;
32
 
 
33
 
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.
34
 
 
35
 
The table name that follows the keyword FROM specifies the table that will be queried to retrieve the desired results.
36
 
 
37
 
The WHERE clause (optional) specifies the data values or rows to be returned or displayed, based on the criteria described after the keyword WHERE.
 
2
========
 
3
 
 
4
To return from values from Drizzled you most commonly use the SELECT
 
5
command. An example of this would be:
 
6
 
 
7
SELECT * FROM table_1;
 
8
 
 
9