Many hyperlinks are disabled.
Use anonymous login
to enable hyperlinks.
Overview
Comment: | Add documentation for the Application ID. Add a proposed release date for 3.7.17. |
---|---|
Downloads: | Tarball | ZIP archive |
Timelines: | family | ancestors | descendants | both | trunk |
Files: | files | file ages | folders |
SHA1: |
0d800b73f25b31ccf42c092009173412 |
User & Date: | drh 2013-05-03 15:43:03.350 |
Context
2013-05-03
| ||
17:42 | Updates to the application-file-format text. (check-in: 9811172daa user: drh tags: trunk) | |
15:43 | Add documentation for the Application ID. Add a proposed release date for 3.7.17. (check-in: 0d800b73f2 user: drh tags: trunk) | |
2013-05-01
| ||
11:51 | Fix a broken hyperlink in the pragma.html page. (check-in: 76230867ab user: drh tags: trunk) | |
Changes
Changes to pages/changes.in.
︙ | ︙ | |||
37 38 39 40 41 42 43 | <a href="http://www.sqlite.org/src/timeline"> http://www.sqlite.org/src/timeline</a>.</p> } hd_close_aux hd_enable_main 1 } } | | > > > | 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 | <a href="http://www.sqlite.org/src/timeline"> http://www.sqlite.org/src/timeline</a>.</p> } hd_close_aux hd_enable_main 1 } } chng {2013-05-22 (3.7.17)} { <li>Add support for [memory-mapped I/O]. <li>Add the [sqlite3_strglob()] convenience interface. <li>Assigned the integer at offset 68 in the [database header] as the [Application ID] and added the [PRAGMA application_id] command to query and set it. <li>Report rollback recovery in the [error log] as SQLITE_NOTICE_RECOVER_ROLLBACK. Change the error log code for WAL recover from SQLITE_OK to SQLITE_NOTICE_RECOVER_WAL. <li>Report the risky uses of [unlinked database files] and [database filename aliasing] as SQLITE_WARNING messages in the [error log]. <li>Added the [SQLITE_TRACE_SIZE_LIMIT] compile-time option. <li>Increase the default value of [SQLITE_MAX_SCHEMA_RETRY] to 50 and make sure |
︙ | ︙ | |||
67 68 69 70 71 72 73 74 75 76 77 78 79 80 | omit the filename suffix, and an appropriate architecture-dependent suffix (".so", ".dylib", or ".dll") will be added automatically. </ol> <li>Added many new loadable extensions to the source tree, including amatch, closure, fuzzer, ieee754, nextchar, regexp, spellfix, and wholenumber. See header comments on each extension source file for further information about what that extension does. <li>Added the [fts3tokenize virtual table] to the [full-text search] logic. <li>Query planner enhancement: Use the transitive property of constraints to move constraints into the outer loops of a join whenever possible, thereby reducing the amount of work that needs to occur in inner loops. <li>Enhance the [fts4aux] virtual table so that a TEMP fts4aux table can reference an [FTS4] table in main database. <li>Discontinue the use of posix_fallocate() on unix, as it does not work on all | > > | 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 | omit the filename suffix, and an appropriate architecture-dependent suffix (".so", ".dylib", or ".dll") will be added automatically. </ol> <li>Added many new loadable extensions to the source tree, including amatch, closure, fuzzer, ieee754, nextchar, regexp, spellfix, and wholenumber. See header comments on each extension source file for further information about what that extension does. <li>Enhance [FTS3] to avoid using excess stack space when there are a huge number of terms on the right-hand side of the MATCH operator. <li>Added the [fts3tokenize virtual table] to the [full-text search] logic. <li>Query planner enhancement: Use the transitive property of constraints to move constraints into the outer loops of a join whenever possible, thereby reducing the amount of work that needs to occur in inner loops. <li>Enhance the [fts4aux] virtual table so that a TEMP fts4aux table can reference an [FTS4] table in main database. <li>Discontinue the use of posix_fallocate() on unix, as it does not work on all |
︙ | ︙ |
Changes to pages/fileformat2.in.
︙ | ︙ | |||
132 133 134 135 136 137 138 | <tr><td valign=top align=center>56<td valign=top align=center>4<td align=left> The database text encoding. A value of 1 means UTF-8. A value of 2 means UTF-16le. A value of 3 means UTF-16be. <tr><td valign=top align=center>60<td valign=top align=center>4<td align=left> The "user version" as read and set by the [user_version pragma]. <tr><td valign=top align=center>64<td valign=top align=center>4<td align=left> True (non-zero) for incremental-vacuum mode. False (zero) otherwise. | | > > | 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 | <tr><td valign=top align=center>56<td valign=top align=center>4<td align=left> The database text encoding. A value of 1 means UTF-8. A value of 2 means UTF-16le. A value of 3 means UTF-16be. <tr><td valign=top align=center>60<td valign=top align=center>4<td align=left> The "user version" as read and set by the [user_version pragma]. <tr><td valign=top align=center>64<td valign=top align=center>4<td align=left> True (non-zero) for incremental-vacuum mode. False (zero) otherwise. <tr><td valign=top align=center>68<td valign=top align=center>4<td align=left> The "Application ID" set by [PRAGMA application_id]. <tr><td valign=top align=center>72<td valign=top align=center>20<td align=left> Reserved for expansion. Must be zero. <tr><td valign=top align=center>92<td valign=top align=center>4<td align=left> The [version-valid-for number]. <tr><td valign=top align=center>96<td valign=top align=center>4<td align=left> [SQLITE_VERSION_NUMBER] </table></center> |
︙ | ︙ | |||
336 337 338 339 340 341 342 343 344 | No other values are allowed.</p> <h4>1.2.14 User version number</h4> <p>^The 4-byte big-endian integer at offset 60 is the user version which is set and queried by the [user_version pragma]. The user version is not used by SQLite.</p> <tcl>hd_fragment validfor {version-valid-for number}</tcl> | > > > > > > > > > > > > > > | | 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 | No other values are allowed.</p> <h4>1.2.14 User version number</h4> <p>^The 4-byte big-endian integer at offset 60 is the user version which is set and queried by the [user_version pragma]. The user version is not used by SQLite.</p> <tcl>hd_fragment appid {Application ID}</tcl> <h4>1.2.15 Application ID</h4> <p>^The 4-byte big-endian integer at offset 68 is an "Application ID" that can be set by the [PRAGMA application_id] command in order to identify the database as belonging to or associated with a particular application. The application ID is intended for database files used as an [application file-format]. The application ID can be used by utilities such as [http://www.darwinsys.com/file/ | file(1)] can determine the specific file type rather than just reporting "SQLite3 Database". A list assigned application IDs can be seen by consulting the [http://www.sqlite.org/src/artifact?ci=trunk&filename=magic.txt|magic.txt] file in the SQLite source repository.</p> <tcl>hd_fragment validfor {version-valid-for number}</tcl> <h4>1.2.16 Write library version number and version-valid-for number</h4> <p>^The 4-byte big-endian integer at offset 96 stores the [SQLITE_VERSION_NUMBER] value for the SQLite library that most recently modified the database file. ^The 4-byte big-endian integer at offset 92 is the value of the [change counter] when the version number was stored. The integer at offset 92 indicates which transaction the version number is valid for and is sometimes called the |
︙ | ︙ |
Changes to pages/pragma.in.
︙ | ︙ | |||
115 116 117 118 119 120 121 | <p>^A pragma may have an optional database name before the pragma name. ^The database name is the name of an [ATTACH]-ed database or it can be "main" or "temp" for the main and the TEMP databases. ^If the optional database name is omitted, "main" is assumed. ^In some pragmas, the database name is meaningless and is simply ignored.</p> | > > > > > > > > > > > > > > > > | | 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 | <p>^A pragma may have an optional database name before the pragma name. ^The database name is the name of an [ATTACH]-ed database or it can be "main" or "temp" for the main and the TEMP databases. ^If the optional database name is omitted, "main" is assumed. ^In some pragmas, the database name is meaningless and is simply ignored.</p> <tcl>Pragma {application_id} { <p><b>PRAGMA application_id; <br>PRAGMA application_id = </b><i>integer </i><b>;</b> <p> ^The application_id PRAGMA is used to query or set the 32-bit unsigned big-endian "Application ID" integer located at offset 68 into the [database header]. Applications that use SQLite as their [application file-format] should set the Application ID integer to a unique integer so that utilities such as [http://www.darwinsys.com/file/ | file(1)] can determine the specific file type rather than just reporting "SQLite3 Database". A list assigned application IDs can be seen by consulting the [http://www.sqlite.org/src/artifact?ci=trunk&filename=magic.txt |magic.txt] file in the SQLite source repository. } Pragma {automatic_index} { <p>^(<b>PRAGMA automatic_index; <br>PRAGMA automatic_index = </b><i>boolean</i><b>;</b></p> <p>Query, set, or clear the [automatic indexing] capability.)^ <p>^[Automatic indexing] is enabled by default. } |
︙ | ︙ |