← Back to branch summary

~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/dynamic.rst

  • Committer: Brian Aker
  • Date: 2010-12-16 20:06:09 UTC
  • Revision ID: brian@tangent.org-20101216200609-xigmi0vbldradofi
I've mentioned this to Paul. Once we have the bits in for session around
thread he will go in and fix what he needs to fix. 

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/dynamic.rst
1
1
Dynamic SQL
2
2
===========
3
3
 
4
 
Dynamic SQL enables you to build SQL statements dynamically at runtime. It can be generated within an application or from the system tables and then executed against the database to manipulate the data. You can create more general purpose, flexible applications by using dynamic SQL since the full text of a SQL statement may be unknown at the time of compilation.
5
 
 
6
 
Dynamic SQL allows you to execute DDL statements (and other SQL statements) that are not supported in purely static SQL programs.
7
 
 
8
4
In Drizzle you can use the EXECUTE command along with :doc:'user defined variables <variables>'
9
5
to create SQL in a dynamic manner on the server. An exmaple of this is:
10
6
 
11
 
.. code-block:: mysql
12
 
 
13
 
        SET @var= "SELECT 1";
14
 
        EXECUTE @var;
 
7
SET @var= "SELECT 1";
 
8
EXECUTE @var;
15
9
 
16
10
You can also omit the variable and just insert the SQL directly:
17
11
 
18
 
.. code-block:: mysql
19
 
 
20
 
        EXECUTE "SELECT 1";
21
 
 
22
 
By adding WITH NO RETURN you can have EXECUTE and no errors will be
 
12
EXECUTE "SELECT 1";
 
13
 
 
14
By adding WITH NO RETURN you can have EXECUTE then no errors will be
23
15
generated and no data will be returned by the execution of the statement.
24
16
 
25
17
If you want to launch the query in a separate session, you can do that with
26
18
the following:
27
 
 
28
 
.. code-block:: mysql
29
 
 
30
 
        EXECUTE "SELECT 1" CONCURRENT;
 
19
EXECUTE "SELECT 1" CONCURRENT;
 
20
 
 
21
By adding "WAIT" to a CONCURRENT execute, you can have the session that
 
22
called EXECUTE wait till the child is finished before returning.
31
23
 
32
24
The query will run in a new session and will execute as the user that
33
25
launched it. It can be killed via KILL and the system limit on total number
34
26
of sessions will be enforced.
35
 
 
36
 
.. todo::
37
 
 
38
 
   EXECUTE executes the statements inside an explicit transaction.