X-Git-Url: http://git.kpe.io/?p=clsql.git;a=blobdiff_plain;f=doc%2FTODO;h=cb7fe98bf48dec80a0a0eb0a2c23c02ee48d4f25;hp=c55c54bf59ee33ac822531068e515f19642c203c;hb=cb683851a0af33e88b7c4995435dc0cf226f6cba;hpb=2051cd1a64edc450319626f8ff1417c36e08a063 diff --git a/doc/TODO b/doc/TODO index c55c54b..cb7fe98 100644 --- a/doc/TODO +++ b/doc/TODO @@ -1,32 +1,72 @@ DOCUMENTATION TO DO LIST -1. Variances from CommonSQL +1. Variances from CommonSQL (Ideally, this will be extremely minimal) + + - The SQL syntax state functions are macros in CLSQL. + + - CLSQL starts with in transaction AUTOCOMMIT mode. To begin a transaction, + START-TRANSACTION has to be called. - - Ideally, this will be extremely minimal 2. Underdocumented CommonSQL features: - Retrieval immediate - - SQL operators: ||, SUBSTR, EXCEPT, INTERSECT, UNION ... + - SQL operators: ||, SUBSTR, MINUS, INTERSECT, UNION, NVL -2. CLSQL extensions to CommonSQL - - RESULT-TYPES, FIELD-NAMES keywords for SELECT and QUERY +3. CLSQL extensions to CommonSQL - New types such as wall-time, boolean, and bigint - SQL operators: group-by, limit, not-null, ==, is, having, the, uplike, - sql-view-class (just from a quick scan of operations.lisp) + sql-view-class, coalesce, except (just from a quick scan of + operations.lisp) - - FDDL: list-views, view-exists-p, list-indexes, list-table-indexes, - index-exists-p, create-sequence, drop-sequence, list-sequences, - sequence-exists-p, sequence-next, sequence-last, set-sequence-position + - FDML: FOR-EACH-ROW, prepared statements and large object support. - OODML: *db-auto-sync* -4. Documenting lower level, non-CommonSQL functions like connection - pools and database-query-result-set. Some of this is already done. + - SELECT: additional keyword arguments accepted include :LIMIT, :OFFSET, + :INNER-JOIN and :ON. + + - SQL-RECORDING-P: also accepts :both and :either values for the TYPE + parameter. + + - DEF-VIEW-CLASS: DB-CONSTRAINTS, DB-TYPE and VOID-VALUE slot options. + + - transactions: START-TRANSACTION and IN-TRANSACTION-P. + + - Tranactions: AUTOCOMMIT + + +4. Documenting lower level, non-CommonSQL functions (some of this is already + done). + + - connection pools + - database-query-result-set + + +5. Notes on any peculiarities of each of the backends (e.g., unsupported + features, notable extensions etc.). + + - MYSQL + + drop-index: requires a table to be specified with the :on parameter + views: mysql does not support views + queries: nested subqueries are not supported + syntax: doesn't support the sql concatenation operator (||). + doesn't support INTERSECT/EXCEPT set operations. + create-table: the transactions keyword arg controls whether the created + table is an InnoDB table (supporting transactions) or not. + FDDL: list-*/*-exists-p: :OWNER keyword argument ignored. + + - SQLITE -5. Notes on any features unsupported by each of the backends. + connection: specifying ":memory:" gives you an SQLite database in RAM. + create-view: column-list parameter not supported + syntax: doesn't support the sql SUBSTRING operator. + FDDL: list-*/*-exists-p: :OWNER keyword argument ignored. + - ODBC + FDDL: list-*/*-exists-p: :OWNER keyword argument ignored.