X-Git-Url: http://git.kpe.io/?a=blobdiff_plain;f=base%2Fdb-interface.lisp;h=2d52105bd2bb3dc478c1cc7b570c9499896ab625;hb=cff8a2497b3f111a43d819476b55bfad2b447532;hp=4f1dc209ee4eb218d9085cac8854618e4fe3323c;hpb=2c14c425a4a203e03b74b868fdf727ea0d48572a;p=clsql.git diff --git a/base/db-interface.lisp b/base/db-interface.lisp index 4f1dc20..2d52105 100644 --- a/base/db-interface.lisp +++ b/base/db-interface.lisp @@ -30,13 +30,6 @@ "The internal generic implementation for checking if database type library loaded successfully.")) -(defgeneric database-type (database) - (:documentation - "Returns database type") - (:method (database) - (signal-no-database-error database))) - - (defgeneric database-initialize-database-type (database-type) (:documentation "The internal generic implementation of initialize-database-type.")) @@ -113,14 +106,21 @@ returns nil when result-set is finished.")) "Creates a database, returns T if successfull or signals an error.")) (defgeneric database-probe (connection-spec type) + (:method (spec type) + (declare (ignore spec)) + (warn "database-proe not support for database-type ~A." type)) (:documentation "Probes for the existence of a database, returns T if database found or NIL if not found. May signal an error if unable to communicate with database server.")) +(defgeneric database-list (connection-spec type) + (:method (spec type) + (declare (ignore spec)) + (warn "database-list not support for database-type ~A." type)) + (:documentation + "Lists all databases found for TYPE. May signal an error if unable to communicate with database server.")) + (defgeneric database-destroy (connection-spec database) - (:method (connection-spec (database t)) - (declare (ignore connection-spec)) - (signal-no-database-error database)) (:documentation "Destroys (drops) a database.")) (defgeneric database-truncate (database) @@ -179,6 +179,9 @@ the given lisp type and parameters.")) (defgeneric database-list-indexes (database &key owner) (:documentation "List all indexes in the DATABASE.")) +(defgeneric database-list-table-indexes (table database &key owner) + (:documentation "List all indexes for a table in the DATABASE.")) + (defgeneric database-list-attributes (table database &key owner) (:documentation "List all attributes in TABLE.")) @@ -194,6 +197,63 @@ the given lisp type and parameters.")) (defgeneric oid (object) (:documentation "Return the unique ID of a database object.")) +;;; Database backend capabilities + +(defgeneric database-underlying-type (database) + (:method (database) + (database-type database)) + (:documentation "Returns the type of the underlying database. For ODBC, needs to query ODBC driver.")) + +(defgeneric db-type-use-column-on-drop-index? (db-type) + (:method (db-type) + (declare (ignore db-type)) + nil) + (:documentation "NIL [default] if database-type does not use column name on DROP INDEX.")) + +(defgeneric db-type-has-views? (db-type) + (:method (db-type) + (declare (ignore db-type)) + ;; SQL92 has views + t) + (:documentation "T [default] if database-type supports views.")) + +(defgeneric db-type-default-case (db-type) + (:method (db-type) + (declare (ignore db-type)) + ;; By default, CommonSQL converts identifiers to UPPER case. + :upper) + (:documentation ":upper [default] if means identifiers mapped to UPPER case SQL like CommonSQL API. However, Postgresql maps identifiers to lower case, so PostgreSQL uses a value of :lower for this result.")) + +(defgeneric db-type-has-fancy-math? (db-type) + (:method (db-type) + (declare (ignore db-type)) + nil) + (:documentation "NIL [default] if database-type does not have fancy math.")) + +(defgeneric db-type-has-subqueries? (db-type) + (:method (db-type) + (declare (ignore db-type)) + t) + (:documentation "T [default] if database-type supports views.")) + +(defgeneric db-type-has-boolean-where? (db-type) + (:method (db-type) + (declare (ignore db-type)) + ;; SQL99 has boolean where + t) + (:documentation "T [default] if database-type supports boolean WHERE clause, such as 'WHERE MARRIED'.")) + +(defgeneric db-backend-has-create/destroy-db? (db-type) + (:method (db-type) + (declare (ignore db-type)) + t) + (:documentation "T [default] if backend can destroy and create databases.")) + +(defgeneric db-type-transaction-capable? (db database) + (:method (db database) + (declare (ignore db database)) + t) + (:documentation "T [default] if database can supports transactions.")) ;;; Large objects support (Marc Battyani) @@ -254,3 +314,7 @@ the given lisp type and parameters.")) (defmethod database-abort-transaction :before ((database database)) (unless (is-database-open database) (signal-closed-database-error database))) + +(defgeneric describe-table (table &key database) + (:documentation "Describes a table, returns a list of name/type for columns in table")) +