diff options
| author | Lorry Tar Creator <lorry-tar-importer@baserock.org> | 2015-02-17 17:25:57 +0000 |
|---|---|---|
| committer | <> | 2015-03-17 16:26:24 +0000 |
| commit | 780b92ada9afcf1d58085a83a0b9e6bc982203d1 (patch) | |
| tree | 598f8b9fa431b228d29897e798de4ac0c1d3d970 /docs/programmer_reference/sequence.html | |
| parent | 7a2660ba9cc2dc03a69ddfcfd95369395cc87444 (diff) | |
| download | berkeleydb-master.tar.gz | |
Diffstat (limited to 'docs/programmer_reference/sequence.html')
| -rw-r--r-- | docs/programmer_reference/sequence.html | 78 |
1 files changed, 44 insertions, 34 deletions
diff --git a/docs/programmer_reference/sequence.html b/docs/programmer_reference/sequence.html index ed259fb4..8d51075d 100644 --- a/docs/programmer_reference/sequence.html +++ b/docs/programmer_reference/sequence.html @@ -14,13 +14,11 @@ <body> <div xmlns="" class="navheader"> <div class="libver"> - <p>Library Version 11.2.5.3</p> + <p>Library Version 12.1.6.1</p> </div> <table width="100%" summary="Navigation header"> <tr> - <th colspan="3" align="center">Chapter 20. - Sequences - </th> + <th colspan="3" align="center">Chapter 20. Sequences </th> </tr> <tr> <td width="20%" align="left"><a accesskey="p" href="txn_limits.html">Prev</a> </td> @@ -34,36 +32,50 @@ <div class="titlepage"> <div> <div> - <h2 class="title"><a id="sequence"></a>Chapter 20. - Sequences - </h2> + <h2 class="title"><a id="sequence"></a>Chapter 20. Sequences </h2> </div> </div> </div> - <p>Sequences provide an arbitrary number of persistent objects that return -an increasing or decreasing sequence of integers. Opening a sequence -handle associates it with a record in a database. The handle can -maintain a cache of values from the database so that a database update -is not needed as the application allocates a value.</p> - <p>A sequence is stored as a record pair in a database. The database may -be of any type, but may not have been configured to support duplicate -data items. The sequence is referenced by the key used when the -sequence is created, therefore the key must be compatible with the -underlying access method. If the database stores fixed-length records, -the record size must be at least 64 bytes long.</p> - <p>Since a sequence handle is opened using a database handle, the use of -transactions with the sequence must follow how the database handle was -opened. In other words, if the database handle was opened within a -transaction, operations on the sequence handle must use transactions. -Of course, if sequences are cached, not all operations will actually -trigger a transaction.</p> - <p>For the highest concurrency, caching should be used and the -<a href="../api_reference/C/envset_flags.html#envset_flags_DB_AUTO_COMMIT" class="olink">DB_AUTO_COMMIT</a> and <a href="../api_reference/C/envset_flags.html#envset_flags_DB_TXN_NOSYNC" class="olink">DB_TXN_NOSYNC</a> flags should be -specified to the <a href="../api_reference/C/seqget.html" class="olink">DB_SEQUENCE->get()</a> method call. If the allocation of the -sequence value must be part of a transaction, and rolled back if the -transaction aborts, then no caching should be specified and the -transaction handle must be passed to the <a href="../api_reference/C/seqget.html" class="olink">DB_SEQUENCE->get()</a> method.</p> - <p>For more information on the operations supported by the sequence handle, see the <a href="../api_reference/C/seq.html#seqlist" class="olink">Sequences and Related Methods</a> section in the <em class="citetitle">Berkeley DB C API Reference Guide.</em> </p> + <p> + Sequences provide an arbitrary number of persistent objects + that return an increasing or decreasing sequence of integers. + Opening a sequence handle associates it with a record in a + database. The handle can maintain a cache of values from the + database so that a database update is not needed as the + application allocates a value. + </p> + <p> + A sequence is stored as a record pair in a database. The + database may be of any type, but may not have been configured + to support duplicate data items. The sequence is referenced by + the key used when the sequence is created, therefore the key + must be compatible with the underlying access method. If the + database stores fixed-length records, the record size must be + at least 64 bytes long. + </p> + <p> + Since a sequence handle is opened using a database handle, + the use of transactions with the sequence must follow how the + database handle was opened. In other words, if the database + handle was opened within a transaction, operations on the + sequence handle must use transactions. Of course, if sequences + are cached, not all operations will actually trigger a + transaction. + </p> + <p> + For the highest concurrency, caching should be used and the + <a href="../api_reference/C/envset_flags.html#envset_flags_DB_AUTO_COMMIT" class="olink">DB_AUTO_COMMIT</a> and <a href="../api_reference/C/envset_flags.html#envset_flags_DB_TXN_NOSYNC" class="olink">DB_TXN_NOSYNC</a> flags should be specified + to the <a href="../api_reference/C/seqget.html" class="olink">DB_SEQUENCE->get()</a> method call. If the allocation of the sequence + value must be part of a transaction, and rolled back if the + transaction aborts, then no caching should be specified and + the transaction handle must be passed to the <a href="../api_reference/C/seqget.html" class="olink">DB_SEQUENCE->get()</a> + method. + </p> + <p> + For more information on the operations supported by the + sequence handle, see the <a href="../api_reference/C/seq.html#seqlist" class="olink">Sequences and Related Methods</a> + section in the <em class="citetitle">Berkeley DB C API Reference Guide.</em> + </p> </div> <div class="navfooter"> <hr /> @@ -78,9 +90,7 @@ transaction handle must be passed to the <a href="../api_reference/C/seqget.html <td width="20%" align="center"> <a accesskey="h" href="index.html">Home</a> </td> - <td width="40%" align="right" valign="top"> Chapter 21. - Berkeley DB Extensions: Tcl - </td> + <td width="40%" align="right" valign="top"> Chapter 21. Berkeley DB Extensions: Tcl </td> </tr> </table> </div> |