← Back to branch summary

~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/queries.rst

  • Committer: Monty Taylor
  • Date: 2011-02-13 17:26:39 UTC
  • mfrom: (2157.2.2 give-in-to-pkg-config)
  • mto: This revision was merged to the branch mainline in revision 2166.
  • Revision ID: mordred@inaugust.com-20110213172639-nhy7i72sfhoq13ms
Merged in pkg-config fixes.

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
        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.