X-Git-Url: http://git.kpe.io/?a=blobdiff_plain;f=doc%2Fappendix.xml;h=d6a50d9cf8aa5b4164e0aef5243564a5ea7899c5;hb=0f3fe9d3a5a9940966262f760e6972015864cac8;hp=eb463cc5de0f4c8823a133e121571df2eaf527da;hpb=8d948bb37d6a4cc9cbdbc0ed3173b1284e00d552;p=clsql.git diff --git a/doc/appendix.xml b/doc/appendix.xml index eb463cc..d6a50d9 100644 --- a/doc/appendix.xml +++ b/doc/appendix.xml @@ -8,82 +8,11 @@ Database Back-ends - - MySQL - - Libraries - The MySQL back-end needs access to the MySQL C - client library (libmysqlclient.so). - The location of this library is specified - via *mysql-so-load-path*, which defaults - to /usr/lib/libmysqlclient.so. - Additional flags to ld needed for - linking are specified via *mysql-so-libraries*, - which defaults to ("-lc"). - - - - Initialization - - Use - -(asdf:operate 'asdf:load-op 'clsql-mysql) - - to load the MySQL back-end. The database type for the MySQL - back-end is :mysql. - - - - Connection Specification - - Syntax of connection-spec - (host db user password) - - - Description of connection-spec - - - host - - String representing the hostname or IP address - the MySQL server resides on, or nil - to indicate the localhost. - - - - db - - String representing the name of the database on - the server to connect to. - - - - user - - String representing the user name to use for - authentication, or nil to use the - current Unix user ID. - - - - password - - String representing the unencrypted password to - use for authentication, or nil if - the authentication record has an empty password - field. - - - - - - - PostgreSQL Libraries - The PostgreSQL back-end needs access to the PostgreSQL C + The PostgreSQL back-end requires the PostgreSQL C client library (libpq.so). The location of this library is specified via *postgresql-so-load-path*, which defaults @@ -96,7 +25,7 @@ Initialization Use -(asdf:operate 'adsf:load-op 'clsql-postgresql) +(asdf:operate 'asdf:load-op 'clsql-postgresql) to load the PostgreSQL back-end. The database type for the PostgreSQL back-end is :postgresql. @@ -105,13 +34,9 @@ Connection Specification Syntax of connection-spec - (host - db - user - password &optional - port - options - tty) + + (host db user password &optional port options tty) + Description of connection-spec @@ -177,6 +102,9 @@ + Notes + None. + @@ -207,13 +135,9 @@ Connection Specification Syntax of connection-spec - (host - db - user - password &optional - port - options - tty) + + (host db user password &optional port options tty) + Description of connection-spec @@ -282,23 +206,251 @@ + Notes + None. + + + + + MySQL + + Libraries + The &mysql; back-end requires the &mysql; C + client library (libmysqlclient.so). + The location of this library is specified + via *mysql-so-load-path*, which defaults + to /usr/lib/libmysqlclient.so. + Additional flags to ld needed for + linking are specified via *mysql-so-libraries*, + which defaults to ("-lc"). + + + + Initialization + + Use + +(asdf:operate 'asdf:load-op 'clsql-mysql) + + to load the &mysql; back-end. The database type for the MySQL + back-end is :mysql. + + + + Connection Specification + + Syntax of connection-spec + (host db user password) + + + Description of connection-spec + + + host + + String representing the hostname or IP address + the &mysql; server resides on, or nil + to indicate the localhost. + + + + db + + String representing the name of the database on + the server to connect to. + + + + user + + String representing the user name to use for + authentication, or nil to use the + current Unix user ID. + + + + password + + String representing the unencrypted password to + use for authentication, or nil if + the authentication record has an empty password + field. + + + + + + Notes + FDDL + + + + drop-index + requires a table to be specified with the + :on keyword parameter. + + + + + views are not + supported by &mysql;. + + + + + The :transactions keyword argument to + create-table + controls whether or not the created table is an InnoDB + table which supports transactions. + + + + + The :owner keyword argument to the FDDL functions + for listing and testing for database objects is ignored. + + + + + FDML + + + + Prior to version 4.1, &mysql; does not support nested + subqueries in calls to select. + + + + + Symbolic SQL Syntax + + + + &mysql; does not support the || + concatenation operator. Use concat + instead. + + + + + &mysql; does not support the substr + operator. Use substring instead. + + + + + &mysql; does not support the + intersect and + except set operations. + + + + + &mysql; (version 4.0 and later) does not support string + table aliases unless the server is started with + ANSI_QUOTES enabled. + + + + + + + + + &odbc; + + Libraries + + The &odbc; back-end requires access to an &odbc; driver + manager as well as &odbc; drivers for the underlying + database server. &clsql; has been tested with + unixODBC ODBC Driver Manager as + well as Microsoft's ODBC manager. These driver managers + have been tested with the + psqlODBC driver for + &postgresql; and the + MyODBC driver for &mysql;. + + + + Initialization + + Use + +(asdf:operate 'asdf:load-op 'clsql-odbc) + + to load the &odbc; back-end. The database type for the &odbc; + back-end is :odbc. + + + + Connection Specification + + Syntax of connection-spec + (dsn user password) + + + Description of connection-spec + + + dsn + + String representing the ODBC data source name. + + + + user + + String representing the user name to use for + authentication. + + + + password + + String representing the unencrypted password to + use for authentication. + + + + + + Notes + FDDL + + + + The :owner keyword argument to the FDDL functions + for listing and testing for database objects is ignored. + + + + + - AODBC + &aodbc; - Libraries - The AODBC back-end requires access to the ODBC interface - of &acl;. + Libraries The &aodbc; back-end requires + access to the &odbc; interface of &acl; named DBI. This + interface is not available in the trial version of + &acl; Initialization Use +(require 'aodbc-v2) (asdf:operate 'asdf:load-op 'clsql-aodbc) - to load the MySQL back-end. The database type for the AODBC + to load the &aodbc; back-end. The database type for the &aodbc; back-end is :aodbc. @@ -306,9 +458,9 @@ Connection Specification Syntax of connection-spec - (dsn - user - password) + + (dsn user password) + Description of connection-spec @@ -336,6 +488,210 @@ + Notes + + None. + + + + + + &sqlite; + + Libraries The &sqlite; back-end requires + the &sqlite; shared library file. Its default file name is + /usr/lib/libsqlite.so. + + + Initialization + + Use + +(asdf:operate 'asdf:load-op 'clsql-sqlite) + + to load the &sqlite; back-end. The database type for the &sqlite; + back-end is :sqlite. + + + + Connection Specification + + Syntax of connection-spec + (filename) + + + Description of connection-spec + + + filename + + String representing the filename of the &sqlite; + database file. + + + + + + Notes + Connection + + + + Passing filename a value of + :memory: will create a database in + physical memory instead of using a file on disk. + + + + + Some operations will be many times faster if database + integrity checking is disabled by setting the SYNCHRONOUS + flag to OFF (see the SQLITE manual for details). + + + + + FDDL + + + + The :owner keyword argument to the FDDL functions + for listing and testing for database objects is ignored. + + + + + The :column-list keyword argument to + create-view + is not supported by &sqlite;. + + + + + Symbolic SQL Syntax + + + + &sqlite; does not support the all, + some, any and + exists subquery operations. + + + + + + + + + Oracle + + Libraries + The &oracle; back-end requires the &oracle; OCI client + library. (libclntsh.so). The location of + this library is specified relative to the + ORACLE_HOME value in the operating system + environment. + + + + Library Versions + + &clsql; has tested sucessfully using the client library from + Oracle 9i and Oracle 10g server installations as well as + Oracle's 10g Instant Client library. For Oracle 8 and earlier + versions, there is vestigial support by pushing the symbol + :oci7 onto cl:*features* + prior to loading the clsql-oracle &asdf; + system. + + (push :oci7 cl:*features*) + (asdf:operate 'asdf:load-op 'clsql-oracle) + + + + + Initialization + + Use + +(asdf:operate 'asdf:load-op 'clsql-oracle) + + to load the &oracle; back-end. The database type for the Oracle + back-end is :oracle. + + + + Connection Specification + + Syntax of connection-spec + (global-name user password) + + + Description of connection-spec + + + global-name + + String representing the global name of the Oracle database. + This is looked up through the tnsnames.ora file. + + + + user + + String representing the user name to use for + authentication. + + + + password + + String representing the password to + use for authentication.. + + + + + + Notes + Symbolic SQL Syntax + + + + The userenv operator is &oracle; specific. + + + + + &oracle; does not support the except + operator. Use minus instead. + + + + + &oracle; does not support the all, + some, any + subquery operations. + + + + + Transactions + + + + By default, &clsql; starts in transaction AUTOCOMMIT mode + (see set-autocommit). + To begin a transaction in autocommit mode, start-transaction + has to be called explicitly. + + + + +