7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
8 Contributors: |
9 --> |
9 --> |
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept xml:lang="en" id="GUID-120163D6-2E49-5D91-A746-2C8C4C944461"><title>DBMS incremental operations overview</title><prolog><metadata><keywords/></metadata></prolog><conbody><section><title>Purpose</title> <p>Allows long-running database operations to be performed in steps, so that a user program can remain responsive to other events.</p> </section> <section><title>Description</title> <p>The API has two key concepts: database incremental operations, and DML statement incremental execution. </p> <p><b>Database incremental operations</b> </p> <p>This allows long-running database operations—table alteration and discard, database compaction and recovery, index creation and discard, DDL (SQL schema update) statement execution—to be performed in incremental steps.</p> <p>While an incremental operation is in progress, the database cannot be used for any other operations such as opening tables or preparing views. Beginning an incremental operation also requires that no rowsets are open on the database, and that no data manipulation transactions are pending a commit. </p> <p>If no explicit transaction has been started by the database, an automatic transaction is begun when any incremental operation is started and is committed when complete, or rolled back if the operation fails or is abandoned prior to completion.</p> <p>Database incremental operations are provided by <xref href="GUID-B07C2FDC-357E-31F8-B67E-0A252EEF2187.dita"><apiname>RDbIncremental</apiname></xref>.</p> <p><b>DML statement incremental execution</b> </p> <p>A class is provided, similar to <xref href="GUID-B07C2FDC-357E-31F8-B67E-0A252EEF2187.dita"><apiname>RDbIncremental</apiname></xref>, for performing DML (SQL data update) statements incrementally. This is <xref href="GUID-B9D43EA2-F1F1-3830-A16A-F73F06C2BB3D.dita"><apiname>RDbUpdate</apiname></xref>.</p> </section> <section><title>See also</title> <p><xref href="GUID-EACA05F0-7291-535C-82BC-16DF3AAA417E.dita">Interface to DBMS databases overview</xref> </p> </section> </conbody></concept> |
12 <concept id="GUID-120163D6-2E49-5D91-A746-2C8C4C944461" xml:lang="en"><title>Incremental |
|
13 operations overview</title><shortdesc>Allows long-running database operations to be performed in steps, |
|
14 so that a user program can remain responsive to other events.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
15 <section id="GUID-10CCFE47-6AC1-4756-BB03-FE07F589DE1F"><title>Description</title> <p>The |
|
16 API has two key concepts: database incremental operations, and DML statement |
|
17 incremental execution. </p> <p><b>Database incremental operations</b> </p> <p>This |
|
18 allows long-running database operations—table alteration and discard, database |
|
19 compaction and recovery, index creation and discard, DDL (SQL schema update) |
|
20 statement execution—to be performed in incremental steps.</p> <p>While an |
|
21 incremental operation is in progress, the database cannot be used for any |
|
22 other operations such as opening tables or preparing views. Beginning an incremental |
|
23 operation also requires that no rowsets are open on the database, and that |
|
24 no data manipulation transactions are pending a commit. </p> <p>If no explicit |
|
25 transaction has been started by the database, an automatic transaction is |
|
26 begun when any incremental operation is started and is committed when complete, |
|
27 or rolled back if the operation fails or is abandoned prior to completion.</p> <p>Database |
|
28 incremental operations are provided by <xref href="GUID-B07C2FDC-357E-31F8-B67E-0A252EEF2187.dita"><apiname>RDbIncremental</apiname></xref>.</p> <p><b>DML |
|
29 statement incremental execution</b> </p> <p>A class is provided, similar to <xref href="GUID-B07C2FDC-357E-31F8-B67E-0A252EEF2187.dita"><apiname>RDbIncremental</apiname></xref>, |
|
30 for performing DML (SQL data update) statements incrementally. This is <xref href="GUID-B9D43EA2-F1F1-3830-A16A-F73F06C2BB3D.dita"><apiname>RDbUpdate</apiname></xref>.</p> </section> |
|
31 </conbody></concept> |