From: jplyon Date: Mon, 19 Jan 2004 05:09:24 +0000 (+0000) Subject: documented pragma foreign_key_list(). X-Git-Tag: version-3.6.10~4875 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=a8fbdd36f8ddaa1169038f873cc3af20ae93db19;p=thirdparty%2Fsqlite.git documented pragma foreign_key_list(). updated docs for removed behavior: Oracle join syntax and temp indexes. (CVS 1193) FossilOrigin-Name: 06bd5070966b59730a91bc4d384df4f8abaadd37 --- diff --git a/manifest b/manifest index f701d2dca8..48be08e0f8 100644 --- a/manifest +++ b/manifest @@ -1,5 +1,5 @@ -C comment\stypos\s(CVS\s1192) -D 2004-01-19T04:57:53 +C documented\spragma\sforeign_key_list().\nupdated\sdocs\sfor\sremoved\sbehavior:\sOracle\sjoin\ssyntax\sand\stemp\sindexes.\s(CVS\s1193) +D 2004-01-19T05:09:24 F Makefile.in 0515ff9218ad8d5a8f6220f0494b8ef94c67013b F Makefile.linux-gcc b86a99c493a5bfb402d1d9178dcdc4bd4b32f906 F README f1de682fbbd94899d50aca13d387d1b3fd3be2dd @@ -170,7 +170,7 @@ F www/faq.tcl 88d3b95d9cd8e374772daa3a646c4d107e7f3e9b F www/fileformat.tcl 56f77e435a6306b337b20b416e3b89500ba2d029 F www/formatchng.tcl ca6cc1cb1bef9bc36f0619049d3c95e749bc6983 F www/index.tcl 2e864feb4a0021ca6fda9d1828d8752c48338361 -F www/lang.tcl 5f39bbda1ba38a28f18f97bd98c81f40355393b2 +F www/lang.tcl 6cb027f5483aa831752daeef0c946111af303713 F www/mingw.tcl d96b451568c5d28545fefe0c80bee3431c73f69c F www/nulls.tcl 38117d24afb81efd079b59723b985a6d654cc2e8 F www/omitted.tcl 11037a1b557bd01405092d93dfa08898a4c26cd7 @@ -180,7 +180,7 @@ F www/speed.tcl 2f6b1155b99d39adb185f900456d1d592c4832b3 F www/sqlite.tcl 3c83b08cf9f18aa2d69453ff441a36c40e431604 F www/tclsqlite.tcl b9271d44dcf147a93c98f8ecf28c927307abd6da F www/vdbe.tcl 9b9095d4495f37697fd1935d10e14c6015e80aa1 -P de35c36ed7657903ebba0c5acff75baaa0453f87 -R 5016fe6fe6275299a3b767a9f0895d11 +P 7972ee321974380a59fef752f5643d98f9df38cc +R cb442edf5997c7f37f655ba9608aaa0e U jplyon -Z 7f28b1cde29695a0721906aa558a015b +Z dfc89bf5caf4326de0e59dc76182fec8 diff --git a/manifest.uuid b/manifest.uuid index 6d7390872b..faf816b4ec 100644 --- a/manifest.uuid +++ b/manifest.uuid @@ -1 +1 @@ -7972ee321974380a59fef752f5643d98f9df38cc \ No newline at end of file +06bd5070966b59730a91bc4d384df4f8abaadd37 \ No newline at end of file diff --git a/www/lang.tcl b/www/lang.tcl index 7321db114e..e472d6e34b 100644 --- a/www/lang.tcl +++ b/www/lang.tcl @@ -1,7 +1,7 @@ # # Run this Tcl script to generate the sqlite.html file. # -set rcsid {$Id: lang.tcl,v 1.65 2003/07/20 01:16:48 drh Exp $} +set rcsid {$Id: lang.tcl,v 1.66 2004/01/19 05:09:24 jplyon Exp $} puts { @@ -205,8 +205,8 @@ are committed at the conclusion of the command.

Transactions can be started manually using the BEGIN -command. Such transactions usually persist until the next -COMMIT or ROLLBACK command. But a transaction will also +command. Such transactions usually persist until the next +COMMIT or ROLLBACK command. But a transaction will also ROLLBACK if the database is closed or if an error occurs and the ROLLBACK conflict resolution algorithm is specified. See the documention on the ON CONFLICT @@ -236,18 +236,18 @@ Syntax {comment} { | puts {

Comments aren't SQL commands, but can occur in SQL queries. They are -treated as whitespace by the parser. They can begin anywhere whitespace +treated as whitespace by the parser. They can begin anywhere whitespace can be found, including inside expressions that span multiple lines.

SQL comments only extend to the end of the current line.

-

C comments can span any number of lines. If there is no terminating -delimiter, they extend to the end of the input. This is not treated as -an error. A new SQL statement can begin on a line after a multiline -comment ends. C comments can be embedded anywhere whitespace can occur, +

C comments can span any number of lines. If there is no terminating +delimiter, they extend to the end of the input. This is not treated as +an error. A new SQL statement can begin on a line after a multiline +comment ends. C comments can be embedded anywhere whitespace can occur, including inside expressions, and in the middle of other SQL statements. -C comments do not nest. SQL comments inside a C comment will be ignored. +C comments do not nest. SQL comments inside a C comment will be ignored.

} @@ -295,7 +295,7 @@ puts "\"[Operator \\.]\".

" Section {CREATE INDEX} createindex Syntax {sql-statement} { -CREATE [TEMP | TEMPORARY] [UNIQUE] INDEX +CREATE [UNIQUE] INDEX ON [ .] ( [, ]* ) [ ON CONFLICT ] } {column-name} { @@ -336,8 +336,8 @@ all CREATE INDEX statements are read from the sqlite_master table and used to regenerate SQLite's internal representation of the index layout.

-

Non-temporary indexes cannot be added on tables in attached -databases. They are removed with the DROP INDEX +

Indexes cannot be added on tables in attached databases. +Indexes are removed with the DROP INDEX command.

} @@ -364,8 +364,8 @@ UNIQUE [ ] | CHECK ( ) [ ] | DEFAULT } {constraint} { -PRIMARY KEY ( [, ]* ) [ ]| -UNIQUE ( [, ]* ) [ ] | +PRIMARY KEY ( ) [ ] | +UNIQUE ( ) [ ] | CHECK ( ) [ ] } {conflict-clause} { ON CONFLICT @@ -681,6 +681,11 @@ CREATE INDEX statement. The index named is completely removed from the disk. The only way to recover the index is to reenter the appropriate CREATE INDEX command. Non-temporary indexes on tables in an attached database cannot be dropped.

+ +

The DROP INDEX statement does not reduce the size of the database +file. Empty space in the database is retained for later INSERTs. To +remove free space in the database, use the VACUUM +command.

} @@ -697,6 +702,11 @@ table name. It is completely removed from the database schema and the disk file. The table can not be recovered. All indices associated with the table are also deleted. Non-temporary tables in an attached database cannot be dropped.

+ +

The DROP TABLE statement does not reduce the size of the database +file. Empty space in the database is retained for later INSERTs. To +remove free space in the database, use the VACUUM +command.

} @@ -761,12 +771,12 @@ Syntax {expr} { . . | | ( | STAR ) | - (+) | ISNULL | NOTNULL | [NOT] BETWEEN AND | [NOT] IN ( ) | [NOT] IN ( ) | + [NOT] IN [ .] | ( ) | CASE [] LP WHEN THEN RPPLUS [ELSE ] END } {like-op} { @@ -855,15 +865,6 @@ column can be used, except that you cannot change the value of a row key in an UPDATE or INSERT statement. "SELECT * ..." does not return the row key.

-

SQLite supports a minimal Oracle8 outer join behavior. A column -expression of the form "column" or "table.column" can be followed by -the special "(+)" operator. If the table of the column expression -is the second or subsequent table in a join, then that table becomes -the left table in a LEFT OUTER JOIN. The expression that uses that -table becomes part of the ON clause for the join. -The exact Oracle8 behavior is not implemented, but it is possible to -construct queries that will work correctly for both SQLite and Oracle8.

-

SELECT statements can appear in expressions as either the right-hand operand of the IN operator or as a scalar quantity. In both cases, the SELECT should have only a single column in its @@ -1318,16 +1319,29 @@ is returned it is as an integer.


PRAGMA default_temp_store = DEFAULT; (0)
PRAGMA default_temp_store = MEMORY; (2)
PRAGMA default_temp_store = FILE; (1)

-

Query or change the setting of the "temp_store" flag stored in - the database. When temp_store is DEFAULT (0), the compile-time default - is used for the temporary database. When temp_store is MEMORY (2), an - in-memory database is used. When temp_store is FILE (1), a temporary - database file on disk will be used. Note that it is possible for - the library compile-time options to override this setting. Once - the temporary database is in use, its location cannot be changed.

+

Query or change the setting of the "temp_store" flag stored in + the database. When temp_store is DEFAULT (0), the compile-time value + of the symbol TEMP_STORE is used for the temporary database. + When temp_store is MEMORY (2), an in-memory database is used. + When temp_store is FILE (1), a temporary database file on disk will be used. + Once the temporary database is in use, its location cannot be changed. + It is possible for the library compile-time symbol TEMP_STORE to override + this setting. The following table summarizes this:

+ + + + + + + + + + + +
TEMP_STOREtemp_storetemp database location
0anyfile
10file
11file
12memory
20memory
21file
22memory
3anymemory

This pragma changes the temp_store mode persistently. Once changed, - the mode stays as set even if the database is closed and reopened. The + the mode stays set even if the database is closed and reopened. The temp_store pragma does the same thing but only applies the setting to the current session.

@@ -1342,6 +1356,12 @@ is returned it is as an integer.

determine the number and names of the columns that would have been in the result set had the set not been empty.

+

  • PRAGMA foreign_key_list(table-name);

    +

    For each foreign key that references a column in the argument + table, invoke the callback function with information about that + foreign key. The callback function will be invoked once for each + column in each foreign key.

    • +

  • PRAGMA full_column_names = ON; (1)
    PRAGMA full_column_names = OFF;     (0)

    The column names reported in an SQLite callback are normally just @@ -1615,12 +1635,21 @@ In version 1.0 of SQLite, the VACUUM command would invoke

    VACUUM became a no-op when the GDBM backend was removed from SQLITE in version 2.0.0. -VACUUM was reimplimented in version 2.8.1. It now cleans +VACUUM was reimplimented in version 2.8.1. +The index or table name argument is now ignored. +

    + +

    When an object (table, index, or trigger) is dropped from the +database, it leaves behind empty space. This makes the database +file larger than it needs to be, but can speed up inserts. In time +inserts and deletes can leave the database file structure fragmented, +which slows down disk access to the database contents. + +The VACUUM command cleans the database by copying its contents to a temporary database file and -reloading the original database file from the copy. This will eliminate -free pages, align table data to be contiguous, and otherwise clean up -the database file structure. The index or table name argument is now -ignored.

    +reloading the original database file from the copy. This eliminates +free pages, aligns table data to be contiguous, and otherwise cleans +up the database file structure.

    This command will fail if there is an active transaction. This command has no effect on an in-memory database.

    @@ -1630,7 +1659,7 @@ command has no effect on an in-memory database.

    Section {SQLite keywords} keywords puts { -

    The following keywords are used by SQLite. Most are either reserved +

    The following keywords are used by SQLite. Most are either reserved words in SQL-92 or were listed as potential reserved words. Those which aren't are shown in italics. Not all of these words are actually used by SQLite. Keywords are not reserved in SQLite. Any keyword can be used